Google Maps Platform входит в число самых широко интегрированных сервисов геокодирования, и поэтому от него одним из самых трудных оказывается уйти. Переписывать формирование запросов и разбор ответов по всему коду только ради того, чтобы попробовать другого провайдера, редко окупает затраченное время разработчиков. Поэтому мы создали хост, который не требует ничего переписывать.
Наш совместимый хост для Google Maps Platform в точности воспроизводит параметры запросов и структуру ответов исходного сервиса, за исключением текста об авторских правах, условиях и конфиденциальности, который принадлежит нам. Всё, что ваша интеграция сейчас отправляет на эндпоинты геокодирования Google, она может отправлять вместо этого на наши. Смена провайдера становится вопросом замены имени хоста и ключа, а не проектом разработки.
Этот хост работает наряду с нашими собственными эндпоинтами. Если вы начинаете с нуля, /v1/forward, /v1/reverse, /v1/autocomplete и /v1/postcode описаны на /docs/ и дают вам нашу структуру запросов напрямую. Если у вас уже есть код, написанный под формат Google, совместимый хост на /compatibility/google-maps/ позволяет оставить его как есть.
Аутентификация работает так же гибко, как и во всём My Geocode: передайте ключ в заголовке X-API-Key, в заголовке Authorization: Bearer, через HTTP Basic auth с ключом в качестве имени пользователя или в параметре запроса. Какой бы способ ни использовала ваша клиентская библиотека для API Google, один из этих четырёх ему соответствует, так что код аутентификации в вашей интеграции тоже редко приходится менять.
Цены на совместимом хосте такие же, как и везде в My Geocode. Каждый ключ получает 2 500 бесплатных запросов в день сверх 2 500 в день, доступных с любого адреса вообще без ключа, с подсчётом по сети. Сверх этого предоплаченный баланс расходуется по 0,0001 € за запрос, или пакет Unlimited покрывает всё за 50 € в месяц. Отдельного, более высокого тарифа за использование совместимого хоста вместо собственного эндпоинта нет. Каждый эндпоинт и каждый drop-in хост стоят одинаково.
Каждый ответ также содержит те же заголовки квот, что и остальной API: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Credits-Remaining и другие, что даёт вам прозрачность использования, которую простая замена провайдера иначе бесплатно не предоставила бы.
Если вашей интеграции нужно больше, чем стандартный ответ, добавление mg_extras=1 к запросу или заголовка X-MG-Extras накладывает поверх совместимой структуры необязательные дополнительные поля, например высоту над уровнем земли. Это исключительно дополнение: если его не указывать, ответ точно соответствует формату исходного провайдера.
Попробовать это можно за несколько минут, а не за спринт. Отправьте тестовый запрос на /compatibility/google-maps/ с новым ключом и сравните ответ с тем, что вы получаете сегодня.