Få geokoding på bedriftsnivå gratis med Positionstack API (REVIEW)

Du trenger ikke å være Google Maps for å få verdi av geokoding. Og takket være Positionstack trenger du heller ikke Big Gs teknologibudsjett. I dag gjennomgår vi Positionstacks robuste API, som har som mål å gjøre virksomhetsnivå fremover og reversere geokoding både svært rimelig og brukbar.

Posisjonsstang 101

Så hvorfor skulle du bry deg om å lese en 2000+ ordanmeldelse på Positionstack, og hva vil du vinne? Svaret høres søtt ut, men det er nøyaktig: de hele verden.

Tenk på et øyeblikk hvor mange steder det er på verdenskartet. Nå, multipliser det tallet i hodet ditt etter hvert stykke metadata som bedriften trenger å vite om disse stedene. Det er det Positionstack tilbyr, og så noen.

La oss se på noen raske statistikker om Positionstack:

• Faktiske milliarder av geokodingsoppslag blir behandlet hver time, hver dag; med 100% oppetid og <100 ms responstid
• Skybasert, høyst skalerbar infrastruktur
• Sanntidsdata om alle land i verden, samlet til et kavernøst datasett som oppdateres med noen få timer
instagram viewer
• Generøst fordelte, konkurransedyktige abonnementsplaner; pluss en uovertruffen månedlig kvote på 10.000 forespørsler for gratis brukere
• Integrasjonsstøtte for alle større programmeringsspråk
• Omfattende, lettlest dokumentasjon komplett med kodebiter
• Et kundetilfredshetsteam i verdensklasse med erfaring som betjener kunder som Zendesk, Slack, LinkedIn, Lyft, Apple og Amazon

Positionstack har absolutt sin stamtavle i sjakk, men i tilfelle du ikke er overbevist av en håndfull kulepunkter, la oss ta et dypt dykk i hvordan det er å bruke API-en.

Positionstacks 3-trinns hurtigstartguide

Hvis du bruker tid på nettstedet deres, vil du se at Positionstack virkelig understreker brukervennligheten som et primært salgsargument for deres API. Under registreringsprosessen vil du umiddelbart se at det er ganske sant. Faktisk er det første du ser etter å ha skrevet inn legitimasjon for kontoen, et raskt veikart over hva som skal til for å komme i gang med Positionstack i tre enkle trinn. La oss ta en titt:

1. Angi API-tilgangsnøkkelen - Som standard har du gitt en tilgangsnøkkel som er klar til å gå ut av boksen. Du kan imidlertid enkelt tilbakestille dette nedover etter behov.
2. Velg API-sluttpunkter - Vi dekker API-endepunkter i mer dybde neste avsnitt, men for nå er det bare å forstå at dette trinnet refererer til å konfigurere hvilken type data som returneres når appen din ber om en Positionstack. Det er her du først vil se grunnleggende URL, som er der du målretter deg mot forespørslene dine, men den vises også i dokumentasjonen. Til slutt ser vi en prøve API-forespørsel, som består av bare noen få enkle kodelinjer.
3. Søknadsintegrasjon - Det siste trinnet viser til den endelige integreringen av Positionstacks API i applikasjonen din. Det er mye å vite om denne prosessen, og det meste dekkes i dokumentasjonen. Det viktige her er: Supportstacks supportteam har ryggen, og vil tilby så mye eller så lite hjelp du trenger for å konfigurere og integrere API-en i appen din.

Ganske enkelt ikke sant? API-er kan virke skremmende for folk uten omfattende IT-kunnskap til å begynne med. Men rett utenfor flaggermusen trøster Positionstack deg med kunnskapen om at ikke bare det er enkelt, de vil hjelpe deg underveis med utrolig dokumentasjon på deres smarte design. Det hjelper at de har et lidenskapelig team av eksperter som er klare til å hjelpe deg også.

Positionstack-dashbordet

Positionstack er en fordoblet kjerneverdi av brukervennlighet, og tilbyr et strømlinjeformet, avslappet instrumentpanel hvor du kan få tilgang til alt du trenger å vite om API-en din. La oss se på sidelinjealternativene:

