Pristupite besplatnom geocodingu na nivou poduzeća pomoću Positionstack API-ja (PREGLED)

Ne morate biti Google Maps da biste dobili vrijednost kod gekodiranja. A zahvaljujući Positionstacku, ni za vas vam nije potreban tehnički proračun Velikog G-a. Danas pregledavamo robusni API kompanije Positionstack koji ima za cilj unaprijediti i unaprijediti geokodiranje na razini poduzeća i vrlo pristupačne i korisne.

Pozicioniranje 101

Dakle, zašto biste se mučili da čitate recenziju s više od 2.000 riječi Positionstack, i što vi želite dobiti? Odgovor zvuči simpatično, ali tačno je: cijeli svijet.

Razmislite na trenutak koliko mjesta ima na karti svijeta. Sada, pomnožite taj broj u glavi sa svim metapodacima koje vaše poduzeće mora znati o tim mjestima. To je ono što Positionstack nudi, a zatim još neke.

Pogledajmo nekoliko brzih statistika o Positionstacku:

• Stvarne milijarde zahtjeva za pretraživanje kodiranja koji se obrađuju svaki sat, svaki dan; sa 100% produženim radnim vremenom i <100ms puta odgovorima
• Infrastruktura s velikim skalom koja se temelji na oblaku
• Podaci u stvarnom vremenu o svakoj zemlji na svijetu, sastavljeni u kavernozni skup podataka koji se ažuriraju svakih nekoliko sati
  instagram viewer
• Pretplatnički planovi velikodušno raspoređeni po konkurentnim cijenama; plus neusporedivu mjesečnu kvotu od 10.000 zahtjeva za Besplatne korisnike
• Integracijska podrška za sve glavne programske jezike
• Sveobuhvatna dokumentacija koju je lako čitati zajedno s isječcima koda
• Svjetski tim za zadovoljstvo kupaca sa iskustvom koji služi klijentima poput Zendesk, Slack, LinkedIn, Lyft, Apple i Amazon

Positionstack sigurno ima svoj rodovnik u provjeri, ali u slučaju da vas nije uvjerila šačica metaka, idemo duboko zaroniti u ono što zapravo želite koristiti API.

Vodič za brzi start u 3 koraka za Positionstack

Provedete li bilo koje vrijeme na njihovoj web stranici, vidjet ćete da Positionstack zaista naglašava jednostavnost upotrebe kao primarne prodajne točke njihovog API-ja. Tijekom postupka prijave, odmah ćete vidjeti da je to sasvim istina. Zapravo, prvo što vidite nakon što upišete vjerodajnice svog računa je brzi plan onoga što je potrebno da biste ustali i pokrenuli Positionstack u tri jednostavna koraka. Pogledajmo:

1. Postavite pristupni ključ za API - Prema zadanim postavkama uručili ste pristupni ključ koji je spreman izaći iz okvira. Međutim, prema potrebi možete jednostavno resetirati ovu liniju prema dolje.
2. Odaberite krajnje točke API-ja - Krajnji kraj API-ja pokrivamo sljedećim odjeljkom u većoj dubini, ali za sada smo samo razumjeli da se ovaj korak odnosi na konfiguriranje vrste podataka koji se vraćaju kad vaša aplikacija podnese zahtjev za Positionstack. Ovdje ćete prvo vidjeti osnovni URL na kojem ciljate svoje zahtjeve, ali također se pojavljuje u dokumentaciji. Konačno, vidimo primjerak zahtjeva za API koji se sastoji od samo nekoliko jednostavnih linija koda.
3. Integracija aplikacija - Posljednji korak odnosi se na konačnu integraciju Positionstack-ovog API-ja u vašu aplikaciju. Postoji priličan iznos o ovom procesu i većina je pokrivena u dokumentaciji. Važna stvar ovdje je: tim za podršku kompanije Positionstack pružio vam je leđa i ponudit će vam toliko ili malo pomoći da biste konfigurirali i integrirali njihov API u vašu aplikaciju.

