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

Nu trebuie să fiți Google Maps pentru a obține valoare din geocodare. Și, datorită Positionstack, nici nu aveți nevoie de bugetul tehnologic al lui Big G pentru a face acest lucru. Astăzi, revizuim API-ul robust Positionstack, care își propune să facă geocodarea directă și inversă la nivel de întreprindere atât la un preț accesibil, cât și la o utilizare foarte bună.

Positionstack 101

Deci, de ce ar trebui să vă obosiți să citiți o recenzie de peste 2.000 de cuvinte pe Positionstack și ce aveți de câștigat? Raspunsul suna dragut, dar este corectă: întreaga lume .

Luați în considerare pentru un moment câte locuri sunt pe harta lumii. Acum, multiplică numărul din capul tău cu fiecare metadate pe care compania ta trebuie să le cunoască despre acele locuri. Asta oferă Positionstack și apoi ceva.

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

• Miliarde reale de cereri de căutare de geocodare procesate în fiecare oră, în fiecare zi; cu 100% timp de funcționare și < 100ms="" response="">
• Infrastructură bazată pe cloud, foarte scalabilă
• Date în timp real pentru fiecare țară din lume, compilate într-un set de date cavernos care este actualizat la fiecare câteva ore
• Planuri de abonament distribuite generos, la prețuri competitive; plus o cotă lunară de neegalat de 10.000 de cereri pentru utilizatorii gratuiti
• Suport de integrare pentru toate limbajele de programare majore
• Documentație cuprinzătoare, ușor de citit, cu fragmente de cod
• O echipă de satisfacție a clienților de clasă mondială, cu experiență în deservirea clienților precum Zendesk, Slack, LinkedIn, Lyft, Apple și Amazon

Positionstack își are cu siguranță pedigree-ul sub control, dar în cazul în care nu sunteți convins de câteva puncte de marcare, haideți să aruncăm o privire profundă în cum este să utilizați de fapt API-ul.

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

Dacă petreceți timp pe site-ul lor, veți vedea că Positionstack subliniază cu adevărat ușurința de utilizare ca principal argument de vânzare pentru API-ul lor. În timpul procesului de înscriere, veți vedea imediat că este adevărat. De fapt, primul lucru pe care îl vedeți după ce ați introdus acreditările contului este o foaie de parcurs rapidă a ceea ce este nevoie pentru a începe și a funcționa cu Positionstack în trei pași simpli. Hai să aruncăm o privire:

1. Setați-vă cheia de acces API – În mod implicit, vi se înmânează o cheie de acces care este gata să iasă din cutie. Cu toate acestea, puteți reseta cu ușurință acest lucru în jos, după cum este necesar.
2. Alegeți punctele finale API – Acoperim punctele finale API mai detaliat secțiunea următoare, dar deocamdată înțelegeți 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 vă vizați solicitările, dar apare și în documentație. În cele din urmă, vedem un exemplu de solicitare API, care constă doar din câteva linii simple de cod.
3. Integrarea aplicației – Ultimul pas se referă la integrarea finală a API-ului Positionstack în aplicația dvs. Există o cantitate suficientă de știut despre acest proces și cea mai mare parte este acoperită în documentație. Lucrul important aici este: echipa de asistență Positionstack vă va sprijini și vă va oferi atât de mult sau cât de puțin ajutor de care aveți nevoie pentru a configura și integra API-ul lor în aplicația dvs.

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

Tabloul de bord Positionstack

Dublandu-și valoarea de bază a ușurinței de utilizare, Positionstack oferă un tablou de bord simplificat și neaglomerat de pe care poți accesa tot ce trebuie să știi despre API-ul tău. Să aruncăm o privire la opțiunile barei laterale:

• Tabloul de bord – Aici veți găsi notificări (de obicei vă avertizează pe măsură ce treceți anumite praguri de utilizare), apoi linkuri către atât Ghidul de pornire rapidă în 3 pași, cât și pagina de documentație. Există, de asemenea, o prezentare generală a cheii dvs. API, a abonamentului dvs. actual, detaliile contului și metoda de plată.
• Upgrade/Abonament – Vă puteți schimba abonamentul pe oricare dintre aceste două opțiuni. Faceți upgrade în orice moment, deși dacă doriți să comutați între un plan lunar sau anual în oricare direcție, va trebui mai întâi să faceți downgrade la un cont gratuit, apoi să alegeți opțiunea dorită. Asistența Positionstack este dispusă să vă ajute dacă aveți nevoie de ajutor pentru a face acest lucru.
• Cont/Plată – Acestea se explică de la sine; oricare dintre filele vă va permite să vă actualizați acreditările în orice moment. Trebuie spus că apreciem că nu îngroapă aceste comenzi de bază într-o interfață supraproiectată, strălucitoare. WYSIWYG.
• Utilizare API – Probabil fila pe care o veți revedea cel mai des, aici puteți afla cât ați consumat până acum din cota lunară de solicitare. Există, de asemenea, o secțiune la îndemână care arată statisticile de utilizare în timp, astfel încât să vă puteți ajusta strategia în consecință.

