LocationIQ занял своё место во многих стеках, которые начинались с малого и выросли, часто потому, что его было легко внедрить на раннем этапе. Наш совместимый хост нацелен именно на такие интеграции: они сегодня исправно работают, никогда не задумывались как постоянные и просто никогда не стоили переписывания.
Хост в точности воспроизводит параметры запросов и тело ответа LocationIQ, за исключением текста об авторских правах, условиях и конфиденциальности, который принадлежит My Geocode. Запросы в формате эндпоинтов LocationIQ можно отправлять на наш хост без изменений, а возвращаемый ответ разбирается так же, как этого уже ожидает существующий код.
Такая точность не объясняется особыми усилиями, потраченными на каждого провайдера. Каждый совместимый хост работает поверх той же системы оплаты, квот и аккаунтов, на которой работает весь остальной My Geocode, поэтому создание нового хоста сводится в основном к сопоставлению: имена полей и структура параметров приводятся в соответствие с тем, что уже отправляют клиенты данного провайдера, без развёртывания отдельного бэкенда. Именно поэтому цены, аутентификация и учёт квот ведут себя одинаково на всех семнадцати хостах и со временем не расходятся друг с другом.
Аутентификация устроена так же, как на всех хостах платформы. Передайте ключ в заголовке X-API-Key, в заголовке Authorization: Bearer, через HTTP Basic auth с ключом в качестве имени пользователя или в параметре запроса, так же, как это уже делает ваша текущая интеграция с LocationIQ. Здесь принимаются все четыре способа без исключения, поэтому переход редко требует вообще трогать ваш HTTP-клиент.
Цены не меняются в зависимости от того, какой хост или эндпоинт обрабатывает запрос. Любой адрес получает 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 добавляет поверх необязательные дополнительные поля, исключительно по вашему выбору. В запросе геокодирования это может быть высота над уровнем земли для возвращённых координат, взятая из того же источника, который отвечает на /v1/elevation напрямую. Без этого формат ответа в точности соответствует структуре LocationIQ, без сюрпризов для существующей логики разбора.
Аккаунты, которые переходят и убеждаются, что всё выдерживает реальный трафик, часто в итоге рекомендуют это тем в своей команде, кто всё ещё платит исходному провайдеру. Реферальная программа в личном кабинете, на /dashboard/referrals, создана именно для таких рекомендаций из уст в уста.
Хост описан на /compatibility/locationiq/, а общие рекомендации по смене провайдера находятся на /docs/compatibility/. Обычно одного тестового запроса с новым ключом достаточно, чтобы убедиться, что он без проблем вписывается в существующую интеграцию.