Вземете геокодиране на корпоративно ниво безплатно с API на Positionstack (ПРЕГЛЕД)

Не е нужно да сте Google Maps, за да получите стойност от геокодирането. И благодарение на Positionstack не се нуждаете и от технологичния бюджет на Big G, за да го направите. Днес преглеждаме стабилния API на Positionstack, който има за цел да направи геокодирането на ниво предприятие напред и назад, както високо достъпно, така и използваемо.

Positionstack 101

И така, защо трябва да си правите труда да четете преглед на 2 000+ думи Positionstack, и какво смятате да спечелите? Отговорът звучи сладко, но е точно: на целия свят.

Помислете за момент само колко места има на картата на света. Сега умножете този номер в главата си на всеки метаданни, които вашият бизнес трябва да знае за тези места. Това предлага Positionstack и след това някои.

Нека да разгледаме няколко бързи статистики за Positionstack:

• Действителни милиарди заявки за търсене на геокодиране, обработвани на всеки час, всеки ден; със 100% време за продължаване и <100ms време на реакция
• Облачна базирана, силно мащабируема инфраструктура
instagram viewer
• Данните в реално време за всяка страна по света, събрани в кавернен набор от данни, който се актуализира на всеки няколко часа
• Абонаментни планове с големи размери, на конкурентни цени; плюс ненадмината месечна квота от 10 000 заявки за безплатни потребители
• Поддръжка за интеграция за всички основни програмни езици
• Изчерпателна, лесна за четене документация, заедно с фрагменти от код
• Екип за удовлетвореност на клиентите от световна класа с опит, обслужващ клиенти като Zendesk, Slack, LinkedIn, Lyft, Apple и Amazon

Positionstack със сигурност има своето родословие в проверка, но в случай, че не сте убедени от шепа точки от куршуми, нека да се потопим дълбоко в това, което искате да използвате API в действителност.

3-стъпково ръководство за бързо стартиране на Positionstack

Ако прекарате някакво време на уебсайта им, ще видите, че Positionstack наистина подчертава лекотата на използване като основна точка за продажба на техния API. По време на процеса на регистрация веднага ще видите, че това е напълно вярно. Всъщност първото нещо, което виждате, след като въведете идентификационните данни на акаунта си, е бърза пътна карта на това, което е необходимо за ставане и работа с Positionstack в три лесни стъпки. Нека да разгледаме:

1. Задайте вашия ключ за достъп до API - По подразбиране ви връчват ключ за достъп, който е готов да излезе извън кутията. Можете обаче лесно да нулирате това надолу по линията, ако е необходимо.
2. Изберете крайни точки на API - Покриваме крайните точки на API с по-голяма дълбочина в следващия раздел, но засега просто разбирам, че тази стъпка се отнася до конфигуриране на какъв тип данни се връща, когато приложението ви направи заявка към Positionstack. Тук ще видите първо основния URL адрес, където насочвате заявките си, но се появява и в документацията. Накрая виждаме примерна заявка за API, която се състои само от няколко лесни реда от код.
3. Интеграция на приложения - Последната стъпка се отнася до окончателното интегриране на API на Positionstack във вашето приложение. Трябва да се знае доста за този процес и повечето от тях са обхванати в документацията. Важното тук е: екипът за поддръжка на Positionstack има гръб и ще ви предложи толкова или малко помощ, за да конфигурирате и интегрирате техния API в приложението ви.

Доста лесно нали? API-ите могат да изглеждат смущаващи за хората без първоначални знания за ИТ. Но веднага след прилепа, Positionstack ви успокоява със знанието, че не само е лесно, но и ще ви помогне по пътя с невероятна документация за техния интелигентен дизайн. Помага им да имат страстен екип от експерти, готови да ви помогнат и вие.

Вашето табло за позициониране

Удвоявайки своята основна стойност на удобството за ползване, Positionstack предлага рационално, неразбрано табло за управление, от което можете да получите достъп до всичко, което трябва да знаете за вашия API. Нека да разгледаме опциите на страничната лента:

• Табло - Тук ще намерите известия (обикновено ви предупреждават при преминаване на определени прагове на използване), след това връзки към ръководството за бърз старт на 3 стъпки и тяхната страница с документация. Има и преглед на вашия ключ за API, текущия ви абонамент, данни за акаунта и начин на плащане.
• Надстройка / абонамент - Можете да промените абонамента си по някоя от тези две опции. Надграждане по всяко време, въпреки че ако искате да превключвате между месечен или годишен план във всяка посока, първо трябва да преминете към безплатен акаунт, след което да изберете желаната опция. Поддръжката на Positionstack е готова да ви помогне, ако имате нужда от помощ за това.
• Плащане по сметка - Това са самостоятелни обяснения; всеки от двата раздела ще ви позволи да актуализирате идентификационните си данни по всяко време. Трябва да се каже, че ние оценяваме, че те не погребват тези основни контроли в прекалено проектиран и бърз интерфейс. WYSIWYG.
• Използване на API - Вероятно разделът, който ще посещавате най-често, тук можете да намерите каква част от месечната си квота за заявки сте изяли досега. Има и удобен раздел, показващ статистическите данни за използването ви във времето, така че можете да коригирате съответно стратегията си.

Документация за API

Сега стигаме до сърцето и душата на предлагането на Positionstack: Документация за API. Помислете тази страница за вашето ръководство за потребителя, което подробно описва всяка крайна точка на API, техните параметри и какъв вид информация ще върнат.

Тази страница е разделена на пет различни раздела. Ще преминем през всеки, като отделим време и многословия, за да предоставим някакъв контекст, за да разберете по-добре какво ще намерите.

Приготвяме се да започнем

Ето, ще намерите основни функции които се отнасят за всяка заявка, която отправяте с Positionstack. Това са:

• API ключ - Вашият API ключ е като цифров паспорт, който ще използвате за достъп до набора от данни на Positionstack. Без него API е безполезен за вас. Ако смятате, че е компрометиран, можете лесно да завъртите стария си ключ за нов.
• Encryption - 256-битовото SSL криптиране се използва в целия Интернет и е основа на индустрията за сигурност по добра причина. Въпреки че ще ви е необходим основен план или по-добре да шифровате комуникациите на приложението си със сървърите на Positionstack, това си струва инвестицията самостоятелно. За да предизвикате криптиране, просто променете HTTP на HTTPS в базовия URL адрес на API. Simple!
• Обратни обаждания от JSON - Няма да изпадаме в твърде много технически подробности за това как работи, но ако вашите заявки за API се преустановяват чрез политики със същия произход, използвайте обратните извиквания на JSON, за да повлияете на решение. По същество вие изисквате данни от външен скрипт, който не се залива с проблеми, свързани с междудомейни.
• Грешки в API - Както при всичко, понякога заявките ви за API ще се сблъскат с грешки. Positionstack разбира това и е вградил в приложението си функционалност за докладване на грешки, за да ви помогне да идентифицирате какво се обърка. Провалите при заявката на API автоматично ще върнат обект за грешка във формат JSON, плюс код, съобщение и под-обекти на контекста, за да предоставят контекст за грешката.

Крайните точки на API

Този раздел документира функционалността на месото и картофите на Positionstack, което означава пренасочване и обратно геокодиране. Ако не сте 100% сигурни каква е разликата, помислете за геокодирането като за двупосочна улица, където можете да превеждате места и адреси, написани на обикновен английски, до данни за местоположение като координати и IP адреси и обратното.

Затова ще използвате геокодиране напред, за да преобразувате местоположението на Айфеловата кула в координати. По подобен начин можете да разберете адреса на улицата, свързан с IP адрес, като използвате обратното геокодиране. Доста проста, в края на краищата!

Напред / назад заявки за геокодиране

За да направите основна заявка за всеки тип геокодиране, ще трябва да добавите подходящата крайна точка (/forward или /reverse) до основния URL адрес на API. След това ще предоставите вашия ключ за достъп, след което ще направите запитване използвайки или обикновен английски адрес за местоположение или съответните му данни за местоположение - и, voila! Ще изглежда така:

https://api.positionstack.com/v1/forward? access_key = YOUR_ACCESS_KEY & заявка = 1600 Пенсилвания Ave NW, Вашингтон. 

или

https://api.positionstack.com/v1/reverse? access_key = YOUR_ACCESS_KEY & заявка = 40.7638435, -73.9729691. 

Разбира се, наборът от данни на Positionstack съдържа много, много повече от само адреси и координати. Можете да анализирате тези други категоризации чрез използването на различни параметри. Ето пример за това какво напред геокодиране запитването, запитване към Белия дом, изглежда така:

{"data": {"results": [{"laitude": 38.897675, "longitude": -77.036547, "label": "1600 Pennsylvania Avenue NW, Washington, DC, USA", "name": "1600 Пенсилвания авеню NW "," тип ":" адрес "," номер ":" 1600 "," улица ":" Пенсилвания авеню NW "," пощенски код ":" 20500 "," увереност ": 1," регион ":" област на Columbia "," region_code ":" DC "," Administrative_area ": null," квартал ":" Grounds на Белия дом "," country ":" Съединени щати "," code_ country ":" US ", "map_url": " http://map.positionstack.com/38.897675,-77.036547" } ] } }

Интересното е, че ако трябваше да правите a обратно геокодиране заявка с помощта на приблизителните координати на Белия дом, върнатите резултати ще изглеждат почти идентични, освен че ще видите разликата в разстояние между вашите координати и официалните координати на Белия дом, както се показват в набора от данни на Positionstack.

Причината за това сходство е, че и двете крайни точки използват един и същ масив от параметри GET и по този начин са в състояние да върнат (почти) едни и същи обекти на отговор. Това означава, че без значение какви изходни данни трябва да минете, можете да получите пълен комплект данни за местоположението в замяна. (Възможно е да стесните тези резултати с помощта на API на полета параметър, но ще го докоснем по-късно.)

Забележка: Страницата за документация на Positionstack подробно описва всеки параметър и обект на отговор, така че не забравяйте да го проверите!

Пакетни заявки

Последното основно заглавие в тази настройка на документацията се занимава партидни заявки. Всичко, което трябва да направите, е да се позовете на това партида параметър, след това гнездо множество запитване екземпляри (заедно с желаните от вас параметри) отдолу в една заявка, а API за Positionstack се грижи за останалото. Мъртво е просто и изглежда така:

{"batch": [{"query": "Main Street", "country": "US", "region": "Minnesota"}, {"query": "Main Street", "държава": "САЩ", "регион": "Илинойс"}, {"заявка": "Главна улица", "държава": "САЩ", "регион": "Мисури"} ] }

Разширени данни

В допълнение към основните параметри на местоположението, можете допълнително да приспособите заявките си за API, за да върнете повече напреднали данни. Те включват:

• Карти за вграждане - Връща обект map_url, свързан с резултата ви от геокодиране, който можете да използвате, за да създадете атрактивно визуално представяне на картата на вашия уебсайт или приложение.
• Държавен модул - За разлика от други параметри, които се връщат до няколко обекта на отговор, country_module връща невероятен масив от данни за вашата заявена държава. Това не са само координати и адреси; това е столицата, знамето, официалното наименование, статутът на държава без изход (или не), валути, използвани езици, кодове за повикване и други.
• Модул за слънце - Хумористично документацията на Positionstack описва това като „Астрологични“ данни. Няма да получите своя хороскоп с този параметър, но ще видите данни за това кога слънцето изгрява и залязва, според астрономическата, гражданската и морската хронология.
• Модул на часовата зона - Допълни timezone_module да върнете компенсираното GMT на местоположението за секунди или като естествен езиков низ.
• Модул за ограничаване на кутията - Ако една двойка координати x / y не е подходяща за вашата задача, опитайте ограничително поле, което обхваща област с минимални и максимални стойности за дължина и ширина.

Допълнителни опции

API за позиции атака има много данни, които да ви хвърлят, но за щастие ви предоставя допълнителни инструменти за управление на тази пътека от информация.

• Посочете полета за отговор - Покрихме задълбочено колко данни могат да върнат Positionstack, но имайте предвид, че всички тези данни се получават на цена. Ако искате да ограничите месечните си заявки, можете да го направите с полета прикачането field = results.flag, например, ще накара API да извежда само знамето на вашата заявена държава. Можете да се позовете полета толкова пъти, колкото е необходимо, за да получите конкретния набор от данни, който се нуждаете.
• Посочете изходния формат - Безплатните абонати са ограничени до формат JSON за върнатите им резултати от геокодиране. Плащащите клиенти обаче могат да добавят продукция по исканията им да посочат JSON, XML или GeoJSON, ако е необходимо.

Примери за код

Когато Positionstack каже, че са тук, за да ви помогнат, те имат предвид. Вече видяхме колко подробна е тяхната документация, но я допълват удобно примери за код на всички езици, които техният API поддържа. Няма да копираме / поставяме този код тук, но за бърза справка тези езици са:

• Питон
• Nodejs
• JQuery
• Отивам
• рубин

Доказателство и изпълнение

В този момент трябва да е ясно, че Positionstack е способен да направи доста. Но, колко добре прави ли тези неща?

