Krijg gratis geocodering op ondernemingsniveau met de Positionstack API (REVIEW)

U hoeft geen Google Maps te zijn om waarde te halen uit geocodering. En dankzij Positionstack heb je ook het technische budget van de Big G niet nodig. Vandaag bekijken we de robuuste API van Positionstack, die tot doel heeft voorwaartse en achterwaartse geocodering op bedrijfsniveau zowel zeer betaalbaar als bruikbaar te maken.

Positiestapel 101

Dus waarom zou u de moeite nemen om een ​​recensie van meer dan 2000 woorden op Positionstack te lezen , en wat heeft u eraan? Het antwoord klinkt schattig, maar het is juist: de hele wereld .

Bedenk eens hoeveel plaatsen er op de wereldkaart zijn. Vermenigvuldig nu dat aantal in uw hoofd met elk stukje metadata dat uw bedrijf over die plaatsen moet weten. Dat is wat Positionstack biedt, en nog wat.

Laten we eens kijken naar enkele snelle statistieken over Positionstack:

• Werkelijke miljarden zoekverzoeken voor geocodering die elk uur en elke dag worden verwerkt; met 100% uptime en < 100ms="" response="">
• Cloudgebaseerde, zeer schaalbare infrastructuur
• Realtime gegevens over elk land ter wereld, gecompileerd in een spelonkachtige dataset die om de paar uur wordt bijgewerkt
• Royaal verdeelde, scherp geprijsde abonnementen; plus een ongeëvenaard maandelijks quotum van 10.000 aanvragen voor gratis gebruikers
• Integratieondersteuning voor alle belangrijke programmeertalen
• Uitgebreide, gemakkelijk leesbare documentatie, compleet met codefragmenten
• Een klanttevredenheidsteam van wereldklasse met ervaring in het bedienen van klanten zoals Zendesk, Slack, LinkedIn, Lyft, Apple en Amazon

Positionstack heeft zijn stamboom zeker onder controle, maar voor het geval je niet overtuigd bent door een handvol opsommingstekens, laten we eens een diepe duik nemen in hoe het is om de API daadwerkelijk te gebruiken.

De 3-stappen snelstartgids van Positionstack

Als u wat tijd op hun website doorbrengt, zult u zien dat Positionstack echt de nadruk legt op gebruiksgemak als een primair verkoopargument voor hun API. Tijdens het aanmeldingsproces zul je meteen zien dat dit helemaal waar is. Het eerste dat u ziet nadat u uw accountgegevens hebt ingevoerd, is een snel stappenplan van wat er nodig is om in drie eenvoudige stappen aan de slag te gaan met Positionstack. Laten we kijken:

1. Stel uw API-toegangssleutel in - Standaard krijgt u een toegangssleutel die direct uit de doos kan worden gebruikt. U kunt dit indien nodig echter eenvoudig opnieuw instellen.
2. Kies API-eindpunten - In de volgende sectie gaan we dieper in op API-eindpunten, maar begrijp nu dat deze stap verwijst naar het configureren van welk type gegevens wordt geretourneerd wanneer uw app een verzoek doet aan Positionstack. Hier ziet u eerst de basis-URL, waarop u uw verzoeken richt, maar deze verschijnt ook in de documentatie. Ten slotte zien we een voorbeeld van een API-verzoek, dat uit slechts een paar eenvoudige regels code bestaat.
3. Applicatie-integratie – De laatste stap verwijst naar de uiteindelijke integratie van de API van Positionstack in uw applicatie. Er is behoorlijk wat te weten over dit proces, en het meeste wordt behandeld in de documentatie. Het belangrijkste hier is: het ondersteuningsteam van Positionstack staat voor je klaar en biedt zo veel of zo weinig hulp die je nodig hebt bij het configureren en integreren van hun API in je app.

Lekker makkelijk toch? API's kunnen in eerste instantie intimiderend lijken voor mensen zonder uitgebreide IT-kennis. Maar meteen stelt Positionstack u gerust met de wetenschap dat het niet alleen gemakkelijk is, maar u ook op weg helpt met ongelooflijke documentatie van hun slimme ontwerp. Het helpt dat ze een gepassioneerd team van experts klaar hebben staan ​​om u ook te helpen.

