Совместимая замена PositionStack

Эндпоинты прямого и обратного геокодирования PositionStack отвечают на positionstack.mygeocode.com с тем же массивом data и плоскими названиями полей. HTTPS здесь доступен на любом тарифе, включая бесплатный.

Измените одно имя хоста

Исходный хост	`api.positionstack.com`
Используйте вместо него	`positionstack.mygeocode.com`
Параметр ключа	`access_key` (необязательно: любой адрес получает 2 500 запросов в день без ключа; укажите здесь свой ключ My Geocode, чтобы пользоваться балансом, пакетами и историей использования)

До

curl "http://api.positionstack.com/v1/forward?access_key=YOUR_POSITIONSTACK_KEY&query=350+5th+Avenue+New+York"

После

curl "https://positionstack.mygeocode.com/v1/forward?access_key=YOUR_MYGEOCODE_KEY&query=350+5th+Avenue+New+York"

Почему переходят

Бесплатный тариф PositionStack работает только по HTTP и ограничен помесячно. Здесь всё работает по HTTPS, а бесплатная квота каждого ключа сбрасывается ежедневно.

Та же бесплатная квота, с ключом или без. Запросы к positionstack.mygeocode.com учитываются в тех же 2 500 бесплатных запросах в день, которые ваш адрес или ваш ключ получает на наших собственных эндпоинтах. Сверх этого: предоплаченный баланс по 0,0001 € за запрос или 50 € в месяц за ключ Unlimited. Для регистрации нужен только адрес электронной почты.

Смотреть цены Получить бесплатный ключ

Эндпоинты

Путь на positionstack.mygeocode.com	Что делает	На основе
`/v1/forward?query=...`	Прямое геокодирование	Прямое геокодирование
`/v1/reverse?query=lat,lng`	Обратное геокодирование	Обратное геокодирование

Пример ответа

Вот что возвращает запрос выше. Названия полей, вложенность и типы соответствуют PositionStack. Наши только данные за ними.

Ответ от positionstack.mygeocode.com

{
  "data": [
    {
      "latitude": 40.748428,
      "longitude": -73.985654,
      "type": "address",
      "name": "350 5th Avenue",
      "number": "350",
      "postal_code": "10118",
      "street": "5th Avenue",
      "confidence": 1,
      "region": "New York",
      "region_code": "NY",
      "county": "New York County",
      "locality": "New York",
      "administrative_area": null,
      "neighbourhood": "Midtown",
      "country": "United States",
      "country_code": "USA",
      "continent": "North America",
      "label": "350 5th Avenue, New York, NY, USA"
    }
  ]
}

Подробности и отличия

Для первых 2 500 запросов в день ключ не нужен. Чтобы использовать ключ My Geocode, укажите его там, где был ключ positionstack: в параметре запроса access_key. Заголовок X-API-Key, Authorization: Bearer и базовая HTTP-аутентификация (ключ в качестве имени пользователя) тоже работают на каждом хосте, поэтому клиентские библиотеки со своим способом аутентификации продолжают работать без изменений.

И прямое, и обратное геокодирование возвращают массив data.
Пакетного эндпоинта нет, потому что его нет у оригинала. Для массовой обработки используйте POST /v1/forward или /v1/reverse на api.mygeocode.com (до 100 за вызов, каждый элемент считается одним запросом).

Если ваш клиент зависит от поля или поведения, которого здесь нет, сообщите нам. Пробелы в совместимости исправляются быстро, потому что обычно они невелики.

Другие совместимые хосты

Как работают совместимые хосты, обзор и совместимые замены для библиотек JavaScript.