Få geokodning på företagsnivå gratis med Positionstack API (REVIEW)

Du behöver inte vara Google Maps för att få värde från geokodning. Och tack vare Positionstack behöver du inte heller Big G: s tekniska budget för att göra det. Idag granskar vi Positionstacks robusta API, som syftar till att göra företagsnivå framåt och omvänd geokodning både mycket prisvärd och användbar.

Positionstack 101

Så varför ska du bry dig om att läsa en 2 000+ ordrecension om Positionstack, och vad kommer du att vinna? Svaret låter söt, men det är korrekt: de hela världen.

Tänk ett ögonblick på hur många platser det finns på världskartan. Nu multiplicerar du det numret i ditt huvud med varje metadata som ditt företag behöver veta om dessa platser. Det är vad Positionstack erbjuder, och sedan några.

Låt oss titta på några snabba statistik om Positionstack:

• Faktiska miljarder geokodningsuppslag begärs varje timme, varje dag; med 100% upptid och <100 ms responstid
• Molnbaserad, mycket skalbar infrastruktur
• Realtidsdata om alla länder i världen, sammanställda till en kavernös datasats som uppdateras med några timmar
instagram viewer
• Generöst fördelade, konkurrenskraftiga prenumerationsplaner; plus en oöverträffad månadskvot på 10 000 för gratis användare
• Integrationsstöd för alla större programmeringsspråk
• Omfattande, lättläst dokumentation komplett med kodavsnitt
• Ett kundnöjdhetsteam i världsklass med erfarenhet som betjänar kunder som Zendesk, Slack, LinkedIn, Lyft, Apple och Amazon

Positionstack har verkligen sin stamtavla i schack, men om du inte är övertygad av en handfull kulpunkterna, låt oss ta ett djupt dyk i hur det är att använda API: et.

Positionstacks 3-stegs snabbstartguide

Om du tillbringar någon tid på deras webbplats ser du att Positionstack verkligen betonar användarvänlighet som en primär försäljningsplats för deras API. Under anmälningsprocessen ser du omedelbart att det är helt sant. Faktum är att det första du ser efter att du har skrivit in dina kontouppgifter är en snabb färdplan över vad som krävs för att komma igång med Positionstack i tre enkla steg. Låt oss ta en titt:

1. Ställ in din API-åtkomstnyckel - Som standard har du fått en åtkomstnyckel som är redo att gå ur rutan. Du kan emellertid enkelt återställa detta nedåt efter behov.
2. Välj API-slutpunkter - Vi täcker API-slutpunkter i större djup nästa avsnitt, men för tillfället bara förstå att detta steg hänvisar till att konfigurera vilken typ av data som returneras när din app gör en begäran till Positionstack. Det är här du först kommer att se bas-URL: en, där du riktar in dina förfrågningar, men den visas också i dokumentationen. Slutligen ser vi ett exempel på API-begäran, som består av bara några enkla kodrader.
3. Programintegration - Det sista steget hänvisar till den slutliga integrationen av Positionstacks API i din applikation. Det finns en hel del att veta om den här processen, och det mesta behandlas i dokumentationen. Det viktiga här är: Positionstacks supportteam har din rygg och kommer att erbjuda så mycket eller så lite hjälp du behöver för att konfigurera och integrera deras API i din app.

Ganska lätt rätt? API: er kan tycka skrämmande för människor utan omfattande IT-kunskap till en början. Men precis utanför fladderträdet bekvämar Positionstack dig med kunskapen om att det inte bara är lätt, de hjälper dig på vägen med otrolig dokumentation av deras smarta design. Det hjälper dem att ha ett passionerat team av experter som är redo att hjälpa dig också.

Din Positionstack-instrumentbräda

Positionstack fördubblar sitt kärnvärde för användarvänlighet och erbjuder en strömlinjeformad, otydlig instrumentbräda från vilken du kan komma åt allt du behöver veta om ditt API. Låt oss titta på alternativen i sidofältet:

