Obțineți gratuit geocodare la nivel de întreprindere cu API-ul Positionstack (REVIZUIRE)

Nu trebuie să fiți Google Maps pentru a obține valoare din geocodare. Și, datorită Positionstack, nici nu ai nevoie de bugetul tehnic al Big G pentru a face acest lucru. Astăzi, trecem în revistă API-ul robust al lui Positionstack, care are ca scop să facă geocodarea în avans și invers la nivel de întreprindere, atât la prețuri accesibile, cât și utilizabile.

Poziție 101

Deci, de ce ar trebui să te deranjezi să citești o recenzie de peste 2000 de cuvinte Positionstackși ce stai să câștigi? Răspunsul sună drăguț, dar este exact: lumea întreagă.

Luați în considerare pentru o clipă câte locuri există pe harta lumii. Acum, multiplicați acest număr în fiecare cap de metadate pe care afacerea dvs. trebuie să le cunoască despre acele locuri. Asta oferă Positionstack și apoi unele.

Să ne uităm la câteva statistici rapide despre Pozitionare:

• Miliarde de solicitări de căutare de geocodare procesate în fiecare oră, în fiecare zi; cu timp de funcționare 100% și timp de răspuns <100ms
• Infrastructură bazată pe cloud, puternic scalabilă
instagram viewer
• Date în timp real despre fiecare țară din lume, compilate într-un set de date cavernos care este actualizat la fiecare câteva ore
• Planuri de abonamente la prețuri competitive, generoase; la care se adaugă o cotă lunară inegalabilă de 10.000 de solicitări pentru utilizatorii gratuite
• Suport de integrare pentru toate limbajele majore de programare
• Documentație completă, ușor de citit, completată cu fragmente de cod
• O echipă de satisfacție a clienților de nivel mondial, cu experiență care servește clienți precum Zendesk, Slack, LinkedIn, Lyft, Apple și Amazon

Positionstack are cu siguranță pedigree-ul său, dar în cazul în care nu sunteți convins de o mână de puncte glonț, să facem o scufundare profundă în ceea ce dorește să utilizeze de fapt API-ul.

Ghidul de pornire rapidă în 3 pași de Positionstack

Dacă petreceți ceva timp pe site-ul lor web, veți vedea că Positionstack subliniază cu adevărat ușurința de utilizare ca punct principal de vânzare pentru API-ul lor. În timpul procesului de înscriere, veți vedea imediat că este destul de adevărat. De fapt, primul lucru pe care îl vedeți după ce introduceți datele de autentificare ale contului dvs. este o foaie de parcurs rapidă a ceea ce este nevoie pentru a vă ridica și a rula cu Positionstack în trei pași simpli. Hai să aruncăm o privire:

1. Setați-vă cheia de acces API - În mod implicit, ați predat o cheie de acces care este gata să iasă din casetă. Cu toate acestea, puteți reseta cu ușurință această linie în funcție de necesități.
2. Alegeți obiectivele API - Acoperim punctele finale ale API în mai mare profunzime în secțiunea următoare, dar deocamdată înțeleg că acest pas se referă la configurarea tipului de date returnate atunci când aplicația dvs. face o solicitare către Positionstack. Aici veți vedea mai întâi adresa URL de bază, care este locul în care vizați solicitările, dar apare și în documentație. În cele din urmă, vedem o solicitare de probă API, care constă din doar câteva linii simple de cod.
3. Integrare de aplicații - Ultimul pas se referă la integrarea finală a API-ului Positionstack în aplicația dvs. Există o cantitate corectă de știut despre acest proces și cea mai mare parte este acoperită în documentație. Lucrul important aici este: Echipa de suport a Positionstack are spatele și vă va oferi tot atât de mult sau cât mai puțin ajutor pentru a configura și integra API-ul lor în aplicație.

Destul de ușor nu? API-urile pot părea intimidante pentru oameni fără cunoștințe IT extinse la început. Însă, imediat după bate, Positionstack vă mângâie cu cunoștințele că nu numai că este ușor, ci vă vor ajuta pe parcurs cu o documentare incredibilă a designului lor inteligent. Îi ajută să aibă o echipă pasionată de experți, gata să te ajute.

Panoul dvs. de bord de poziție

Dublându-și valoarea esențială a ușurinței în materie de utilizare, Positionstack oferă un Tablou de bord simplificat, neclintit, din care poți accesa tot ceea ce trebuie să știi despre API-ul tău. Să aruncăm o privire asupra opțiunilor din bara laterală:

