MapQuest Geocoding входит во множество давно работающих приложений, некоторые из которых годами не трогали свой код поиска местоположений, потому что он просто продолжает работать. Наш совместимый хост создан именно для такой ситуации: код исправно работает, никто не хочет его переписывать, но команда всё же хотела бы уйти от устаревающей интеграции без перестройки.
Хост в точности воспроизводит параметры запросов и тело ответа MapQuest, за исключением текста об авторских правах, условиях и конфиденциальности, который принадлежит нам, а не исходному провайдеру. Запрос, сейчас сформированный для эндпоинтов геокодирования MapQuest, можно отправить на наш хост как есть, а возвращаемый ответ разбирается так же, как этого уже ожидает существующий код.
Изменить нужно только имя хоста и ключ. Этот ключ проходит аутентификацию тем из четырёх наших стандартных способов, который соответствует вашей текущей интеграции: заголовок X-API-Key, заголовок Authorization: Bearer, HTTP Basic auth с ключом в качестве имени пользователя или параметр запроса.
Чтобы получить этот ключ, не нужно сначала завершать подтверждение аккаунта. Ключи нового аккаунта работают в течение льготного периода, прежде чем My Geocode потребует подтвердить адрес электронной почты, указанный при регистрации, а после этого неподтверждённые ключи приостанавливаются, а не отказывают полностью. Это важно именно для такого тестирования миграции, когда кто-то хочет направить устаревшую интеграцию на новый хост в пятницу после обеда, не дожидаясь обмена письмами.
Цены устроены так же, как и везде в My Geocode. Любой адрес получает 2 500 бесплатных запросов в день вообще без ключа, с подсчётом по сети. Ключ добавляет свои отдельные 2 500 бесплатных запросов в день. Сверх этих квот предоплаченный баланс стоит 0,0001 € за запрос, или пакет Unlimited покрывает использование за 50 € в месяц, и тариф на этом хосте ничем не отличается от любого другого.
Каждый ответ содержит те же заголовки квот, что и на остальной платформе: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used, X-Credits-Remaining, X-Key-IPs-Used, X-Key-IPs-Limit и X-Quota-Reset. Два из них, X-Key-IPs-Used и X-Key-IPs-Limit, отслеживают то, что относится к ключам, а не к сетям: каждому ключу разрешено небольшое скользящее число IP-адресов, с которых его можно вызывать. Это не даёт использовать один ключ на множестве не связанных между собой серверов, но при этом допускает обычный деплой, меняющий исходящий адрес приложения.
Для проектов, которым нужно больше, чем возвращает совместимый ответ, mg_extras=1 в запросе или заголовок X-MG-Extras добавляет необязательные поля поверх стандартной структуры, исключительно по вашему выбору.
Документация по хосту находится на /compatibility/mapquest/, а более широкий обзор совместимости на платформе на /docs/compatibility/. Если MapQuest Geocoding всё ещё тихо работает в вашем стеке, это недорогой способ увидеть, как выглядит современная структура квот под той же привычной оболочкой.