Семнадцать совместимых хостов сложно отслеживать по одному анонсу за раз, поэтому мы собрали их все в одном месте: матрица совместимости на странице /compatibility/ перечисляет все поддерживаемые нами совместимые хосты рядом друг с другом, с прямой ссылкой на документацию каждого.
В список входят Google Maps Platform, Bing Maps REST Services, HERE Geocoding and Search, Mapbox Geocoding, Geocode.Farm, OpenStreetMap Nominatim, OpenCage, LocationIQ, Geoapify, TomTom Search, MapQuest Geocoding, Geocodio, PositionStack, ip-api.com, ipinfo.io, ipstack и Open-Elevation. Вместе они охватывают геокодирование, IP-геолокацию и определение высоты, в точности воспроизводя формат запросов и ответов каждого исходного провайдера, за исключением текстов об авторских правах, условиях и конфиденциальности, которые наши.
Смысл размещения их на одной странице не только в аккуратности. Команда, которая решает, от какого провайдера уйти, может сразу увидеть полную картину, а не узнавать о совместимых хостах по одному из отдельных анонсов. Если ваш стек использует больше одного из этих провайдеров, будь то Mapbox для геокодирования и ipinfo.io для определения IP или любое другое сочетание, матрица ясно показывает, что всех их можно объединить за одним аккаунтом My Geocode и одним ключом.
Такое объединение и есть главное преимущество подхода с совместимостью в целом. Один ключ проходит аутентификацию на каждом хосте из списка любым из наших четырёх стандартных способов, который уже предпочитает ваша интеграция: заголовок X-API-Key, заголовок Authorization: Bearer, HTTP Basic auth или параметр запроса. Использование всех хостов засчитывается в одну и ту же бесплатную квоту, один и тот же предоплаченный баланс или один и тот же пакет Unlimited, и каждый ответ, каким бы хостом он ни был сформирован, содержит одни и те же заголовки квоты. Один аккаунт, один ключ, один счёт, сколько бы отдельных провайдеров ни использовала раньше ваша интеграция.
Для команд, которые рассматривают более широкую миграцию, а не замену одного провайдера, эта матрица естественная отправная точка, а общие рекомендации по миграции находятся рядом, на странице /docs/compatibility/. Страница документации каждого хоста описывает конкретные параметры запроса и все детали, которые стоит знать перед переходом.
Мы планируем поддерживать эту страницу в актуальном состоянии по мере развития совместимости, чтобы она оставалась единым справочником о доступных возможностях, а не устаревала между отдельными анонсами.