• instrumentbräda - Här hittar du aviseringar (brukar varna dig när du passerar vissa användningströsklar) och länkar sedan till både 3-stegs snabbstartguide och deras dokumentationssida. Det finns också en översikt över din API-nyckel, din nuvarande prenumeration, kontouppgifter och betalningsmetod.
• Uppgradera / Subscription - Du kan ändra ditt prenumeration på något av dessa två alternativ. Uppgradera när som helst, men om du vill växla mellan en månads- eller årsplan i endera riktningen måste du först nedgradera till ett gratis konto och sedan välja önskat alternativ. Positionstack-support är villigt att hjälpa dig om du behöver hjälp med att göra detta.
• Konto / Betalning - Dessa är självförklarande; endera fliken låter dig uppdatera dina referenser när som helst. Det måste sägas att vi uppskattar att de inte begraver dessa grundläggande kontroller i ett överkonstruerat, prickigt gränssnitt. WYSIWYG.
• API-användning - Troligtvis fliken du kommer att titta igen ofta, här kan du hitta hur mycket av din månadskvot som du har ätit upp hittills. Det finns också ett praktiskt avsnitt som visar din användningsstatistik över tid, så att du kan justera din strategi i enlighet därmed.

API-dokumentation

Nu kommer vi till hjärtat och själen i Positionstacks erbjudande: API-dokumentation. Tänk på den här sidan i din bruksanvisning som anger varje API-slutpunkt, deras parametrar och vilken typ av information de kommer att returnera.

Denna sida är uppdelad i fem olika avsnitt. Vi kommer att gå igenom var och en, spenderar lite tid och språket för att ge lite sammanhang för att du bättre ska förstå vad du kommer att hitta.

Komma igång

Här hittar du det grundläggande funktioner som gäller för varje begäran du gör med Positionstack. Dessa är:

• API-nyckel - Din API-nyckel är som ett digitalt pass som du kommer att använda för att komma åt Positionstacks datasats. Utan den är API värdelös för dig. Om du tror att det har äventyrats kan du enkelt rotera din gamla nyckel för en ny.
• kryptering - 256-bitars SSL-kryptering används över hela Internet och är branschstandarden för säkerhet av goda skäl. Du behöver en grundläggande plan eller bättre för att kryptera din apps kommunikation med Positionstacks servrar, men det är väl värt investeringen på egen hand. För att framkalla kryptering, ändra helt enkelt HTTP till HTTPS i API-basens URL. Enkel!
• JSON återuppringningar - Vi kommer inte in på för många tekniska detaljer om hur detta fungerar, men om dina API-förfrågningar blir stonewalled av samma ursprungspolicy använder du JSON-återuppringningar för att påverka en lösning. I huvudsak begär du data från ett externt skript, som inte fastnar i problem med domäner.
• API-fel - Som med allt kommer ibland dina API-förfrågningar att bli fel. Positionstack förstår detta och har inbyggt en felrapporteringsfunktion i sin app för att hjälpa dig identifiera vad som gick fel. API-begäran misslyckas returnerar automatiskt ett felobjekt i JSON-formatet, plus kod-, meddelandes- och sammanhangsobjekt för att ge sammanhang för felet.

API-slutpunkter

Det här avsnittet dokumenterar Positionstacks kött-och-potatisfunktioner, det vill säga geokodning framåt och bakåt. Om du inte är 100% säker på vad skillnaden är, tänk på geokodning som en tvåvägsgata där du kan översätta platser och adresser skrivna på vanligt engelska till platsdata som koordinater och IP-adresser, och vice versa.

Så du skulle använda geokodning framåt för att konvertera Eiffeltornets plats till koordinater. På liknande sätt kan du ta reda på gatuadressen som är associerad med en IP-adress genom att använda omvänd geokodning. Ganska enkelt, trots allt!

Framåt / bakåt geokodningsförfrågningar

För att göra en grundläggande begäran för endera typen av geokodning, måste du lägga till lämplig slutpunkt (/forward eller /reverse) till API: s bas-URL. Därefter anger du din åtkomstnyckel och gör sedan en fråga använder antingen en vanligt engelska platsadress eller motsvarande platsdata - och, voila! Det ser ut så här:

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

eller

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

Positionstacks dataset innehåller naturligtvis mycket, mycket mer än bara adresser och koordinater. Du kan analysera dessa andra kategoriseringar genom att använda olika parametrar. Här är ett exempel på vad a geokodning framåt begäran, ifrågasätter Vita huset, ser ut som:

{"data": {"results": [{"latitude": 38.897675, "longitude": -77.036547, "label": "1600 Pennsylvania Avenue NW, Washington, DC, USA", "name": "1600 Pennsylvania Avenue NW "," typ ":" adress "," nummer ":" 1600 "," street ":" Pennsylvania Avenue NW "," postal_code ":" 20500 "," trust ": 1," region ":" Distrikt of Columbia "," region_code ":" DC "," administrative_area ": null," Neighborhood ":" White House Grounds "," country ":" United States "," country_code ":" US ", "map_url": " http://map.positionstack.com/38.897675,-77.036547" } ] } }

