Ontvang gratis geocodering op bedrijfsniveau 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 erop gericht is geocodering op ondernemingsniveau zowel zeer betaalbaar als bruikbaar te maken.

Positionstack 101

Dus waarom zou u de moeite nemen om een ​​recensie van meer dan 2000 woorden te lezen Positionstack, en wat heb je te winnen? Het antwoord klinkt schattig, maar het klopt: de gehele wereld.

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

Laten we enkele snelle statistieken over Positionstack bekijken:

• Werkelijke miljarden opzoekverzoeken voor geocodering worden elk uur, elke dag verwerkt; met 100% uptime en <100ms reactietijden
• Cloudgebaseerde, zeer schaalbare infrastructuur
• Real-time gegevens over elk land ter wereld, verzameld in een holle dataset die om de paar uur wordt bijgewerkt
instagram viewer
• Royaal verdeelde, scherp geprijsde abonnementen; plus een ongeëvenaard maandelijks quotum van 10.000 verzoeken voor gratis gebruikers
• Integratie-ondersteuning voor alle belangrijke programmeertalen
• Uitgebreide, gemakkelijk te lezen 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 zeker zijn stamboom onder controle, maar als je niet overtuigd bent door een handvol opsommingstekens, laten we dan een diepe duik nemen in hoe het is om de API daadwerkelijk te gebruiken.

Positionstack's 3-stappen snelstartgids

Als je enige tijd op hun website doorbrengt, zul je zien dat Positionstack echt het gebruiksgemak benadrukt als een primair verkoopargument voor hun API. Tijdens het aanmeldingsproces zie je meteen dat dat helemaal waar is. In feite is het eerste dat u ziet na het invoeren van uw accountgegevens een snelle roadmap 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 - U krijgt standaard een toegangssleutel die klaar is om uit de doos te gaan. U kunt dit echter zo nodig eenvoudig opnieuw instellen.
2. Kies API-eindpunten - We gaan in de volgende sectie dieper in op API-eindpunten, maar voor nu begrijp ik dat deze stap verwijst naar het configureren van het type gegevens dat wordt geretourneerd wanneer uw app een verzoek indient bij Positionstack. Hier ziet u eerst de basis-URL, waar u uw verzoeken op target, maar deze verschijnt ook in de documentatie. Ten slotte zien we een voorbeeld van een API-verzoek dat uit slechts een paar eenvoudige coderegels bestaat.
3. Applicatie-integratie - De laatste stap verwijst naar de definitieve integratie van Positionstack's API in uw applicatie. Er is redelijk wat te weten over dit proces en het meeste wordt behandeld in de documentatie. Het belangrijkste hier is: het ondersteuningsteam van Positionstack staat achter je en biedt zoveel of zo weinig hulp als je nodig hebt om hun API in je app te configureren en te integreren.

Vrij eenvoudig toch? API's kunnen in eerste instantie intimiderend lijken voor mensen zonder uitgebreide IT-kennis. Maar Positionstack stelt je meteen gerust met de wetenschap dat het niet alleen gemakkelijk is, maar ook dat ze je op weg helpen met ongelooflijke documentatie van hun slimme ontwerp. Het helpt hen om een ​​gepassioneerd team van experts klaar te 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 krijgt tot alles wat u moet weten over uw API. Laten we de zijbalkopties eens bekijken:

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

API-documentatie

Nu komen we bij het hart en de ziel van het aanbod van Positionstack: de API-documentatie. Beschouw deze pagina als uw 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 u wat context te geven om beter te begrijpen wat u zult vinden.

Ermee beginnen

Hier vind je basisfuncties die van toepassing zijn op elk verzoek dat u met Positionstack doet. Dit zijn:

• API sleutel - Uw API-sleutel is als een digitaal paspoort dat u gebruikt om toegang te krijgen tot de dataset van Positionstack. Zonder dit is de API nutteloos voor jou. Als u denkt dat het is gecompromitteerd, kunt u uw oude sleutel eenvoudig omdraaien voor een nieuwe.
• Versleuteling - 256-bit SSL-codering wordt overal op internet gebruikt en is niet voor niets de industriestandaard voor beveiliging. Hoewel u een basisplan of beter nodig heeft om de communicatie van uw app met de servers van Positionstack te versleutelen, is het de investering alleen al de moeite waard. Om versleuteling op te roepen, verander eenvoudig HTTP naar HTTPS in de API-basis-URL. Gemakkelijk!
• JSON-terugbelverzoeken - We zullen niet te veel technische details bespreken over hoe dit werkt, maar als uw API-verzoeken worden belemmerd door hetzelfde oorsprongsbeleid, gebruikt u JSON-callbacks om een ​​tijdelijke oplossing te beïnvloeden. In wezen vraagt ​​u gegevens op van een extern script, dat niet blijft steken in domeinoverschrijdende problemen.
• API-fouten - Zoals met alles, zullen uw API-verzoeken soms fouten tegenkomen. Positionstack begrijpt dit en heeft in hun app een functie voor foutrapportage ingebouwd om u te helpen identificeren wat er mis is gegaan. Mislukte API-verzoeken retourneren automatisch een foutobject in de JSON-indeling, plus code-, bericht- en context-subobjecten om context te bieden voor de fout.

