Nemokamai gaukite įmonės lygio geodeziją naudodami „Positionstack“ API (APŽVALGA)

Jei norite gauti naudos iš geokodavimo, jūs neprivalote būti „Google Maps“. Ir „Positionstack“ dėka jums taip pat nereikia „Big G“ technologijų biudžeto. Šiandien apžvelgiame patikimą „Positionstack“ API, kuria siekiama, kad įmonės lygio pirmyn ir atgal geografinis kodavimas būtų labai prieinamas ir tinkamas naudoti.

„Positionstack 101“

Taigi, kodėl turėtumėte nerimauti skaitant daugiau nei 2 000 žodžių Padėties kaminas, o ką jūs galite gauti? Atsakymas skamba mielai, bet tikslus: visas pasaulis.

Trumpam apsvarstykite, kiek vietų yra pasaulio žemėlapyje. Dabar padauginkite tą skaičių savo galvoje iš kiekvieno metaduomenų rinkinio, kurį jūsų verslas turi žinoti apie tas vietas. Štai ką siūlo „Positionstack“, o po to kai kuriuos.

Pažvelkime į trumpą „Positionstack“ statistiką:

• Faktiniai milijardai geokodavimo užklausų, apdorojamų kiekvieną valandą, kiekvieną dieną; su 100% veikimo laiku ir <100 ms reakcijos laikų
• Debesų pagrindu sukurta, labai keičiama infrastruktūra
• Realiojo laiko duomenys apie kiekvieną pasaulio šalį, kaupiami į pralaidų duomenų rinkinį, kuris atnaujinamas kas kelias valandas
  instagram viewer
• Dosniai paskirstomi, konkurencingomis kainomis prenumeratos planai; plius neprilygstama 10 000 užklausų mėnesinė kvota nemokamiems vartotojams
• Visų pagrindinių programavimo kalbų integracijos palaikymas
• Išsami, lengvai skaitoma dokumentacija su kodo fragmentais
• Pasaulinės klasės klientų pasitenkinimo komanda, turinti patirties aptarnaujant tokius klientus kaip „Zendesk“, „Slack“, „LinkedIn“, „Lyft“, „Apple“ ir „Amazon“.

„Positionstack“ kilmės istorija tikrai yra patikrinta, tačiau tuo atveju, jei jūsų neįtikina keli kulkos punktai, įsigilinkime į tai, ką norėtume iš tikrųjų naudoti API.

„Positionstack“ 3 žingsnių greito pradžios vadovas

Jei praleisite bet kurį laiką jų svetainėje, pamatysite, kad „Positionstack“ iš tikrųjų pabrėžia paprastumą naudoti kaip pagrindinį pardavimo tašką jų API. Registracijos metu iškart pamatysite, kad tai tiesa. Tiesą sakant, pirmas dalykas, kurį matote įvedęs savo paskyros kredencialus, yra greitas veiksmų planas, kurio reikia norint pradėti naudotis „Positionstack“ ir atlikti tris paprastus veiksmus. Pažiūrėkime:

1. Nustatykite savo API prieigos raktą - Pagal numatytuosius nustatymus jums suteikiamas prieigos raktas, kuris yra pasirengęs išeiti iš dėžutės. Tačiau, jei reikia, galite lengvai tai atkurti.
2. Pasirinkite API galinius taškus - Mes išsamiau apžvelgsime API galinius taškus kitame skyriuje, tačiau kol kas tiesiog supraskite, kad šis veiksmas susijęs su konfigūravimu, kokio tipo duomenys grąžinami, kai jūsų programa pateikia užklausą „Positionstack“. Čia pirmiausia pamatysite pagrindinį URL, kuriuo nukreipiate savo užklausas, tačiau jis taip pat rodomas dokumentuose. Galiausiai matome pavyzdinę API užklausą, kurią sudaro tik kelios paprastos kodo eilutės.
3. Programų integracija - Paskutinis veiksmas susijęs su galutine „Positionstack“ API integracija į jūsų programą. Žinoti apie šį procesą yra gana daug, o dauguma jo aprašyta dokumentuose. Svarbus dalykas yra tas, kad „Positionstack“ palaikymo komanda turi jūsų nugarą ir pasiūlys tiek daug, kiek mažai pagalbos, reikalingos konfigūruoti ir integruoti jų API į jūsų programą.

Gana lengva, tiesa? Iš pradžių gali atrodyti, kad API be baimių IT žinių žmonėms gąsdina. Bet iškart po šikšnosparnio „Positionstack“ paguos jus žinodamas, kad tai ne tik lengva, bet ir padės jums kartu su neįtikėtinu jų intelektualaus dizaino dokumentais. Tai padeda jiems turėti aistringą ekspertų komandą, pasirengusią padėti ir jums.