Intressant nog, om du skulle göra en omvänd geokodning om du använder Vita husets ungefärliga koordinater skulle de returnerade resultaten se nästan identiska ut, förutom att du också skulle se skillnaden i distans mellan dina koordinater och Vita husets officiella koordinater som de visas i Positionstacks datasats.

Anledningen till denna likhet är att båda ändpunkterna använder samma grupp av GET-parametrar och således kan returnera (nästan) samma svarobjekt. Det betyder att oavsett vilken startdata du måste gå igenom, kan du få ett komplett komplement med platsinformation i gengäld. (Det är möjligt att begränsa dessa resultat med API: er fält parameter, men vi kommer att beröra det mer senare.)

Obs! Positionstacks dokumentationssida innehåller detaljerad information om varje parameter och svarobjekt, så se till att kolla in det!

Batchförfrågningar

Den sista huvudrubriken i denna dokumentationsinställning behandlar batchförfrågningar. Allt du måste göra är att åberopa omgång parameter, sedan nest flera fråga instanser (tillsammans med önskade parametrar) under i en enda begäran och Positionstacks API tar hand om resten. Det är död enkelt och ser ut så här:

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

Avancerad data

Förutom de grundläggande platsparametrarna kan du ytterligare skräddarsy dina API-förfrågningar för att returnera mer avancerad data. Dessa inkluderar:

• Bädda in kartor - Returnerar ett map_url-objekt som är länkat till ditt geokodningsresultat, som du kan använda för att skapa en attraktiv visuell kartrepresentation på din webbplats eller app.
• Landsmodul - Till skillnad från andra parametrar som återgår till några få svarobjekt, country_module ger en otrolig mängd data om ditt ifrågasatta land. Det är inte heller bara koordinater och adresser; det är huvudstaden, flaggan, officiellt namn, status som ett landstoppat (eller inte) land, använda valutor, språk som talas, samtalskoder och mer.
• Sun Module - Humoröst beskriver Positionstacks dokumentation detta som ”astrologiska” data. Du får inte ditt horoskop med den här parametern, men du kommer att se data om när solen stiger upp och går ner, enligt astronomisk, civil och nautisk kronologi.
• Tidszonmodul - Bifoga timezone_module för att returnera en positions GMT-offset på antingen sekunder eller som en naturlig språksträng.
• Bounding Box Module - Om ett enda x / y-par koordinater inte är rätt för din uppgift, prova en avgränsningsruta som omsluter ett område med minimi- och maximivärden för longitud och latitud.

Ytterligare alternativ

Positionstack API har massor av data att kasta på dig, men lyckligtvis ger det dig ytterligare verktyg att hantera denna informationskälla.

• Ange svarfält - Vi har fördjupat hur mycket data Positionstack kan returnera, men kom ihåg att all den informationen kostar. Om du vill begränsa dina månatliga förfrågningar kan du göra det med fält bifoga fält = result.flag, till exempel, kommer att göra att API: en endast sänder ut ditt frågade lands flagga. Du kan åberopa fält så många gånger du behöver för att få det specifika datasätt du behöver.
• Ange utgångsformat - Gratis prenumeranter är begränsade till JSON-formatet för deras returnerade geokodningsresultat. Betalande kunder kan dock bifogas produktion på deras förfrågningar om att specificera JSON, XML eller GeoJSON vid behov.

Kodsexempel

När Positionstack säger att de är här för att hjälpa dig, menar de det. Vi har redan sett hur grundlig deras dokumentation är, men de kompletterar den med praktiskt kodexempel på alla språk som deras API stöder. Vi kommer inte att kopiera / klistra in den koden här, men för snabb referens är dessa språk:

• Pytonorm
• Nodejs
• jQuery
• Gå
• Rubin

Bevis och prestanda

Vid denna punkt bör det vara tydligt att Positionstack kan göra ganska mycket. Men, hur bra gör det de här sakerna?

Låt oss först överväga en del sammanhang. Positionstack är en av 20+ API-mikroservicer i Apilayers molnbaserade ekosystem. Tillsammans tjänar dessa API: er över en miljon B2B-klienter från start upp till företag. Några av deras mest anmärkningsvärda kunder inkluderar Amazon, Apple, Slack, LinkedIn och många fler hushållsnamn. Det är uppenbart att de har lite robust infrastruktur för att hantera denna efterfrågan.