API-eindpunten

Deze sectie beschrijft de vlees-en-aardappelfunctionaliteit van Positionstack, dat wil zeggen voorwaartse en achterwaartse geocodering. Als u niet 100% zeker weet wat het verschil is, kunt u geocodering beschouwen als een tweerichtingsstraat waar u kunt vertalen plaatsen en adressen geschreven in gewoon Engels naar locatiegegevens zoals coördinaten en IP-adressen, en omgekeerd.

U zou dus voorwaartse geocodering gebruiken om de locatie van de Eiffeltoren om te zetten in coördinaten. Op dezelfde manier kunt u het adres dat aan een IP-adres is gekoppeld, achterhalen door gebruik te maken van reverse geocoding. Vrij eenvoudig toch!

Aanvragen voor geocodering vooruit / achteruit

Om een ​​basisverzoek te doen voor beide soorten geocodering, moet u het juiste eindpunt toevoegen (/forward of /reverse) naar de basis-URL van de API. Vervolgens geeft u uw toegangssleutel op en maakt u vervolgens een vraag met behulp van een gewoon Engels locatie-adres of de bijbehorende locatiegegevens - en, voila! Het ziet er ongeveer zo uit:

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

of

https://api.positionstack.com/v1/reverse? access_key = YOUR_ACCESS_KEY & query = 40.7638435, -73.9729691. 

De dataset van Positionstack bevat natuurlijk veel, veel meer dan alleen adressen en coördinaten. Je kunt deze andere categorisaties ontleden door het gebruik van verschillende parameters. Hier is een voorbeeld van wat een voorwaartse geocodering verzoek, het Witte Huis bevragend, ziet er als volgt uit:

{"data": {"results": [{"latitude": 38.897675, "longitude": -77.036547, "label": "1600 Pennsylvania Avenue NW, Washington, DC, USA", "name": "1600 Pennsylvania Avenue NW "," type ":" address "," number ":" 1600 "," street ":" Pennsylvania Avenue NW "," Postal_code ":" 20500 "," trust ": 1," region ":" Wijk van Columbia "," region_code ":" DC "," Administrative_area ": null," neighbourhood ":" White House Grounds "," country ":" United States "," country_code ":" US ", "map_url": " http://map.positionstack.com/38.897675,-77.036547" } ] } }

Interessant is dat als je een omgekeerde geocodering verzoek met behulp van de geschatte coördinaten van het Witte Huis, zouden de geretourneerde resultaten er bijna identiek uitzien, behalve dat u ook het verschil zou zien in afstand tussen uw coördinaten en de officiële coördinaten van het Witte Huis zoals ze worden weergegeven in de dataset van Positionstack.