Prilično lako zar ne? API-ji mogu izgledati zastrašujuće za ljude bez iscrpnog informatičkog znanja u početku. Ali odmah od šišmiša, Positionstack vas tješi spoznajom da je ne samo da je lagan, već će vam pomoći na putu nevjerojatne dokumentacije o njihovom pametnom dizajnu. Pomaže im da imaju strastveni tim stručnjaka koji su spremni da vam pomognu.

Vaša nadzorna ploča Positionstack

Udvostručujući svoju temeljnu vrijednost korisnosti, Positionstack nudi pojednostavljenu, nekrštenu nadzornu ploču s koje možete pristupiti svemu što trebate znati o vašem API-ju. Pogledajmo opcije bočne trake:

• kontrolna ploča - Ovdje ćete pronaći obavijesti (obično vas upozoravaju dok prijeđete određene pragove upotrebe), zatim veze do vodiča za brzo pokretanje u 3 koraka i njihove stranice Dokumentacija. Također je prikazan vaš API ključ, trenutna pretplata, detalji računa i način plaćanja.
• Nadogradnja / pretplata - Možete promijeniti pretplatu na bilo koju od ove dvije mogućnosti. Nadogradite u bilo kojem trenutku, iako želite prelaziti s mjesečnog ili godišnjeg plana u bilo koji smjer, prvo morate prijeći na besplatni račun, a zatim odabrati željenu opciju. Podrška pozicije napada želi vam pomoći ako vam treba pomoć.
• Račun / Plaćanje - To su samorazumljive; bilo koja kartica omogućuje vam da u bilo kojem trenutku ažurirate svoje vjerodajnice. Mora se reći da cijenimo što ove osnovne kontrole ne sahranjuju u prekomjerno dizajniranom, blistavom sučelju. WYSIWYG.
• Upotreba API-ja - Na kartici koju ćete najčešće pregledavati, ovdje možete pronaći koliko ste dosad pojeli kvotu mjesečnog zahtjeva. Tu je i zgodan odjeljak koji prikazuje statistiku vaše upotrebe tijekom vremena, tako da možete u skladu s tim prilagoditi strategiju.

Dokumentacija API-ja

Sada smo došli do srca i duše Positionstack ponude: the Dokumentacija API-ja. Pogledajte ovu stranicu svojim korisničkim priručnikom koji detaljno opisuje svaku krajnju točku API-ja, njihove parametre i kakve će se informacije vratiti.

Ova je stranica podijeljena na pet različitih odjeljaka. Proći ćemo svako od vas, trošit ćemo malo vremena i verzije da bismo vam osigurali neki kontekst da biste bolje shvatili što ćete pronaći.

Početak rada

Evo, naći ćete osnovne funkcije koji se primjenjuju na svaki zahtjev koji postavite uz Positionstack. Ovi su:

• API ključ - Vaš ključ API-ja je poput digitalne putovnice koju ćete koristiti za pristup skupu podataka Positionstack-a. Bez njega API vam je beskoristan. Ako smatrate da je ugrožena, stari ključ možete lako okrenuti za novi.
• Šifriranje - 256-bitna SSL enkripcija upotrebljava se na cijelom Internetu i industrijski je standard sigurnosti iz dobrog razloga. Iako će vam trebati Osnovni plan ili bolje za šifriranje komunikacije vaše aplikacije s poslužiteljima Positionstack-a, dobro je uložiti samostalno. Da biste potakli šifriranje, jednostavno promijenite HTTP u HTTPS u API osnovnom URL-u. Jednostavan!
• Povrat JSON-a - Nećemo ulaziti u previše tehničkih detalja o tome kako to funkcionira, ali ako se zahtjevi API-ja obustave pravilima istog podrijetla, koristite povratne pozive JSON da biste utjecali na rješavanje problema. U osnovi, tražite podatke iz vanjske skripte, koja se ne zasuti problemima s više domena.
• Pogreške API-ja - Kao i u bilo kojem slučaju, ponekad će vam API zahtjevi naići na pogreške. Positionstack to razumije i u svoju je aplikaciju ugradila funkcionalnost prijavljivanja pogreške kako bi vam pomogla prepoznati što je pošlo po zlu. Neuspjesi zahtjeva API-ja automatski će vratiti objekt pogreške u JSON formatu, plus kôd, poruku i kontekst pod-objekte kako bi pružio kontekst za pogrešku.

