Nominatim работает на данных OpenStreetMap и давно остаётся выбором по умолчанию для команд, которым нужен вариант геокодирования без коммерческой лицензии. Правила использования общего публичного экземпляра могут сделать такой вариант менее надёжным по мере роста трафика, и именно здесь пригодится совместимый хост с учётом квот.
Наш совместимый хост для Nominatim в точности воспроизводит параметры запросов и тело ответа исходного сервиса, за исключением текста об авторских правах, условиях и конфиденциальности, который принадлежит My Geocode. Запросы в формате Nominatim можно отправлять на наш хост без изменений, а ответ возвращается в той же структуре, которую уже ожидает существующий код разбора.
Аутентификация и здесь поддерживает наши обычные четыре способа: заголовок X-API-Key, заголовок Authorization: Bearer, HTTP Basic auth с ключом в качестве имени пользователя или параметр запроса. Поскольку публичный экземпляр Nominatim обычно вообще не требует ключа, добавление ключа здесь также означает, что вы получаете выделенную, отслеживаемую квоту вместо общего, никем не управляемого публичного ресурса.
Цены такие же, как на всех остальных наших хостах и эндпоинтах. Любой адрес получает 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 накладывает поверх необязательные дополнительные поля, не меняя базовую структуру, пока вы об этом не попросите.
Если вы не уверены, как переход поведёт себя в конкретной стране или регионе, на странице покрытия /coverage/ подробно описано, где доступны данные геокодирования. Это разумная первая остановка перед тем, как направлять рабочий трафик на любой новый хост, в формате Nominatim или любом другом.
Хост описан на /compatibility/nominatim/, а общие рекомендации по смене провайдера находятся на /docs/compatibility/. Тем, кто сегодня полагается на публичный экземпляр Nominatim, это даёт ту же структуру запросов с выделенной квотой и понятными заголовками квот.