Uzņēmuma līmeņa ģeokodēšana bez maksas, izmantojot Positionstack API (REVIEW)

Lai gūtu labumu no ģeokodēšanas, jums nav jābūt Google Maps. Un, pateicoties Positionstack, arī jums nav nepieciešams Big G tehnoloģiju budžets. Šodien mēs pārskatām Positionstack spēcīgo API, kuras mērķis ir padarīt uzņēmuma līmeņa priekšu un atpakaļejošu ģeogrāfisko kodēšanu gan ļoti pieejamu, gan izmantojamu.

Positionstack 101

Tātad, kāpēc jums vajadzētu uztraukties lasīt vairāk nekā 2000 vārdu pārskatu vietnē Stāvoklis, un ko jūs varat gūt? Atbilde izklausās glīta, bet precīza: visa pasaule.

Uz brīdi apsveriet, cik daudz vietu ir pasaules kartē. Tagad reiziniet šo numuru galvā ar katru metadatu, kas jūsu uzņēmumam jāzina par šīm vietām. Tas ir tas, ko piedāvā Positionstack, un pēc tam daži.

Apskatīsim dažus īsus statistikas datus par Positionstack:

• Faktiskie miljardi ģeokodēšanas meklēšanas pieprasījumu tiek apstrādāti katru stundu, katru dienu; ar 100% uptime un <100ms reakcijas laiku
• Mākoņu balstīta, ļoti mērogojama infrastruktūra
• Reālā laika dati par katru pasaules valsti, apkopoti kavernozā datu kopā, kas tiek atjaunināta ik pēc dažām stundām
instagram viewer
• Pateicīgi abonēšanas plāni, par konkurētspējīgu cenu; plus nepārspējama ikmēneša kvota 10000 lietotājiem bez maksas
• Integrācijas atbalsts visām galvenajām programmēšanas valodām
• Visaptveroša, viegli lasāma dokumentācija ar koda fragmentiem
• Pasaules klases klientu apmierinātības komanda ar pieredzi tādu klientu apkalpošanā kā Zendesk, Slack, LinkedIn, Lyft, Apple un Amazon

Positionstack ciltsgrāmata noteikti ir pārbaudīta, taču, ja jūs nepārliecina nedaudz aizzīmju punktu, tad nopietni padomājiet par to, ko vēlētos izmantot API.

Positionstack 3-soļu ātrā starta rokasgrāmata

Ja jūs kādu laiku pavadāt viņu vietnē, redzēsit, ka Positionstack patiešām uzsver lietošanas vienkāršību kā galveno viņu API pārdošanas punktu. Reģistrēšanās laikā jūs uzreiz redzēsit, ka tā ir taisnība. Faktiski pirmā lieta, ko redzat pēc konta akreditācijas datu ierakstīšanas, ir ātrs ceļvedis par to, kas nepieciešams, lai izveidotu un darbotos ar Positionstack trīs vienkāršās darbībās. Apskatīsim:

1. Iestatiet API piekļuves atslēgu - Pēc noklusējuma jums tiek izsniegta piekļuves atslēga, kas ir gatava iziet no kastes. Tomēr pēc nepieciešamības varat to viegli atiestatīt.
2. Izvēlieties API galapunktus - Nākamajā sadaļā mēs sīkāk aplūkojam API parametrus, bet pagaidām vienkārši saprotiet, ka šis solis attiecas uz tā konfigurēšanu, kāda veida dati tiek atgriezti, kad jūsu lietotne iesniedz pieprasījumu Positionstack. Šeit jūs vispirms redzēsit pamata URL, uz kuru jūs adresējat savus pieprasījumus, bet tas ir redzams arī dokumentācijā. Visbeidzot, mēs redzam API pieprasījuma paraugu, kas sastāv tikai no dažām vienkāršām koda rindām.
3. Lietojumprogrammu integrācija - pēdējais solis attiecas uz Positionstack API galīgo integrāciju jūsu lietojumprogrammā. Par šo procesu ir jāzina daudz, un lielākā daļa no tā ir aprakstīta dokumentācijā. Svarīga lieta šeit ir: Positionstack atbalsta komandai ir jūsu aizmugure, un tā piedāvās tik daudz vai tik mazu palīdzību, kāda jums nepieciešama, lai konfigurētu un integrētu viņu API savā lietotnē.

Diezgan viegli, vai ne? Sākumā API var šķist iebiedējoši bez plašām IT zināšanām. Bet uzreiz pie nūjas, Positionstack jūs mierina, zinot, ka tas ir ne tikai viegli, bet arī palīdzēs, izmantojot ceļu, neticami dokumentējot viņu viedo dizainu. Tas viņiem palīdz ar aizrautīgu ekspertu komandu, kas ir gatava arī jums palīdzēt.

