Pridobite brezplačno geokodiranje na ravni podjetja z API-om Positionstack (PREGLED)

Za geokodiranje vam ni treba biti Google Maps. In zahvaljujoč podjetju Positionstack ne potrebujete niti tehničnega proračuna podjetja Big G. Danes pregledujemo robustni API podjetja Positionstack, katerega cilj je narediti napredno in vzvratno geokodiranje na ravni podjetja, hkrati cenovno zelo ugodno in uporabno.

Pozicioniranje 101

Torej, zakaj bi se trudili, da berete pregled več kot 2000 besed Pozicioniranjein kaj si zaslužite? Odgovor se sliši simpatično, vendar je natančno: the cel svet.

Za trenutek razmislite, koliko krajev je na zemljevidu sveta. Zdaj to številko v glavi zmnožite z vsakim metapodatkom, ki ga mora vaše podjetje vedeti o teh krajih. To je tisto, kar ponuja Positionstack, nato pa še nekaj.

Poglejmo nekaj hitrih statističnih podatkov o Positionstack:

• Dejansko več milijard zahtev za iskanje kod geokodov, obdelanih vsako uro, vsak dan; s 100% uptime in <100ms odzivni časi
• Infrastruktura, ki je zelo razširljiva v oblaku
• Podatki v realnem času za vsako državo na svetu, zbrani v kavernozni nabor podatkov, ki se posodablja vsakih nekaj ur
instagram viewer
• Naročniški načrti z velikimi razpoložljivimi cenami po konkurenčnih cenah; plus neprekosljivo mesečno kvoto 10.000 zahtevkov za brezplačne uporabnike
• Integracijska podpora za vse glavne programske jezike
• Izčrpna dokumentacija, ki jo je enostavno prebrati, skupaj z odlomki kode
• Svetovna skupina za zadovoljstvo strank z izkušnjami, ki strežejo strankam, kot so Zendesk, Slack, LinkedIn, Lyft, Apple in Amazon

Positionstack zagotovo preverja svoj rodovnik, če pa vas ne prepriča peščica metkov, se poglobimo v to, kar dejansko želite uporabiti API.

Vodnik za hitri zagon podjetja Positionstack v treh korakih

Če boste porabili kakšen čas na njihovem spletnem mestu, boste videli, da Positionstack resnično poudarja preprostost uporabe kot glavno prodajno mesto njihovega API-ja. Med postopkom registracije boste takoj videli, da je to povsem res. Dejansko je prva stvar, ki jo opazite, ko vtipkate poverilnice v svojem računu, hiter načrt, kako je treba v treh preprostih korakih vstati in zagnati Positionstack. Poglejmo:

1. Nastavite dostopni ključ za API - Privzeto vam je izročen dostopni ključ, ki je pripravljen za izhod iz polja. Vendar lahko to enostavno ponastavite po vrstici po potrebi.
2. Izberite končne točke API - Naslednji razdelek zajemamo končne točke API z večjo globino, vendar zaenkrat samo razumemo, da se ta korak nanaša na konfiguriranje vrste podatkov, ki se vrne, ko aplikacija vloži zahtevo Positionstack. Tu boste najprej videli osnovni URL, kamor ciljate svoje zahteve, vendar je tudi ta prikazan v dokumentaciji. Končno vidimo vzorčno zahtevo API-ja, ki je sestavljena iz le nekaj preprostih vrstic kode.
3. Integracija aplikacij - Zadnji korak se nanaša na končno integracijo Positionstack-ovega API-ja v vašo aplikacijo. O tem postopku je treba vedeti kar nekaj, večina pa je zajeta v dokumentaciji. Pomembno pri tem je: skupina za podporo Positionstack-a ima hrbet in nudila vam bo toliko ali malo pomoči, da lahko konfigurirate in vključite njihov API v vašo aplikacijo.

Precej enostavno kajne? API-ji se morda zdijo zastrašujoči za ljudi, ki na začetku nimajo širokega znanja o IT. Toda takoj za palico vas Positionstack potolaži z vedenjem, da ne samo, da je enostaven, ampak vam bodo pomagali na poti z neverjetno dokumentacijo o njihovi pametni zasnovi. Pomaga jim imeti strastno ekipo strokovnjakov, ki so vam pripravljeni pomagati.