Uw Positionstack-dashboard

Positionstack verdubbelt hun kernwaarde van gebruiksvriendelijkheid en biedt een gestroomlijnd, overzichtelijk dashboard van waaruit u toegang hebt tot alles wat u moet weten over uw API. Laten we eens kijken naar de zijbalkopties:

• Dashboard - Hier vindt u meldingen (die u gewoonlijk waarschuwen wanneer u bepaalde gebruiksdrempels overschrijdt), en vervolgens links naar zowel de 3-stappen snelstartgids als hun documentatiepagina. Er is ook een overzicht van uw API-sleutel, uw huidige abonnement, accountgegevens en betaalmethode.
• Upgrade/Abonnement – U kunt uw abonnement wijzigen op een van deze twee opties. Upgrade op elk gewenst moment, maar als u in beide richtingen wilt schakelen tussen een maandelijks of jaarlijks abonnement, moet u eerst downgraden naar een gratis account en vervolgens de gewenste optie kiezen. Positionstack support staat graag voor u klaar als u hierbij hulp nodig heeft.
• Rekening/Betaling – Deze spreken voor zich; Met beide tabbladen kunt u uw inloggegevens op elk gewenst moment bijwerken. Het moet gezegd worden dat we het op prijs stellen dat ze deze basisbedieningen niet begraven in een over-ontworpen, flitsende interface. WYSIWYG.
• API-gebruik - Waarschijnlijk het tabblad dat u het vaakst bezoekt, hier kunt u zien hoeveel van uw maandelijkse verzoekquotum u tot nu toe hebt opgegeten. Er is ook een handig gedeelte met uw gebruiksstatistieken in de loop van de tijd, zodat u uw strategie dienovereenkomstig kunt aanpassen.

API-documentatie

Nu komen we tot de kern van het aanbod van Positionstack: de API-documentatie . Beschouw deze pagina als uw go-to-gebruikershandleiding, waarin elk API-eindpunt, hun parameters en wat voor soort informatie ze zullen retourneren, worden beschreven.

Deze pagina is opgedeeld in vijf verschillende secties. We zullen ze allemaal doornemen en wat tijd en woorden besteden om wat context voor u te bieden om beter te begrijpen wat u zult aantreffen.

Beginnen

Hier vindt u basisfuncties die van toepassing zijn op elke aanvraag die u met Positionstack doet. Dit zijn:

• API-sleutel – Uw API-sleutel is als een digitaal paspoort dat u zult gebruiken om toegang te krijgen tot de dataset van Positionstack. Zonder dit is de API nutteloos voor u. Als u denkt dat deze is gecompromitteerd, kunt u uw oude sleutel eenvoudig omwisselen voor een nieuwe.
• Versleuteling - 256-bit SSL-codering wordt overal op internet gebruikt en is niet voor niets de industriestandaard voor beveiliging. Hoewel je een basisabonnement of beter nodig hebt om de communicatie van je app met de servers van Positionstack te versleutelen, is het op zichzelf al de investering waard. Om codering op te roepen, wijzigt u eenvoudig HTTP in HTTPS in de API-basis-URL. Gemakkelijk!
• JSON-callbacks - We zullen niet te veel technische details geven over hoe dit werkt, maar als uw API-verzoeken worden geblokkeerd door beleid van dezelfde oorsprong, gebruikt u JSON-callbacks om een ​​tijdelijke oplossing te vinden. In wezen vraag je gegevens op uit een extern script, dat niet verzandt in domeinoverschrijdende problemen.
• API-fouten - Zoals met alles, zullen uw API-verzoeken soms fouten tegenkomen. Positionstack begrijpt dit en heeft in hun app een functionaliteit voor foutrapportage ingebouwd om u te helpen identificeren wat er mis is gegaan. Bij mislukte API-verzoeken wordt automatisch een foutobject geretourneerd in de JSON-indeling, plus code, bericht en contextsubobjecten om context voor de fout te bieden.

API-eindpunten