• dashbord - Her finner du varsler (vanligvis varsler deg når du passerer visse bruksgrenser), og lenker deretter til både 3-trinns hurtigstartguide og deres dokumentasjonsside. Det finnes også en oversikt over API-nøkkelen, ditt nåværende abonnement, kontodetaljer og betalingsmåte.
• Oppgradering / abonnement - Du kan endre abonnementet på et av disse to alternativene. Oppgrader når som helst, men hvis du vil veksle mellom en månedlig eller årlig plan i begge retninger, må du først nedgradere til en gratis konto og deretter velge ønsket alternativ. Positionstack-støtte er villig til å hjelpe deg hvis du trenger hjelp til å gjøre dette.
• Konto / Betaling - Dette er selvforklarende; en av kategoriene lar deg når som helst oppdatere legitimasjonsbeskrivelsen. Det må sies at vi setter pris på at de ikke begraver disse grunnleggende kontrollene i et overdesignet, prangende grensesnitt. WYSIWYG.
• API-bruk - Sannsynligvis fanen du ofte vil se på, her kan du finne hvor mye av den månedlige forespørselskvoten du har spist opp til nå. Det er også et praktisk avsnitt som viser bruksstatistikken over tid, slik at du kan justere strategien din deretter.

API-dokumentasjon

Nå kommer vi til hjertet og sjelen til Positionstacks tilbud: the API-dokumentasjon. Tenk på denne siden din brukerhåndbok for bruk, som inneholder detaljer om hvert API-sluttpunkt, deres parametere og hva slags informasjon de vil returnere.

Denne siden er delt opp i fem forskjellige seksjoner. Vi vil gå gjennom hver, bruke litt tid og ordbruk for å gi litt kontekst for deg å forstå bedre hva du finner.

Starter

Her finner du grunnleggende funksjoner som gjelder for hver forespørsel du sender med Positionstack. Disse er:

• API-nøkkel - API-nøkkelen din er som et digitalt pass som du vil bruke til å få tilgang til Positionstacks datasett. Uten den er API ubrukelig for deg. Hvis du mener at det er blitt kompromittert, kan du enkelt rotere den gamle nøkkelen for en ny.
• kryptering - 256-bit SSL-kryptering brukes over hele Internett, og er bransjestandarden for sikkerhet for en god grunn. Selv om du trenger en grunnleggende plan eller bedre for å kryptere appens kommunikasjon med Positionstacks servere, er det vel verdt investeringen på egen hånd. For å fremkalle kryptering, bare endre HTTP til HTTPS i API-basen URL. Enkel!
• JSON tilbakeringinger - Vi får ikke inn for mange tekniske detaljer om hvordan dette fungerer, men hvis API-forespørslene dine blir stensnettet av retningslinjer med samme opprinnelse, bruker du JSON tilbakeringinger for å påvirke en løsning. I hovedsak ber du om data fra et eksternt skript, som ikke blir fast i problemer med tvers av domener.
• API-feil - Som med alt, noen ganger vil API-forespørslene dine oppstå feil. Positionstack forstår dette og har innebygd en feilrapporteringsfunksjonalitet i appen deres for å hjelpe deg med å identifisere hva som gikk galt. Feil i API-forespørsel vil automatisk returnere et feilobjekt i JSON-format, pluss kodeobjekter, melding og kontekst-underobjekter for å gi kontekst for feilen.

API-sluttpunkter

Denne delen dokumenterer Positionstacks kjøtt-og-poteter-funksjonalitet, det vil si geokoding frem og tilbake. Hvis du ikke er 100% sikker på hva forskjellen er, kan du tenke på geokoding som en toveis gate der du kan oversette steder og adresser skrevet på vanlig engelsk til stedsdata som koordinater og IP-adresser, og visa-versa.

Så du vil bruke geokoding fremover for å konvertere Eiffeltårnets beliggenhet til koordinater. På samme måte kan du finne ut gateadressen knyttet til en IP-adresse ved å bruke omvendt geokoding. Ganske enkelt, tross alt!

Forespørsler om fremover / reversering av geokoding

For å komme med en grunnleggende forespørsel for begge typer geokoding, må du legge til riktig sluttpunkt (/forward eller /reverse) til API-basens URL. Deretter oppgir du tilgangsnøkkelen din, og lag deretter en spørsmål bruker enten en vanlig engelsk adresse eller tilhørende stedsdata - og, voila! Det ser slik ut:

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

eller

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

Positionstacks datasett inneholder selvfølgelig mye, mye mer enn bare adresser og koordinater. Du kan analysere disse andre kategoriseringene ved bruk av forskjellige parametere. Her er et eksempel på hva a frem geokoding forespørsel, spør i Det hvite hus, ser ut som:

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