Vaša nadzorna plošča Positionstack

Positionstack podvoji svojo osnovno vrednost prijaznosti do uporabnika in poenostavi nadzorno ploščo, s katere lahko dostopate do vsega, kar morate vedeti o svojem API-ju. Oglejmo si možnosti stranske vrstice:

• Armaturna plošča - Tu boste našli obvestila (ponavadi vas opozorijo ob prehodu določenih pragov uporabe), nato povezave do vodnika za hitri začetek v treh korakih in njihove strani z dokumentacijo. Tu je tudi pregled vašega ključa API-ja, trenutne naročnine, podrobnosti računa in načina plačila.
• Nadgradnja / naročnina - Naročnino lahko spremenite na kateri koli od teh dveh možnosti. Kadar koli želite nadgraditi, če želite preklopiti med mesečnim ali letnim načrtom v katero koli smer, morate najprej preklopiti na brezplačen račun in nato izbrati želeno možnost. Podpora Positionstack vam bo pomagala, če potrebujete pomoč pri tem.
• Račun / plačilo - so samoumevne; kateri koli zavihek vam bo omogočil, da kadar koli posodobite svoje poverilnice. Treba je povedati, da cenimo, da teh osnovnih kontrol ne pokopljejo v preoblikovanem, bliskovitem vmesniku. WYSIWYG.
• Uporaba API-ja - Najbrž na zavihku, ki ga boste najpogosteje obiskali, tukaj lahko najdete, koliko kvote mesečnih zahtev ste do zdaj pojedli. Obstaja tudi priročen razdelek, ki prikazuje statistiko vaše uporabe sčasoma, tako da lahko ustrezno prilagodite strategijo.

Dokumentacija API-ja

Zdaj smo spoznali srce in dušo ponudbe Positionstack: Dokumentacija API-ja. Na tej strani si oglejte uporabniški priročnik, ki vsebuje vsako končno točko API, njihove parametre in podatke, ki jih bodo vrnili.

Ta stran je razdeljena na pet različnih delov. Preučili bomo vsakega, porabili bomo nekaj časa in besed, da bomo zagotovili nek kontekst, da boste bolje razumeli, kaj boste našli.

Uvod

Tukaj boste našli osnovne funkcije ki veljajo za vsako zahtevo, ki jo vložite s Positionstack. To so:

• Ključ API-ja - Vaš ključ API je kot digitalni potni list, ki ga boste uporabili za dostop do zbirke podatkov Positionstack. Brez njega je API neuporaben za vas. Če menite, da je ogrožena, lahko stari ključ enostavno zasukate za novega.
• Šifriranje - 256-bitno šifriranje SSL se uporablja po vsem internetu in je dober razlog industrijski standard varnosti. Čeprav boste potrebovali Osnovni načrt ali bolje, da boste šifrirali komunikacijo svoje aplikacije s strežniki Positionstack, je naložba dobro vredna sama. Če želite sprožiti šifriranje, preprosto spremenite HTTP v HTTPS v osnovnem URL-ju API-ja. Preprosto!
• Povratne informacije JSON - Ne bomo spuščali preveč tehničnih podrobnosti, kako to deluje, če pa vaše zahteve API-ja preprečujejo pravilniki istega izvora, za vpliv na rešitev uporabite povratne klice JSON. V bistvu zahtevate podatke iz zunanje skripte, ki se ne spopada s težavami med domenami.
• Napake API-ja - Kot pri vsem, včasih tudi vaše zahteve API naletijo na napake. Positionstack to razume in je v njihovo aplikacijo vgradil funkcijo poročanja o napakah, ki vam bo pomagala ugotoviti, kaj je šlo narobe. Neuspehi v zahtevi API-ja bodo samodejno vrnili objekt napake v formatu JSON ter plus predmete kode, sporočila in konteksta in tako zagotovili kontekst napake.

Končne točke API