• Tablou de bord - Aici veți găsi notificări (de obicei, vă avertizează pe măsură ce treceți anumite praguri de utilizare), apoi link-uri atât la Ghidul de pornire rapidă în 3 pași, cât și la pagina Documentare. Există, de asemenea, o imagine de ansamblu a cheii API, a abonamentului dvs. curent, detaliile contului și metoda de plată.
• Upgrade / abonare - Vă puteți modifica abonamentul pentru oricare dintre aceste două opțiuni. Actualizați oricând, deși dacă doriți să comutați între un plan lunar sau anual în orice direcție, va trebui să faceți mai întâi o trecere în jos la un cont gratuit, apoi alegeți opțiunea dorită. Asistența positionstack este dispusă să vă ajute dacă aveți nevoie de ajutor în acest sens.
• Cont / Plată - Acestea sunt auto-explicative; oricare dintre filele vă va permite să vă actualizați acreditările în orice moment. Trebuie spus că apreciem că nu îngroapă aceste controale de bază într-o interfață exagerat de proiectată. WYSIWYG.
• Utilizare API - Probabil că fila pe care o veți consulta cel mai des, aici puteți afla cât din cota dvs. de solicitare lunară ați consumat până acum. Există, de asemenea, o secțiune utilă care arată statisticile de utilizare în timp, astfel încât să puteți ajusta strategia în consecință.

Documentare API

Acum ajungem la inima și sufletul ofertei Pozitionale: Documentația API. Luați în considerare această pagină manualul dvs. de utilizare, care prezintă fiecare punct de referință al API, parametrii lor și ce fel de informații vor returna.

Această pagină este împărțită în cinci secțiuni diferite. Vom parcurge fiecare, petrecând ceva timp și versiune pentru a oferi un context pentru ca dvs. să înțelegeți mai bine ce veți găsi.

Noțiuni de bază

Aici, veți găsi funcții de bază care se aplică oricărei solicitări pe care o faceți cu Positionstack. Acestea sunt:

• Cheie API - Cheia dvs. API este ca un pașaport digital pe care îl veți folosi pentru a accesa setul de date Positionstack. Fără ea, API-ul nu este inutil pentru tine. Dacă credeți că a fost compromisă, puteți roti cu ușurință cheia veche pentru una nouă.
• Criptarea - Criptarea SSL de 256 biți este utilizată peste tot pe Internet și este standardul industriei pentru securitate dintr-un motiv bun. Deși veți avea nevoie de un plan de bază sau mai bun pentru a cripta comunicările aplicației cu serverele Positionstack, merită investiția singură. Pentru a evoca criptarea, pur și simplu schimbați HTTP în HTTPS în adresa URL de bază a API. Simplu!
• JSON Callbacks - Nu vom intra în prea multe detalii tehnice despre modul în care funcționează acest lucru, dar dacă solicitările API sunt primite prin politici de aceeași origine, utilizați apeluri JSON pentru a afecta o soluție. În esență, solicitați date dintr-un script extern, care nu se confruntă cu probleme cross-domain.
• Erori API - Ca în orice, uneori solicitările API vor avea erori. Positionstack înțelege acest lucru și a integrat în aplicația lor o funcționalitate de raportare a erorilor pentru a vă ajuta să identificați ce a mers prost. Eșecurile solicitării API vor returna automat un obiect de eroare în format JSON, plus sub-obiecte de cod, mesaj și context pentru a oferi contextul erorii.

Obiectivele API

Această secțiune documentează funcționalitatea carnea și cartofii Positionstack, adică geocodarea înainte și inversă. Dacă nu sunteți sigur 100% care este diferența, gândiți-vă la geocodare ca o stradă cu două sensuri unde puteți traduce locații și adrese scrise în engleză simplă pentru date despre locații precum coordonate și adrese IP și viceversa.

Așadar, veți folosi geocodarea înainte pentru a transforma locația Turnului Eiffel în coordonate. În mod similar, puteți afla adresa stradală asociată cu o adresă IP folosind geocodarea inversă. Destul de simplu, până la urmă!

Cereri de geocodare înainte / invers

Pentru a face o solicitare de bază pentru oricare tip de geocodare, va trebui să adăugați punctul final corespunzător (/forward sau /reverse) la adresa URL de bază a API-ului. În continuare, veți furniza cheia de acces, apoi creați o întrebare folosind o adresă de locație în engleză simplă sau datele de locație corespunzătoare - și, voilă! Va arăta așa:

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

sau

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

Desigur, setul de date al Positionstack conține mult, mult mai mult decât simple adrese și coordonate. Puteți analiza aceste alte categorizări prin utilizarea diferiților parametri. Iată un exemplu despre ceea ce a geocodare înainte cerere, interogând Casa Albă, arată:

{"data": {"rezultate": [{"latitudine": 38.897675, "longitudine": -77.036547, "etichetă": "1600 Pennsylvania Avenue NW, Washington, DC, SUA", "nume": "1600 Pennsylvania Avenue NW "," tip ":" adresă "," număr ":" 1600 "," stradă ":" Pennsylvania Avenue NW "," cod poștal ":" 20500 "," încredere ": 1," regiune ":" District of Columbia "," region_code ":" DC "," administrative_area ": nul," cartier ":" White House Grounds "," country ":" Statele Unite "," country_code ":" SUA ", "map_url": " http://map.positionstack.com/38.897675,-77.036547" } ] } }