Jūsu Positionstack informācijas panelis

Divkāršojot to par galveno draudzīgumu lietotājam, Positionstack piedāvā racionalizētu, nepiesārņotu informācijas paneli, no kura varat piekļūt visam, kas jums jāzina par savu API. Apskatīsim sānjoslas iespējas:

• Mērinstrumentu panelis - Šeit atradīsit paziņojumus (parasti tas brīdina jūs, pārsniedzot noteiktus lietošanas sliekšņus), pēc tam saites uz 3-pakāpju ātrās sākšanas rokasgrāmatu un to dokumentācijas lapu. Šeit ir arī pārskats par jūsu API atslēgu, pašreizējo abonementu, konta informāciju un maksājuma veidu.
• Jaunināšana / abonēšana - Abonementu varat mainīt, izmantojot jebkuru no šīm divām iespējām. Jaunināt jebkurā laikā, lai gan, ja vēlaties pārslēgties starp mēneša vai gada plānu abos virzienos, jums vispirms būs jāmaina uz bezmaksas kontu un pēc tam jāizvēlas vajadzīgā opcija. Positionstack atbalsts ir gatavs jums palīdzēt, ja jums ir nepieciešama palīdzība to darot.
• Konts / maksājums - tie ir pašsaprotami; jebkura no cilnēm ļaus jums jebkurā laikā atjaunināt savus akreditācijas datus. Jāsaka, ka mēs novērtējam, ka viņi šīs pamata vadības ierīces neapglabā pārāk izstrādātā, bezgaumīgā saskarnē. WYSIWYG.
• API izmantošana - Iespējams, cilne, kuru visbiežāk apmeklēsit, šeit varat uzzināt, cik daudz no jūsu ikmēneša pieprasījuma kvotas esat apēdis. Šeit ir arī ērta sadaļa, kurā parādīta lietošanas statistika laika gaitā, lai jūs varētu attiecīgi pielāgot savu stratēģiju.

API dokumentācija

Tagad mēs nonākam pie Positionstack piedāvājuma sirds un dvēseles: API dokumentācija. Apsveriet šo lapu kā jūsu tiešā lietotāja rokasgrāmatu, kurā ir sīki aprakstīts katrs API galapunkts, to parametri un kāda veida informācija viņi atgriezīsies.

Šī lapa ir sadalīta piecās dažādās sadaļās. Mēs pārdomāsim katru, veltot laiku un liekulības, lai sniegtu jums kontekstu, lai jūs varētu labāk izprast, ko atradīsit.

Darba sākšana

Šeit jūs atradīsit pamatfunkcijas kas attiecas uz katru pieprasījumu, ko iesniedzat ar Positionstack. Šie ir:

• API atslēga - Jūsu API atslēga ir kā digitālā pase, kuru izmantosit, lai piekļūtu Positionstack datu kopai. Bez tā API jums ir bezjēdzīga. Ja uzskatāt, ka tas ir ticis apdraudēts, varat viegli pagriezt veco atslēgu pret jaunu.
• Šifrēšana - Visā internetā tiek izmantota 256 bitu SSL šifrēšana, un tā ir laba nozares drošības standarts pamatota iemesla dēļ. Lai gan jums būs nepieciešams pamatplāns vai labāks, lai šifrētu savas lietotnes sakarus ar Positionstack serveriem, tas ir ieguldījuma vērts pats par sevi. Lai izsauktu šifrēšanu, vienkārši mainiet HTTP uz HTTPS API bāzes URL. Vienkārši!
• JSON atzvanīšana - Mēs neiedziļināsimies pārāk daudzās tehniskajās detaļās, kā tas darbojas, taču, ja jūsu API pieprasījumus aizkavē vienas un tās pašas izcelsmes politikas, jūs izmantojat JSON atzvanīšanas, lai ietekmētu izvairīšanās problēmu. Būtībā jūs pieprasāt datus no ārēja skripta, kas nav saistīts ar starpdomēnu problēmām.
• API kļūdas - Tāpat kā jebkas cits, dažreiz jūsu API pieprasījumos būs kļūdas. Positionstack to saprot un savā lietotnē ir iebūvējis kļūdu ziņošanas funkciju, lai palīdzētu noteikt, kas nogājis greizi. API pieprasījuma kļūmes automātiski atdos kļūdas objektu JSON formātā, kā arī kodu, ziņojumu un konteksta apakšobjektus, lai nodrošinātu kļūdas kontekstu.

API galapunkti