Първо, нека разгледаме някакъв контекст. Positionstack е една от 20+ API микросервизи в облачната екосистема на Apilayer. Заедно тези API-та обслужват над милион B2B клиенти от стартиращи компании до целия бизнес. Някои от най-забележителните им клиенти включват Amazon, Apple, Slack, LinkedIn и много други имена на домакинствата. Ясно е, че имат някаква здрава инфраструктура, която да се справи с този мащаб на търсенето.

Само по себе си, Positionstack е в съответствие с родословието си, с невероятните 100% продължителност през 2020 г. по време на писането. Това е още по-впечатляващо, когато вземете предвид API рутинно обработва над милиард търсене на геокод на ден на клиент на кит, да не говорим за главозамайващия масив от едновременни заявки, идващи от техните стабилни от SMB клиенти. Нещо повече, тези искания обикновено получават отговори между 10 и 100 ms.

В нашата книга това е нещо като технологично чудо, особено като се има предвид колко агресивно е цената на тази оферта на SaaS.

И не само суровата мощност прави Positionstack толкова привлекателен. Техният набор от данни е наистина сложен, получен от надеждни имена като Nominatim, GeoNames, Pelias и OpenStreetMap. Positionstack кръстосано проверява, филтрира и рекомбинира това богатство от данни няколко пъти на ден, като настоява за редовни актуализации чрез интелигентни алгоритми, които гарантират, че винаги имате високо точни данни за местоположението, навсякъде по света и в реално време.

Мразим да разваляме окончателната си присъда, но ако търсите стабилно, мащабируемо решение за геокодиране, възобновяването на Positionstack изисква по-внимателно разглеждане.

Ценообразуване

Apilayer си постави за цел да предостави достъпна алтернатива на високо скъпия софтуер за геокодиране на корпоративно ниво и за тази цел те успяха.

Positionstack идва в пет ценообразуване подрежда и поддържа месечно таксуване или годишни абонаменти с 20% отстъпка. Тези нива са:

• Безплатно - Оценен за лична употреба, все още получавате добър пробег с 25 000 месечни заявки за геокодиране напред и назад, изведени във формат JSON. Не получавате много разширени функции или поддръжка на клиенти, но вече ви показахме какъв ценен ресурс е тяхната страница с документация. Този ред е безплатен и без задължения - дори не е необходимо да предоставяте данни за кредитна карта, за да започнете.
• Основен - Търговски пакет за входно ниво. Основните абонати утрояват месечната си квота до 100 000 заявки за геокодиране, плюс получават достъп до разширени функции като криптиране на HTTPS, множество опции за изход (JSON, XML, GeoJSON), вграждащи се карти, няколко езика, и още. Вземете търговски лиценз Positionstack само за $ 9,99 на месец.
• професионален - Най-популярното предложение на Positionstack, Професионалният слой предлага десетократно увеличение на заявките за геокодиране - до 1 000 000 на месец. Всички екстри от Basic ниво присъстват, а след това и някои, по-специално включително заявки за партиди за тежки приложения. Този ред работи с $ 49,99 на месец.
• Бизнес - Придвижвайки се в мащаб на предприятието, Business Tier балонира месечната квота до огромните 3 000 000 заявки. За пореден път всяка разширена функция е напълно достъпна, подкрепена от страстния екип за поддръжка на Positionstack, който да ви помогне да извлечете максимума от тях. 99,99 долара на месец.
• начинание - Това е ниво, в което стандартните оферти излизат през прозореца, а клиентът е крал. Имате точни нужди, които изискват персонализирани решения, а Positionstack е готов да постигне целите си. Вие диктувате своите месечни заявки за обем, дори (особено), ако те са променливи. Нуждаете се от повече конски сили от API? Достигнете до поддръжка за решения, създадени по поръчка. Свържете се с Positionstack за оферта.

присъда

Positionstack прави точно това, което си е поставил за цел: да свали геокодирането на корпоративно ниво от ценовите точки в противен случай извън бюджета до повечето SMB, без да се жертва ефективността. Техният API е добре документиран и лесен за използване, но разполага със здрава интеграция във всички основни езици за програмиране за максимална полезност. Броят на заявките, с които Positionstack рутинно се справят, е потресаващ, докато техният набор от данни се поддържа интелигентно за наистина глобален обхват в геокодиране в реално време. Ако сте на пазара за този тип продукти, не спите на Positionstack.

Каква интеграция планирате? Как ще използвате геокодирането във вашия бизнес? Имате ли въпроси или коментари относно Positionstack? Оставете ни бележка в коментарите по-долу.