Interessant, hvis du skulle gjøre en omvendt geokoding forespørsel om å bruke Det hvite hus omtrentlige koordinater, ville de returnerte resultatene se nesten identiske ut, bortsett fra at du også ser forskjellen i avstand mellom koordinatene dine og Det hvite huss offisielle koordinater slik de vises i Positionstacks datasett.

Årsaken til denne likheten er at begge endepunktene bruker den samme rekke GET-parametere, og dermed er i stand til å returnere (nesten) de samme svarobjektene. Det betyr at uansett hvilke startdata du må gå etter, kan du få et komplett komplement med posisjonsdata til gjengjeld. (Det er mulig å begrense disse resultatene ved å bruke API-ene Enger parameter, men vi berører det mer senere.)

Merk: Positionstacks dokumentasjonsside inneholder detaljerte detaljer om hver parameter og responsobjekt, så husk å sjekke det ut!

Batch-forespørsler

Den siste hovedoverskriften i denne dokumentasjonsinnstillingen omhandler batchforespørsler. Alt du trenger å gjøre er å påkalle parti parameter, deretter nest flere spørsmål forekomster (sammen med de ønskede parametrene) under i en enkelt forespørsel, og Positionstacks API sørger for resten. Den er død enkel, og ser slik ut:

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

Avanserte data

I tillegg til de grunnleggende posisjonsparametrene, kan du skreddersy API-forespørslene dine ytterligere for å returnere mer avanserte data. Disse inkluderer:

• Innbyggbare kart - Returnerer et map_url-objekt som er koblet til geokodingsresultatet, som du kan bruke til å lage en attraktiv visuell kartrepresentasjon på nettstedet eller appen din.
• Landsmodul - I motsetning til andre parametere som kommer tilbake til noen få svarobjekter, country_module returnerer en utrolig rekke data om landet du har spørsmål om. Det er ikke bare koordinater og adresser; det er hovedstaden, flagget, det offisielle navnet, statusen som et landstengt (eller ikke) land, brukte valutaer, språk som er talt, koder og mer.
• Solmodul - Humorøst beskriver Positionstacks dokumentasjon dette som “astrologiske” data. Du får ikke horoskopet med denne parameteren, men du vil se data om når solen står opp og går, i henhold til astronomisk, sivil og nautisk kronologi.
• Tidssone-modul - Legg ved timezone_module for å returnere en posisjons GMT-forskyvning på enten sekunder eller som en naturlig språkstreng.
• Bindingsboksmodul - Hvis et enkelt x / y-par koordinater ikke stemmer med oppgaven din, kan du prøve en avgrensningsboks som omslutter et område med minimums- og maksimumsverdier for lengdegrad og breddegrad.

Ytterligere alternativer

Positionstack API har massevis av data å kaste på deg, men heldigvis gir den deg tilleggsverktøy å administrere denne informasjonskraften.

• Spesifiser svarfelt - Vi har dekket grundig hvor mye data Positionstack kan returnere, men husk at alle disse dataene koster. Hvis du vil begrense månedlige forespørsler, kan du gjøre det med Enger Legger felt = results.flag, vil for eksempel føre til at APIen bare sender ut flagget fra spørsmålet ditt. Du kan påberope deg Enger så mange ganger du trenger for å få det spesifikke datasettet du trenger.
• Spesifiser output format - Gratis abonnenter er begrenset til JSON-formatet for returnerte geokodingsresultater. Betalende kunder kan imidlertid legge ved produksjon på deres forespørsler om å spesifisere JSON, XML eller GeoJSON etter behov.

Kodeeksempler

Når Positionstack sier at de er her for å hjelpe deg, mener de det. Vi har allerede sett hvor grundig dokumentasjonen deres er, men de topper den med hendig kodeeksempler på alle språkene deres API støtter. Vi kommer ikke til å kopiere / lime inn den koden her, men for rask referanse er disse språkene:

• Python
• Nodejs
• jQuery
• Gå
• Rubin

Bevis og ytelse

På dette tidspunktet bør det være klart at Positionstack er i stand til å gjøre ganske mye. Men, hvor godt gjør den disse tingene?

La oss først vurdere litt kontekst. Positionstack er en av 20+ API-mikroservices i Apilayers skybaserte økosystem. Til sammen tjener disse APIene over en million B2B-klienter fra oppstart helt opp til bedrift. Noen av deres mest bemerkelsesverdige kunder inkluderer Amazon, Apple, Slack, LinkedIn og mange flere husholdningsnavn. Det er tydelig at de har en robust infrastruktur for å håndtere denne etterspørselen.

