Získajte zadarmo Geocoding na úrovni podniku pomocou API Positionstack (REVIEW)

Nemusíte byť Mapami Google, aby ste mohli využívať výhody geokódovania. A vďaka Positionstacku na to nepotrebujete ani technický rozpočet Big G. Dnes preskúmame robustné rozhranie API spoločnosti Positionstack, ktorého cieľom je dosiahnuť vysoko cenovo dostupné a použiteľné geokódovanie na úrovni podniku.

Pozícia 101

Prečo by ste sa preto mali obťažovať čítaním 2 000+ slovných recenzií Positionstacka čo vlastne získate? Odpoveď znie roztomilo, ale je presná: celý svet.

Na chvíľu zvážte, koľko miest je na mape sveta. Teraz vynásobte toto číslo v hlave každým kúskom metadát, ktoré vaša firma potrebuje vedieť o týchto miestach. To je to, čo Positionstack ponúka, a potom niektoré.

Pozrime sa na niekoľko rýchlych štatistík o pozícii Positionstack:

• Skutočne miliardy žiadostí o vyhľadávanie geokódov spracovaných každú hodinu, každý deň; s dobou odozvy 100% a menej ako 100 ms
• Vysoko škálovateľná infraštruktúra v cloude
• Údaje v reálnom čase o každej krajine na svete, zostavené do kavernózneho súboru údajov, ktorý sa aktualizuje každých pár hodín
instagram viewer
• Plány predplatného za veľkorysé a konkurencieschopné ceny; plus bezkonkurenčná mesačná kvóta 10 000 žiadostí pre bezplatných používateľov
• Integračná podpora všetkých hlavných programovacích jazykov
• Komplexná, ľahko čitateľná dokumentácia doplnená úryvkami kódov
• Špičkový tím spokojnosti zákazníkov so skúsenosťami s obsluhou klientov ako Zendesk, Slack, LinkedIn, Lyft, Apple a Amazon.

Positionstack má určite svoj rodokmeň pod kontrolou, ale v prípade, že nie ste presvedčení hrsťou guľkových bodov, urobme hlboký ponor do toho, aké to je skutočne použiť API.

Sprievodca rýchlym spustením produktu Positionstack je 3-krokový

Ak na svojich webových stránkach strávite nejaký čas, zistíte, že softvér Positionstack skutočne zdôrazňuje jednoduché použitie ako primárny predajný bod ich rozhrania API. Počas procesu registrácie okamžite uvidíte, že je to celkom pravda. V skutočnosti je prvá vec, ktorú vidíte po zadaní poverení svojho účtu, rýchla mapa toho, čo je potrebné na to, aby ste mohli začať pracovať s Positionstackom, a to v troch jednoduchých krokoch. Pozrime sa:

1. Nastavte prístupový kľúč API - V predvolenom nastavení ste dostali prístupový kľúč, ktorý je pripravený vyradiť z krabice. Môžete to však podľa potreby ľahko resetovať.
2. Vyberte koncové body API - V ďalšej časti sa zaoberáme koncovými bodmi rozhrania API podrobnejšie, ale zatiaľ len rozumieme, že tento krok sa týka konfigurácie toho, aký typ údajov sa vracia, keď vaša aplikácia požiada o funkciu Positionstack. Tu sa najskôr zobrazí základná adresa URL, na ktorú zacieľujete svoje požiadavky, ale tiež sa zobrazí v dokumentácii. Nakoniec vidíme vzorovú požiadavku API, ktorá pozostáva z niekoľkých ľahkých riadkov kódu.
3. Integrácia aplikácií - Posledný krok sa týka konečnej integrácie rozhrania API produktu Positionstack do vašej aplikácie. O tomto procese je veľa informácií a väčšina z nich je uvedená v dokumentácii. Dôležité je, že tím podpory spoločnosti Positionstack má chrbát a ponúkne toľko alebo malú pomoc, ktorú potrebujete na konfiguráciu a integráciu ich rozhrania API do svojej aplikácie.