Šajā sadaļā dokumentēta Positionstack gaļas un kartupeļu funkcionalitāte, tas ir, priekšu un atpakaļgaitas ģeokodēšana. Ja neesat 100% pārliecināts, kāda ir atšķirība, domājiet par ģeokodēšanu kā divvirzienu ielu, kur var tulkot vietas un adreses, kas rakstītas vienkāršā angļu valodā, ar atrašanās vietas datiem, piemēram, koordinātām un IP adresēm, un visaptveroši.

Tātad, lai pārveidotu Eifeļa torņa atrašanās vietu koordinātēs, jūs izmantojāt priekšu ģeokodēšanu. Līdzīgi, izmantojot reverso ģeokodēšanu, varat uzzināt ar IP adresi saistīto ielas adresi. Galu galā diezgan vienkārši!

Uz priekšu / atpakaļejoši ģeokodēšanas pieprasījumi

Lai iesniegtu pamatprasību par jebkura veida ģeokodēšanu, jums būs jāpievieno atbilstošais beigu punkts (/forward vai /reverse) uz API bāzes URL. Pēc tam jūs norādīsit piekļuves atslēgu un pēc tam izveidosit a vaicājums izmantojot vai nu vienkāršas angļu valodas atrašanās vietas adresi vai tai atbilstošos atrašanās vietas datus, un, voila! Tas izskatīsies apmēram šādi:

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

vai

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

Protams, Positionstack datu kopā ir daudz, daudz vairāk nekā tikai adreses un koordinātas. Šīs citas kategorijas var parsēt, izmantojot dažādus parametrus. Šeit ir piemērs tam, kas: priekšu ģeokodēšana pieprasījums, vaicājot Baltajam namam, izskatās šādi:

{"dati": {"rezultāti": [{"platums": 38.897675, "garums": -77.036547, "etiķete": "1600 Pennsylvania Avenue NW, Vašingtona, DC, ASV", "name": "1600 Pennsylvania Avenue NW "," type ":" address "," number ":" 1600 "," street ":" Pennsylvania Avenue NW "," postal_code ":" 20500 "," confidence ": 1," region ":" " Apgabals Columbia "," region_code ":" DC "," Administrative_area ": nulle," apkārtne ":" White House Grounds "," country ":" United States "," country_code ":" US ", "map_url": " http://map.positionstack.com/38.897675,-77.036547" } ] } }

Interesanti, ja jums būtu jādara a reversā ģeokodēšana izmantojot Baltā nama aptuvenās koordinātas, atgrieztie rezultāti izskatās gandrīz identiski, izņemot gadījumus, kad redzat atšķirību attālums starp jūsu koordinātām un Baltā nama oficiālajām koordinātām, kā tās parādās Positionstack datu kopā.

Šīs līdzības iemesls ir tas, ka abi parametri izmanto to pašu GET parametru masīvu, un tādējādi tie var atgriezt (gandrīz) tos pašus atbildes objektus. Tas nozīmē, ka neatkarīgi no sākuma datiem, kas jums jāiet, pretī varat saņemt pilnu atrašanās vietas datu komplektu. (Izmantojot API, šos rezultātus ir iespējams sašaurināt lauki parametru, bet mēs to vairāk skarsim vēlāk.)

Piezīme: Positionstack dokumentācijas lapā ir sīki aprakstīts katrs parametrs un atbildes objekts, tāpēc noteikti pārbaudiet to!

Partijas pieprasījumi

Šī dokumentācijas iestatījuma pēdējā galvenā sadaļa attiecas uz partijas pieprasījumi. Viss, kas jums jādara, ir - partija parametru, pēc tam ligzdu vairākus vaicājums gadījumus (kopā ar jūsu vēlamajiem parametriem) vienā pieprasījumā, un par pārējo rūpējas Positionstack API. Tas ir miris vienkāršs un izskatās šādi:

{"partija": [{"vaicājums": "Galvenā iela", "valsts": "ASV", "reģions": "Minesota"}, {"vaicājums": "Galvenā iela", "valsts": "ASV", "reģions": "Ilinoisa"}, {"vaicājums": "Galvenā iela", "valsts": "ASV", "reģions": "Misūri"} ] }

Papildu dati

Papildus pamata atrašanās vietas parametriem varat arī pielāgot API pieprasījumus, lai atgrieztos vairāk uzlaboti dati. Tie ietver:

• Iegultās kartes - Tiek atgriezts objekts map_url, kas saistīts ar jūsu ģeokodēšanas rezultātu, kuru varat izmantot, lai izveidotu pievilcīgu vizuālo kartes attēlojumu savā vietnē vai lietotnē.
• Valsts modulis - Atšķirībā no citiem parametriem, kas atgriežas līdz dažiem reakcijas objektiem, valsts_modulis atgriež neticamu datu klāstu par jūsu vaicāto valsti. Tas nav tikai koordinātas un adreses; tas ir galvaspilsēta, karogs, oficiālais nosaukums, valsts, kurai nav jūras (vai nav) valsts, izmantotās valūtas, runājamās valodas, izsaukuma kodi un daudz kas cits.
• Saules modulis - Jautri, Positionstack dokumentācija to raksturo kā “astroloģiskus” datus. Jūs nesaņemsit savu horoskopu ar šo parametru, bet jūs redzēsit datus par to, kad saule ceļas un riet, saskaņā ar astronomisko, civilo un navigācijas hronoloģiju.
• Laika joslas modulis - Papildināt laika josla_modulis lai atgrieztu atrašanās vietas GMT nobīdi pēc dažām sekundēm vai kā dabiskas valodas virkne.
• Iesiešanas kastes modulis - Ja viens x / y koordinātu pāris nav piemērots jūsu uzdevumam, izmēģiniet ierobežojošo lodziņu, kurā ir apgabals ar minimālo un maksimālo garuma un platuma vērtību.

Papildu iespējas

Positionstack API ir ļoti daudz datu, kas jums noder, taču par laimi tas jūs nodrošina papildu rīki pārvaldīt šo informācijas trūkumu.

• Norādiet atbildes laukus - Mēs esam padziļināti izpētījuši, cik daudz datu Positionstack var atgriezt, taču ņemiet vērā, ka visi šie dati ir par maksu. Ja vēlaties ierobežot ikmēneša pieprasījumus, varat to izdarīt ar lauki Papildinot lauki = results.flagpiemēram, API liks izvadīt tikai jūsu pieprasītās valsts karogu. Jūs varat atsaukties lauki tik reižu, cik nepieciešams, lai iegūtu nepieciešamo datu kopu.
• Norādiet izvades formātu - Bezmaksas abonentu atgriezeniskās ģeogrāfiskās kodēšanas rezultātu ierobežojums ir JSON formāts. Maksājoši klienti tomēr var pievienot izlaide pēc viņu pieprasījuma pēc vajadzības norādīt JSON, XML vai GeoJSON.

Kodu piemēri

Kad Positionstack saka, ka viņi ir šeit, lai jums palīdzētu, viņi to domā. Mēs jau esam redzējuši, cik pilnīga ir viņu dokumentācija, taču viņi to papildina ar ērtībām koda piemēri visās valodās, ko atbalsta viņu API. Mēs šeit nekopēsim / ielīmēsim šo kodu, bet, lai ātri uzzinātu, šīs valodas ir:

• Python
• Nodejs
• jQuery
• Ej
• Rubīns

Pierādījums un izpildījums

Šajā brīdī vajadzētu būt skaidram, ka Positionstack ir spējīgs izdarīt diezgan daudz. Bet, cik labi vai tas dara šīs lietas?

Vispirms apskatīsim kādu kontekstu. Positionstack ir viens no vairāk nekā 20 API mikropakalpojumiem Apilayer mākoņu bāzes ekosistēmā. Šīs API kopā apkalpo vairāk nekā miljonu B2B klientu no jaunizveidotiem uzņēmumiem līdz pat uzņēmumam. Daži no viņu ievērojamākajiem klientiem ietver Amazon, Apple, Slack, LinkedIn un daudzus citus mājsaimniecības nosaukumus. Skaidrs, ka viņi ir ieguvuši stabilu infrastruktūru, lai izturētu šo pieprasījuma apmēru.

Pēc saviem nopelniem Positionstack ievēro savu ciltsrakstu, un rakstīšanas laikā tas ir neticami 100% izmantojams visā 2020. gadā. Tas ir vēl iespaidīgāk, ja ņem vērā API regulāri dienā apstrādā vairāk nekā miljardu ģeokodeksa meklējumu vienam vaļu klientam, nemaz nerunājot par reibinošo masīvu vienlaicīgu pieprasījumu, kas nāk no viņu mazajiem un vidējiem klientiem stabilajiem. Turklāt šie pieprasījumi parasti sniedz atbildes no 10 līdz 100 ms.

Mūsu grāmatā tas ir kaut kas tehnoloģisks brīnums, it īpaši ņemot vērā, cik agresīvs šis SaaS piedāvājums ir cenu ziņā.

Ne tikai neapstrādāts spēks padara Positionstack tik pievilcīgu. Viņu datu kopa ir patiesi izsmalcināta, to iegūst no uzticamiem nosaukumiem, piemēram, Nominatim, GeoNames, Pelias un OpenStreetMap. Positionstack salīdzina, filtrē un rekombinē šo datu bagātību vairākas reizes dienā, regulāri atjaunojot datus izmantojot viedos algoritmus, kas nodrošina, ka jums vienmēr ir ļoti precīzi atrašanās vietas dati jebkur pasaulē un reāli laiks.

Mēs ļoti vēlamies sabojāt mūsu galīgo spriedumu, bet, ja jūs meklējat stabilu, mērogojamu ģeokodēšanas risinājumu, tad Positionstack atsākšanai ir nepieciešama rūpīgāka izpēte.

Cenu noteikšana

Apilayer plānoja piedāvāt pieejamu alternatīvu ļoti dārgai uzņēmuma līmeņa ģeokodēšanas programmatūrai, un šajā nolūkā viņiem tas ir izdevies.

Positionstack nāk piecos cenu noteikšana līmeņi un atbalsta ikmēneša rēķinus vai gada abonementus ar 20% atlaidi. Šie līmeņi ir:

• Bezmaksas - Nomināls personīgai lietošanai, jūs joprojām saņemat nelielu nobraukumu, izmantojot JSON formātā izvadītus 25 000 ikmēneša pieprasījumus uz priekšu un atpakaļgaitā. Jūs nesaņemat daudz papildu funkciju vai klientu atbalsta, taču mēs jau parādījām, cik vērtīgs resurss ir viņu dokumentācijas lapa. Šis līmenis ir bezmaksas un bez saistībām - lai sāktu, jums pat nav jāsniedz kredītkartes informācija.
• Pamata - Sākuma līmeņa komercpakete. Pamata abonenti četrkāršo ikmēneša kvotu līdz 100 000 ģeokodēšanas pieprasījumu, kā arī iegūst piekļuvi uzlabotajiem tādas funkcijas kā HTTPS šifrēšana, vairākas izvades opcijas (JSON, XML, GeoJSON), iegultas kartes, vairākas valodas, un vēl. Iegūstiet komerciālu Positionstack licenci tikai par 9,99 USD mēnesī.
• Profesionāls - Positionstack vispopulārākais piedāvājums - profesionālais līmenis piedāvā desmitkārtīgu ģeokodēšanas pieprasījumu pieaugumu - līdz 1 000 000 mēnesī. Ir klāt visi pamata līmeņa labumi, pēc tam daži, jo īpaši ieskaitot partijas pieprasījumus lieljaudas lietojumiem. Šī līmeņa ienākumi mēnesī ir USD 49,99.
• Bizness - Piekļūstot uzņēmuma līmeņa sniegumam, biznesa līmenis ikmēneša kvotu palielina līdz milzīgajiem 3 000 000 pieprasījumiem. Atkal katra uzlabotā funkcija ir pilnībā pieejama, un to atbalsta Positionstack kaislīgā klientu atbalsta komanda, kas palīdzēs jums maksimāli izmantot visas iespējas. Mēnesī 99,99 USD.
• Uzņēmējdarbība - Šajā līmenī standarta piedāvājumi iziet pa logu, un klients ir karalis. Jums ir precīzas vajadzības, kurām nepieciešami pielāgoti risinājumi, un Positionstack ir gatavs sasniegt savus mērķus. Jūs diktējat ikmēneša apjoma pieprasījumus, pat (īpaši), ja tie ir mainīgi. Nepieciešams vairāk zirgspēku no API? Sazinieties ar atbalstu pēc pasūtījuma būvētiem risinājumiem. Lai uzzinātu cenu, sazinieties ar Positionstack.

Spriedums

Positionstack izdara tieši to, ko bija nolēmis darīt: vairumam mazo un vidējo uzņēmumu mazina uzņēmuma līmeņa ģeogrāfisko kodēšanu no cenu punktiem lielākajā daļā MVU, nezaudējot sniegumu. Viņu API ir labi dokumentēta un viegli lietojama, taču tai ir stabila integrācija visās galvenajās programmēšanas valodās, lai nodrošinātu maksimālu lietderību. Pieprasījumu skaits, kas parasti tiek izmantots pozīcijas statīvā, ir satriecošs, savukārt to datu kopa tiek gudri uzturēta, lai reāllaika ģeokodēšana būtu patiesi globāla. Ja atrodaties šāda veida produktu tirgū, nemiegojiet Positionstack.

Kādu integrāciju jūs plānojāt? Kā jūs savā uzņēmumā izmantosit ģeokodēšanu? Vai jums ir kādi jautājumi vai komentāri par Positionstack? Atstājiet mums piezīmi komentāros zemāk.