Získejte zdarma Geocoding na úrovni organizace pomocí API Positionstack (REVIEW)

Nemusíte být Mapy Google, abyste získali hodnotu z geokódování. A díky Positionstacku nepotřebujete ani technický rozpočet Velké G, aby tak učinil. Dnes přezkoumáváme robustní rozhraní API společnosti Positionstack, které si klade za cíl zajistit, aby geokódování dopředu a dozadu na úrovni podniku bylo vysoce dostupné a použitelné.

Pozice 101

Proč byste se tedy měli obtěžovat čtením 2 000+ slovních recenzí Pozicea co vlastně získáte? Odpověď zní roztomilý, ale je přesná: celý svět.

Na chvíli zvažte, kolik míst na mapě světa je. Nyní vynásobte toto číslo v hlavě každým kusem metadat, které vaše firma potřebuje vědět o těchto místech. To je to, co Positionstack nabízí, a pak některé.

Podívejme se na několik rychlých statistik o polohách Positionstack:

• Skutečně miliardy žádostí o vyhledávání geokódů zpracovaných každou hodinu, každý den; se 100% provozuschopností a <100 ms dobou odezvy
• Vysoce škálovatelná infrastruktura založená na cloudu
• Data v reálném čase o každé zemi na světě, zkompilovaná do kavernózního datového souboru, který je aktualizován každých pár hodin
instagram viewer
• Plány předplatného za velkorysé rozdělení za konkurenceschopné ceny; plus bezkonkurenční měsíční kvóta 10 000 žádostí pro bezplatné uživatele
• Integrační podpora pro všechny hlavní programovací jazyky
• Komplexní, snadno čitelná dokumentace doplněná úryvky kódu
• Špičkový tým spokojenosti zákazníků se zkušenostmi s obsluhou klientů jako Zendesk, Slack, LinkedIn, Lyft, Apple a Amazon

Pozice určitě má rodokmen na uzdě, ale v případě, že nejste přesvědčeni hrstkou odrážek, pojďme se hlouběji ponořit do toho, jaké to je vlastně API používat.

Průvodce rychlým startem společnosti Positionstack je třístupňový

Pokud na svých webových stránkách trávíte nějaký čas, zjistíte, že Positionstack opravdu zdůrazňuje snadné použití jako primární prodejní bod jejich API. Během procesu registrace okamžitě uvidíte, že je to docela pravda. Ve skutečnosti je první věcí, kterou uvidíte po zadání přihlašovacích údajů k účtu, rychlý plán toho, co je potřeba pro uvedení do provozu a provozování s Positionstack ve třech jednoduchých krocích. Podívejme se na to:

1. Nastavte přístupový klíč API - Ve výchozím nastavení máte přístupový klíč, který je připraven vyrazit z krabice. Tuto linku však můžete podle potřeby snadno resetovat.
2. Zvolte koncový bod API - V další části se podrobněji zabýváme koncovými body API, ale prozatím pochopíme, že tento krok se týká konfigurace toho, jaký typ dat se vrací, když aplikace požádá o funkci Positionstack. Zde se nejprve zobrazí základní adresa URL, na kterou cílíte své požadavky, ale také se zobrazí v dokumentaci. Nakonec vidíme ukázkový požadavek API, který se skládá z několika jednoduchých řádků kódu.
3. Integrace aplikací - Poslední krok se týká konečné integrace API Positionstack do vaší aplikace. O tomto procesu je dobré vědět a většina z nich je obsažena v dokumentaci. Důležité je, že tým podpory společnosti Positionstack má záda a nabídne tolik nebo jen malou pomoc, kterou potřebujete pro konfiguraci a integraci jejich API do aplikace.

Docela snadné, že? Rozhraní API se mohou lidem zdát zastrašující, aniž by zpočátku měli rozsáhlé znalosti IT. Ale hned vedle netopýra vás Positionstack potěší vědomím, že nejenže je to snadné, ale pomohou vám na cestě s neuvěřitelnou dokumentací o jejich chytrém designu. Pomáhá jim připravit vášnivý tým odborníků, který vám pomůže také.

Váš Poziční panel

Díky zdvojnásobení základní hodnoty uživatelsky přívětivosti nabízí Positionstack efektivní a přehledný řídicí panel, ze kterého máte přístup ke všemu, co potřebujete vědět o svém API. Pojďme se podívat na možnosti postranního panelu:

• Přístrojová deska - Zde najdete oznámení (obvykle vás upozorní, když překročíte určité prahové hodnoty využití), poté odkazy na 3-Step Quickstart Guide a jejich stránku dokumentace. K dispozici je také přehled vašeho klíče API, vašeho aktuálního předplatného, ​​údajů o účtu a způsobu platby.
• Upgrade / předplatné - Předplatné můžete změnit u jedné z těchto dvou možností. Upgradujte kdykoli, i když chcete přepínat mezi měsíčním nebo ročním plánem v obou směrech, musíte nejprve přejít na bezplatný účet a poté vybrat požadovanou možnost. Podpora Positionstack je ochotna vám pomoci, pokud potřebujete pomoc s tím.
• Účet / platba - Jsou to samovysvětlující; kterákoli karta vám umožní kdykoli aktualizovat své přihlašovací údaje. Je třeba říci, že si ceníme, že tyto základní ovládací prvky nezabíjejí v přepracovaném, honosném rozhraní. WYSIWYG.
• Použití API - Pravděpodobně karta, kterou budete nejčastěji vracet, zde naleznete informace o tom, kolik z vaší měsíční kvóty na žádost jste dosud snědli. K dispozici je také užitečná část ukazující statistiky využití v průběhu času, takže můžete podle toho upravit svou strategii.

Dokumentace API

Teď se dostáváme k srdci a duši nabídky Positionstacku: Dokumentace API. Zvažte tuto stránku v uživatelské příručce s podrobnými údaji o jednotlivých koncových bodech API, jejich parametrech a o tom, jaké informace se vrátí.

Tato stránka je rozdělena do pěti různých sekcí. Procházíme každou z nich, trávíme nějaký čas a verbování, abychom vám poskytli nějaký kontext, abyste lépe porozuměli tomu, co najdete.

Začínáme

Zde najdete základní funkce které se vztahují na každý požadavek, který zadáte pomocí funkce Pozastavení. Tyto jsou:

• Klíč API - Váš klíč API je jako digitální pas, který budete používat pro přístup k datové sadě Positionstack. Bez něj je API k ničemu. Pokud se domníváte, že došlo ke kompromitaci, můžete svůj starý klíč snadno otočit o nový.
• Šifrování - 256bitové šifrování SSL se používá na celém internetu a je dobrým důvodem pro průmyslový standard zabezpečení. I když budete potřebovat základní nebo lepší plán pro šifrování komunikace vaší aplikace se servery Positionstack, vyplatí se to sama o sobě. Chcete-li vyvolat šifrování, jednoduše změňte HTTP na HTTPS v základní adrese URL API. Jednoduchý!
• JSON zpětná volání - Nebudeme se zabývat příliš mnoha technickými podrobnostmi o tom, jak to funguje, ale pokud vaše požadavky na rozhraní API budou blokovány zásadami stejného původu, použijete zpětná volání JSON k ovlivnění řešení. V zásadě požadujete data z externího skriptu, který se nezabývá problémy s více doménami.
• Chyby API - Stejně jako u všech ostatních se vaše požadavky na rozhraní API někdy stanou chybami. Positionstack to chápe a zabudoval do své aplikace funkci hlášení chyb, která vám pomůže zjistit, co se stalo. Selhání požadavků API automaticky vrátí chybový objekt ve formátu JSON, plus kód, zprávu a dílčí objekty kontextu, aby poskytl kontext pro chybu.

Koncové body API

Tato sekce dokumentuje funkčnost masa a brambor společnosti Positionstack, což znamená geokódování vpřed a vzad. Pokud si nejste stoprocentně jisti, jaký je rozdíl, uvažujte o geokódování jako o obousměrné ulici, kde můžete přeložit - místa a adresy zapsané v prosté angličtině na údaje o poloze, jako jsou souřadnice a adresy IP, a - víza versa.

Pomocí převodu geokódování tedy převedete polohu Eiffelovy věže na souřadnice. Podobně můžete zjistit reverzní geokódování ulicní adresy spojené s IP adresou. Konec konců docela jednoduché!

Přeposílání / zpětné žádosti o geokódování

Chcete-li podat základní požadavek na některý typ geokódování, musíte připojit příslušný koncový bod (/forward nebo /reverse) na základní adresu URL API. Dále zadejte přístupový klíč a poté zadejte dotaz pomocí adresy prosté angličtiny nebo odpovídajících údajů o poloze - a voila! Vypadá to takto:

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

nebo

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

Datová sada Positionstacku samozřejmě obsahuje mnohem, mnohem více než jen adresy a souřadnice. Tyto další kategorizace můžete analyzovat pomocí různých parametrů. Zde je příklad toho, co dopředu geokódování dotaz, dotaz na Bílý dům, vypadá 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," sousedství ":" White House Grounds "," country ":" United States "," country_code ":" US ", "map_url": " http://map.positionstack.com/38.897675,-77.036547" } ] } }

