Hankige ettevõtte tasemel geokoodeerimine Positionstack API abil tasuta (REVIEW)

Geokoodide väärtuse saamiseks ei pea te olema Google Maps. Ja tänu Positionstackile pole teil selleks vaja ka Big G tehnoloogia eelarvet. Täna vaatame üle Positionstacki tugeva API-liidese, mille eesmärk on muuta ettevõtte tasemel edasisuunamise ja tagasikäigu geokoodeerimine ülimalt taskukohaseks ja kasutatavaks.

Positsioneer 101

Miks peaksite vaevama lugema üle 2000 sõna arvustust Positsioneer, ja mida sa võid võita? Vastus kõlab armsalt, kuid on täpne: kogu maailm.

Mõelge hetkeks, kui palju kohti on maailmakaardil. Nüüd korrutage see number peas iga metaandmetega, mida teie ettevõte peab nende kohtade kohta teadma. Seda pakub Positionstack ja seejärel mõni.

Vaatame lühikest statistikat Positionstacki kohta:

• Iga tund, iga päev töödeldakse tegelikke miljardeid geokoodide otsingutaotlusi; 100% tööajaga ja <100 ms reageerimisaegadega
• Pilvepõhine, väga skaleeritav infrastruktuur
• Reaalajas olevad andmed kõigi maailma riikide kohta, koondatud õõnsasse andmekogumisse, mida uuendatakse iga paari tunni tagant
instagram viewer
• Heldelt jagatud, konkurentsivõimelise hinnaga tellimisplaanid; pluss ületamatu 10 000 taotlusega kuukvoot tasuta kasutajatele
• Kõigi suuremate programmeerimiskeelte integratsioonitugi
• Põhjalik ja hõlpsasti loetav dokumentatsioon koos koodilõikudega
• Maailmatasemel klientide rahulolu meeskond, kellel on kogemusi selliste klientide teenindamisel nagu Zendesk, Slack, LinkedIn, Lyft, Apple ja Amazon

Positionstacki sugupuu on kindlasti kontrollimisel, kuid kui teid ei veena käputäis täppjaotusi, siis mõelgem sügavalt, mis tunne on tegelikult API kasutamist.

Positionstacki 3-etapiline kiire juhend

Kui veedate nende veebisaidil aega, näete, et Positionstack rõhutab nende API esmase müügiargumendina kasutamise lihtsust. Registreerumise ajal näete kohe, et see on tõsi. Tegelikult on esimene asi, mida pärast konto mandaadi sisestamist näete, kiire tegevuskava selle kohta, mida on vaja Positionstacki abil käivitamiseks ja käitamiseks kolmel lihtsal sammul. Vaatame:

1. Seadke oma API juurdepääsukood - Vaikimisi antakse teile juurdepääsuklahv, mis on valmis karbist välja minema. Selle saab aga vajaduse korral hõlpsalt lähtestada.
2. Valige API lõpp-punktid - Katame järgmises jaotises API-lõpp-punkte põhjalikumalt, kuid mõistame nüüd lihtsalt, et see samm viitab selle konfigureerimisele, mis tüüpi andmeid tagastatakse, kui teie rakendus esitab asukohastackile taotluse. Siin näete kõigepealt lähte-URL-i, kuhu oma taotlusi sihite, kuid see kuvatakse ka dokumentatsioonis. Lõpuks näeme API näidistaotlust, mis koosneb vaid mõnest lihtsast koodiridadest.
3. Rakenduste integreerimine - Viimane samm viitab Positionstacki API lõplikule integreerimisele teie rakendusse. Selle protsessi kohta on teada üsna palju ja suurem osa sellest on kaetud dokumentidega. Oluline on siinjuures: Positionstacki tugitiimil on teie selg ja ta pakub sama palju või vähe abi, mida vajate nende API konfigureerimiseks ja integreerimiseks oma rakendusse.

Päris lihtne, eks? Rakendusliidesed võivad inimestele tunduda hirmutavatena, kui neil pole algul laialdasi IT-teadmisi. Kuid kohe pärast nahkhiirt lohutab Positionstack teid teadmisega, et see pole mitte ainult lihtne, vaid aitavad ka teid nutika disaini uskumatute dokumentide abil. See aitab neil olla kirglik ekspertide meeskond, kes on valmis teid ka aitama.