De reden voor deze overeenkomst is dat beide eindpunten dezelfde array van GET-parameters gebruiken en dus in staat zijn om (bijna) dezelfde responsobjecten terug te sturen. Dat betekent dat het niet uitmaakt welke startgegevens u moet doorlopen, u kunt in ruil daarvoor een volledige aanvulling op locatiegegevens krijgen. (Het is mogelijk om deze resultaten te beperken met behulp van de API's velden parameter, maar daar komen we later op terug.)

Opmerking: de documentatiepagina van Positionstack geeft een gedetailleerde beschrijving van elke parameter en elk responsobject, dus zorg ervoor dat u deze bekijkt!

Batchverzoeken

De laatste grote kop in deze documentatie-instelling behandelt batchverzoeken. Het enige dat u hoeft te doen, is de partij parameter en nest dan meerdere vraag instanties (samen met uw gewenste parameters) eronder in één verzoek, en de API van Positionstack zorgt voor de rest. Het is doodeenvoudig en ziet er zo uit:

{"batch": [{"query": "Main Street", "country": "US", "region": "Minnesota"}, {"query": "Main Street", "country": "US", "region": "Illinois"}, {"query": "Main Street", "country": "US", "region": "Missouri"} ] }

Geavanceerde gegevens

Naast de basislocatieparameters, kunt u uw API-verzoeken om meer terug te sturen verder afstemmen geavanceerde gegevens. Deze omvatten:

• Insluitbare kaarten - Retourneert een map_url-object gekoppeld aan uw geocoderingsresultaat, dat u kunt gebruiken om een ​​aantrekkelijke visuele kaartweergave op uw website of app te creëren.
• Landenmodule - In tegenstelling tot andere parameters die tot enkele responsobjecten terugkeren, country_module geeft een ongelooflijke reeks gegevens terug over uw ondervraagde land. Het zijn niet alleen coördinaten en adressen; het is de hoofdstad, de vlag, de officiële naam, de status van een geheel door land omgeven land (of niet), de gebruikte valuta's, gesproken talen, belcodes en meer.
• Zon Module - Humoristisch beschrijft de documentatie van Positionstack dit als "astrologische" gegevens. U krijgt uw horoscoop niet met deze parameter, maar u zult gegevens zien over wanneer de zon opkomt en ondergaat, volgens de astronomische, civiele en nautische chronologie.
• Tijdzonemodule - Bijvoegen tijdzone_module om de GMT-offset van een locatie in seconden of als een natuurlijke taalreeks te retourneren.
• Bounding Box Module - 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 te gooien, maar gelukkig biedt het je extra tools om deze schat aan informatie te beheren.

• Geef antwoordvelden op - 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 velden = resultaten. vlagzorgt er bijvoorbeeld voor dat de API alleen de vlag van uw ondervraagde land uitvoert. Je kunt een beroep doen velden zo vaak als je nodig hebt om de specifieke dataset te krijgen die je nodig hebt.
• Geef het uitvoerformaat op - Gratis abonnees zijn beperkt tot het JSON-formaat voor hun geretourneerde geocoderingsresultaten. Betalende klanten kunnen wel meedoen output op hun verzoeken om indien nodig JSON, XML of GeoJSON te specificeren.

Code voorbeelden

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

• Python
• Nodejs
• jQuery
• Gaan
• Robijn

Bewijs en prestaties

Op dit moment moet het duidelijk zijn dat Positionstack behoorlijk veel kan. Maar, hoe goed doet het deze dingen?

Laten we eerst eens wat context bekijken. 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 en met 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 aan deze vraag te voldoen.

Op zijn eigen merites maakt Positionstack zijn stamboom waar, met een ongelooflijke uptime van 100% gedurende 2020 op het moment van schrijven. Dit is nog indrukwekkender als je kijkt naar de API routinematig verwerkt meer dan een miljard geocode-zoekopdrachten per dag per walviscliënt, om nog maar te zwijgen van de duizelingwekkende reeks gelijktijdige verzoeken afkomstig van hun stal van MKB-klanten. Bovendien krijgen deze verzoeken doorgaans reacties tussen 10 en 100 ms.

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

En het is niet alleen brute 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 hercombineert deze schat aan gegevens meerdere keren per dag, met regelmatige updates via slimme algoritmen die ervoor zorgen dat u altijd over zeer nauwkeurige locatiegegevens beschikt, overal ter wereld en in het echt tijd.

We haten het om ons eindoordeel te bederven, maar als u op zoek bent naar een robuuste, schaalbare geocoderingsoplossing, vereist het cv van Positionstack een nadere blik.

Prijzen

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

Positionstack komt in vijf prijzen niveaus en ondersteunt maandelijkse facturering of jaarlijkse abonnementen met 20% korting. Die niveaus zijn:

• Vrij - Beoordeeld voor persoonlijk gebruik, je krijgt nog steeds een flink aantal kilometers met 25.000 maandelijkse verzoeken voor geocodering voor vooruit en achteruit, uitgevoerd in de JSON-indeling. U krijgt niet veel geavanceerde functies of klantenondersteuning, maar we hebben u al laten zien wat een waardevolle bron hun documentatiepagina is. Deze laag is gratis en vrijblijvend: u hoeft niet eens creditcardgegevens op te geven om aan de slag te gaan.
• Basic - Het commerciële pakket op instapniveau. Basisabonnees verviervoudigen hun maandelijkse quotum tot 100.000 geocoderingsverzoeken en krijgen toegang tot geavanceerd functies zoals HTTPS-codering, meerdere uitvoeropties (JSON, XML, GeoJSON), insluitbare kaarten, meerdere talen, en meer. Koop een commerciële Positionstack-licentie voor slechts $ 9,99 per maand.
• Professioneel - Het meest populaire aanbod van Positionstack, de Professional-laag, vertienvoudigt het aantal aanvragen voor geocodering - tot 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 in voor $ 49,99 per maand.
• Bedrijf - Op weg naar prestaties op bedrijfsniveau, 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.
• Onderneming - Dit is het niveau waarin standaardaanbiedingen het raam uitgaan en de klant koning is. U heeft nauwkeurige behoeften die maatwerkoplossingen vereisen en Positionstack staat klaar om uw doelen te bereiken. U dicteert uw maandelijkse volumeverzoeken, zelfs (vooral) als ze variabel zijn. Meer pk's nodig van de API? Neem contact op met ondersteuning voor op maat gemaakte oplossingen. Neem contact op met Positionstack voor een offerte.

Vonnis

Positionstack doet precies wat het van plan was: geocodering op bedrijfsniveau verlagen van prijspunten die anders buiten het budget vallen voor de meeste kleine en middelgrote ondernemingen, zonder in te boeten op prestaties. Hun API is goed gedocumenteerd en gemakkelijk te gebruiken, maar biedt robuuste integratie in alle belangrijke programmeertalen voor maximale bruikbaarheid. Het aantal verzoeken dat Positionstack routinematig afhandelt, is verbluffend, terwijl hun dataset slim wordt onderhouden voor echt wereldwijd bereik in realtime geocodering. Als je op de markt bent voor dit type product, slaap dan niet op Positionstack.

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