Geoapify сочетает геокодирование с более широким набором геосервисов, поэтому построенные на нём интеграции иногда затрагивают больше кода, чем можно было бы ожидать от одного вызова API. Наш совместимый хост сосредоточен именно на структуре запросов и ответов геокодирования, воспроизведённой в точности, чтобы эту часть можно было перенести, не затрагивая всё остальное.
Хост точно воспроизводит параметры запросов и тело ответа Geoapify, за исключением текста об авторских правах, условиях и конфиденциальности, который принадлежит нам, а не исходному провайдеру. Запрос, сейчас сформированный для эндпоинтов геокодирования Geoapify, можно отправить на наш хост как есть, а возвращаемый JSON разбирается так же, как уже ожидает существующий код.
Такое сужение охвата сделано намеренно. Собственная платформа Geoapify наряду с геокодированием охватывает маршрутизацию, изохроны и поиск мест, и попытка воспроизвести всё это в одном совместимом хосте привязала бы график его выпусков к функциям, далеко выходящим за рамки геокодирования. Ограничение хоста эндпоинтами геокодирования позволяет легко сверять его с исходным сервисом и поддерживать в актуальном состоянии по мере того, как My Geocode добавляет собственные возможности.
Для перехода нужно изменить имя хоста и ключ, и больше ничего. Этот ключ проходит аутентификацию так же гибко, как на всех наших хостах: в заголовке X-API-Key, в заголовке Authorization: Bearer, через HTTP Basic auth с ключом в качестве имени пользователя или в параметре запроса. Какой бы способ ни использовал ваш текущий клиент, здесь он тоже принимается.
Цены при этом не отличаются от остальной платформы. Любой адрес получает 2 500 бесплатных запросов в день вообще без ключа, с подсчётом по сети. Ключ добавляет сверх этого свои 2 500 бесплатных запросов в день. Сверх обеих квот предоплаченный баланс стоит 0,0001 € за запрос, или пакет Unlimited покрывает всё за 50 € в месяц, и тот же тариф действует независимо от того, ушёл ли запрос на этот хост или напрямую на /v1/forward.
Заголовки квот здесь тоже сопровождают каждый ответ: 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 присутствуют все, давая прозрачность, которой обычная интеграция с Geoapify сама по себе не обладает.
Перенос интеграции геокодирования к новому провайдеру также хороший повод в целом усилить безопасность аккаунта. Настройка двухфакторной аутентификации в личном кабинете находится рядом с API-ключами и оплатой, поэтому её включение для аккаунта, в котором теперь есть новый ключ, занимает один дополнительный шаг, а не становится отдельным проектом.
Если нужно что-то сверх стандартного совместимого ответа, добавление mg_extras=1 к запросу или заголовка X-MG-Extras накладывает необязательные поля поверх, не меняя базовую структуру, пока это явно не запрошено.
Полная документация по хосту находится на /compatibility/geoapify/, а общий справочник по совместимости, охватывающий все семнадцать хостов, на /docs/compatibility/. Если Geoapify уже стоит за частью вашего стека, это простой способ сравнить его с нашим сервисом.