Teie Positionstacki armatuurlaud

Kahekordistades oma kasutajasõbralikkuse põhiväärtuse, pakub Positionstack sujuvamat, segamatut armatuurlauda, ​​kust pääseb juurde kõigele, mida peate oma API-st teadma. Vaatame külgriba võimalusi:

• Armatuurlaud - Siit leiate teatised (tavaliselt hoiatavad teid teatud kasutamiskünniste ületamisel), seejärel linke nii 3-etapilise kiirstartimisjuhendi kui ka nende dokumenteerimislehele. Samuti on ülevaade teie API-võtmest, teie praegusest tellimusest, konto üksikasjadest ja makseviisist.
• Uuendamine / tellimine - Oma tellimust saate muuta mõlemal neist kahest võimalusest. Uuendage igal ajal, kuigi kui soovite kuu- või aastaplaani vahel liikuda kummaski suunas, peate esmalt alandama tasuta kontole ja seejärel valima soovitud valiku. Positionstacki tugi on valmis teid abistama, kui vajate selle tegemisel abi.
• Konto / makse - need on iseenesestmõistetavad; mõlemal vahekaardil saate oma mandaati igal ajal värskendada. Peab ütlema, et me hindame, et nad ei mata neid põhilisi juhtseadmeid üle kujundatud, toretsevasse liidesesse. WYSIWYG.
• API kasutamine - Tõenäoliselt vahekaart, mida sagedamini külastate, leiate siit, kui suure osa teie igakuisest taotluskvoodist olete seni ära söönud. Seal on ka mugav jaotis, mis näitab teie kasutusstatistikat aja jooksul, nii et saate oma strateegiat vastavalt kohandada.

API dokumentatsioon

Nüüd jõuame Positionstacki pakkumise südamesse ja hinge: API dokumentatsioon. Mõelge sellele lehele oma kasutuselevõtu juhendis, kus on täpsustatud iga API lõpp-punkt, nende parameetrid ja millist teavet nad tagastavad.

See leht on jagatud viieks erinevaks osaks. Läbime need kõik, kulutades veidi aega ja sõnavara, et pakkuda teile konteksti, et leitust paremini aru saada.

Alustamine

Siit leiate põhifunktsioonid mis kehtivad igale asukohastacki abil tehtud päringule. Need on:

• API-võti - Teie API-võti on nagu digitaalne pass, mida kasutate Positionstacki andmestikule juurde pääsemiseks. Ilma selleta pole API teile kasutu. Kui usute, et see on ohustatud, saate hõlpsalt vana võtme uue vastu välja pöörata.
• Krüptimine - 256-bitist SSL-krüptimist kasutatakse kogu Internetis ja see on mõjuval põhjusel tööstuse turvalisuse standard. Ehkki vajate põhiplaani või paremat, et oma rakenduse sidepidamine Positionstacki serveritega krüptida, on see ainuüksi investeeringu väärt. Krüptimise esilekutsumiseks muutke API põhilises URL-is lihtsalt HTTP-ks HTTPS-i. Lihtne!
• JSON tagasihelistamine - Me ei puutu liiga palju tehnilistesse üksikasjadesse selle toimimise kohta, kuid kui teie API-taotlustele lähevad vastu samad päritolupõhimõtted, kasutate JSON-i tagasilükkamisi, et seda vältida. Põhimõtteliselt taotlete andmeid välise skripti järgi, mida ei seostata domeenidevaheliste probleemidega.
• API vead - Nagu kõigega, võib mõnikord ka teie API taotlustes tekkida vigu. Positionstack mõistab seda ja on nende rakendusesse sisse vigade teatamise funktsionaalsuse, mis aitab teil tuvastada, mis valesti läks. API päringu tõrked tagastavad automaatselt tõrkeobjekti JSON-vormingus, millele lisanduvad kood, teade ja konteksti alamobjektid, et pakkuda vea konteksti.

API lõpp-punktid