Deze sectie documenteert de vlees-en-aardappelfunctionaliteit van Positionstack, dat wil zeggen voorwaartse en achterwaartse geocodering. Als je niet 100% zeker weet wat het verschil is, beschouw geocodering dan als tweerichtingsverkeer waar je plaatsen en adressen die in gewoon Engels zijn geschreven, kunt vertalen naar locatiegegevens zoals coördinaten en IP-adressen, en omgekeerd.

Je zou dus voorwaartse geocodering gebruiken om de locatie van de Eiffeltoren om te zetten in coördinaten. Op dezelfde manier kunt u het straatadres vinden dat is gekoppeld aan een IP-adres door omgekeerde geocodering te gebruiken. Lekker simpel, tenslotte!

Vooruit/achteruit geocoderingsverzoeken

Om een ​​basisverzoek in te dienen voor elk type geocodering, moet u het juiste eindpunt ( /forward  of /reverse ) toevoegen aan de basis-URL van de API. Vervolgens geeft u uw toegangssleutel op en stelt u vervolgens een vraag met behulp van een gewoon Engels locatieadres of de bijbehorende locatiegegevens - en voila! Het zal er ongeveer zo uitzien:

https://api.positionstack.com/v1/forward
    ? access_key = UW_ACCESS_KEY
    & query = 1600 Pennsylvania Ave NW, Washington DC

of

https://api.positionstack.com/v1/reverse
    ? access_key = UW_ACCESS_KEY
    & zoekopdracht = 40,7638435,-73,9729691

Natuurlijk bevat de dataset van Positionstack veel, veel meer dan alleen adressen en coördinaten. U kunt deze andere categorisaties ontleden door het gebruik van verschillende parameters. Hier is een voorbeeld van hoe een voorwaarts geocoderingsverzoek , waarbij het Witte Huis wordt ondervraagd, eruitziet:

{
   "gegevens": {
      "resultaten": [
         {
            "breedtegraad": 38.897675,
            "lengtegraad": -77,036547,
            "label": "1600 Pennsylvania Avenue NW, Washington, DC, VS",
            "naam": "1600 Pennsylvania Avenue NW",
            "type": "adres",
            "nummer": "1600",
            "straat": "Pennsylvania Avenue NW",
            "postcode": "20500",
            "vertrouwen": 1,
            "regio": "District of Columbia",
            "region_code": "DC",
            "administrative_area": ​​null,
            "buurt": "Witte Huisterrein",
            "land": "Verenigde Staten",
            "country_code": "VS",
            "map_url": "https://map.positionstack.com/38.897675,-77.036547"
         }
      ]
   }
}

Interessant is dat als u een verzoek om omgekeerde geocodering zou doen met behulp van de geschatte coördinaten van het Witte Huis, de geretourneerde resultaten er bijna identiek uit zouden zien, behalve dat u ook het verschil in afstand zou zien tussen uw coördinaten en de officiële coördinaten van het Witte Huis zoals ze verschijnen in Positionstack's gegevensset.

