Ir al contenido
API de Boundaries + Areas, hecha para agentes

Todos los límites de la Tierra, en una sola llamada a la API.

O simplemente describa el área.

Obtenga el polígono de cualquier país, estado, condado, ciudad, distrito o código postal por nombre o por punto. O envíe una frase, o el texto de un contrato, y reciba un único polígono validado, o un rechazo claro.

1000 unidades al mes gratis. Sin tarjeta. La búsqueda no requiere clave.

Probar
Alameda CountyContra Costa CountyMarin CountyNapa CountySan Francisco CountySan Mateo CountySanta Clara CountySolano CountySonoma CountySF Bay Area (excl. San Jose)excluded: San Jose
Areas: “SF Bay area counties excluding San Jose City limits” → 10 partes, 17.765 km²

Dos productos, una clave

Boundaries cuando conoce el lugar. Areas cuando solo tiene las palabras.

Boundaries

Cualquier límite administrativo de OpenStreetMap, desde países hasta distritos y códigos postales. Busque por nombre, haga geocodificación inversa de un punto, recorra padres e hijos, compruebe puntos, combine formas y exporte a GeoJSON, KML, WKT, GML o SVG.
  • Búsqueda por nombre, gratis
  • Polígono por 1 unidad
  • Búsqueda inversa por punto
  • Punto en polígono por lotes
  • Padres e hijos
  • Combinar en una sola forma

Áreas

Los contratos y las normativas rara vez nombran un único límite. Un agente de IA lee la descripción, asigna cada lugar a un límite real y valida el resultado. 50 unidades por área.
  • Territorios a partir de una lista
    “Los condados de Alameda, Contra Costa y Santa Clara”
  • Exclusiones
    “…excepto la ciudad de San José”
  • Instalaciones
    «…y las instalaciones del aeropuerto»
  • Límites históricos
    “el antiguo municipio, tal como era antes de la fusión de 2004”
  • Prioridad
    “…sin perjuicio de las normas locales”
  • Cualquier idioma
    “函館市及び北斗市の区域”

Una llamada

De un nombre a un polígono

La búsqueda es gratuita y no requiere clave. Una geometría cuesta una unidad y queda en caché para todos tras la primera solicitud.

Obtenga el límite de Berlín en GeoJSON

curl "https://geocodeai.dev/v1/boundaries/r62422?detail=medium" \  -H "Authorization: Bearer $GEOCODE_API_KEY"

O describa el área

curl -X POST "https://geocodeai.dev/v1/areas" \  -H "Authorization: Bearer $GEOCODE_API_KEY" \  -H "Content-Type: application/json" \  -d '{"text":"The municipality of A Coruña, Spain"}'

Casos difíciles

La redacción que confunde a los geocodificadores

Trece descripciones, desde una frase de cuatro palabras hasta avisos de tarifas japoneses y decretos de taxi españoles, cada una enviada tal cual. Cada mapa y cada veredicto es la salida real de la API, incluidos los que rechazó. Ejecute cualquiera de ellas usted mismo.

🇺🇸 Área de la Bahía de San Francisco, EE. UU.

Una región nombrada en cuatro palabras

Aceptada
SF Bay area counties
Alameda CountyContra Costa CountyMarin CountyNapa CountySan Francisco CountySan Mateo CountySanta Clara CountySolano CountySonoma CountySF Bay Area (9 counties)
Superficie
18.230 km²
Nivel
metro

Partes

La dificultad

No se nombra ningún condado, estado ni país. «SF Bay area» debe interpretarse como la región estándar de nueve condados.

Qué hace Geocode AI

Deduce que el texto se refiere a EE. UU. y mapea los nueve condados como una sola área solo terrestre: unos 18 200 km².

Aceptado o rechazado. Sin suposiciones.

Un territorio trazado demasiado grande aplica un contrato donde no corresponde; uno demasiado pequeño deja lugares fuera. Por eso no hay término medio: un polígono que puede usar o un error que explica por qué.

  • Aceptada

    Aceptada

    Todos los lugares de la descripción se identificaron en el mapa y el polígono superó la validación: la API devuelve HTTP 200 con el GeoJSON.

  • Rechazada · 422

    Rechazada, con motivos

    Si algún lugar no se puede mapear o el resultado no supera la validación, no hay polígono: HTTP 422 indica exactamente qué no se pudo mapear y por qué.