Selles jaotises dokumenteeritakse Positionstacki liha ja kartuli funktsionaalsus, see tähendab edasi-tagasi pöörduv geokoodeerimine. Kui te pole 100% kindel, milles erinevus on, siis mõelge geokoodeerimisele kahesuunalise tänavana, kus saaksite tõlkida - lihtsas inglise keeles kirjutatud kohad ja aadressid asukohaandmeteks, nagu koordinaadid ja IP - aadressid, ja - viisa vastupidi.

Niisiis, kui kasutate Eiffeli torni asukoha koordinaatideks teisendamist, kasutaksite edasist geokoodimist. Samamoodi saate teada IP-aadressiga seotud tänava-aadressi, kasutades pöörd-geokoodimist. Päris lihtne ju!

Edasi / tagasi geokoodide taotlused

Mõlema geokoodide tüübi põhitaotluse esitamiseks peate lisama vastava lõpp-punkti (/forward või /reverse) API põhiaadressile. Järgmisena annate oma juurdepääsuklahvi ja teete a päring kasutades kas tavalist ingliskeelset asukohaaadressi või sellele vastavaid asukohaandmeid - ja, voila! See näeb välja umbes selline:

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

või

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

Muidugi sisaldab Positionstacki andmekogum palju, palju enamat kui lihtsalt aadresse ja koordinaate. Neid teisi liigitusi saate sõeluda mitmesuguste parameetrite abil. Siin on näide sellest, mida a edasine geokoodeerimine Valge Maja kohta päringu esitamine näeb välja järgmine:

{"andmed": {"tulemused": [{"laiuskraad": 38.897675, "pikkuskraad": -77.036547, "silt": "1600 Pennsylvania Avenue NW, Washington, DC, USA", "nimi": "1600 Pennsylvania Avenue NW "," type ":" address "," number ":" 1600 "," street ":" Pennsylvania Avenue NW "," postal_code ":" 20500 "," trust ": 1," region ":" Rajoon Columbia "," piirkonna_kood ":" DC "," administratiivne ala ": null," naabruskond ":" Valge Maja alused "," riik ":" Ameerika Ühendriigid "," riigikood ":" USA ", "map_url": " http://map.positionstack.com/38.897675,-77.036547" } ] } }

Huvitav, kui peaksite tegema a vastupidine geokoodeerimine kui kasutate Valge Maja ligikaudseid koordinaate, näeksid tagastatud tulemused peaaegu identsed, välja arvatud juhul, kui näete ka erinevust kaugus teie koordinaatide ja Valge Maja ametlike koordinaatide vahel, nagu need kuvatakse Positionstacki andmestikus.

Selle sarnasuse põhjus on see, et mõlemad lõpp-punktid kasutavad sama GET-i parameetrite massiivi ja on seega võimelised tagastama (peaaegu) samu reageerimisobjekte. See tähendab, et ükskõik millistest lähteandmetest peate mööda minema, saate vastutasuks kogu asukohaandmete komplekti. (Neid tulemusi on võimalik API-de abil kitsendada) väljad parameetri kohta, kuid puudutame seda hiljem.)

Märkus. Positionstacki dokumenteerimislehel on iga parameetri ja vastusobjekti kohta täielik teave, seega kontrollige seda kindlasti!

Partii taotlused

Selle dokumentatsiooni seadete viimane suurem pealkiri käsitleb partii taotlused. Teil on vaja vaid helistada partii pesa, siis pesitse mitu päring eksemplare (koos teie soovitud parameetritega) ühe päringu all ja ülejäänu eest hoolitseb Positionstacki API. See on surnud lihtne ja näeb välja selline:

{"partii": [{"päring": "Main Street", "country": "US", "region": "Minnesota"}, {"query": "Main Street", "riik": "USA", "piirkond": "Illinois"}, {"päring": "Peatänav", "riik": "USA", "piirkond": "Missouri"} ] }

Täpsemad andmed

Lisaks põhilistele asukohaparameetritele saate oma API taotlusi täiendavalt kohandada, et rohkem naasta täpsemad andmed. Need sisaldavad:

• Manustatavad kaardid - Tagastab teie geokoodide tulemusega lingitud objekti map_url, mida saate kasutada oma veebisaidil või rakenduses atraktiivse visuaalse kaardi esituse loomiseks.
• Riigimoodul - erinevalt teistest parameetritest, mis annavad tagasi mõne reageerimisobjekti, country_module tagastab uskumatu hulga andmeid teie päritud riigi kohta. Samuti pole see ainult koordinaadid ja aadressid; see on pealinn, lipp, ametlik nimi, riik sisenemiseta (või mitte) riigina, kasutatavad valuutad, räägitavad keeled, suunakoodid ja palju muud.
• Päikesemoodul - Humoorikalt kirjeldab Positionstacki dokumentatsioon seda kui „astroloogilisi“ andmeid. Te ei saa selle parameetriga oma horoskoopi, kuid näete astronoomilise, tsiviil- ja merenduskronoloogia kohaselt andmeid selle kohta, kui päike tõuseb ja loojub.
• Ajatsoonimoodul - Lisage ajatsoonimoodul asukoha GMT nihke tagastamiseks kas sekundites või loodusliku keelestringina.
• Piirdekarbi moodul - Kui üks x / y koordinaadipaar pole teie ülesandeks sobiv, proovige piirdekasti, mis ümbritseb ala, mille pikkus- ja laiuskraadi minimaalsed ja maksimaalsed väärtused on olemas.

Täiendavad valikud

Positionstack API-l on palju andmeid, et teid ära visata, kuid õnneks pakub see teile lisatööriistad selle teabeharu haldamiseks.

• Täpsustage vastusväljad - Oleme põhjalikult uurinud, kui palju andmeid Positionstack tagasi saab, kuid pidage meeles, et kõik need andmed on tasulised. Kui soovite oma igakuiseid taotlusi piirata, saate seda teha rakendusega väljad Lisamine väljad = tulemused.flagnäiteks väljastab API rakendus ainult teie päritud riigi lipu. Võite helistada väljad nii mitu korda, kui vajate konkreetse andmestiku saamiseks.
• Määrake väljundvorming - Tasuta abonentide tagastatud geokoodide tulemuste saamiseks piirdutakse JSON-vorminguga. Tasulised kliendid saavad aga liituda väljund vastavalt nende taotlustele täpsustada JSON, XML või GeoJSON.

Koodinäited

Kui Positionstack ütleb, et nad on siin teid aitamas, tähendavad nad seda. Oleme juba näinud, kui põhjalik on nende dokumentatsioon, kuid nad täiendavad seda käepäraselt koodinäited kõigis keeltes, mida nende API toetab. Me ei hakka seda koodi siia kopeerima / kleepima, kuid kiireks tutvumiseks on need keeled järgmised:

• Python
• Nodejs
• jQuery
• Mine
• Rubiin

Tõestus ja jõudlus

Siinkohal peaks olema selge, et Positionstack on võimeline päris palju ära tegema. Aga, kui hästi kas ta teeb neid asju?

Kõigepealt mõelgem mõnele kontekstile. Positionstack on üks enam kui 20 API-liidesega mikroteenusest Apilayeri pilvepõhises ökosüsteemis. Need API-d teenindavad kokku üle miljoni B2B kliendi alustavatest ettevõtetest kuni ettevõtteni. Nende silmapaistvamate klientide hulka kuuluvad Amazon, Apple, Slack, LinkedIn ja veel paljud leibkonna nimed. On selge, et neil on selle nõudluse ulatuse rahuldamiseks olemas tugev infrastruktuur.

Omaette teenete kohaselt elab Positionstack oma põlvnemist ja on uskumatu 100% tööajaga kogu 2020. aasta jooksul selle kirjutamise ajal. See on veelgi muljetavaldavam, kui arvestada API-ga rutiinselt töötleb päevas ühe vaalakliendi kohta üle miljardi geokoodide otsingu päevas, rääkimata peadpööritava hulga samaaegsetest päringutest, mis tulevad nende stabiilsetelt väikeste ja keskmise suurusega ettevõtete klientidelt. Veelgi enam, need taotlused annavad vastuseid tavaliselt vahemikus 10–100 ms.

Meie raamatus on see midagi tehnoloogilist imet, eriti kui arvestada seda SaaS-pakkumise agressiivse hinnaga.

