Многие картографические интеграции были построены годы назад на Bing Maps REST Services и с тех пор просто продолжают работать нетронутыми, потому что убедительной причины их переписывать так и не появилось. Мы считаем, что теперь такая причина есть: совместимый хост, который принимает те же запросы и возвращает ответы той же структуры, с ценами и квотами, прозрачными с первого же запроса.
Наш совместимый хост для Bing Maps REST Services в точности повторяет параметры запросов и тело ответа исходного сервиса, за исключением текста об авторских правах, условиях и конфиденциальности, который относится к My Geocode, а не к исходному провайдеру. Существующий код, который формирует запросы в формате Bing, разбирает ответы в формате Bing или делает и то и другое, можно направить на наш хост без какой-либо переработки.
Для этого нужно изменить две вещи: имя хоста, на который уходят ваши запросы, и ключ, которым вы проходите аутентификацию. Этот ключ можно передавать так, как ваша интеграция уже привыкла: в заголовке X-API-Key, в заголовке Authorization: Bearer, через HTTP Basic auth с ключом в качестве имени пользователя или в обычном параметре запроса. Все четыре способа работают одинаково на каждом хосте 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 и остальные заголовки нашего стандартного набора, так что вы всегда точно знаете, в каком положении находится конкретный ключ или сеть. Исходный сервис в таком виде этого не предлагает.
Командам, которым нужно больше, чем строго совместимый ответ, mg_extras=1 в запросе или заголовок X-MG-Extras добавляет необязательные поля поверх стандартной структуры, не нарушая её. Если этот флаг не указывать вовсе, ответ по структуре неотличим от того, что вернул бы исходный API.
Руководства по миграции, которые пошагово, эндпоинт за эндпоинтом, описывают перенос существующей интеграции, находятся на /docs/compatibility/, а сам хост описан на /compatibility/bing-maps/. Проверка не стоит ничего, кроме нескольких свободных минут и ключа.