Documentația API

Acum ajungem la inima și sufletul ofertei Positionstack: documentația API . Luați în considerare această pagină manualul dvs. de utilizare, care detaliază fiecare punct final API, parametrii acestora și ce fel de informații vor returna.

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

Noțiuni de bază

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

• Cheia 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ă el, API-ul este inutil pentru tine. Dacă credeți că a fost compromisă, puteți roti cu ușurință vechea cheie pentru una nouă.
• Criptare – Criptarea SSL pe 256 de biți este utilizată pe tot Internetul și este standardul industriei pentru securitate dintr-un motiv întemeiat. Deși veți avea nevoie de un plan de bază sau mai bun pentru a cripta comunicațiile aplicației dvs. cu serverele Positionstack, merită investiția de la sine. Pentru a evoca criptarea, schimbați pur și simplu HTTP în HTTPS în adresa URL de bază a API. Simplu!
• Apeluri JSON – Nu vom intra în prea multe detalii tehnice despre cum funcționează acest lucru, dar dacă solicitările dvs. API sunt blocate de politici de aceeași origine, utilizați apelurile JSON pentru a afecta o soluție. În esență, solicitați date dintr-un script extern, care nu se blochează cu probleme între domenii.
• Erori API – Ca și în orice caz, uneori, solicitările dvs. API se vor confrunta cu erori. Positionstack înțelege acest lucru și a integrat în aplicația sa 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 cod, mesaj și subobiecte context pentru a furniza context pentru eroare.

Puncte finale API

Această secțiune documentează funcționalitatea de carne și cartofi a Positionsstack, adică geocodarea înainte și inversă. Dacă nu sunteți 100% sigur care este diferența, gândiți-vă la geocodarea ca pe o stradă cu două sensuri în care puteți traduce locuri și adrese scrise în limba engleză simplă în date de locație, cum ar fi coordonatele și adresele IP și invers.

Deci, ați folosi geocodarea directă pentru a converti locația Turnului Eiffel în coordonate. În mod similar, puteți afla adresa străzii asociată cu o adresă IP utilizând geocodarea inversă. Destul de simplu, la urma urmei!

Solicitări de geocodare înainte/inversare

Pentru a face o solicitare de bază pentru oricare dintre tipurile de geocodare, va trebui să atașați punctul final corespunzător ( /forward  sau /reverse ) la adresa URL de bază a API-ului. Apoi, veți furniza cheia de acces, apoi veți face o interogare folosind fie o adresă de locație în limba engleză simplă, fie datele de locație corespunzătoare acesteia – și, voila! Va arata cam asa:

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

sau

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

Desigur, setul de date Positionstack conține mult, mult mai mult decât adrese și coordonate. Puteți analiza aceste alte categorii prin utilizarea diferiților parametri. Iată un exemplu despre cum arată o solicitare de geocodare înainte , interogând Casa Albă:

{
   "date": {
      „rezultate”: [
         {
            „latitudine”: 38,897675,
            „longitudine”: -77,036547,
            „label”: „1600 Pennsylvania Avenue NW, Washington, DC, SUA”,
            „nume”: „1600 Pennsylvania Avenue NW”,
            "type": "adresă",
            „număr”: „1600”,
            „stradă”: „Pennsylvania Avenue NW”,
            "postal_code": "20500",
            „încredere”: 1,
            „region”: „Districtul Columbia”,
            "region_code": "DC",
            „zona_administrativă”: nul,
            „neighbourhood”: „Terenul Casei Albe”,
            „country”: „Statele Unite”,
            "country_code": "SUA",
            „map_url”: „https://map.positionstack.com/38.897675,-77.036547”
         }
      ]
   }
}

Interesant, dacă ar fi să faceți o solicitare de geocodare inversă folosind coordonatele aproximative ale Casei Albe, rezultatele returnate ar arăta aproape identice, cu excepția faptului că ați vedea și diferența de distanță dintre coordonatele dvs. și coordonatele oficiale ale Casei Albe, așa cum apar în Positionsstack. set de date.