Interesant, dacă ar fi să faci un geocodare inversă la solicitarea utilizând coordonatele aproximative ale Casei Albe, rezultatele returnate ar arăta aproape identice, cu excepția faptului că veți vedea și diferența distanţă între coordonatele dvs. și coordonatele oficiale ale Casei Albe, așa cum apar în setul de date al lui Positionstack.

Motivul acestei asemănări este că ambele puncte finale utilizează aceeași serie de parametri GET și sunt astfel capabili să returneze (aproape) aceleași obiecte de răspuns. Asta înseamnă că, indiferent de datele de pornire pe care trebuie să le parcurgeți, puteți obține o completare completă a datelor despre locație în schimb. (Este posibil să se restrângă aceste rezultate utilizând API-ul câmpuri parametru, dar vom mai atinge asta mai târziu.)

Notă: pagina de documentare a Pozitionale detaliează fiecare parametru și obiect de răspuns, deci asigurați-vă că îl verificați!

Cereri de lot

Ultima rubrică importantă din această setare de documentare se referă la cereri de lot. Nu trebuie decât să invoci lot parametru, apoi cuib multiplu întrebare instanțe (împreună cu parametrii doriți) de mai jos într-o singură solicitare, iar API-ul Positionstack are grijă de restul. Este simplu și pare așa:

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

Date avansate

În plus față de parametrii de locație de bază, puteți personaliza în continuare solicitările API pentru a vă returna mai multe date avansate. Acestea includ:

• Hărți încorporate - returnează un obiect map_url legat de rezultatul dvs. de geocodare, pe care îl puteți utiliza pentru a crea o reprezentare atractivă a hărții vizuale pe site-ul sau aplicația dvs.
• Modulul de țară - Spre deosebire de alți parametri care revin la câteva obiecte de răspuns, country_module returnează o serie incredibilă de date despre țara dvs. interogată. Nu sunt doar coordonate și adrese; este capitala, steagul, numele oficial, statutul de țară fără lac (sau nu), valute utilizate, limbi vorbite, coduri de apel și multe altele.
• Modul Soare - Cu umor, documentația Positionstack descrie aceasta drept date „astrologice”. Nu veți obține horoscopul cu acest parametru, dar veți vedea date despre momentul în care răsare și apune soarele, conform cronologiei astronomice, civile și nautice.
• Modul de fus orar - Anexă timezone_module pentru a returna compensarea GMT a unei locații în secunde sau ca un șir de limbă naturală.
• Modulul casetei de delimitare - Dacă o singură pereche de coordonate x / y nu este potrivită pentru sarcina dvs., încercați o casetă de delimitare, care cuprinde o zonă cu valori minime și maxime pentru longitudine și latitudine.

Opțiuni suplimentare

API-ul Positionstack are o mulțime de date de aruncat către dvs., dar din fericire vă oferă instrumente suplimentare pentru a gestiona acest trove de informații.

• Specificați câmpurile de răspuns - Am acoperit în profunzime cât de multe date pot returna Positionstack, dar rețineți că toate aceste date costă. Dacă doriți să vă limitați solicitările lunare, puteți face acest lucru cu ajutorul câmpuri Adăugarea fields = rezultate.flag, de exemplu, va face ca API-ul să scoată numai steagul țării dvs. solicitate. Puteți invoca câmpuri de câte ori aveți nevoie pentru a obține setul de date specific dorit.
• Specificați formatul de ieșire - Abonații gratuite sunt limitați la formatul JSON pentru rezultatele returnate de geocodare. Cu toate acestea, clienții plătitori pot însoți producție la cererile lor de a specifica JSON, XML sau GeoJSON, după caz.

Exemple de cod

Când Positionstack spune că sunt aici pentru a vă ajuta, înseamnă că. Am văzut deja cât de amănunțită este documentația lor, dar o rezolvă la îndemână exemple de cod în toate limbile, suporta API-ul lor. Nu vom copia / insera codul aici, dar pentru o trimitere rapidă, aceste limbi sunt:

• Piton
• Nodejs
• jQuery
• Merge
• Rubin

Dovadă și performanță

În acest moment, ar trebui să fie clar că Positionstack este capabil să facă destul de multe. Dar, cât de bine face aceste lucruri?

În primul rând, să luăm în considerare anumite contexte. Positionstack este unul dintre mai mult de 20 de microservicii API din ecosistemul bazat pe cloud de la Apilayer. Împreună, aceste API-uri servesc peste un milion de clienți B2B de la start-up până la întreprindere. Unii dintre cei mai notabili clienți ai acestora includ Amazon, Apple, Slack, LinkedIn și multe alte nume de familie. În mod clar, au o infrastructură robustă pentru a face față acestei scări de cerere.