Ta razdelek dokumentira funkcijo podjetja Positionstack za meso in krompir, to je geocodiranje naprej in nazaj. Če niste stoodstotno prepričani, v čem je razlika, pomislite na geokodiranje kot na dvosmerno ulico, kamor lahko prevedete kraji in naslovi, napisani v navadni angleščini, do lokacijskih podatkov, kot so koordinate in naslovi IP, in vizumsko obratno.

Torej bi za pretvorbo lokacije Eifflovega stolpa v koordinate uporabili naprej geocoding naprej. Podobno lahko z nasprotno geokodiranjem ugotovite naslov ulice, povezan z naslovom IP. Konec koncev precej preprosto!

Zahteve za geokodiranje naprej / nazaj

Če želite vložiti osnovno zahtevo za katero koli vrsto geokodiranja, morate dodati ustrezno končno točko (/forward ali /reverse) na osnovni URL API. Nato vnesete svoj dostopni ključ in nato naredite poizvedba z uporabo navadnega angleškega lokacijskega naslova ali ustreznih lokacijskih podatkov - in, voila! Izgledalo bo nekako takole:

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

ali

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

Seveda nabor podatkov Positionstack vsebuje veliko, veliko več kot le naslove in koordinate. Te druge kategorizacije lahko razdelite z uporabo različnih parametrov. Tu je primer, kaj naprej geokodiranje zahteva, ki sprašuje po Beli hiši, izgleda tako:

{"podatki": {"rezultati": [{"zemljepisna širina": 38.897675, "dolžina": -77.036547, "oznaka": "1600 Pennsylvania Avenue NW, Washington, DC, ZDA", "ime": "1600 Pennsylvania Avenue NW "," vrsta ":" naslov "," številka ":" 1600 "," ulica ":" Pennsylvania Avenue NW "," poštna številka ":" 20500 "," zaupanje ": 1," regija ":" Okrožje of Columbia "," region_code ":" DC "," Administrative_area ": null," soseska ":" Ozemlje Bele hiše "," država ":" Združene države Amerike "," country_code ":" ZDA ", "map_url": " http://map.positionstack.com/38.897675,-77.036547" } ] } }

Zanimivo je, če bi naredili a povratno geokodiranje V zahtevi s približnimi koordinatami Bele hiše bodo vrnjeni rezultati videti skoraj enaki, razen če bi videli tudi razliko v razdalja med vašimi koordinatami in uradnimi koordinatami Bele hiše, kot so prikazane v zbirki podatkov Positionstack.

Razlog za to podobnost je v tem, da obe končni točki uporabljata isti niz parametrov GET in sta tako sposobna vrniti (skoraj) iste odzivne objekte. To pomeni, da ne glede na to, s kakšnimi začetnimi podatki morate iti mimo, lahko v zameno dobite popoln dodatek lokacijskih podatkov. (Te rezultate je mogoče zožiti z uporabo API-jev polja parametra, vendar se bomo tega dotaknili kasneje.)

Opomba: Na strani z dokumentacijo Positionstack v celoti so podrobno navedeni vsi parametri in odzivni predmeti, zato se prepričajte, da to preverite!

Paketne zahteve

Zadnji glavni naslov te nastavitve dokumentacije obravnava paketne zahteve. Vse, kar morate storiti, je, da pokličete šarža parameter, nato gnezdi več poizvedba primerke (skupaj z želenimi parametri) pod eno samo zahtevo, za ostalo pa skrbi Positionstack-ov API. Mrtvo je preprosto in izgleda tako:

{"batch": [{"poizvedba": "Main Street", "država": "ZDA", "regija": "Minnesota"}, {"poizvedba": "Main Street", "država": "ZDA", "regija": "Illinois"}, {"poizvedba": "Glavna ulica", "država": "ZDA", "regija": "Missouri"} ] }

Napredni podatki

Poleg osnovnih parametrov lokacije lahko dodatne zahteve za API še prilagodite, da jih vrnete več napredni podatki. Tej vključujejo:

• Vdelani zemljevidi - Vrne objekt map_url, povezan z vašim rezultatom geokodiranja, ki ga lahko uporabite za ustvarjanje privlačne vizualne predstavitve zemljevida na vašem spletnem mestu ali v aplikaciji.
• Državni modul - za razliko od drugih parametrov, ki se vrnejo do nekaj odzivnih objektov, country_module vrne neverjetno paleto podatkov o vaši državi. To niso samo koordinate in naslovi; to je glavno mesto, zastava, uradno ime, država kot nepokrito (ali ne) države, uporabljene valute, govorjeni jeziki, klicne kode in drugo.
• Modul sonca - V šaljivi dokumentaciji Positionstack je to opisano kot "Astrološki" podatki. S tem parametrom ne boste dobili svojega horoskopa, vendar boste videli podatke o tem, kdaj sonce vzhaja in zahaja, v skladu z astronomsko, civilno in navtično kronologijo.
• Modul časovnega pasu - Dodaj modul časovne cone za vrnitev GMT-ja za lokacijo v sekundah ali kot niz v naravnem jeziku.
• Modul za omejevanje - Če en par koordinat x / y ni primeren za vašo nalogo, poskusite z omejevalnim poljem, ki zajema območje z najnižjimi in največjimi vrednostmi za dolžino in širino.

Dodatne možnosti

API Positionstack ima na vas veliko podatkov, vendar vam ga na srečo ponuja dodatna orodja za upravljanje tega sklopa informacij.

• Določite odzivna polja - Poglobljeno smo poročali o tem, koliko podatkov se lahko Positionstack vrne, vendar ne pozabite, da vsi ti podatki pridejo do stroškov. Če želite omejiti mesečne zahteve, lahko to storite z polja Priložen polja = rezultati.flagbo na primer API povzročil samo zastavo vaše poizvedene države. Lahko se sklicujete polja tolikokrat, kot potrebujete za določen nabor podatkov, ki ga potrebujete.
• Določite obliko izhoda - Brezplačni naročniki so za vrnjene rezultate geokodiranja omejeni na format JSON. Stranke, ki plačujejo, pa lahko dodajo izhod na njihove zahteve, da po potrebi določijo JSON, XML ali GeoJSON.

Primeri kode

Ko Positionstack reče, da so tukaj, da ti pomagajo, to mislijo. Videli smo že, kako temeljita je njihova dokumentacija, vendar jo natančno dopolnjujejo primeri kod v vseh jezikih, ki jih podpira njihov API. Tu ne bomo kopirali / prilepili kode, ampak za hitre reference so ti jeziki:

• Python
• Nodejs
• jQuery
• Pojdi
• Ruby

Dokaz in zmogljivost

Na tem mestu bi moralo biti jasno, da je Positionstack sposoben narediti precej. Ampak, kako dobro to počne te stvari?

Najprej razmislimo o nekaterih okoliščinah. Positionstack je ena izmed 20+ API mikroservisov v Apilayerjevem ekosistemu v oblaku. Ti API-ji skupaj ponujajo več kot milijon B2B odjemalcev od zagonov vse do podjetja. Nekatere njihove najpomembnejše stranke vključujejo Amazon, Apple, Slack, LinkedIn in še mnogo drugih gospodinjskih imen. Jasno je, da imajo neko trdno infrastrukturo, da lahko rešijo ta obseg povpraševanja.

Positionstack sam po sebi zasluži svoj rodovnik, z neverjetnim 100-odstotnim podaljšanjem v celotnem letu 2020 v času pisanja. To je še toliko bolj impresivno, če upoštevamo API rutinsko obdeluje več kot milijardo iskalnih kod na dan na odjemalca kitov, da ne omenjam vrtoglavega niza hkratnih zahtev, ki prihajajo iz njihovih stabilnih strank SMB. Še več, te zahteve običajno odzivajo med 10 in 100 ms.

V naši knjigi je to nekaj tehnološkega čudeža, zlasti glede na to, kako zelo ugodna je ta ponudba SaaS-a.