Je to celkom jednoduché? Rozhrania API sa môžu ľuďom zdať zastrašujúce bez toho, aby si spočiatku vyžiadali rozsiahle znalosti IT. Hneď na pálke vás Positionstack poteší vedomím, že nielenže je to ľahké, ale pomôžu vám na ceste s neuveriteľnou dokumentáciou ich inteligentného dizajnu. Pomáha im pripraviť vášnivý tím odborníkov, ktorí vám pomôžu tiež.

Váš informačný panel Positionstack

Zdvojnásobenie základnej hodnoty užívateľskej prívetivosti, Positionstack ponúka efektívny, prehľadný informačný panel, z ktorého máte prístup ku všetkému, čo potrebujete vedieť o svojom API. Pozrime sa na možnosti bočného panela:

• prístrojová doska - Tu nájdete upozornenia (zvyčajne vás upozornia, keď prejdete určitými prahovými hodnotami používania), potom odkazy na 3-krokovú príručku rýchleho spustenia a stránku ich dokumentácie. K dispozícii je tiež prehľad vášho kľúča API, aktuálneho prihlásenia, podrobností o účte a spôsobu platby.
• Aktualizovať / Subscription - Svoje predplatné môžete zmeniť pomocou ktorejkoľvek z týchto dvoch možností. Inovujte kedykoľvek, ale ak chcete prepínať medzi mesačným alebo ročným plánom v oboch smeroch, musíte najskôr prejsť na bezplatný účet a potom zvoliť požadovanú možnosť. Podpora Positionstack je ochotná vám pomôcť, ak potrebujete pomoc s tým.
• Účet / Payment - sú samovysvetľujúce; Ktorákoľvek karta vám umožní kedykoľvek aktualizovať svoje poverenia. Je potrebné povedať, že si vážime, že tieto základné ovládacie prvky nezatierajú do prefíkaného a honosného rozhrania. WYSIWYG.
• Použitie API - Pravdepodobne karta, ktorú budete najčastejšie vracať, tu nájdete informácie o tom, koľko svojej mesačnej kvóty na požiadavku, ktorú ste doteraz konzumovali. K dispozícii je tiež užitočná sekcia ukazujúca vaše štatistiky používania v priebehu času, takže môžete zodpovedajúcim spôsobom upraviť svoju stratégiu.

Dokumentácia API

Teraz sa dostávame k srdcu a duši ponuky Positionstacku: Dokumentácia API. Zvážte túto stránku svoju používateľskú príručku s podrobnými údajmi o každom koncovom bode rozhrania API, ich parametroch a o tom, aké informácie vrátia.

Táto stránka je rozdelená do piatich rôznych sekcií. Prejdeme sa každým, strávime nejaký čas a verbujeme, aby sme vám poskytli nejaký kontext, aby ste lepšie porozumeli tomu, čo nájdete.

Začíname

Tu nájdete základné funkcie ktoré sa vzťahujú na každú požiadavku, ktorú ste zadali v službe Positionstack. Sú to tieto:

• Kľúč API - Váš kľúč rozhrania API je ako digitálny pas, ktorý budete používať na prístup k množine údajov Positionstack. Bez neho je API pre vás zbytočné. Ak sa domnievate, že došlo k ohrozeniu, môžete starý kľúč ľahko otočiť o nový.
• šifrovanie - 256-bitové šifrovanie SSL sa používa na celom internete a z dobrého dôvodu je priemyselným štandardom zabezpečenia. Aj keď budete potrebovať základný plán alebo lepší na šifrovanie komunikácie svojej aplikácie so servermi Positionstack, stojí za to investíciu samo o sebe. Aby ste vyvolali šifrovanie, jednoducho zmeňte HTTP na HTTPS v základnej URL API. Simple!
• Spätné volania JSON - Nebudeme sa zaoberať priveľa technickými podrobnosťami o tom, ako to funguje, ale ak sú vaše požiadavky na rozhranie API chránené zásadami rovnakého pôvodu, pomocou spätných volaní JSON ovplyvníte riešenie. V podstate požadujete údaje z externého skriptu, ktorý sa nezaoberá problémami viacerých domén.
• Chyby API - Rovnako ako v prípade všetkých ostatných žiadostí API sa niekedy vyskytnú chyby. Positionstack tomu rozumie a do svojej aplikácie zabudovala funkciu hlásenia chýb, ktorá vám pomôže zistiť, čo sa stalo. Zlyhania žiadosti API automaticky vrátia chybový objekt vo formáte JSON plus kód, správu a kontextové objekty kontextu, aby poskytli kontext pre chybu.

