Получите геокодирование корпоративного уровня бесплатно с API Positionstack (ОБЗОР)

Вам не обязательно быть Google Maps, чтобы получить пользу от геокодирования. И, благодаря Positionstack, для этого вам не нужен технический бюджет Big G. Сегодня мы рассмотрим надежный API Positionstack, цель которого - сделать прямое и обратное геокодирование корпоративного уровня доступным и удобным для использования.

Стек позиций 101

Итак, зачем вам читать обзор Positionstack , содержащий более 2000 слов , и что вы от этого выиграете? Ответ звучит мило, но это точно: на весь мир .

Задумайтесь на мгновение, сколько мест на карте мира. Теперь умножьте это число в уме на каждый фрагмент метаданных, которые необходимо знать вашему бизнесу об этих местах. Это то, что предлагает Positionstack, и еще кое-что.

Давайте посмотрим на небольшую статистику по Positionstack:

• Фактические миллиарды запросов на поиск геокодирования обрабатываются каждый час, каждый день; со 100% временем безотказной работы и <100ms = "" response = "">
• Облачная, высокомасштабируемая инфраструктура
• Данные в реальном времени по каждой стране мира, скомпилированные в обширный набор данных, который обновляется каждые несколько часов.
• Щедро распределенные планы подписки по конкурентоспособным ценам; плюс непревзойденная ежемесячная квота на 10 000 запросов для бесплатных пользователей
• Поддержка интеграции для всех основных языков программирования
• Исчерпывающая, удобная для чтения документация с фрагментами кода
• Команда мирового уровня по удовлетворению запросов клиентов с опытом работы с такими клиентами, как Zendesk, Slack, LinkedIn, Lyft, Apple и Amazon.

Positionstack, безусловно, имеет свою родословную под контролем, но если вас не убедили несколько пунктов, давайте глубоко погрузимся в то, каково это на самом деле использовать API.

Трехэтапное руководство по началу работы с Positionstack

Если вы проведете какое-то время на их веб-сайте, вы увидите, что Positionstack действительно подчеркивает простоту использования как основной аргумент в пользу своего API. В процессе регистрации вы сразу увидите, что это правда. Фактически, первое, что вы видите после ввода учетных данных, - это краткая дорожная карта того, что нужно для того, чтобы начать работу с Positionstack за три простых шага. Давайте взглянем:

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

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

Панель инструментов вашего стека позиций

Positionstack, удваивая свою основную ценность, заключающуюся в удобстве использования, предлагает оптимизированную и незагроможденную панель инструментов, из которой вы можете получить доступ ко всему, что вам нужно знать о своем API. Давайте посмотрим на параметры боковой панели:

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

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

Теперь мы переходим к сути предложения Positionstack: документации по API . Считайте эту страницу своим руководством пользователя, в котором подробно описаны все конечные точки API, их параметры и какая информация они будут возвращать.

Эта страница разбита на пять разных разделов. Мы рассмотрим каждый из них, потратив некоторое время и используя словоблудие, чтобы предоставить вам некоторый контекст, чтобы вы могли лучше понять, что вы найдете.

Начиная

Здесь вы найдете основные функции, которые применимы к каждому запросу, который вы делаете с помощью Positionstack. Эти:

• Ключ API. Ваш ключ API подобен цифровому паспорту, который вы будете использовать для доступа к набору данных Positionstack. Без него API для вас бесполезен. Если вы считаете, что он был взломан, вы можете легко заменить старый ключ на новый.
• Шифрование - 256-битное шифрование SSL используется во всем Интернете и является отраслевым стандартом безопасности по уважительной причине. Хотя вам понадобится план Basic или лучше для шифрования связи вашего приложения с серверами Positionstack, само по себе оно того стоит. Чтобы вызвать шифрование, просто измените HTTP на HTTPS в базовом URL-адресе API. Простой!
• Обратные вызовы JSON - мы не будем вдаваться в технические подробности того, как это работает, но если ваши запросы API ограничиваются политиками одного и того же происхождения, вы используете обратные вызовы JSON, чтобы повлиять на обходной путь. По сути, вы запрашиваете данные из внешнего скрипта, который не увяз в междоменных проблемах.
• Ошибки API - как и все остальное, иногда ваши запросы API будут вызывать ошибки. Positionstack понимает это и встроил в свое приложение функцию отчетов об ошибках, чтобы помочь вам определить, что пошло не так. При ошибках запроса API будет автоматически возвращен объект ошибки в формате JSON, а также подобъекты кода, сообщения и контекста, чтобы предоставить контекст для ошибки.