De reden voor deze overeenkomst is dat beide eindpunten dezelfde reeks GET-parameters gebruiken en dus in staat zijn om (bijna) dezelfde responsobjecten te retourneren. Dat betekent dat het niet uitmaakt welke startgegevens u moet gebruiken, u kunt er een volledige aanvulling op locatiegegevens voor terugkrijgen. (Het is mogelijk om deze resultaten te beperken met behulp van de API's velden  parameter, maar we zullen op die later meer aanraken.)

Opmerking: de documentatiepagina van Positionstack geeft volledige details over elke parameter en elk responsobject, dus zorg ervoor dat u het bekijkt!

Batchverzoeken

De laatste hoofdkop in deze documentatie-instelling gaat over batchverzoeken . Alles wat je hebt te doen is het aanroepen van de batch  parameter, dan nest meerdere vraag instances (samen met uw gewenste parameters) onder in een enkel verzoek, en Positionstack API zorgt voor de rest. Het is doodeenvoudig en ziet er als volgt uit:

{
   "partij":[
      {
         "query": "Hoofdstraat",
         "land": "VS",
         "regio": "Minnesota"
      },
      {
         "query": "Hoofdstraat",
         "land": "VS",
         "regio": "Illinois"
      },
      {
         "query": "Hoofdstraat",
         "land": "VS",
         "regio": "Missouri"
      }
   ]
}

Geavanceerde gegevens

Naast de basislocatieparameters kunt u uw API-verzoeken verder aanpassen om meer geavanceerde gegevens te retourneren . Deze omvatten:

• Insluitbare kaarten - Retourneert een map_url-object dat is gekoppeld aan uw geocoderingsresultaat, dat u kunt gebruiken om een ​​aantrekkelijke visuele kaartweergave op uw website of app te maken.
• Landmodule – In tegenstelling tot andere parameters die tot een paar responsobjecten retourneren , retourneert country_module een ongelooflijke reeks gegevens over uw opgevraagde land. Het zijn niet alleen coördinaten en adressen; het is de hoofdstad, vlag, officiële naam, status als een geheel door land omgeven (of niet) land, gebruikte valuta, gesproken talen, belcodes en meer.
• Sun Module - Humoristisch beschrijft de documentatie van Positionstack dit als "astrologische" gegevens. U krijgt uw horoscoop niet met deze parameter, maar u ziet gegevens over wanneer de zon opkomt en ondergaat, volgens astronomische, civiele en nautische chronologie.
• Tijdzonemodule - Voeg timezone_module toe om de GMT-offset van een locatie in seconden of als een natuurlijke taalreeks te retourneren.
• Begrenzingsvakmodule – Als een enkel x/y-paar coördinaten niet geschikt is voor uw taak, probeer dan een begrenzingsvak, dat een gebied omsluit met minimum- en maximumwaarden voor lengte- en breedtegraad.

Toegevoegde opties

De Positionstack API heeft een hoop gegevens om naar je toe te gooien, maar gelukkig biedt het je extra tools om deze schat aan informatie te beheren.

• Specificeer responsvelden - We hebben uitgebreid besproken hoeveel gegevens Positionstack kan retourneren, maar houd er rekening mee dat al die gegevens kosten met zich meebrengen. Als u uw maandelijkse verzoeken wilt beperken, kunt u dat doen met de velden Appending fields = results.flag bijvoorbeeld, waardoor de API alleen de vlag van uw opgevraagde land uitvoert. U kunt velden zo vaak aanroepen als nodig is om de specifieke dataset te krijgen die u nodig heeft.
• Specificeer uitvoerformaat - Gratis abonnees zijn beperkt tot het JSON-formaat voor hun geretourneerde geocoderingsresultaten. Betalende klanten kunnen echter output toevoegen aan hun verzoeken om JSON, XML of GeoJSON op te geven als dat nodig is. 

Codevoorbeelden 

Als Positionstack zegt dat ze er zijn om je te helpen, menen ze dat. We hebben al gezien hoe grondig hun documentatie is, maar ze maken het af met handige codevoorbeelden in alle talen die hun API ondersteunt. We gaan die code hier niet kopiëren/plakken, maar voor een snelle referentie zijn die talen:

• Python
• Nodejs
• jQuery
• Gaan
• Robijn

Bewijs en prestatie

Op dit punt zou het duidelijk moeten zijn dat Positionstack heel wat kan doen. Maar hoe goed doet het deze dingen?

Laten we eerst eens kijken naar wat context. Positionstack is een van de 20+ API-microservices in het cloudgebaseerde ecosysteem van Apilayer. Samen bedienen deze API's meer dan een miljoen B2B-klanten, van startups tot ondernemingen. Enkele van hun meest opvallende klanten zijn Amazon, Apple, Slack, LinkedIn en nog veel meer bekende namen. Het is duidelijk dat ze een robuuste infrastructuur hebben om deze grote vraag aan te kunnen.

Op zijn eigen verdiensten maakt Positionstack zijn afkomst waar, met een ongelooflijke uptime van 100% in heel 2020 op het moment van schrijven. Dit is nog indrukwekkender als je bedenkt dat de API routinematig meer dan een miljard geocode-lookups per dag per walvisclient verwerkt, om nog maar te zwijgen van de duizelingwekkende reeks gelijktijdige verzoeken van hun stal van MKB-klanten. Bovendien genereren deze verzoeken doorgaans reacties tussen 10 en 100 ms.

In ons boek is dat iets van een technologisch wonder, vooral gezien de agressieve prijs van dit SaaS-aanbod.

En het is niet alleen pure kracht die Positionstack zo aantrekkelijk maakt. Hun dataset is echt geavanceerd, afkomstig van betrouwbare namen zoals Nominatim, GeoNames, Pelias en OpenStreetMap. Positionstack controleert, filtert en recombineert deze schat aan gegevens meerdere keren per dag, en zorgt voor regelmatige updates via slimme algoritmen die ervoor zorgen dat u altijd over zeer nauwkeurige locatiegegevens beschikt, waar ook ter wereld en in realtime.

We haten het om ons eindoordeel te verpesten, maar als je op zoek bent naar een robuuste, schaalbare geocoderingsoplossing, moet je het cv van Positionstack nader bekijken.

Prijzen 

Apilayer wilde een betaalbaar alternatief bieden voor zeer dure geocoderingssoftware op ondernemingsniveau, en daarin zijn ze geslaagd.

Positionstack wordt geleverd in vijf prijsniveaus en ondersteunt maandelijkse facturering of jaarlijkse abonnementen met 20% korting. Die niveaus zijn:

• Gratis - Beoordeeld voor persoonlijk gebruik, u krijgt nog steeds een flink aantal kilometers met 25.000 maandelijkse verzoeken voor voorwaartse en achterwaartse geocodering, uitgevoerd in het JSON-formaat. U krijgt niet veel geavanceerde functies of klantenondersteuning, maar we hebben u al laten zien wat een waardevolle bron hun documentatiepagina is. Dit niveau is gratis en vrijblijvend - u hoeft niet eens creditcardgegevens op te geven om te beginnen.
• Basic – Het commerciële pakket op instapniveau. Basisabonnees verviervoudigen hun maandelijkse quotum tot 100.000 geocoderingsverzoeken, en krijgen toegang tot geavanceerde functies zoals HTTPS-codering, meerdere uitvoeropties (JSON, XML, GeoJSON), insluitbare kaarten, meerdere talen en meer. Ontvang een commerciële Positionstack-licentie voor slechts $ 9,99 per maand.
• Professional – Het meest populaire aanbod van Positionstack, de Professional-laag, biedt een tienvoudige toename van geocoderingsverzoeken, tot wel 1.000.000 per maand. Alle goodies van de Basic-laag zijn aanwezig en nog wat, met name batchverzoeken voor zware toepassingen. Deze laag klokt af op $ 49,99 per maand.
• Zakelijk – Met de overstap naar prestaties op ondernemingsniveau, verhoogt de Business-laag het maandelijkse quotum tot maar liefst 3.000.000 verzoeken. Nogmaals, elke geavanceerde functie is volledig beschikbaar, ondersteund door het gepassioneerde klantenserviceteam van Positionstack om u te helpen er het maximale uit te halen. $ 99,99 per maand.
• Enterprise - Dit is het niveau waarop standaardaanbiedingen uit het raam gaan en de klant koning is. U heeft precieze behoeften die om maatwerk vragen, en Positionstack staat klaar om uw doelen te bereiken. U dicteert uw maandelijkse volumeverzoeken, zelfs (vooral) als ze variabel zijn. Meer pk's uit de API nodig? Neem contact op met ondersteuning voor op maat gemaakte oplossingen. Neem contact op met Positionstack voor een offerte.

Vonnis

Positionstack doet precies wat het wilde doen: geocodering op ondernemingsniveau verlagen van prijspunten die anders buiten budget zouden zijn voor de meeste MKB's, zonder in te boeten aan prestaties. Hun API is goed gedocumenteerd en gebruiksvriendelijk, maar biedt een robuuste integratie in alle belangrijke programmeertalen voor maximaal nut. Het aantal verzoeken dat Positionstack routinematig verwerkt, is enorm, terwijl hun dataset slim wordt onderhouden voor een echt wereldwijd bereik in realtime geocodering. Als u op zoek bent naar dit type product, slaap dan niet op Positionstack.

Wat voor soort integratie heb je gepland? Hoe gaat u geocodering gebruiken in uw bedrijf? Heeft u vragen of opmerkingen over Positionstack? Laat een bericht achter in de reacties hieronder.