Koncové body API

Táto sekcia dokumentuje funkčnosť mäsa a zemiakov Positionstack, čo znamená predkľúčovanie a spätné geokódovanie. Ak si nie ste úplne istí, v čom je rozdiel, myslite na geokódovanie ako na obojsmernú ulicu, kde môžete preložiť - miesta a adresy napísané v jednoduchej angličtine na údaje o polohe, ako sú súradnice a adresy IP, a - a naopak.

Na premenu polohy Eiffelovej veže na súradnice by ste teda použili geografické kódovanie dopredu. Podobne môžete zistiť adresu ulice priradenú k adrese IP pomocou reverzného geokódovania. Koniec koncov, celkom jednoduché!

Požiadavky na geokódovanie vpred / vzad

Ak chcete podať základnú žiadosť o každý typ geokódovania, musíte pripojiť príslušný koncový bod (/forward alebo /reverse) na základnú adresu URL rozhrania API. Ďalej zadáte prístupový kľúč a potom zadáte znak a dopyt pomocou adresy obyčajnej angličtiny alebo jej príslušných údajov o polohe - a, voila! Vyzerá to takto:

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

alebo

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

Dátový súbor Positionstacku samozrejme obsahuje omnoho viac než len adresy a súradnice. Tieto ďalšie kategorizácie môžete analyzovať pomocou rôznych parametrov. Tu je príklad toho, čo a dopredu geokódovanie dotaz, ktorý obsahuje dotaz na Biely dom, vyzerá takto:

{"data": {"results": [{"Latitude": 38.897675, "longitude": -77.036547, "label": "1600 Pennsylvania Avenue NW, Washington, DC, USA", "name": "1600 Pennsylvania Avenue NW "," type ":" address "," number ":" 1600 "," street ":" Pennsylvania Avenue NW "," postal_code ":" 20500 "," trust ": 1," region ":" okres Columbia "," region_code ":" DC "," Administrative_area ": null," Neighborhood ":" White House Grounds "," country ":" United States "," country_code ":" US ", "map_url": " http://map.positionstack.com/38.897675,-77.036547" } ] } }

Zaujímavé je, ak ste mali urobiť spätné geokódovanie Ak použijete približné súradnice Bieleho domu, vrátené výsledky by vyzerali takmer rovnako, okrem toho, že by ste videli aj rozdiel v vzdialenosť medzi vašimi súradnicami a oficiálnymi súradnicami Bieleho domu, ako sú uvedené v súbore údajov Positionstack.

Dôvodom tejto podobnosti je to, že oba koncové body využívajú rovnaké pole parametrov GET, a sú teda schopné vracať (takmer) rovnaké objekty odozvy. To znamená, že bez ohľadu na to, aké počiatočné údaje musíte prejsť, môžete za to získať úplný doplnok údajov o polohe. (Tieto výsledky je možné zúžiť pomocou rozhraní API poľa parameter, ale dotkneme sa toho viac neskôr.)

Poznámka: Stránka dokumentácie Positionstacku podrobne popisuje každý parameter a objekt odpovede, takže si ho vyskúšajte!

Žiadosti o dávku

Posledný hlavný nadpis tejto dokumentácie sa zaoberá dávkové žiadosti. Jediné, čo musíte urobiť, je vyvolať várka parameter, potom vnoriť viac dopyt inštancie (spolu s požadovanými parametrami) pod jednou požiadavkou a rozhranie Positionstack API sa postará o zvyšok. Je to mŕtve jednoduché a vyzerá to takto:

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

Rozšírené údaje

Okrem základných parametrov umiestnenia môžete svoje požiadavky API ďalej prispôsobiť tak, aby sa vám vrátili ďalšie rozšírené údaje. Tie obsahujú:

• Vkladateľné mapy - Vracia objekt map_url prepojený s vaším výsledkom geokódovania, pomocou ktorého môžete na svojom webe alebo v aplikácii vytvoriť atraktívne zobrazenie vizuálnej mapy.
• Modul krajiny - Na rozdiel od iných parametrov, ktoré vracajú až niekoľko objektov odozvy, country_module vráti neuveriteľné množstvo údajov o vašej požadovanej krajine. Nejde iba o súradnice a adresy; je to hlavné mesto, vlajka, oficiálny názov, štatút vnútrozemskej (alebo nie) krajiny, použité meny, hovorené jazyky, volacie kódy a ďalšie.
• Sun modul - Humorne to dokumentácia spoločnosti Positionstack popisuje ako „astrologické“ údaje. Nebudete mať svoj horoskop s týmto parametrom, ale uvidíte údaje o tom, kedy slnko vychádza a zapadá, podľa astronomickej, civilnej a námornej chronológie.
• Modul časových pásiem - Pripojiť timezone_module na vrátenie kompenzácie GMT polohy v priebehu niekoľkých sekúnd alebo ako reťazec v prirodzenom jazyku.
• Modul ohraničovacej skrinky - Ak jedna súradnica x / y nie je pre vašu úlohu vhodná, skúste ohraničujúci rámček, ktorý ohraničuje oblasť s minimálnymi a maximálnymi hodnotami pre zemepisnú šírku a šírku.

Ďalšie možnosti

Rozhranie Positionstack API má na vás veľa údajov, ale našťastie vám poskytuje ďalšie nástroje spravovať tento informačný tok.

• Zadajte polia odpovede - Podrobne sme sa zamerali na to, koľko údajov sa môže Positionstack vrátiť, ale nezabudnite, že všetky tieto údaje sú spoplatnené. Ak chcete obmedziť svoje mesačné požiadavky, môžete tak urobiť pomocou poľa pridávanie field = results.flag, napríklad spôsobí, že sa na výstupe API zobrazí iba príznak vašej požadovanej krajiny. Môžete sa odvolať poľa toľkokrát, koľkokrát potrebujete získať konkrétny súbor údajov, ktorý potrebujete.
• Zadajte výstupný formát - Bezplatní odberatelia sú pre výsledky vrátenia geokódovania obmedzené na formát JSON. Platiaci zákazníci však môžu pripojiť výkon o ich požiadavkách na špecifikovanie JSON, XML alebo GeoJSON podľa potreby.

Príklady kódu

Keď Positionstack hovorí, že sú tu, aby vám pomohli, majú na mysli. Už sme videli, aká dôkladná je ich dokumentácia, ale doplnili ju po ruke príklady kódu vo všetkých jazykoch, ktoré ich rozhranie API podporuje. Nebudeme tu kopírovať / vkladať tento kód, ale pre rýchlu orientáciu sú tieto jazyky:

• krajta
• Nodejs
• jQuery
• go
• rubín

Dôkaz a výkon

V tomto bode by malo byť jasné, že Positionstack je schopný urobiť dosť veľa. Ale, ako dobre robí tieto veci?

Najprv sa pozrime na niektoré súvislosti. Positionstack je jedným z 20+ rozhraní API v ekosystéme založenom na cloude spoločnosti Apilayer. Tieto rozhrania API slúžia spolu viac ako miliónu B2B klientov od startupov až po podnikanie. Medzi ich najvýznamnejších zákazníkov patria Amazon, Apple, Slack, LinkedIn a mnoho ďalších mien domácností. Je zrejmé, že majú určitú robustnú infraštruktúru na zvládnutie tohto rozsahu dopytu.

Na základe vlastných zásluh, Positionstack žije až po svoj rodokmeň, s neuveriteľnou 100% prevádzkou po celý rok 2020 v čase písania správy. Toto je ešte pôsobivejšie, keď uvažujete o API rutinne Spracováva viac ako miliardu vyhľadávaní geokódov denne na jedného veľrybího klienta, nehovoriac o závratnom súbore súčasných požiadaviek prichádzajúcich od ich stálych zákazníkov SMB. Tieto žiadosti navyše zvyčajne získavajú odpovede medzi 10 a 100 ms.

V našej knihe je to niečo technologického zázraku, najmä vzhľadom na to, aké agresívne je táto ponuka služby SaaS.