Krajnje točke API-ja

Ovaj odjeljak dokumentira funkciju mesa i krumpira Positionstack, što znači unaprijed i obrnuto geokodiranje. Ako niste 100% sigurni u čemu je razlika, razmislite o geokodiranju kao dvosmjernoj ulici u koju možete prevesti mjesta i adrese napisane na običnom engleskom jeziku na podatke o lokaciji kao što su koordinate i IP adrese i viza versa.

Dakle, upotrijebite Geocoding naprijed za pretvorbu lokacije Eiffelovog tornja u koordinate. Slično tome, uličnu adresu koja je povezana s IP adresom možete saznati pomoću obrnutog kodiranja. Prilično jednostavno, na kraju krajeva!

Naprijed / nazad zahtjevi za geokodiranje

Da biste postavili osnovni zahtjev za bilo koju vrstu geokodiranja, morat ćete dodati odgovarajuću krajnju točku (/forward ili /reverse) na API-jev osnovni URL. Zatim ćete unijeti pristupni ključ i napravite a pitanje upotrebom obične engleske adrese ili odgovarajućih podataka o lokaciji - i, voila! Izgledat će ovako:

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

ili

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

Naravno, skup podataka Positionstack sadrži puno, puno više od adrese i koordinata. Te ostale kategorizacije možete razvrstati korištenjem različitih parametara. Evo primjera onoga što naprijed geocoding upit, upit Bijela kuća, izgleda:

{"data": {"results": [{"laitude": 38.897675, "longitude": -77.036547, "label": "1600 Pennsylvania Avenue NW, Washington, DC, SAD", "name": "1600 Pennsylvania Avenue NW "," type ":" address "," number ":" 1600 "," street ":" Pennsylvania Avenue NW "," Postal_code ":" 20500 "," trust ": 1," regija ":" Okrug of Columbia "," region_code ":" DC "," Administrative_area ": null," kvart ":" Grounds White House "," država ":" Sjedinjene Države "," code_država ":" US ", "map_url": " http://map.positionstack.com/38.897675,-77.036547" } ] } }

Zanimljivo je da ste to učinili obrnuto geokodiranje zahtjevom pomoću približnih koordinata Bijele kuće, vraćeni rezultati izgledali bi gotovo identično, osim što ćete također vidjeti razliku u udaljenost između vaših koordinata i službenih koordinata Bijele kuće onako kako se pojavljuju u skupu podataka Positionstack.

Razlog ove sličnosti je u tome što obje krajnje točke koriste isti niz GET parametara i na taj su način sposobni vratiti (gotovo) iste objekte odgovora. To znači da bez obzira na početne podatke koje morate proći, zauzvrat možete dobiti potpuni kompletan lokacijski podatak. (Moguće je suziti ove rezultate pomoću API-ja polja parametara, ali to ćemo se dotaknuti nešto kasnije.)

Napomena: Stranica s dokumentacijom Positionstack u potpunosti sadrži svaki parametar i objekt odgovora, stoga svakako provjerite!

Paketni zahtjevi

Posljednji glavni naslov ove postavke dokumentacije bavi se skupni zahtjevi. Sve što trebate učiniti je pozivati ​​se na serija parametar, a zatim gnijezdo više pitanje instance (zajedno s vašim željenim parametrima) ispod u jednom zahtjevu, a za sve ostalo se brine Positionstack API. Mrtav je jednostavan put, a izgleda ovako:

{"batch": [{"upit": "Glavna ulica", "država": "SAD", "regija": "Minnesota"}, {"upit": "Glavna ulica", "država": "SAD", "regija": "Illinois"}, {"upit": "Glavna ulica", "država": "SAD", "regija": "Missouri"} ] }

Napredni podaci

Uz osnovne parametre lokacije, možete dodatno prilagoditi zahtjeve API-ja za vraćanje više napredni podaci. To uključuje:

• Ugradive karte - Vraća objekt map_url povezan s rezultatom geokodiranja koji možete koristiti za stvaranje atraktivnog vizualnog prikaza mape na web mjestu ili u aplikaciji.
• Country Module - Za razliku od drugih parametara koji se vraćaju do nekoliko objekata odgovora, country_module vraća nevjerojatan niz podataka o vašoj zemlji upita. Nisu to samo koordinate i adrese; to je glavni grad, zastava, službeno ime, status neotvorene države (ili ne), korištene valute, govorni jezici, pozivni brojevi i još mnogo toga.
• Modul Sunca - Šaljivo, u dokumentaciji Positions napada to se opisuje kao "Astrološki" podaci. Nećete dobiti svoj horoskop s ovim parametrom, ali vidjet ćete podatke o vremenu izlaska i zalaska sunca, prema astronomskoj, civilnoj i nautičkoj hronologiji.
• Modul vremenske zone - Dodati timezone_module za povraćaj GMT-a na lokaciju u bilo kojoj sekundi ili kao prirodni jezični niz.
• Modul za ograničavanje okvira - Ako jedan x / y par koordinata nije prikladan za vaš zadatak, pokušajte s ograničavajućim okvirom koji obuhvaća područje s minimalnim i maksimalnim vrijednostima za zemljopisnu širinu i širinu.

Dodatne mogućnosti

Positionstack API može vas baciti na mnoštvo podataka, ali srećom vas pruža dodatni alati za upravljanje ovom skupom informacija.

• Navedite polja odgovora - Detaljno smo opisali koliko podataka Positionstack može vratiti, ali imajte na umu da svi ti podaci dolaze po cijenu. Ako želite ograničiti mjesečne zahtjeve, to možete učiniti s polja dodavajući polja = rezultati.flagna primjer, uzrokovat će da API prikazuje samo zastavu vaše zemlje za upit. Možete pozvati polja onoliko puta koliko vam je potrebno da biste dobili određeni skup podataka koji vam je potreban.
• Navedite izlazni format - Besplatni pretplatnici ograničeni su na JSON format za vraćene rezultate geokodiranja. Kupci koji plaćaju mogu se dodati izlaz na njihove zahtjeve da po potrebi navedu JSON, XML ili GeoJSON.

Primjeri kodova

Kad Positionstack kaže da su ovdje da vam pomognu, to misle. Već smo vidjeli koliko je temeljita njihova dokumentacija, ali oni to upotpunjuju primjeri koda na svim jezicima koji njihov API podržava. Nećemo kopirati / zalijepiti ovaj kod ovdje, ali za brzu upotrebu ti su jezici:

• Piton
• Nodejs
• jQuery
• Ići
• Rubin

Dokaz i performanse

U ovom bi trenutku trebalo biti jasno da je Positionstack sposoban učiniti prilično mnogo. Ali, Koliko dobro radi li ove stvari?

Prvo, razmotrimo neki kontekst. Positionstack je jedan od 20+ API mikroservera u Apilayerovom ekosustavu utemeljenom u oblaku. Zajedno, ti API-ji opslužuju preko milijun B2B klijenata od pokretanja sve do poduzeća. Neki od njihovih najistaknutijih kupaca uključuju Amazon, Apple, Slack, LinkedIn i mnoga imena kućanstava. Jasno je da imaju neku robusnu infrastrukturu da podnose ovu potražnju.

Positionstack, prema vlastitim zaslugama, živi u svom rodoslovlju, s nevjerojatnim 100% produženjem tijekom 2020. godine u vrijeme pisanja. Ovo je još impresivnije kad uzmete u obzir API rutinski obrađuje preko milijardu pretraživanja geokodova dnevno po klijentu kitova, a da ne spominjemo vrtoglavi niz istodobnih zahtjeva koji dolaze iz njihovih stabilnih SMB kupaca. Pored toga, ti zahtjevi obično odgovaraju od 10 do 100 ms.

U našoj knjizi to je nešto tehnološkog čuda, posebno imajući u vidu koliko je SaaS ponuda agresivna.