Motivul acestei similitudini este că ambele puncte finale utilizează aceeași matrice de parametri GET și sunt astfel capabile să returneze (aproape) aceleași obiecte de răspuns. Aceasta înseamnă că indiferent de ce date de pornire trebuie să utilizați, puteți obține în schimb o gamă completă de date despre locație. (Este posibil să restrângem aceste rezultate utilizând parametrul câmpuri  al API-ului , dar îl vom atinge mai târziu.)

Notă: pagina de documentație a Positionstack detaliază complet fiecare parametru și obiect de răspuns, așa că asigurați-vă că îl verificați!

Solicitări de lot

Ultimul titlu major din această setare a documentației tratează solicitările de loturi . Tot ce trebuie să faceți este să invocați parametrul lot  , apoi să încadrați mai multe instanțe de interogare (împreună cu parametrii doriti) dedesubt într-o singură solicitare, iar API-ul Positionstack se ocupă de restul. Este foarte simplu și arată astfel:

{
   "lot":[
      {
         "query": "Strada principală",
         „țară”: „SUA”,
         „region”: „Minnesota”
      },
      {
         "query": "Strada principală",
         „țară”: „SUA”,
         „regiune”: „Illinois”
      },
      {
         "query": "Strada principală",
         „țară”: „SUA”,
         "region": "Missouri"
      }
   ]
}

Date avansate

Pe lângă parametrii de bază ale locației, puteți personaliza în continuare solicitările dvs. API pentru a returna date mai avansate . Acestea includ:

• Hărți încorporabile – Returnează un obiect map_url legat de rezultatul geocodării, pe care îl puteți folosi pentru a crea o reprezentare vizuală atractivă a hărții pe site-ul sau aplicația dvs.
• Modulul de țară – Spre deosebire de alți parametri care returnează până la câteva obiecte de răspuns, country_module returnează o serie incredibilă de date despre țara interogată. Nu este vorba doar de coordonate și adrese; este capitala, steagul, numele oficial, statutul de țară fără ieșire la mare (sau nu), valutele folosite, limbile vorbite, codurile de apel și multe altele.
• Modulul Sun – Cu umor, documentația Positionstack descrie acest lucru drept date „astrologice”. Nu veți obține horoscopul cu acest parametru, dar veți vedea date despre când soarele răsare și apune, conform cronologiei astronomice, civile și nautice.
• Modul fus orar – Adăugați timezone_module pentru a returna decalajul GMT al unei locații fie în secunde, fie ca șir în limbaj natural.
• Modulul de delimitare – Dacă o singură pereche de coordonate x/y nu este potrivită pentru sarcina dvs., încercați o casetă de delimitare, care include 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 asupra dvs., dar, din fericire, vă oferă instrumente suplimentare pentru a gestiona acest depozit de informații.

• Specificați câmpurile de răspuns – Am acoperit în detaliu câte date poate returna Positionstack, dar rețineți că toate aceste date au un cost. Dacă doriți să vă limitați solicitările lunare, puteți face acest lucru cu câmpurile Adăugarea câmpurilor = results.flag , de exemplu, va face ca API-ul să scoată numai steagul țării solicitate. Puteți invoca câmpuri de câte ori aveți nevoie pentru a obține setul de date specific de care aveți nevoie.
• Specificați formatul de ieșire – Abonații gratuiti sunt limitați la formatul JSON pentru rezultatele returnate de geocodare. Clienții plătitori, totuși, pot adăuga rezultate la solicitările lor pentru a specifica JSON, XML sau GeoJSON, după cum este necesar. 

Exemple de coduri 

Când Positionstack spune că sunt aici pentru a vă ajuta, vorbesc serios. Am văzut deja cât de completă este documentația lor, dar ei completează cu exemple de cod la îndemână în toate limbile suportate de API-ul lor. Nu vom copia/lipi codul aici, dar pentru referință rapidă, acele limbi sunt:

• Piton
• Nodejs
• jQuery
• Merge
• Rubin

Dovada si performanta

Î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?

Mai întâi, să luăm în considerare un context. Positionstack este unul dintre cele peste 20 de microservicii API din ecosistemul Apilayer bazat pe cloud. Împreună, aceste API-uri deservesc peste un milion de clienți B2B, de la startup-uri până la întreprinderi. Unii dintre clienții lor cei mai importanți includ Amazon, Apple, Slack, LinkedIn și multe alte nume cunoscute. În mod clar, au o infrastructură robustă pentru a face față acestei cereri.