Positionstack tako privlačen ni samo zaradi surove moči. Njihov nabor podatkov je resnično izpopolnjen, pridobljen iz zanesljivih imen, kot so Nominatim, GeoNames, Pelias in OpenStreetMap. Positionstack navzkrižno preverja, filtrira in ponovno priporoča to bogastvo podatkov večkrat na dan, kar redno posodablja prek pametnih algoritmov, ki zagotavljajo, da imate vedno natančne podatke o lokaciji, kjer koli po svetu in resnično čas.

Sovražimo, da bi dokončno razsodili, če pa iščete zanesljivo in razširljivo rešitev za geokodiranje, se nadaljuje Positionstack nadaljuje natančnejši pregled.

Cenitev

Apilayer si je zastavil, da bi ponudil cenovno ugodno alternativo zelo dragi programski opremi za geokodiranje na ravni podjetja, zato jim je uspelo.

Positionstack pride v petih Cenitev stopnje in podpira mesečno zaračunavanje ali letne naročnine z 20% popustom. Te stopnje so:

• prost - Po ocenah za osebno uporabo še vedno dobite kar nekaj prevoženih kilometrov s 25.000 mesečnimi zahtevami za naprej in vzvratno geokodiranje, ki se oddajajo v obliki JSON. Nimate veliko naprednih funkcij ali podpore strankam, mi pa smo vam že pokazali, kako dragocen vir je njihova stran Dokumentacija. Ta stopnja je brezplačna in brez obveznosti - za začetek vam ni treba navesti podatkov o kreditni kartici.
• Osnovni - Komercialni paket vstopne ravni. Osnovni naročniki svojo četrtletno kvoto potrošijo na 100.000 zahtev za geokodiranje, poleg tega pa dobijo dostop do naprednih funkcije, kot so šifriranje HTTPS, več izhodnih možnosti (JSON, XML, GeoJSON), vdelani zemljevidi, več jezikov, in več. Pridobite komercialno licenco Positionstack za samo 9,99 USD na mesec.
• Poklicno - Najbolj priljubljena ponudba Positionstack, profesionalna raven ponuja desetkratno povečanje zahtev za geokodiranje - do 1.000.000 na mesec. Vse dobrote iz osnovnega nivoja so prisotne, nato pa še nekaj, zlasti vključno s prošnjami paketov za zahtevne aplikacije. Ta stopnja ure se giblje po 49,99 USD na mesec.
• Posel - Za dosego uspešnosti v podjetju poslovni sloj odda mesečno kvoto na ogromnih 3.000.000 zahtev. Še enkrat je vsa napredna funkcija v celoti na voljo, podprta s strastno ekipo za podporo strankam Positionstack, ki vam bo pomagala kar najbolje izkoristiti. 99,99 USD na mesec.
• Enterprise - To je stopnja, v kateri standardne ponudbe gredo skozi okno, kupec pa je kralj. Imate natančne potrebe, ki zahtevajo rešitve po meri, in Positionstack je pripravljen doseči svoje cilje. Sami narekujete mesečne zahteve po količini, še posebej (še posebej), če so spremenljive. Potrebujete več konjskih moči od API-ja? Pridružite se podpori za rešitve po meri. Za ponudbo se obrnite na Positionstack.

Razsodba

Positionstack naredi natanko tisto, kar si je zastavil: znižati geografsko kodiranje na ravni podjetij s cenovnih točk drugače kot izven proračuna za večino malih in srednje velikih podjetij, ne da bi pri tem žrtvovali uspešnost. Njihov API je dobro dokumentiran in enostaven za uporabo, vendar ima trdno integracijo v vse glavne programske jezike za največjo uporabnost. Število zahtev, s katerimi Positionstack rutinsko obravnava, je osupljivo, medtem ko je njihov nabor podatkov pametno vzdrževan za resnično globalni doseg v geokodiranju v realnem času. Če ste na trgu za to vrsto izdelkov, ne spijte na Positionstack.

Kakšno integracijo načrtujete? Kako boste v svojem poslu uporabili geokodiranje? Imate kakršna koli vprašanja ali komentarje o Positionstack? Pustite nam opombo v spodnjih komentarjih.