Совместимая замена Geocode.Farm

Эндпоинты прямого и обратного геокодирования Geocode.Farm, в стилях URL как v3, так и v4, отвечают на farm.mygeocode.com. Вложенный объект geocoding_results с разделами STATUS, ACCOUNT, RESULTS и STATISTICS воспроизводится, поэтому существующие парсеры продолжают работать.

Измените одно имя хоста

Исходный хост	`api.geocode.farm` `www.geocode.farm`
Используйте вместо него	`farm.mygeocode.com`
Параметр ключа	`key` (необязательно: любой адрес получает 2 500 запросов в день без ключа; укажите здесь свой ключ My Geocode, чтобы пользоваться балансом, пакетами и историей использования)

До

curl "https://www.geocode.farm/v3/json/forward/?addr=530+W+Main+St+Anoka+MN+55303&key=YOUR_FARM_KEY"

После

curl "https://farm.mygeocode.com/v3/json/forward/?addr=530+W+Main+St+Anoka+MN+55303&key=YOUR_MYGEOCODE_KEY"

Почему переходят

Если вы начали с Geocode.Farm ради бесплатного тарифа, здесь вы получаете 2 500 бесплатных запросов в день на ключ и результаты с точностью до дома в большем числе стран. См. страницу покрытия.

Та же бесплатная квота, с ключом или без. Запросы к farm.mygeocode.com учитываются в тех же 2 500 бесплатных запросах в день, которые ваш адрес или ваш ключ получает на наших собственных эндпоинтах. Сверх этого: предоплаченный баланс по 0,0001 € за запрос или 50 € в месяц за ключ Unlimited. Для регистрации нужен только адрес электронной почты.

Смотреть цены Получить бесплатный ключ

Эндпоинты

Путь на farm.mygeocode.com	Что делает	На основе
`/forward/?addr=...`	Прямое геокодирование, стиль v4	Прямое геокодирование
`/reverse/?lat=...&lon=...`	Обратное геокодирование, стиль v4	Обратное геокодирование
`/v3/json/forward/?addr=...`	Прямое геокодирование, стиль v3	Прямое геокодирование
`/v3/json/reverse/?lat=...&lon=...`	Обратное геокодирование, стиль v3	Обратное геокодирование

Пример ответа

Вот что возвращает запрос выше. Названия полей, вложенность и типы соответствуют Geocode.Farm. Наши только данные за ними.

Ответ от farm.mygeocode.com (структура v3)

{
  "geocoding_results": {
    "LEGAL_COPYRIGHT": {
      "copyright_notice": "Copyright My Geocode. All rights reserved.",
      "copyright_logo": "https://www.mygeocode.com/assets/img/logo.svg",
      "terms_of_service": "https://www.mygeocode.com/terms/",
      "privacy_policy": "https://www.mygeocode.com/privacy/"
    },
    "STATUS": {
      "access": "KEY_VALID, ACCESS_GRANTED",
      "status": "SUCCESS",
      "address_provided": "530 W Main St Anoka MN 55303",
      "result_count": 1
    },
    "ACCOUNT": {
      "ip_address": "203.0.113.24",
      "distribution_license": "NONE, UNLICENSED",
      "usage_limit": "2500",
      "used_today": "17",
      "used_total": "9120",
      "first_used": "2026-03-02"
    },
    "RESULTS": [
      {
        "result_number": 1,
        "formatted_address": "530 W Main St, Anoka, MN 55303, USA",
        "accuracy": "EXACT_MATCH",
        "ADDRESS": {
          "street_number": "530",
          "street_name": "W Main St",
          "locality": "Anoka",
          "admin_2": "Anoka County",
          "admin_1": "MN",
          "postal_code": "55303",
          "country": "United States"
        },
        "LOCATION_DETAILS": {
          "elevation": "268.4",
          "timezone_long": "America/Chicago",
          "timezone_short": "CDT"
        },
        "COORDINATES": { "latitude": "45.203146", "longitude": "-93.396711" },
        "BOUNDARIES": {
          "northeast_latitude": "45.203296",
          "northeast_longitude": "-93.396461",
          "southwest_latitude": "45.202996",
          "southwest_longitude": "-93.396961"
        }
      }
    ],
    "STATISTICS": { "https_ssl": "ENABLED, SECURE" }
  }
}

Подробности и отличия

Для первых 2 500 запросов в день ключ не нужен. Чтобы использовать ключ My Geocode, укажите его там, где был ключ GeoCode Farm: в параметре запроса key. Заголовок X-API-Key, Authorization: Bearer и базовая HTTP-аутентификация (ключ в качестве имени пользователя) тоже работают на каждом хосте, поэтому клиентские библиотеки со своим способом аутентификации продолжают работать без изменений.

Строки об авторских правах, названия лицензий, ссылки на условия и политику конфиденциальности в ответе наши, а не исходного провайдера. Всё остальное сохраняет исходную структуру.

Блок LEGAL_COPYRIGHT содержит наше уведомление и ссылки на условия и политику конфиденциальности.
Блок ACCOUNT показывает вашу реальную квоту и использование за день.
Пакетного эндпоинта нет, потому что его нет у оригинала. Для массовой обработки используйте POST /v1/forward или /v1/reverse на api.mygeocode.com (до 100 за вызов, каждый элемент считается одним запросом).

Если ваш клиент зависит от поля или поведения, которого здесь нет, сообщите нам. Пробелы в совместимости исправляются быстро, потому что обычно они невелики.

Другие совместимые хосты

Как работают совместимые хосты, обзор и совместимые замены для библиотек JavaScript.