Positionstack lever etter sin egen fortjeneste opp til sin stamtavle, med en utrolig 100% oppetid gjennom hele 2020 i skrivende stund. Dette er enda mer imponerende når du vurderer API rutinemessig behandler over en milliard geokodeoppslag per dag per hvalklient, for ikke å snakke om det svimlende utvalget av samtidige forespørsler som kommer fra deres stall av SMB-kunder. Dessuten får disse forespørslene vanligvis svar mellom 10 og 100 ms.

I vår bok er det noe av et teknologisk underverk, spesielt med tanke på hvor aggressivt dette SaaS-tilbudet er.

Og det er ikke bare rå kraft som gjør Positionstack så tiltalende. Datasettet deres er virkelig sofistikert, hentet fra pålitelige navn som Nominatim, GeoNames, Pelias og OpenStreetMap. Positionstack kryssjekker, filtrerer og rekombinerer denne mengden data flere ganger om dagen, og presser regelmessige oppdateringer via smarte algoritmer som sikrer at du alltid har svært nøyaktige posisjonsdata, hvor som helst i verden og på ekte tid.

Vi hater å ødelegge for den endelige dommen, men hvis du leter etter en robust, skalerbar geokodingsløsning, krever CV-en en nærmere titt.

Priser

Apilayer tok sikte på å tilby et rimelig alternativ til svært kostbar geokodingsprogramvare på bedriftsnivå, og mot det formål har de lyktes.

Positionstack kommer i fem prising nivåer, og støtter månedlig fakturering, eller årlige abonnement med 20% rabatt. Disse nivåene er:

• Gratis - Vurdert for personlig bruk, får du fremdeles en god kjørelengde med 25 000 månedlige forespørsler om frem-og bakover-geokoding, utgitt i JSON-format. Du får ikke mange avanserte funksjoner eller kundestøtte, men vi har allerede vist deg hvilken verdifull ressurs dokumentasjonssiden deres er. Dette nivået er gratis og pliktig - du trenger ikke en gang å oppgi kredittkortinformasjon for å komme i gang.
• Grunnleggende - Den kommersielle pakken på inngangsnivå. Grunnabonnenter firedobler sin månedlige kvote til 100 000 geokodingsforespørsler, i tillegg får tilgang til avansert funksjoner som HTTPS-kryptering, flere utskriftsalternativer (JSON, XML, GeoJSON), innebygde kart, flere språk, og mer. Få en kommersiell Positionstack-lisens for bare $ 9.99 per måned.
• Profesjonell - Positionstacks mest populære tilbud, Professional-nivået gir en tidobling av forespørsler om geokoding - opptil 1 000 000 per måned. Alle godbitene fra Basic-nivået er til stede, og deretter noen, spesielt inkludert batch-forespørsler for kraftige applikasjoner. Dette nivået klokker inn til $ 49.99 per måned.
• Virksomhet - Når vi går over til bedriftsskala ytelser, ballonger virksomhetsnivået den månedlige kontingenten til hele 3.000.000 forespørsler. Nok en gang er alle avanserte funksjoner fullt tilgjengelige, støttet av Positionstacks lidenskapelige kundesupportteam for å hjelpe deg med å få mest mulig ut av dem. 99,99 dollar per måned.
• Bedriften - Dette er nivået der standardtilbud går ut av vinduet, og kunden er konge. Du har presise behov som krever tilpassede løsninger, og Positionstack er klar til å nå dine mål. Du dikterer månedlige volumforespørsler, selv (spesielt) hvis de er varierende. Trenger du mer hestekrefter fra API? Nå ut for å støtte for spesialbyggede løsninger. Kontakt Positionstack for et pristilbud.

Kjennelse

Positionstack gjør nettopp det den siktet ut for å gjøre: få geokoding på bedriftsnivå ned fra prispunkter ellers utenfor budsjettet til de fleste SMB, uten å ofre ytelsen. Deres API er godt dokumentert og enkel å bruke, men har robust integrasjon på tvers av alle viktige programmeringsspråk for maksimal brukervennlighet. Antall forespørsler Positionstack håndterer rutinemessig, mens datasettet deres opprettholdes smart for virkelig global rekkevidde i sanntids geokoding. Hvis du er i markedet for denne typen produkter, ikke sove på Positionstack.

Hva slags integrering har du planlagt? Hvordan vil du benytte deg av geokoding i virksomheten din? Har du spørsmål eller kommentarer til Positionstack? Legg igjen en kommentar i kommentarene nedenfor.