Reemplazo compatible (drop-in) de Geocode.Farm

Los endpoints directos e inversos de Geocode.Farm, con los estilos de URL v3 y v4, responden en farm.mygeocode.com. Se reproduce el objeto anidado geocoding_results con las secciones STATUS, ACCOUNT, RESULTS y STATISTICS para que los analizadores existentes sigan funcionando.

Cambia un nombre de host

Host original	`api.geocode.farm` `www.geocode.farm`
Usa en su lugar	`farm.mygeocode.com`
Parámetro de la clave	`key` (opcional: cualquier dirección recibe 2.500 solicitudes al día sin clave; pon aquí tu clave de My Geocode para tener crédito, paquetes y un historial de uso)

Antes

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

Después

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

Por qué se cambia la gente

Si empezaste con Geocode.Farm por su nivel gratuito, aquí tienes 2.500 solicitudes gratuitas al día por clave, con resultados a nivel de número de portal en más países. Consulta la página de cobertura.

La misma cuota gratuita, con clave o sin ella. Las solicitudes a farm.mygeocode.com cuentan para las mismas 2.500 solicitudes gratuitas al día que tu dirección, o tu clave, recibe en nuestros propios endpoints. Por encima de eso, crédito prepago a 0,0001 € por solicitud, o 50 € al mes por una clave Unlimited. Para registrarte solo necesitas una dirección de correo electrónico.

Ver precios Obtén una clave gratis

Endpoints

Ruta en farm.mygeocode.com	Qué hace	Respaldado por
`/forward/?addr=...`	Geocodificación directa, estilo v4	Geocodificación directa
`/reverse/?lat=...&lon=...`	Geocodificación inversa, estilo v4	Geocodificación inversa
`/v3/json/forward/?addr=...`	Geocodificación directa, estilo v3	Geocodificación directa
`/v3/json/reverse/?lat=...&lon=...`	Geocodificación inversa, estilo v3	Geocodificación inversa

Ejemplo de respuesta

Esto es lo que devuelve la solicitud anterior. Los nombres de campo, el anidamiento y los tipos siguen a Geocode.Farm. Solo los datos que hay detrás son nuestros.

Respuesta de farm.mygeocode.com (estructura 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" }
  }
}

Detalles y diferencias

No se necesita clave para las primeras 2.500 solicitudes al día. Para usar una clave de My Geocode, ponla donde iba tu clave de GeoCode Farm: el parámetro de consulta key. La cabecera X-API-Key, Authorization: Bearer y la autenticación HTTP Basic (con la clave como nombre de usuario) también funcionan en todos los hosts, así que las bibliotecas cliente que se autentican a su manera siguen funcionando sin cambios.

Las líneas de copyright, los nombres de licencia y los enlaces a los términos y a la privacidad de la respuesta son nuestros y no del proveedor original. Todo lo demás conserva la estructura original.

El bloque LEGAL_COPYRIGHT lleva nuestro aviso y nuestros enlaces a los términos y a la privacidad.
El bloque ACCOUNT indica tu cuota y tu uso reales del día.
No hay endpoint por lotes, porque el original no lo tiene. Para trabajos masivos, usa POST /v1/forward o /v1/reverse en api.mygeocode.com (hasta 100 por llamada, una solicitud cada una).

Si tu cliente depende de un campo o de un comportamiento que no aparece aquí, dínoslo. Las carencias de compatibilidad se corrigen rápido porque suelen ser pequeñas.

Otros hosts compatibles

Cómo funcionan los hosts compatibles, el resumen y los reemplazos compatibles de bibliotecas JavaScript.