Geocode.Farm давно и незаметно обеспечивает геокодирование во многих небольших приложениях и внутренних инструментах, часто подключённый ещё на ранней стадии разработки и с тех пор не тронутый. Наш совместимый хост предназначен именно для таких интеграций: они исправно работают и заслуживают простого пути вперёд, а не переписывания.
Хост в точности воспроизводит параметры запросов и тело ответа Geocode.Farm, за исключением текста об авторских правах, условиях и конфиденциальности, который принадлежит My Geocode. Запросы, сейчас сформированные для эндпоинтов Geocode.Farm, можно направить на наш хост как есть, а ответ возвращается в той же структуре, которую уже ожидает существующий код.
Для перехода нужно изменить имя хоста и ключ, и ничего в логике формирования запросов или разбора ответов вокруг них. Этот ключ может проходить аутентификацию в заголовке X-API-Key, в заголовке Authorization: Bearer, через HTTP Basic auth с ключом в качестве имени пользователя или в параметре запроса, в зависимости от того, что уже отправляет ваша текущая интеграция.
Такие старые интеграции часто писались напрямую на сырых HTTP-вызовах, ещё до того, как у провайдера появился SDK или его стоило внедрять. My Geocode выпускает собственные SDK, перечисленные на /sdks/, для тех, кто предпочёл бы полностью уйти от сырого 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, X-Key-IPs-Used, X-Key-IPs-Limit и X-Quota-Reset, что даёт прозрачность использования, которой у небольшой старой интеграции, возможно, никогда раньше не было.
Для проектов, которым нужно больше, чем возвращает совместимый ответ, добавление mg_extras=1 к запросу или заголовка X-MG-Extras накладывает поверх необязательные дополнительные поля, исключительно по вашему выбору и по умолчанию выключенные.
Так число наших опубликованных совместимых хостов достигает семнадцати, и они охватывают геокодирование, IP-геолокацию и высоту. Дело было не столько в том, чтобы охватить всех возможных провайдеров, сколько в том, чтобы охватить тех, которыми действительно пользуются реальные интеграции, поэтому список охватывает эти три категории, а не сосредоточен целиком вокруг одной из них.
Сам хост описан на /compatibility/geocode-farm/, а полный список находится на /compatibility/. Если Geocode.Farm входит в одну из старых интеграций вашего стека, это простой способ увидеть, как выглядит современная структура квот за той же структурой запросов.