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

Эндпоинты поиска, обратного геокодирования, автодополнения и часовых поясов LocationIQ отвечают на locationiq.mygeocode.com. JSON-массив в стиле Nominatim с display_name, address и boundingbox возвращается в неизменной структуре.

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

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

До

curl "https://us1.locationiq.com/v1/search?key=YOUR_LOCATIONIQ_KEY&q=Sydney+Opera+House&format=json"

После

curl "https://locationiq.mygeocode.com/v1/search?key=YOUR_MYGEOCODE_KEY&q=Sydney+Opera+House&format=json"

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

Тот же интерфейс, 2 500 бесплатных запросов в день на ключ и ключ Unlimited по фиксированной цене для нагруженных приложений.

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

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

Эндпоинты

Путь на locationiq.mygeocode.com	Что делает	На основе
`/v1/search?q=...&format=json`	Прямое геокодирование	Прямое геокодирование
`/v1/reverse?lat=...&lon=...&format=json`	Обратное геокодирование	Обратное геокодирование
`/v1/autocomplete?q=...`	Автодополнение	Автодополнение адресов
`/v1/timezone?lat=...&lon=...`	Часовой пояс	Определение часового пояса

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

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

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

[
  {
    "place_id": "mg.au.poi.3b7e91c0",
    "licence": "Data by My Geocode, https://www.mygeocode.com/terms/",
    "osm_type": "way",
    "osm_id": 4245932,
    "boundingbox": ["-33.8576", "-33.8560", "151.2141", "151.2166"],
    "lat": "-33.8567844",
    "lon": "151.2152967",
    "display_name": "Sydney Opera House, Bennelong Point, Sydney, New South Wales, 2000, Australia",
    "class": "tourism",
    "type": "attraction",
    "importance": 0.8543,
    "icon": "https://www.mygeocode.com/assets/img/icons/tourism.png",
    "address": {
      "name": "Sydney Opera House",
      "road": "Bennelong Point",
      "suburb": "Sydney",
      "city": "Sydney",
      "state": "New South Wales",
      "postcode": "2000",
      "country": "Australia",
      "country_code": "au"
    }
  }
]

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

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

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

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

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

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