My Geocode

Prueba la API

Elige un endpoint, cambia los valores y pulsa Enviar. La solicitud va desde tu navegador a api.mygeocode.com y la respuesta JSON se abre en una pestaña nueva. Cuenta para las 2.500 solicitudes gratuitas al día que recibe tu dirección sin clave; pega una clave para que se descuente de la clave. ¿Quieres una? Regístrate con una dirección de correo electrónico y la tendrás en un minuto.

GET /v1/forward

De 1 a 10, predeterminado 5

Códigos ISO 3166-1 alfa-2 separados por comas

Respuesta de ejemplo para los 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 }
    }
  ]
}

Prueba a quitar el número de portal y observa cómo precision cambia de house a street. Referencia

GET /v1/reverse

address, street, postcode, city, region o country

Respuesta de ejemplo para los 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"
    }
  }
}

Prueba 0 y 0: obtienes "result": null con status: ok, porque un punto en el océano es una pregunta válida. Referencia

GET /v1/autocomplete

Al menos 2 caracteres

Respuesta de ejemplo para los 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 sugerencia incluye coordenadas, así que elegir una no requiere una segunda llamada. Referencia

GET /v1/ipv4

Déjalo vacío para consultar tu propia dirección

Respuesta de ejemplo para los 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
}

Referencia

GET /v1/ipv6

Déjalo vacío para consultar tu propia dirección

Respuesta de ejemplo para los 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
}

Referencia

GET /v1/timezone

Respuesta de ejemplo para los 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
}

Referencia

GET /v1/elevation

Respuesta de ejemplo para los valores mostrados

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

Para varios puntos a la vez, usa locations=lat,lon|lat,lon en su lugar. Referencia

GET /v1/postcode

ISO 3166-1 alfa-2. Muy recomendable

Respuesta de ejemplo para los 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
    }
  ]
}

Referencia

Cómo leer la respuesta. Cada respuesta tiene un campo status. Los resultados de geocodificación incluyen una precision de house, street, postcode o admin para que sepas cuánto confiar en el punto. Las cabeceras de la respuesta incluyen X-Quota-Used y X-Quota-Reset; las herramientas para desarrolladores de tu navegador las muestran. Los campos opcionales vacíos se omiten de la solicitud. Aquí tu clave se envía como el parámetro key porque un formulario no puede establecer una cabecera; en el código, usa la cabecera X-API-Key. Consulta la documentación para ver todos los campos.