My Geocode

Experimente a API

Escolha um endpoint, altere os valores e clique em Enviar. A requisição vai do seu navegador para api.mygeocode.com e a resposta em JSON abre em uma nova aba. Ela conta para as 2.500 requisições gratuitas por dia que o seu endereço recebe sem chave; cole uma chave para que ela conte na chave. Quer uma? Cadastre-se com um endereço de e-mail e você a terá em um minuto.

GET /v1/forward

De 1 a 10, padrão 5

Códigos ISO 3166-1 alfa-2 separados por vírgula

Exemplo de resposta para os valores mostrados

{
  "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 }
    }
  ]
}

Experimente remover o número da casa e veja precision mudar de house para street. Referência

GET /v1/reverse

address, street, postcode, city, region ou country

Exemplo de resposta para os valores mostrados

{
  "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"
    }
  }
}

Experimente 0 e 0: você recebe "result": null com status: ok, porque um ponto no oceano é uma pergunta válida. Referência

GET /v1/autocomplete

Pelo menos 2 caracteres

Exemplo de resposta para os valores mostrados

{
  "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" }
  ]
}

Cada sugestão traz coordenadas, então escolher uma não exige uma segunda chamada. Referência

GET /v1/ipv4

Deixe em branco para consultar o seu próprio endereço

Exemplo de resposta para os valores mostrados

{
  "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
}

Referência

GET /v1/ipv6

Deixe em branco para consultar o seu próprio endereço

Exemplo de resposta para os valores mostrados

{
  "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
}

Referência

GET /v1/timezone

Exemplo de resposta para os valores mostrados

{
  "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
}

Referência

GET /v1/elevation

Exemplo de resposta para os valores mostrados

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

Para vários pontos de uma vez, use locations=lat,lon|lat,lon. Referência

GET /v1/postcode

ISO 3166-1 alfa-2. Altamente recomendado

Exemplo de resposta para os valores mostrados

{
  "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
    }
  ]
}

Referência

Como ler a resposta. Toda resposta tem um campo status. Os resultados de geocodificação trazem uma precision de house, street, postcode ou admin, para que você saiba o quanto pode confiar no ponto. Os cabeçalhos da resposta incluem X-Quota-Used e X-Quota-Reset; as ferramentas de desenvolvedor do seu navegador mostram esses cabeçalhos. Campos opcionais em branco ficam de fora da requisição. Aqui a sua chave é enviada como o parâmetro key porque um formulário não consegue definir um cabeçalho; no código, use o cabeçalho X-API-Key. Consulte a documentação para ver todos os campos.