Pe propriile merite, Positionstack se ridică la înălțimea pedigree-ului său, cu un timp de funcționare incredibil de 100% pe tot parcursul anului 2020 la momentul scrierii acestui articol. Acest lucru este și mai impresionant dacă luați în considerare că API-ul procesează în mod obișnuit peste un miliard de căutări de geocoduri pe zi pentru fiecare client balenă, ca să nu mai vorbim de gama amețitoare de solicitări simultane venite de la stabilul lor de clienți SMB. În plus, aceste solicitări obțin de obicei răspunsuri între 10 și 100 ms.

În cartea noastră, aceasta este o minune tehnologică, mai ales având în vedere cât de agresiv este această ofertă SaaS.

Și nu doar puterea brută face Positionstack atât de atrăgător. Setul lor de date este cu adevărat sofisticat, provenit de la nume de încredere precum Nominatim, GeoNames, Pelias și OpenStreetMap. Positionstack verifică, filtrează și recombină această bogăție de date de mai multe ori pe zi, împingând actualizări regulate prin algoritmi inteligenți care vă asigură că aveți întotdeauna date de locație foarte precise, oriunde în lume și în timp real.

Urăm să ne stricam verdictul final, dar dacă sunteți în căutarea unei soluții de geocodare robustă și scalabilă, CV-ul Positionstack necesită o privire mai atentă.

Prețuri 

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

Positionstack vine în cinci niveluri de preț și acceptă facturarea lunară sau abonamentele anuale cu o reducere de 20%. Aceste niveluri sunt:

• Gratuit – Evaluat pentru uz personal, încă obțineți un kilometraj bun cu 25.000 de solicitări lunare pentru geocodare înainte și inversă, afișate în format JSON. Nu beneficiați de multe funcții avansate sau de asistență pentru clienți, dar v-am arătat deja ce resursă valoroasă este pagina lor de documentație. Acest nivel este gratuit și fără obligații – nici măcar nu trebuie să furnizați detaliile cardului de credit pentru a începe.
• Basic – Pachetul comercial de nivel de intrare. Abonații de bază își multiplică de patru ori cota lunară la 100.000 de solicitări de geocodare, plus au acces la funcții avansate precum criptarea HTTPS, mai multe opțiuni de ieșire (JSON, XML, GeoJSON), hărți încorporabile, mai multe limbi și multe altele. Obțineți o licență comercială Positionstack pentru doar 9,99 USD pe lună.
• Professional – cea mai populară ofertă de la Positionstack, nivelul Professional oferă o creștere de zece ori a solicitărilor de geocodare – până la 1.000.000 pe lună. Toate bunătățile de la nivelul de bază sunt prezente și apoi unele, inclusiv solicitările de loturi pentru aplicații grele. Acest nivel costă 49,99 USD pe lună.
• Afaceri – Trecând la performanța la scară de întreprindere, nivelul Business crește cota lunară la 3.000.000 de solicitări. Încă o dată, fiecare funcție avansată este complet disponibilă, susținută de echipa pasionată de asistență pentru clienți Positionstack pentru a vă ajuta să profitați la maximum de ele. 99,99 USD pe lună.
• Enterprise – Acesta este nivelul în care ofertele standard ies pe fereastră, iar clientul este rege. Aveți nevoi precise care necesită soluții personalizate, iar Positionstack este gata să vă atingă obiectivele. Îți dictați cererile lunare de volum, chiar și (mai ales) dacă sunt variabile. Aveți nevoie de mai mulți cai putere de la API? Apelați la asistență pentru soluții personalizate. Contactați Positionstack pentru o ofertă.

Verdict

Positionstack face exact ceea ce și-a propus: să reducă geocodarea la nivel de întreprindere de la punctele de preț, altfel în afara bugetului, către 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 de programare majore pentru utilitate maximă. Numărul de solicitări pe care Positionstack le gestionează în mod obișnuit este uimitor, în timp ce setul de date este întreținut inteligent pentru o acoperire cu adevărat globală în geocodare în timp real. Dacă ești pe piață pentru acest tip de produs, nu dormi pe Positionstack.

Ce fel de integrare ai planificat? Cum vei folosi geocodarea în afacerea ta? Aveți întrebări sau comentarii despre Positionstack? Lăsați-ne o notă în comentarii de mai jos.