Cómo funciona Areas

  1. 01

    Leer

    Lee la descripción y determina qué lugares incluir y excluir: condados, ciudades, distritos, aeropuertos.

  2. 02

    Mapear

    Encuentra el límite exacto de cada lugar, recortado a tierra firme, y comprueba que sea el tipo de lugar correcto y de un tamaño plausible.

  3. 03

    Validar

    Se validan los tamaños, su punto de referencia, los solapamientos y las actualizaciones de áreas existentes. Solo obtiene un polígono si supera la validación.

De un PDF a una zona que puede consultar

Una resolución tarifaria real del Ayuntamiento de A Coruña. Extraiga la cláusula que define dónde se aplica, envíela a la API y guarde el polígono. A partir de ahí, “¿se aplica aquí esta tarifa?” es una sola consulta en su propia base de datos.

  1. 01 · Extraer la cláusula

    resolucion.pdfpág. 1

    resolve autorizar a aplicación das seguintes tarifas máximas (IVE incluído) para o transporte urbano en auto-taxi para o Concello da Coruña

    pdftotext -layout resolucion.pdf - \  | grep -i "concello da coruña"

    Cualquier herramienta de PDF a texto sirve. La cláusula se introduce tal cual, en gallego.

  2. 02 · Envíelo a POST /v1/areas

    A CoruñaConcello da Coruña
    Concello da Coruña · 37,1 km²HTTP 200

    El municipio, no la comarca de 473 km² que la mayoría de los conjuntos de datos llaman «A Coruña». Devuelto como GeoJSON.

  3. 03 · Consúltelo en su stack

    -- store the zone onceINSERT INTO zones (name, geom)VALUES ('A Coruña urban',  ST_GeomFromGeoJSON(:geometry));
    -- then look up any pointSELECT name FROM zonesWHERE ST_Contains(geom,  ST_Point(:lon, :lat, 4326));
    Estación de tren de A Coruña

    43.3536, -8.4095

    Tarifa urbana
    Torre de Hércules

    43.3859, -8.4065

    Tarifa urbana
    Aeropuerto de A Coruña, en Culleredo

    43.3021, -8.3773

    Fuera de la zona

    Aquí se muestra PostGIS. Funciona cualquier biblioteca GIS o base de datos que lea GeoJSON.

Hecho para agentes

Su agente ya sabe cómo usarlo

Cada operación tiene un nombre y un esquema de entrada únicos en REST, MCP, la CLI y los plugins, con descripciones escritas para un modelo que elige una herramienta.

Casos de uso

Allí donde una norma sigue una frontera

Precios

Pague por la geometría, no por buscar

Una unidad equivale a una geometría de límite, una búsqueda inversa, una exportación o 1000 comprobaciones de puntos. La búsqueda y la jerarquía son gratuitas. Un área descrita cuesta 50 unidades.

Free

Para prototipos y agentes que lo están probando.

0 US$/ mes

  • 1000 unidades al mes
  • 60 solicitudes por minuto
  • Hasta 20 áreas descritas
  • REST, MCP, CLI y plugins
  • Sin tarjeta

Pro

Para producción
Para aplicaciones en producción.

29 US$/ mes

o 290 US$ al año, dos meses gratis

  • 50.000 unidades al mes
  • 600 solicitudes por minuto
  • Hasta 1000 áreas descritas
  • REST, MCP, CLI y plugins

Business

Para pipelines de alto volumen y exportaciones masivas.

199 US$/ mes

o 1990 US$ al año, dos meses gratis

  • 1.000.000 unidades al mes
  • 3000 solicitudes por minuto
  • Hasta 20.000 áreas descritas
  • REST, MCP, CLI y plugins

Enterprise

Datos autoalojados, SLA y conjuntos de límites personalizados.

Personalizado

  • Unidades ilimitadas
  • 10.000 solicitudes por minuto
  • Areas por contrato
  • REST, MCP, CLI y plugins
  • Datos autoalojados, SLA, conjuntos de límites personalizados

Comparar planes en detalle

Preguntas

Convierta nombres de lugares y letra pequeña en mapas fiables.

Territorios de servicio, jurisdicciones fiscales, zonas tarifarias, áreas de cobertura: allí donde una norma se define por un lugar.