A nie je to iba surová sila, ktorá robí z aplikácie Positionstack tak príťažlivú. Ich súbor údajov je skutočne sofistikovaný a vychádza zo spoľahlivých mien, ako sú Nominatim, GeoNames, Pelias a OpenStreetMap. Pozičné krížové kontroly, filtrujú a kombinujú toto množstvo údajov viackrát za deň, čím sa tlačia pravidelné aktualizácie prostredníctvom inteligentných algoritmov, ktoré zaisťujú, že budete mať vždy vysoko presné údaje o polohe kdekoľvek na svete a v reálnom čase Čas.

Nerád pokazíme náš konečný verdikt, ale ak hľadáte robustné, škálovateľné riešenie geokódovania, obnovenie pozície spoločnosti Positionstack vyžaduje bližší pohľad.

stanovenie ceny

Spoločnosť Apilayer sa rozhodla poskytnúť cenovo dostupnú alternatívu k vysoko drahému softvéru na geokódovanie na úrovni podniku a za týmto účelom uspeli.

Positionstack prichádza v piatich oceňovanie úrovní a podporuje mesačnú fakturáciu alebo ročné predplatné so zľavou 20%. Ide o tieto úrovne:

• zadarmo - Keďže je určený na osobné použitie, stále máte najazdené kilometre s 25 000 mesačnými požiadavkami na smerovanie a spätné geokódovanie vo formáte JSON. Nemáte veľa pokročilých funkcií alebo zákazníckej podpory, ale už sme vám ukázali, aký cenný zdroj predstavuje ich stránka Dokumentácia. Táto úroveň je bezplatná a povinná - na to, aby ste mohli začať, nemusíte poskytovať ani podrobnosti o kreditnej karte.
• základné - komerčný balík základnej úrovne. Základné predplatitelia štvornásobne zvýšia svoju mesačnú kvótu na 100 000 žiadostí o geokódovanie a získajú prístup k pokročilým funkcie ako šifrovanie HTTPS, viac možností výstupu (JSON, XML, GeoJSON), vkladateľné mapy, viac jazykov, a viac. Získajte komerčnú licenciu Positionstack za pouhých 9,99 dolárov mesačne.
• profesionálny - Najpopulárnejšia ponuka Positionstacku, profesionálna úroveň ponúka desaťnásobné zvýšenie počtu žiadostí o geokódovanie - až 1 000 000 mesačne. Všetky dobroty zo základnej úrovne sú prítomné a potom niektoré, najmä vrátane žiadostí o dávky pre vysokovýkonné aplikácie. Táto úroveň hodiny na 49,99 dolárov za mesiac.
• obchodné - Po prechode na výkonnosť v podnikovom meradle obchodná úroveň nafúkne mesačnú kvótu na neuveriteľných 3 000 000 žiadostí. Každá pokročilá funkcia je opäť plne k dispozícii, podporovaná vášnivým tímom zákazníckej podpory spoločnosti Positionstack, ktorý vám pomôže z nich vyťažiť maximum. 99,99 dolárov mesačne.
• podnik - Toto je úroveň, v ktorej štandardné ponuky idú z okna a zákazník je kráľom. Máte presné potreby, ktoré si vyžadujú riešenia na mieru a Positionstack je pripravený na dosiahnutie vašich cieľov. Diktujete svoje mesačné požiadavky na objem, a to (najmä), ak sú rôzne. Potrebujete viac koní z API? Oslovte podporu pre riešenia na mieru. Ak chcete získať cenovú ponuku, kontaktujte spoločnosť Positionstack.

verdikt

Positionstack robí presne to, čo si stanovil: priniesť geokódovanie na úrovni podniku z cenových bodov inak z rozpočtu na väčšinu malých a stredných podnikov bez toho, aby obetoval výkon. Ich API je dobre zdokumentované a ľahko použiteľné, ale ponúka robustnú integráciu vo všetkých hlavných programovacích jazykoch pre maximálne využitie. Počet žiadostí, s ktorými sa rutinne zaobchádza, je ohromujúci, zatiaľ čo ich množina údajov je inteligentne udržiavaná pre skutočne globálny dosah v geokódovaní v reálnom čase. Ak ste na trhu s týmto typom produktu, nespite v službe Positionstack.

Aký druh integrácie máte v pláne? Ako využijete geokódovanie vo svojej firme? Máte nejaké otázky alebo pripomienky k pozícií? Zanechajte nám poznámku v komentároch nižšie.