Ja mitte ainult toores jõud ei muuda Positionstacki nii ahvatlevaks. Nende andmekogum on tõeliselt keerukas, pärinedes usaldusväärsetest nimedest nagu Nominatim, GeoNames, Pelias ja OpenStreetMap. Positionstack ristkontrollib, filtreerib ja rekombineerib seda rikkalikku andmeid mitu korda päevas, lükates korrapäraseid värskendusi nutikate algoritmide kaudu, mis tagavad, et teil on alati väga täpsed asukohaandmed kõikjal maailmas ja reaalsuses aeg.

Me ei soovi oma viimast kohtuotsust rikkuda, kuid kui otsite jõulist, skaleeritavat geokoodeerimise lahendust, nõuab Positionstacki jätkamine lähemalt.

Hinnakujundus

Apilayer kavatses pakkuda taskukohast alternatiivi väga kallile ettevõttesisesele geokodeerimise tarkvarale ja selle eesmärgi saavutamiseks on see neil ka õnnestunud.

Positionstack tuleb viieks hinnakujundus määramistasandid ja toetab igakuiseid arveldusi või aastatellimusi 20% allahindlusega. Need astmed on:

• Tasuta - Isiklikuks kasutamiseks hinnatud, saate ikka veel palju läbisõitu, kasutades JSON-vormingus igakuiseid 25 000 edasisuunalise ja tagurpidi geokoodeerimise taotlust. Te ei saa palju lisafunktsioone ega klienditugi, kuid oleme juba teile näidanud, kui väärtuslik ressurss on nende dokumenteerimisleht. See määramistasand on tasuta ja kohustuslik - alustamiseks ei pea te isegi krediitkaardiandmeid esitama.
• Põhiline - algtaseme kaubanduspakett. Tavalised abonendid neljakordistavad oma igakuise kvoodi 100 000 geokoodide taotluseni ja saavad juurdepääsu edasijõudnutele sellised funktsioonid nagu HTTPS-i krüptimine, mitu väljundvalikut (JSON, XML, GeoJSON), manustatavad kaardid, mitu keelt, ja veel. Hankige kaubik Positionstacki litsentsi hinnaga vaid 9,99 dollarit kuus.
• Professionaalne - Positionstacki kõige populaarsem pakkumine - Professional Tier pakub geokoodide taotluste arvu kümnekordselt - kuni 1 000 000 kuus. Kohal on kõik põhitaseme maiustused ja mõned neist, sealhulgas ka pakenditaotlused raskete rakenduste jaoks. See määramistasu on 49,99 dollarit kuus.
• Äri - Ettevõtte tasandil toimiva jõudluse saavutamisel õhutab ettevõtlustaseme kuukvoot ilmatu 3 000 000 taotlust. Jällegi on kõik täiustatud funktsioonid täielikult saadaval, mida toetab Positionstacki kirglik klienditoe meeskond, et aidata teil neist maksimaalselt kasu saada. Kuus 99,99 dollarit.
• Ettevõtlus - See on tase, kus tavapakkumised aknast välja lähevad ja klient on kuningas. Teil on täpsed vajadused, mis nõuavad kohandatud lahendusi, ja Positionstack on teie eesmärkide saavutamiseks valmis. Dikteerite oma igakuised mahupäringud, isegi (eriti), kui need on muutlikud. Kas vajate API-st rohkem hobujõudu? Uurige eritellimusel ehitatud lahenduste toe. Pakkumise saamiseks pöörduge Positionstacki poole.

Kohtuotsus

Positionstack teeb täpselt seda, mida ta otsustas teha: viia ettevõtte tasemel geokoodeerimine hinnapunktidest madalamal juhul enamiku väikeste ja keskmise suurusega ettevõtete jaoks eelarvest ilma tulemuslikkust ohverdamata. Nende API on hästi dokumenteeritud ja hõlpsasti kasutatav, kuid funktsioonide täielik integreerimine kõigi peamiste programmeerimiskeelte vahel on maksimaalne utiliit. Tavapäraselt käsitletavate Positionstacki päringute arv on jahmatav, samas kui nende andmestikku hoitakse nutikalt, et reaalajas geokoodeerida tõeliselt globaalselt. Kui olete seda tüüpi toodete turul, ärge magage Positionstackis.

Millist integratsiooni olete kavandanud? Kuidas kasutate oma ettevõttes geokoodeerimist? Kas teil on Positionstacki kohta küsimusi või kommentaare? Jäta meile kommentaar allpool.