A ne samo sirova snaga čini Positionstack tako privlačnim. Njihov je skup podataka doista sofisticiran, izveden iz pouzdanih imena poput Nominatim, GeoNames, Pelias i OpenStreetMap. Positionstack unakrsno provjerava, filtrira i rekombinira ovo bogatstvo podataka više puta dnevno, gurajući redovita ažuriranja putem pametnih algoritama koji osiguravaju vam uvijek visoko precizne podatke o lokaciji, bilo gdje u svijetu, a i u stvarnosti vrijeme.

Mrzimo pokvariti našu konačnu presudu, ali ako tražite robusno, skalabilno rješenje za geokodiranje, nastavak pozicije napada zahtijeva pomniji pregled.

cijena

Apilayer je zacrtao pružiti pristupačnu alternativu skupocjenom softveru za geokodiranje na razini poduzeća i u tome su uspjeli.

Positionstack dolazi u pet cijena slojeva i podržava mjesečno naplate ili godišnje pretplate uz popust od 20%. Ti su slojevi:

• Besplatno - Ocijenjeni za osobnu upotrebu, još uvijek vam je prijeđena velika kilometraža s 25.000 mjesečnih zahtjeva za geocodiranje unaprijed i obrnuto, ispisano u JSON formatu. Ne dobivate puno naprednih funkcija ili korisničke podrške, ali već smo vam pokazali koji je dragocjeni resurs njihova stranica Dokumentacija. Ova razina je besplatna i bez obveza - čak ne morate davati podatke o kreditnoj kartici.
• Osnovni, temeljni - Komercijalni paket ulazne razine. Osnovni pretplatnici udvostruče svoju mjesečnu kvotu na 100 000 zahtjeva za geokodiranje, plus dobiju pristup naprednim značajke poput HTTPS enkripcije, više izlaznih opcija (JSON, XML, GeoJSON), ugradive karte, više jezika, i više. Nabavite komercijalnu licencu Positionstack za samo 9,99 USD mjesečno.
• profesionalac - Najpopularnija ponuda kompanije Positionstack, Profesionalni sloj nudi desetostruko povećanje zahtjeva za geokodiranje - do 1.000.000 mjesečno. Prisutni su svi proizvodi iz osnovnog sloja, a zatim i neki, osobito uključujući serijske zahtjeve za velike zahtjeve. Ovaj sloj radi na 49,99 USD mjesečno.
• Poslovanje - Prelazeći na performanse poduzeća, poslovni sloj balonira mjesečnu kvotu na nevjerojatnih 3 000 000 zahtjeva. Još jednom je svaka napredna značajka u potpunosti dostupna, a potpomognuta je strastvenim timom za korisničku podršku Positionstack-a koji će vam pomoći da izvučete maksimum iz njih. 99,99 USD mjesečno.
• Poduzeće - Ovo je red u kojem standardne ponude idu kroz prozor, a kupac je kralj. Imate precizne potrebe koje zahtijevaju prilagođena rješenja, a Positionstack je spreman da postigne vaše ciljeve. Diktirate mjesečne zahtjeve za količinu, čak (posebno) ako su promjenjivi. Treba vam više konjskih snaga od API-ja? Dođite do podrške za prilagođena rješenja. Kontaktirajte Positionstack za ponudu.

Presuda

Positionstack radi upravo ono što je namjeravao učiniti: svodi geokodiranje na razini poduzeća s cijena, inače, iz proračuna, većini malih i srednjih poduzeća, bez žrtvovanja performansi. Njihov API je dobro dokumentiran i jednostavan za korištenje, ali ima snažnu integraciju u sve glavne programske jezike za maksimalnu korisnost. Broj zahtjeva s kojima se Positionstack rutinski rukuje zadivljujući je, dok se njihov skup podataka pametno održava za istinski globalni domet u geokodiranju u stvarnom vremenu. Ako ste na tržištu ove vrste proizvoda, nemojte spavati na Positionstacku.

Kakvu integraciju planirate? Kako ćete se koristiti Geocoding u svom poslu? Imate li kakvih pitanja ili komentara o Positionstacku? Ostavite nam bilješku u komentarima ispod.