„Positionstack“ informacijos suvestinė

Padvigubindami savo pagrindinę vertę - patogumą vartotojui, „Positionstack“ siūlo supaprastintą, neužterštą prietaisų skydelį, iš kurio galite pasiekti viską, ką reikia žinoti apie savo API. Pažvelkime į šoninės juostos parinktis:

• Prietaisų skydelis - Čia rasite pranešimus (paprastai įspėjančius, kai peržengsite tam tikras naudojimo ribas), tada pateiksite nuorodas į 3-ių žingsnių greito paleidimo vadovą ir jų dokumentacijos puslapį. Čia taip pat yra jūsų API rakto, dabartinės prenumeratos, paskyros informacijos ir mokėjimo metodo apžvalga.
• Naujovinimas / prenumerata - Savo abonementą galite pakeisti naudodami bet kurią iš šių dviejų parinkčių. Naujovinkite bet kuriuo metu, tačiau jei norite perjungti mėnesio ar metinį planą abiem kryptimis, pirmiausia turėsite pereiti prie nemokamos paskyros, tada pasirinkti norimą parinktį. „Positionstack“ palaikymo tarnyba nori padėti, jei jums reikia pagalbos tai padarant.
• Sąskaita / mokėjimas - Tai savaime suprantama; bet kuriame skirtuke galėsite bet kada atnaujinti kredencialus. Reikia pasakyti, kad mes suprantame, kad jie nepameta šių pagrindinių valdiklių per daug suplanuotoje, prašmatnioje sąsajoje. WYSIWYG.
• API naudojimas - Tikėtina, kad dažniausiai peržiūrėsite skirtuką, čia galite sužinoti, kiek mėnesio užklausos kvotos suvalgėte iki šiol. Taip pat yra patogus skyrius, kuriame rodoma naudojimo statistika per tam tikrą laiką, kad galėtumėte atitinkamai pakoreguoti savo strategiją.

API dokumentacija

Dabar mes žiūrime į „Positionstack“ pasiūlymą: API dokumentacija. Apsvarstykite šį puslapį savo vartotojo vadove, kuriame išsamiai aprašoma kiekviena API baigtis, jų parametrai ir kokia informacija jie bus grąžinti.

Šis puslapis yra suskaidytas į penkias skirtingas dalis. Mes peržvelgsime kiekvieną, praleisdami šiek tiek laiko ir žodžių, kad pateiktume kontekstą, kad galėtumėte geriau suprasti, ką rasite.

Darbo pradžia

Čia rasite pagrindinės funkcijos kurie taikomi kiekvienai užklausai, kurią pateikiate naudodami „Positionstack“. Šitie yra:

• API raktas - Jūsų API raktas yra tarsi skaitmeninis pasas, kurį naudosite prieigai prie „Positionstack“ duomenų rinkinio. Be jo API jums nenaudinga. Jei manote, kad tai buvo pažeista, galite lengvai pasukti seną raktą naujam.
• Šifravimas - 256 bitų SSL šifravimas naudojamas visame internete. Tai yra svarbiausias pramonės saugumo standartas. Nors jums reikės pagrindinio plano ar geresnio, norint užšifruoti programos ryšius su „Positionstack“ serveriais, verta vien tik investuoti. Norėdami sukelti šifravimą, tiesiog pakeiskite HTTP į HTTPS API baziniame URL. Paprasta!
• JSON atgalinis ryšys - Mes neįsigilinsime į per daug techninės informacijos apie tai, kaip tai veikia, tačiau jei jūsų API užklausoms netaikoma tos pačios kilmės politika, naudodamiesi JSON atšaukimais siekiate pakeisti sprendimą. Iš esmės reikalaujate duomenų iš išorinio scenarijaus, kuriame netrukdoma spręsti kelių domenų problemas.
• API klaidos - Kaip ir bet kada, kartais jūsų API užklausose bus klaidų. „Positionstack“ tai supranta ir į jų programą įtraukė pranešimų apie klaidas funkciją, kad padėtų nustatyti, kas nutiko. API užklausos nesėkmės automatiškai grąžins klaidos objektą JSON formatu, pridėdami kodą, pranešimą ir kontekstinius sub-objektus, kad būtų pateiktas klaidos kontekstas.

API galiniai taškai