Pe propriile merite, Pozitionstack trăiește la maximum, cu un uptime incredibil de 100% pe tot parcursul anului 2020, la momentul scrierii. Acest lucru este și mai impresionant atunci când luați în considerare API-ul în mod obișnuit procesează peste un miliard de căutări de geocoduri pe zi pe client de balenă, fără să mai vorbim de amețitorul de solicitări simultane venite de la graiul lor de clienți SMB. Mai mult, aceste solicitări obțin de obicei răspunsuri între 10 și 100 ms.

În cartea noastră, acesta este ceva minunat tehnologic, în special având în vedere cât de prețiv este această ofertă SaaS.

Și nu doar puterea brută este cea care face poziția atât de atrăgătoare. Datele lor de date sunt cu adevărat sofisticate, provenind de la nume fiabile precum Nominatim, GeoNames, Pelias și OpenStreetMap. Poziția de blocare a controalelor, filtrează și recombină această bogăție de date de mai multe ori pe zi, împingând actualizări periodice prin algoritmi inteligenti care vă asigură că aveți întotdeauna date de locație extrem de precise, oriunde în lume și în realitate timp.

Urăm să ne răsfățăm verdictul final, dar dacă căutați o soluție robustă și scalabilă de geocodare, CV-ul poziției cere o privire mai atentă.

Prețuri

Apilayer și-a propus să ofere o alternativă accesibilă la software-urile de geocodare la nivel înalt de întreprindere și, în acest scop, au reușit.

Positionstack vine în cinci de stabilire a prețurilor niveluri și acceptă facturare lunară sau abonamente anuale la o reducere de 20%. Aceste niveluri sunt:

• Liber - Potrivit pentru utilizare personală, mai primiți o cantitate bună de kilometri cu 25.000 de solicitări lunare de geocodare înainte și inversă, transmise în format JSON. Nu beneficiați de o mulțime de funcții avansate sau de asistență pentru clienți, dar v-am arătat deja ce resursă valoroasă este pagina lor de Documentare. Acest nivel este gratuit și nu este obligatoriu - nici nu trebuie să furnizați detalii despre cardul de credit pentru a începe.
• De bază - Pachetul comercial la nivel de intrare. Abonații de bază își quadrupluază cota lunară la 100.000 de solicitări de geocodare, plus că au acces la avans caracteristici precum criptarea HTTPS, mai multe opțiuni de ieșire (JSON, XML, GeoJSON), hărți încorporate, mai multe limbi, și altele. Obțineți o licență comercială Positionstack pentru doar 9,99 USD pe lună.
• Profesionist - Cea mai populară ofertă Positionstack, nivelul Profesional oferă o creștere de zece ori a cererilor de geocodare - până la 1.000.000 pe lună. Toate bunătățile de la nivelul de bază sunt prezente și apoi unele, în special incluzând cererile de loturi pentru aplicații grele. Acest nivel se înregistrează la 49,99 USD pe lună.
• Afaceri - Trecând la performanța la scară a întreprinderii, nivelul de afaceri balonează cota lunară la 3.000.000 de solicitări. Încă o dată, fiecare caracteristică avansată este pe deplin disponibilă, susținută de pasionata echipă de asistență a clienților Positionstack, pentru a vă ajuta să beneficiați la maxim de ele. 99,99 USD lunar.
• Afacere - Acesta este nivelul în care ofertele standard ies pe fereastră, iar clientul este rege. Aveți nevoi precise care solicită soluții personalizate, iar Pozitionarea este gata să vă atingă obiectivele. Dictati solicitările dvs. de volum lunar, chiar (mai ales) dacă acestea sunt variabile. Aveți nevoie de mai mulți cai putere din API? Accesați suportul pentru soluții personalizate. Contactați Poștașul pentru o ofertă.

Verdict

Positionstack face exact ceea ce și-a propus să facă: reducerea geocodării la nivel de întreprindere din punctele de preț, altfel din buget la majoritatea IMM-urilor, fără a sacrifica performanța. API-ul lor este bine documentat și ușor de utilizat, dar oferă o integrare robustă în toate limbajele majore de programare pentru o utilitate maximă. Numărul de solicitări gestionate de rutina Positionstack este eșalonant, în timp ce setul de date al acestora este menținut în mod inteligent pentru o abordare cu adevărat globală în geocodarea în timp real. Dacă sunteți pe piață pentru acest tip de produs, nu dormiți pe Poștaș.

Ce fel de integrare ați planificat? Cum veți folosi geocodarea în afacerea dvs.? Aveți întrebări sau comentarii cu privire la Positionstack? Lasă-ne o notă în comentariile de mai jos.