Positionstack lever upp till sina egna fördelar upp till sin stamtavla, med en otrolig 100% drifttid under hela 2020 vid skrivandet. Detta är ännu mer imponerande när du överväger API rutinmässigt bearbetar över en miljard geokoduppslag per dag per valsklient, för att inte tala om den svimlande uppsättningen samtidiga förfrågningar som kommer från deras stall av SMB-kunder. Dessutom får dessa förfrågningar vanligtvis svar mellan 10 och 100 ms.

I vår bok är det något av ett teknologiskt underverk, särskilt med tanke på hur aggressivt detta SaaS-erbjudande är.

Och det är inte bara rå kraft som gör Positionstack så tilltalande. Deras datasats är verkligen sofistikerad, härrör från tillförlitliga namn som Nominatim, GeoNames, Pelias och OpenStreetMap. Positionstack korskontrollerar, filtrerar och rekombinerar denna mängd data flera gånger om dagen, genom att driva regelbundna uppdateringar via smarta algoritmer som säkerställer att du alltid har mycket exakt platsdata, var som helst i världen och verkligen tid.

Vi hatar att förstöra vår slutliga dom, men om du letar efter en robust, skalbar geokodningslösning kräver Positionstacks CV en närmare titt.

Prissättning

Apilayer avsåg att tillhandahålla ett prisvärt alternativ till mycket dyra geokodningsprogramvara på företagsnivå, och mot det slutet har de lyckats.

Positionstack kommer i fem prissättning nivåer och stöder månadsvis fakturering eller årliga prenumerationer med 20% rabatt. Dessa nivåer är:

• Fri - Betygsatt för personligt bruk. Du får fortfarande en god körsträcka med 25 000 månatliga förfrågningar om framåt- och omvänd geokodning, matade ut i JSON-format. Du får inte många avancerade funktioner eller kundsupport, men vi har redan visat dig vilken värdefull resurs deras dokumentationssida är. Den här nivån är gratis och utan skyldighet - du behöver inte ens ge kreditkortsuppgifter för att komma igång.
• Grundläggande - Det kommersiella paketet på startnivå. Grundabonnenter fyrdubblar sin månadskvot till 100 000 geokodningsförfrågningar, plus får tillgång till avancerade funktioner som HTTPS-kryptering, flera utgångsalternativ (JSON, XML, GeoJSON), inbäddbara kartor, flera språk, och mer. Få en kommersiell Positionstack-licens för bara $ 9,99 per månad.
• Professionell - Positionstacks mest populära erbjudande, Professional-nivån erbjuder en tiofaldig ökning av geokodningsförfrågningar - upp till 1 000 000 per månad. Alla godbitar från Basic-nivå är närvarande och sedan några, särskilt inklusive batchförfrågningar för tunga applikationer. Denna nivå klockar in på $ 49,99 per månad.
• Företag - Genom att flytta till företagets prestanda ballongerar Business-nivån den månatliga kvoten till en enorma 3 000 000 förfrågningar. Återigen är alla avancerade funktioner fullt tillgängliga, med stöd av Positionstacks passionerade kundsupportteam för att hjälpa dig få ut mesta möjliga av dem. 99,99 dollar per månad.
• Företag - Detta är den nivå där standarderbjudanden går ut genom fönstret och kunden är kung. Du har exakta behov som kräver anpassade lösningar, och Positionstack är redo att nå dina mål. Du dikterar dina månatliga volymförfrågningar, även (särskilt) om de är variabla. Behöver du mer hästkrafter från API? Nå ut för att stödja kundanpassade lösningar. Kontakta Positionstack för en offert.

Dom

Positionstack gör exakt vad den avsåg att göra: ta ner geokodning på företagsnivå från prispunkter annars i budgeten till de flesta små och medelstora företag, utan att offra prestanda. Deras API är väldokumenterad och lätt att använda, men har robust integration över alla större programmeringsspråk för maximal nytta. Antalet förfrågningar som Positionstack hanterar rutinmässigt är häpnadsväckande, medan deras datasätt upprätthålls smart för verkligt global räckvidd i realtid geokodning. Om du är ute efter marknaden för den här typen av produkter ska du inte sova på Positionstack.

Vilken typ av integration har du planerat? Hur kommer du att använda geokodning i ditt företag? Har du några frågor eller kommentarer till Positionstack? Lämna oss en kommentar i kommentarerna nedan.