Zajímavé je, že pokud jste měli udělat zpětné geokódování Pokud použijete přibližné souřadnice Bílého domu, vrátené výsledky by vypadaly téměř stejně, kromě toho, že byste také viděli rozdíl vzdálenost mezi vašimi souřadnicemi a oficiálními souřadnicemi Bílého domu, jak jsou uvedeny v datovém souboru Positionstacku.

Důvodem této podobnosti je, že oba koncové body používají stejné pole parametrů GET, a jsou tedy schopny vracet (téměř) stejné objekty odezvy. To znamená, že bez ohledu na to, jaká počáteční data musíte projít, můžete za to získat úplný doplněk údajů o poloze. (Pomocí API je možné tyto výsledky zúžit pole parametr, ale dotkneme se toho více později.)

Poznámka: Stránka dokumentace Positionstacku plně podrobně popisuje každý parametr a objekt odpovědi, proto jej nezapomeňte zkontrolovat!

Žádosti o dávku

Poslední hlavní nadpis v tomto nastavení dokumentace se zabývá dávkové požadavky. Jediné, co musíte udělat, je vyvolat šarže parametr, pak vnořit více dotaz instancí (spolu s požadovanými parametry) pod jedním požadavkem a API Poststacku se postará o zbytek. Je mrtvý jednoduchý a vypadá takto:

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

Pokročilá data

Kromě základních parametrů umístění můžete své požadavky API dále přizpůsobit tak, aby se vám vrátilo více pokročilá data. Tyto zahrnují:

• Vkládatelné mapy - Vrací objekt map_url propojený s vaším výsledkem geokódování, který můžete použít k vytvoření atraktivního zobrazení vizuální mapy na vašem webu nebo aplikaci.
• Modul země - Na rozdíl od jiných parametrů, které vracejí až několik objektů odezvy, country_module vrátí neuvěřitelné množství dat o vaší dotazované zemi. Nejedná se pouze o souřadnice a adresy; je to hlavní město, vlajka, oficiální jméno, stav jako vnitrozemská (nebo ne) země, použité měny, mluvené jazyky, volací kódy a další.
• Sun modul - Humorně to dokumentace společnosti Positionstack popisuje jako „astrologická“ data. Nebudete mít horoskop s tímto parametrem, ale uvidíte údaje o tom, kdy slunce vychází a zapadá, podle astronomické, civilní a námořní chronologie.
• Modul časových pásem - Připojit timezone_module pro vrácení offsetu GMT polohy během několika sekund nebo jako řetězec přirozeného jazyka.
• Bounding Box Module - Pokud jedna dvojice souřadnic x / y není pro váš úkol vhodná, zkuste ohraničovací rámeček, který ohraničuje oblast s minimální a maximální hodnotou pro zeměpisnou délku a šířku.

Další možnosti

Rozhraní Positionstack API má na vás spoustu dat, ale naštěstí vám to poskytne další nástroje spravovat tento informační tok.

• Zadejte pole odpovědí - Podrobně jsme se zabývali tím, kolik dat se může Positionstack vracet, ale mějte na paměti, že všechna ta data jsou za cenu. Pokud chcete omezit své měsíční požadavky, můžete to udělat pomocí pole Připojuje se field = results.flag, například způsobí, že rozhraní API vydá pouze příznak zadané země. Můžete se odvolat pole tolikrát, kolikrát potřebujete získat konkrétní datový soubor, který potřebujete.
• Určete výstupní formát - Bezplatní odběratelé jsou pro své vrácené výsledky geokódování omezeni na formát JSON. Placení zákazníci však mohou připojit výstup na jejich žádost o specifikaci JSON, XML nebo GeoJSON podle potřeby.

Příklady kódu

Když Positionstack řekne, že jsou tu, aby vám pomohli, myslí to vážně. Už jsme viděli, jak důkladná je jejich dokumentace, ale doplňují ji po ruce příklady kódu ve všech jazycích, které jejich API podporuje. Nebudeme zde kopírovat / vkládat tento kód, ale pro rychlou orientaci jsou tyto jazyky:

• Krajta
• Nodejs
• jQuery
• Jít
• Rubín

Důkaz a výkon

V tomto okamžiku by mělo být jasné, že Positionstack je schopen dělat docela dost. Ale, jak dobře dělá to tyto věci?

Nejprve se podívejme na nějaký kontext. Positionstack je jedním z více než 20 mikroservisů API v cloudovém ekosystému společnosti Apilayer. Tato API společně obsluhují více než milion B2B klientů od startupů až po podniky. Mezi jejich nejvýznamnější zákazníky patří Amazon, Apple, Slack, LinkedIn a mnoho dalších domácností. Je zřejmé, že mají nějakou robustní infrastrukturu, aby zvládli tento rozsah poptávky.