Šiame skyriuje aprašoma „Positionstack“ mėsos ir bulvių funkcija, tai yra, pirmyn ir atgal, geografinis kodavimas. Jei nesate 100% tikri, koks skirtumas, pagalvokite apie geokodavimą kaip dvipusę gatvę, kur galite versti vietos ir adresai, parašyti paprasta anglų kalba, į vietos duomenis, tokius kaip koordinatės ir IP adresai, ir atvirkščiai.

Taigi, norėdami konvertuoti Eifelio bokšto vietą į koordinates, naudosite nukreipimą į priekį. Panašiai galite sužinoti gatvės adresą, susietą su IP adresu, naudodamiesi atvirkštiniu geokodu. Juk gana paprasta!

Pirmyn / atgal geokodavimo užklausos

Norėdami pateikti pagrindinę užklausą dėl bet kokio geografinio kodo tipo, turėsite pridėti atitinkamą baigtį (/forward arba /reverse) į pagrindinį API URL. Tada pateiksite prieigos raktą, tada atlikite a užklausa naudojant paprasto angliško buvimo vietos adresą arba atitinkamus vietos duomenis - ir, voila! Tai atrodys maždaug taip:

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

arba

https://api.positionstack.com/v1/reverse? „access_key = YOUR_ACCESS_KEY“ ir užklausa = 40.7638435, -73,9729691. 

Žinoma, „Positionstack“ duomenų rinkinyje yra daug, daug daugiau, nei tik adresai ir koordinatės. Šias kitas kategorijas galite analizuoti naudodami įvairius parametrus. Štai pavyzdys, kaip: pirmyn geokodavimas Prašymas, pateikiant užklausą dėl Baltųjų rūmų, atrodo taip:

{"duomenys": {"rezultatai": [{"platuma": 38.897675, "ilguma": -77.036547, "etiketė": "1600 Pennsylvania Avenue NW, Vašingtonas, DC, JAV", "name": "1600 „Pennsylvania Avenue NW“, „type“: „address“, „number“: „1600“, „street“: „Pennsylvania Avenue NW“, „postal_code“: „20500“, „confidence“: 1, „region“: „ Rajonas of Columbia “,„ region_code “:„ DC “,„ Administrative_area “: nulis,„ kaimynystė “:„ White House Grounds “,„ country “:„ United States “,„ country_code “:„ US “, "map_url": " http://map.positionstack.com/38.897675,-77.036547" } ] } }

Įdomu, jei jūs darytumėte a atvirkštinis geokodavimas jei naudosite apytiksles Baltųjų rūmų koordinates, grąžinti rezultatai atrodys beveik identiški, išskyrus atvejus, kai matysite atstumas tarp jūsų ir oficialių Baltųjų rūmų koordinačių, kaip jie yra „Positionstack“ duomenų rinkinyje.

Šio panašumo priežastis yra ta, kad abu galiniai taškai naudoja tą patį GET parametrų masyvą ir todėl gali grąžinti (beveik) tuos pačius atsakymo objektus. Tai reiškia, kad nesvarbu, kokius pradinius duomenis turite pereiti, mainais galite gauti visą vietos duomenų rinkinį. (Šiuos rezultatus galima susiaurinti naudojant API laukai parametrą, bet paliesime tai daugiau vėliau.)

Pastaba: „Positionstack“ dokumentacijos puslapis išsamiai apibūdina kiekvieną parametrą ir atsakymo objektą, todėl būtinai patikrinkite!

Serijos užklausos

Paskutinė pagrindinė šio dokumentų rinkinio antraštė yra susijusi su: siuntos užklausos. Viskas, ką turite padaryti, yra paskambinti partija parametrą, tada įdėkite kelis užklausa egzempliorių (kartu su jūsų pageidaujamais parametrais), esančiais viename prašyme, o likusiais dalykais rūpinasi „Positionstack“ API. Jis yra miręs paprastas ir atrodo taip:

{"partija": [{"užklausa": "Pagrindinė gatvė", "šalis": "JAV", "regionas": "Minesota"}, {"užklausa": "Pagrindinė gatvė", „šalis“: „JAV“, „regionas“: „Ilinojus“}, {„užklausa“: „Pagrindinė gatvė“, „šalis“: „JAV“, „regionas“: „Misūris“} ] }

Išplėstiniai duomenys

Be pagrindinių vietos parametrų, galite dar labiau pritaikyti savo API užklausas, kad galėtumėte grąžinti daugiau išplėstiniai duomenys. Jie apima:

• Įterptieji žemėlapiai - Pateikia „map_url“ objektą, susietą su jūsų geografinio kodavimo rezultatu, kurį galite naudoti norėdami sukurti patrauklų vaizdinį žemėlapio vaizdą savo svetainėje ar programoje.
• Šalies modulis - Skirtingai nuo kitų parametrų, iš kurių gaunami keli atsakymo objektai, šalies modulis grąžina neįtikėtiną daugybę duomenų apie jūsų užklausą šalį. Tai taip pat nėra tik koordinatės ir adresai; tai sostinė, vėliava, oficialus pavadinimas, šalies, neturinčios priėjimo prie jūros (arba ne), statusas, naudojamos valiutos, šnekamosios kalbos, telefono kodai ir kita.
• Saulės modulis - Juokingai, „Positionstack“ dokumentai apibūdina tai kaip „astrologinius“ duomenis. Neįtrauksite savo horoskopo su šiuo parametru, tačiau pamatysite duomenis apie tai, kada saulė kyla ir leidžiasi pagal astronominę, civilinę ir jūrinę chronologiją.
• Laiko juostos modulis - Prideda laiko juostos modulis grąžinti vietos GMT poslinkį per kelias sekundes arba kaip natūralios kalbos eilutė.
• Apribojimo dėžutės modulis - Jei viena x / y koordinačių pora netinka jūsų uždaviniui, pabandykite apjuosti langelį, kuris uždengia plotą su minimaliomis ir maksimaliomis ilgumos ir platumos vertėmis.

Papildomos parinktys

„Positionstack“ API turi daugybę duomenų, kad galėtų jus panaudoti, tačiau, laimei, ji suteikia papildomos priemonės valdyti šį informacijos srautą.

• Nurodykite reagavimo laukus - Mes išsamiai išsiaiškinome, kiek duomenų gali grąžinti „Positionstack“, tačiau atminkite, kad visi šie duomenys kainuoja. Jei norite apriboti mėnesines užklausas, galite tai padaryti naudodami laukai Pridedama laukai = results.flagpavyzdžiui, API sukels tik jūsų užklausos šalies vėliavą. Galite pasikviesti laukai tiek kartų, kiek reikia norint gauti konkretų duomenų rinkinį, kurio jums reikia.
• Nurodykite išvesties formatą - Nemokami prenumeratoriai gali naudotis tik JSON formatu, už kuriuos grąžina geografinio kodavimo rezultatus. Tačiau mokantys klientai gali pateikti apeliaciją išėjimas esant jų prašymams nurodyti JSON, XML arba GeoJSON.

Kodo pavyzdžiai

Kai „Positionstack“ sako, kad jie jums padės, jie turi tai omenyje. Mes jau matėme, kokia kruopšti jų dokumentacija, tačiau jie patogu kodo pavyzdžiai visomis kalbomis, kurias palaiko jų API. Neketinsime nukopijuoti / įklijuoti to kodo čia, tačiau norint greitai sužinoti, šios kalbos yra:

• Python
• Nodejai
• jQuery
• Eik
• Rubinas

Įrodymas ir atlikimas

Šiuo metu turėtų būti aišku, kad „Positionstack“ sugeba gana daug. Bet, kaip gerai ar tai daro šie dalykai?

Pirmiausia panagrinėkime kontekstą. „Positionstack“ yra viena iš daugiau nei 20 API mikropaslaugų „Apilayer“ debesų ekosistemoje. Kartu šios API aptarnauja daugiau nei milijoną B2B klientų nuo pradedančiųjų iki verslo pradžios. Tarp žymiausių jų klientų yra „Amazon“, „Apple“, „Slack“, „LinkedIn“ ir daugybė kitų namų ūkio vardų. Akivaizdu, kad jie turi patikimą infrastruktūrą, kad galėtų patenkinti tokio masto paklausą.

Dėl savo nuopelnų „Positionstack“ gyvena pagal savo kilmę ir yra neįtikėtinai 100% veiksminga visą 2020 m. Rašymo metu. Tai dar įspūdingesnė, kai atsižvelgiama į API įprasta per dieną apdoroja daugiau nei milijardą geokodo paieškų per vieną banginių klientą, jau neminint svaiginančio masyvo vienalaikių užklausų iš jų stabilių mažų ir vidutinių įmonių klientų. Be to, į šias užklausas atsakymai paprastai būna nuo 10 iki 100 ms.

Mūsų knygoje tai yra kažkas technologinio stebuklo, ypač atsižvelgiant į tai, kokia agresyvi kaina yra šis „SaaS“ pasiūlymas.

„Positionstack“ yra patrauklus ne tik neapdorotas galingumas. Jų duomenų rinkinys yra tikrai sudėtingas, gaunamas iš patikimų vardų, tokių kaip „Nominatim“, „GeoNames“, „Pelias“ ir „OpenStreetMap“. „Positionstack“ kelis kartus per dieną kryžminiu būdu patikrina, filtruoja ir rekombinuoja šią gausybę duomenų, reguliariai atnaujindama naudodamiesi išmaniaisiais algoritmais, užtikrinančiais, kad visada turite labai tikslius vietos duomenis bet kurioje pasaulio vietoje ir realioje vietoje laikas.

Mes nekenčiame sugadinti savo galutinio verdikto, tačiau jei jūs ieškote tvirto, keičiamo geodezinio sprendimo, „Positionstack“ atnaujintame pranešime reikia atidžiau pažvelgti.

Kainodara

„Apilayer“ ketino pasiūlyti prieinamą alternatyvą labai brangiai kainuojančiai įmonės lygio programinės įrangos geodezijai, ir tuo tikslu jai pasisekė.

„Positionstack“ yra penki kainodara pakopas ir palaiko mėnesinį atsiskaitymą arba metines prenumeratas su 20% nuolaida. Šios pakopos yra:

• Laisvas - Skirtas asmeniniam naudojimui, jūs vis dar pasiekiate nemažai ridos, gaudami 25 000 mėnesinių užklausų dėl pirmyn ir atgal nukreipto geoko kodavimo, išvedamos JSON formatu. Jūs negaunate daug patobulintų funkcijų ar klientų palaikymo, tačiau jau parodėme, koks vertingas šaltinis yra jų dokumentacijos puslapis. Ši pakopa yra nemokama ir neprivaloma - norint pradėti, jums net nereikia pateikti kreditinės kortelės informacijos.
• Pagrindinis - Pradinio lygio komercinis paketas. Pagrindiniai abonentai keturis kartus padidina savo mėnesinę kvotą iki 100 000 geografinio kodavimo užklausų ir gauna prieigą prie pažengusiųjų tokias funkcijas kaip HTTPS šifravimas, kelios išvesties parinktys (JSON, XML, GeoJSON), įterpiami žemėlapiai, kelios kalbos, ir dar. Gaukite komercinę „Positionstack“ licenciją tik už 9,99 USD per mėnesį.
• Profesionalus - Populiariausias „Positionstack“ pasiūlymas - „Professional“ pakopa siūlo dešimteriopai padidinti geokodavimo užklausas - iki 1 000 000 per mėnesį. Pateikiamos visos pagrindinės pakopos gėrybės, o vėliau ir kai kurios, ypač partijos užklausos dėl sunkiųjų programų. Šios pakopos įmoka siekia 49,99 USD per mėnesį.
• Verslas - Pereinant prie įmonės masto veiklos, verslo pakopos balionuoja mėnesinę kvotą į milžinišką 3.000.000 užklausų skaičių. Vėlgi, kiekviena patobulinta funkcija yra visiškai prieinama, palaikoma aistringos „Positionstack“ klientų palaikymo komandos, kuri padės jums maksimaliai išnaudoti visas jų galimybes. 99,99 USD per mėnesį.
• Įmonės - Tai yra pakopa, kurioje standartiniai pasiūlymai išeina pro langą, o klientas yra karalius. Jūs turite tikslius poreikius, kuriems reikia pasirinktinių sprendimų, ir „Positionstack“ yra pasirengusi pasiekti savo tikslus. Jūs diktuojate mėnesio apimties užklausas, net (ypač), jei jos kintamos. Reikia daugiau arklio galių iš API? Kreipkitės į palaikymą pagal užsakymą pagamintus sprendimus. Norėdami gauti pasiūlymą, susisiekite su „Positionstack“.

Verdiktas

„Positionstack“ daro tiksliai tai, ką užsibrėžė daryti: daugeliui mažų ir vidutinių įmonių mažindama įmonės lygio geodeziją nuo kainų taškų, kitaip nesinaudodama biudžetu, neprarandant rezultatų. Jų API yra gerai dokumentuota ir lengvai naudojama, tačiau pasižymi tvirta integracija į visas pagrindines programavimo kalbas, kad būtų maksimaliai naudinga. „Statusstack“ įprastinių rankenų užklausų skaičius yra stulbinantis, o jų duomenų rinkinys yra protingai prižiūrimas, kad realiu laiku būtų galima atlikti geografinį kodavimą. Jei esate šio tipo produktų rinkoje, nemiegokite „Positionstack“.

Kokią integraciją planuoji? Kaip naudosite geodezinį kodą savo versle? Ar turite klausimų ar komentarų apie „Positionstack“? Palikite mums komentarą žemiau.