Конечные точки API

В этом разделе документируется функциональность Positionstack «мясо-и-картофель», то есть прямое и обратное геокодирование. Если вы не уверены на 100%, в чем разница, подумайте о геокодировании как об улице с двусторонним движением, где вы можете переводить места и адреса, написанные на простом английском языке, в данные о местоположении, такие как координаты и IP-адреса, и наоборот.

Итак, вы должны использовать прямое геокодирование, чтобы преобразовать местоположение Эйфелевой башни в координаты. Точно так же вы можете узнать почтовый адрес, связанный с IP-адресом, с помощью обратного геокодирования. В конце концов, довольно просто!

Запросы прямого / обратного геокодирования

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

https://api.positionstack.com/v1/forward
    ? access_key = ВАШ_ACCESS_KEY
    & query = 1600 Pennsylvania Ave NW, Вашингтон, округ Колумбия

или

https://api.positionstack.com/v1/reverse
    ? access_key = ВАШ_ACCESS_KEY
    & query = 40.7638435, -73.9729691

Конечно, набор данных Positionstack содержит гораздо больше, чем просто адреса и координаты. Вы можете анализировать эти другие категории с помощью различных параметров. Вот пример того , как выглядит запрос прямого геокодирования , запрашивающий Белый дом:

{
   "данные": {
      "Результаты": [
         {
            «широта»: 38.897675,
            "долгота": -77.036547,
            "label": "1600 Pennsylvania Avenue NW, Вашингтон, округ Колумбия, США",
            "name": "1600 Pennsylvania Avenue NW",
            "тип": "адрес",
            "number": "1600",
            "улица": "Пенсильвания-авеню северо-запад",
            "postal_code": "20500",
            «уверенность»: 1,
            "region": "Округ Колумбия",
            "region_code": "DC",
            "административная_площадь": ноль,
            "окрестности": "Территория Белого дома",
            "страна": "США",
            "country_code": "США",
            "map_url": "https://map.positionstack.com/38.897675,-77.036547"
         }
      ]
   }
}

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

Причина этого сходства в том, что обе конечные точки используют один и тот же массив параметров GET и, таким образом, способны возвращать (почти) одни и те же объекты ответа. Это означает, что независимо от того, какие исходные данные вам нужно использовать, вы можете получить взамен полный набор данных о местоположении. (Можно сузить эти результаты, используя параметр полей  API , но мы коснемся этого позже.)

Note: Positionstack’s documentation page fully details each parameter and response object, so be sure to check it out!

Batch requests

The last major heading in this documentation setting deals with batch requests. All you’ve got to do is invoke the batch parameter, then nest multiple query instances (along with your desired parameters) underneath in a single request, and Positionstack’s API takes care of the rest. It’s dead simple, and looks like this:

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

Advanced Data

In addition to the basic location parameters, you can further tailor your API requests to return more advanced data. These include:

• Embeddable Maps – Returns a map_url object linked to your geocoding result, which you can use to create an attractive visual map representation on your website or app.
• Country Module – Unlike other parameters which return up to a few response objects, country_module returns an incredible array of data about your queried country. It’s not just coordinates and addresses, either; it’s the capital, flag, official name, status as a landlocked (or not) country, currencies used, languages spoken, calling codes, and more.
• Sun Module – Humorously, Positionstack’s documentation describes this as “Astrological” data. You won’t be getting your horoscope with this parameter, but you will see data about when the sun rises and sets, according to astronomical, civil, and nautical chronology.
• Timezone Module – Append timezone_module to return a location’s GMT offset in either seconds or as a natural language string.
• Bounding Box Module ­­– If a single x/y pair of coordinates isn’t right for your task, try a bounding box, which encloses an area with minimum and maximum values for longitude and latitude.

Additional Options

The Positionstack API has a ton of data to throw at you, but luckily it provides you with additional tools to manage this trove of information.