Pozice samy o sobě záleží na svém rodokmenu, s neuvěřitelnou 100% uptime po celý rok 2020 v době psaní. To je ještě působivější, když uvažujete o API běžně zpracovává více než miliardu vyhledávání geokódů denně na velrybího klienta, nemluvě o závratném poli současných požadavků přicházejících od jejich stálých zákazníků SMB. Navíc tyto požadavky obvykle získávají odpovědi mezi 10 a 100 ms.

V naší knize je to něco technologického zázraku, zejména s ohledem na to, jak agresivně je tato nabídka SaaS cenová.

A není to jen surová síla, díky které je Positionstack tak přitažlivý. Jejich dataset je skutečně sofistikovaný a pochází ze spolehlivých jmen, jako jsou Nominatim, GeoNames, Pelias a OpenStreetMap. Crossstack Positionstack křížově kontroluje, filtruje a kombinuje toto bohatství dat několikrát denně, čímž tlačí pravidelné aktualizace pomocí inteligentních algoritmů, které zajistí, že budete mít vždy vysoce přesné údaje o poloze kdekoli na světě a ve skutečnosti čas.

Nesnášíme, abychom pokazili náš konečný verdikt, ale pokud hledáte robustní a škálovatelné řešení geokódování, je třeba, aby se životopis společnosti Positionstack blíže podíval.

Ceny

Apilayer se rozhodl poskytnout cenově dostupnou alternativu k vysoce nákladnému podnikovému geokódovacímu softwaru a za tímto účelem uspěl.

Positionstack přichází v pěti ceny úrovně a podporuje měsíční fakturaci nebo roční předplatné s 20% slevou. Tyto úrovně jsou:

• Volný, uvolnit - Je hodnoceno pro osobní potřebu, stále dosahujete ujetých kilometrů s 25 000 žádostmi o měsíční a zpětné geokódování, které jsou vydávány ve formátu JSON. Nemáte mnoho pokročilých funkcí nebo zákaznické podpory, ale již jsme vám ukázali, jaký cenný zdroj je jejich stránka dokumentace. Tato úroveň je bezplatná a bez závazků - k zahájení nemusíte poskytovat ani podrobnosti o kreditní kartě.
• Základní - Základní obchodní balíček. Základní předplatitelé ztrojnásobují svou měsíční kvótu na 100 000 požadavků na geokódování a získají přístup k pokročilým funkce, jako je šifrování HTTPS, více možností výstupu (JSON, XML, GeoJSON), vložitelné mapy, více jazyků, a více. Získejte komerční licenci Positionstack za pouhých 9,99 $ měsíčně.
• Profesionální - Nejpopulárnější nabídka Positionstacku, profesionální úroveň nabízí desetinásobné zvýšení požadavků na geokódování - až 1 000 000 měsíčně. Všechny dobroty ze základní úrovně jsou přítomny a pak některé, zejména včetně dávkových požadavků na aplikace pro náročné aplikace. Tato úroveň hodiny za 49,99 dolarů za měsíc.
• Podnikání - Po přechodu na výkon v podnikovém měřítku překonává obchodní vrstva měsíční kvótu na neuvěřitelných 3 000 000 požadavků. Každá pokročilá funkce je opět plně k dispozici a podporuje vášnivý tým zákaznické podpory společnosti Positionstack, který vám pomůže vytěžit z nich maximum. 99,99 $ měsíčně.
• Podnik - Toto je úroveň, ve které standardní nabídky vycházejí z okna a zákazník je králem. Máte přesné potřeby, které vyžadují řešení na míru, a Positionstack je připraven dosáhnout vašich cílů. Diktujete své žádosti o měsíční objem, a to i (zejména), pokud jsou proměnné. Potřebujete více výkonu z API? Oslovte podporu pro řešení na míru. Kontaktujte nabídku pro nabídku.

Výrok

Positionstack dělá přesně to, co si stanovil: snížit úroveň podnikového geokódování z cenových bodů jinak z rozpočtu na většinu malých a středních podniků, aniž by obětoval výkon. Jejich API je dobře zdokumentováno a snadno použitelné, ale nabízí robustní integraci ve všech hlavních programovacích jazycích pro maximální užitečnost. Počet požadavků, které Positionstack běžně zpracovává, je ohromující, zatímco jejich datový soubor je inteligentně udržován pro skutečně globální dosah v geokódování v reálném čase. Pokud jste na trhu s tímto typem produktu, nespí se v polohovacím automatu.

Jaký druh integrace jste plánovali? Jak využijete geokódování ve své firmě? Máte nějaké dotazy nebo připomínky k Positionstacku? Zanechte nám poznámku v komentářích níže.