Попробуйте API

Выберите эндпоинт, измените значения, нажмите «Отправить». Запрос уходит из вашего браузера на api.mygeocode.com, а JSON-ответ открывается в новой вкладке. Он учитывается в 2 500 бесплатных запросах в день, которые ваш адрес получает без ключа; вставьте ключ, чтобы запрос учитывался по ключу. Нужен ключ? Зарегистрируйтесь с адресом электронной почты, и через минуту он у вас будет.

Запрос GET /v1/forward

От 1 до 10, по умолчанию 5

Коды ISO 3166-1 alpha-2 через запятую

Пример ответа для указанных значений

{
  "status": "ok",
  "query": "221B Baker Street, London",
  "results": [
    {
      "formatted": "221B Baker Street, London NW1 6XE, United Kingdom",
      "lat": 51.523767,
      "lon": -0.158555,
      "type": "address",
      "precision": "house",
      "confidence": 0.97,
      "place_id": "gb.addr.7f3c2a19",
      "components": {
        "house_number": "221B",
        "road": "Baker Street",
        "neighbourhood": "Marylebone",
        "city": "London",
        "state": "England",
        "postcode": "NW1 6XE",
        "country": "United Kingdom",
        "country_code": "gb"
      },
      "bounds": { "north": 51.523917, "south": 51.523617, "east": -0.158305, "west": -0.158805 }
    }
  ]
}

Попробуйте убрать номер дома и посмотрите, как precision изменится с house на street. Справочник

Запрос GET /v1/reverse

address, street, postcode, city, region или country

Пример ответа для указанных значений

{
  "status": "ok",
  "lat": 48.8584,
  "lon": 2.2945,
  "result": {
    "formatted": "5 Avenue Anatole France, 75007 Paris, France",
    "lat": 48.85837,
    "lon": 2.29448,
    "distance_m": 12,
    "type": "address",
    "precision": "house",
    "components": {
      "house_number": "5",
      "road": "Avenue Anatole France",
      "suburb": "7th Arrondissement",
      "city": "Paris",
      "state": "Ile-de-France",
      "postcode": "75007",
      "country": "France",
      "country_code": "fr"
    }
  }
}

Попробуйте 0 и 0: вы получите "result": null со status: ok, потому что точка в океане тоже является корректным запросом. Справочник

Запрос GET /v1/autocomplete

Не менее 2 символов

Пример ответа для указанных значений

{
  "status": "ok",
  "query": "10 Downing",
  "suggestions": [
    { "text": "10 Downing Street, London SW1A 2AA, United Kingdom", "lat": 51.503396, "lon": -0.12764, "type": "address", "precision": "house", "place_id": "gb.addr.7f3c2a19" },
    { "text": "10 Downing Place, Cambridge CB2 3EN, United Kingdom", "lat": 52.203042, "lon": 0.121811, "type": "address", "precision": "house", "place_id": "gb.addr.a01d9e44" },
    { "text": "10 Downing Road, Dagenham RM9 6NP, United Kingdom", "lat": 51.536118, "lon": 0.137204, "type": "address", "precision": "house", "place_id": "gb.addr.c58b7e02" }
  ]
}

Каждая подсказка содержит координаты, поэтому после выбора второй вызов не нужен. Справочник

Запрос GET /v1/ipv4

Очистите поле, чтобы определить свой собственный адрес

Пример ответа для указанных значений

{
  "status": "ok",
  "ip": "8.8.8.8",
  "version": 4,
  "country": "United States",
  "country_code": "US",
  "region": "California",
  "region_code": "CA",
  "city": "Mountain View",
  "postcode": "94043",
  "lat": 37.4056,
  "lon": -122.0775,
  "timezone": "America/Los_Angeles",
  "asn": 15169,
  "org": "Google LLC",
  "is_datacenter": true,
  "is_proxy": false,
  "is_private": false
}

Справочник

Запрос GET /v1/ipv6

Очистите поле, чтобы определить свой собственный адрес

Пример ответа для указанных значений

{
  "status": "ok",
  "ip": "2001:4860:4860::8888",
  "version": 6,
  "prefix": "2001:4860::/32",
  "country": "United States",
  "country_code": "US",
  "region": "California",
  "region_code": "CA",
  "city": "Mountain View",
  "postcode": "94043",
  "lat": 37.4056,
  "lon": -122.0775,
  "timezone": "America/Los_Angeles",
  "asn": 15169,
  "org": "Google LLC",
  "is_datacenter": true,
  "is_proxy": false,
  "is_private": false
}

Справочник

Запрос GET /v1/timezone

Пример ответа для указанных значений

{
  "status": "ok",
  "lat": 35.6762,
  "lon": 139.6503,
  "timezone": "Asia/Tokyo",
  "abbreviation": "JST",
  "utc_offset": "+09:00",
  "utc_offset_seconds": 32400,
  "dst": false,
  "timestamp": 1756335245,
  "local_time": "2026-08-28T08:34:05+09:00",
  "country_code": "JP",
  "next_transition": null
}

Справочник

Запрос GET /v1/elevation

Пример ответа для указанных значений

{
  "status": "ok",
  "results": [
    { "lat": 27.9881, "lon": 86.925, "elevation_m": 8752.1, "resolution_m": 30 }
  ]
}

Для нескольких точек сразу используйте вместо этого locations=lat,lon|lat,lon. Справочник

Запрос GET /v1/postcode

ISO 3166-1 alpha-2. Настоятельно рекомендуется

Пример ответа для указанных значений

{
  "status": "ok",
  "postcode": "10001",
  "country_code": "US",
  "results": [
    {
      "postcode": "10001",
      "place": "New York",
      "region": "New York",
      "region_code": "NY",
      "country": "United States",
      "country_code": "US",
      "lat": 40.7484,
      "lon": -73.9967
    }
  ]
}

Справочник

Как читать ответ. В каждом ответе есть поле status. Результаты геокодирования содержат precision со значением house, street, postcode или admin, чтобы вы знали, насколько можно доверять точке. Заголовки ответа включают X-Quota-Used и X-Quota-Reset; их показывают инструменты разработчика вашего браузера. Пустые необязательные поля в запрос не включаются. Здесь ваш ключ передаётся в параметре key, потому что форма не может задать заголовок; в коде используйте заголовок X-API-Key. Все поля описаны в документации.