• Specify Response Fields – We’ve covered in depth how much data Positionstack can return, but keep in mind that all that data comes at a cost. If you want to limit your monthly requests, you can do that with the fields Appending fields = results.flag, for example, will cause the API to output only your queried country’s flag. You can invoke fields as many times as you need to get the specific dataset you require.
• Specify Output Format – Free subscribers are limited to the JSON format for their returned geocoding results. Paying customers, however, can append output on their requests to specify JSON, XML, or GeoJSON as necessary. 

Code Examples 

When Positionstack says they’re here to help you, they mean it. We’ve already seen how thorough their documentation is, but they top it off with handy code examples in all the languages their API supports. We’re not going to copy/paste that code here, but for quick reference, those languages are:

• Python
• Nodejs
• jQuery
• Go
• Ruby

Proof and performance

At this point, it should be clear that Positionstack is capable of doing quite a lot. But, how well does it do these things?

First, let’s consider some context. Positionstack is one of 20+ API microservices in Apilayer’s cloud-based ecosystem. Together, these APIs serve over a million B2B clients from startups all the way up to enterprise. Some of their most notable customers include Amazon, Apple, Slack, LinkedIn, and many more household names. Clearly, they’ve got some robust infrastructure to handle this scale of demand.

On its own merits, Positionstack lives up to its pedigree, with an incredible 100% uptime throughout 2020 at the time of writing. This is even more impressive when you consider the API routinely processes over a billion geocode lookups per day per whale client, not to mention the dizzying array of simultaneous requests coming from their stable of SMB customers. What’s more, these requests typically garner responses between 10 and 100 ms.

In our book, that’s something of a technological marvel, especially considering how aggressively priced this SaaS offering is.

And it’s not just raw power that makes Positionstack so appealing. Their dataset is truly sophisticated, sourced from reliable names like Nominatim, GeoNames, Pelias, and OpenStreetMap. Positionstack cross-checks, filters and recombines this wealth of data multiple times a day, pushing regular updates via smart algorithms that ensure you always have highly accurate location data, anywhere in the world, and in real time.

We hate to spoil our final verdict, but if you’re looking for a robust, scalable geocoding solution, Positionstack’s resume demands a closer look.

Pricing 

Apilayer set out to provide an affordable alternative to highly expensive enterprise-level geocoding software, and towards that end they have succeeded.

Positionstack comes in five pricing tiers, and supports monthly billing, or yearly subscriptions at a 20% discount. Those tiers are:

• Free – Rated for personal use, you’re still getting a good bit of mileage with 25,000 monthly requests for forward and reverse geocoding, outputted in the JSON format. You don’t get a lot of advanced features or customer support, but we’ve already shown you what a valuable resource their Documentation page is. This tier is free of charge, and free of obligation–you don’t even have to provide credit card details to get started.
• Basic – The entry-level commercial package. Basic subscribers quadruple their monthly quota to 100,000 geocoding requests, plus get access to advanced features like HTTPS encryption, multiple output options (JSON, XML, GeoJSON), embeddable maps, multiple languages, and more. Get a commercial Positionstack license for just $9.99 per month.
• Professional – Positionstack’s most popular offering, the Professional tier offers a tenfold increase in geocoding requests–up to 1,000,000 per month. All the goodies from the Basic tier are present and then some, notably including batch requests for heavy-duty applications. This tier clocks in at $49.99 per month.
• Business – Moving into enterprise-scale performance, the Business tier balloons the monthly quota to a whopping 3,000,000 requests. Once again, every advanced feature is fully available, backed by Positionstack’s passionate customer support team to help you get the most out of them. $99.99 per month.
• Enterprise – This is the tier in which standard offers go out the window, and the customer is king. You have precise needs that demand custom solutions, and Positionstack is at the ready to achieve your goals. You dictate your monthly volume requests, even (especially) if they’re variable. Need more horsepower from the API? Reach out to support for custom-built solutions. Contact Positionstack for a quote.

Verdict

Positionstack does precisely what it set out to do: bring enterprise-level geocoding down from price points otherwise out of budget to most SMBs, without sacrificing performance. Their API is well-documented and easy to use, but features robust integration across all major programming languages for maximum utility. The number of requests Positionstack routinely handles is staggering, while their dataset is smartly maintained for truly global reach in real-time geocoding. If you’re in the market for this type of product, don’t sleep on Positionstack.

What sort of integration do you have planned? How will you make use of geocoding in your business? Do you have any questions or comments on Positionstack? Leave us a note in the comments below.