Pular para o conteúdo
API de Limites + Áreas, feita para agentes

Todos os limites do planeta, em uma chamada de API.

Ou simplesmente descreva a área.

Obtenha o polígono de qualquer país, estado, condado, cidade, distrito ou CEP por nome ou por ponto. Ou envie uma frase, ou o texto de um contrato, e receba de volta um polígono validado, ou uma recusa clara.

1.000 unidades grátis por mês. Sem cartão. A busca não precisa de chave.

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

Dois produtos, uma chave

Limites quando você conhece o lugar. Áreas quando você só tem as palavras.

Boundaries

Qualquer limite administrativo do OpenStreetMap, de países a distritos e CEPs. Busque por nome, faça geocodificação reversa de um ponto, percorra pais e filhos, teste pontos, una formas e exporte em GeoJSON, KML, WKT, GML ou SVG.
  • Busca por nome, grátis
  • Polígono por 1 unidade
  • Busca reversa por ponto
  • Lotes de ponto em polígono
  • Pais e filhos
  • Unir em uma forma

Areas

Contratos e regulamentos raramente citam um único limite. Um agente de IA lê a descrição, associa cada lugar a um limite real e valida o resultado. 50 unidades por área.
  • Territórios por lista
    “os condados de Alameda, Contra Costa e Santa Clara”
  • Exclusões
    “…excluindo a cidade de San Jose”
  • Instalações
    “…e as instalações do aeroporto”
  • Limites históricos
    “a antiga cidade, como era antes da fusão de 2004”
  • Precedência
    “…sem prejuízo das normas locais”
  • Qualquer idioma
    “函館市及び北斗市の区域”

Uma chamada

De um nome a um polígono

A busca é grátis e não precisa de chave. Uma geometria custa uma unidade e fica em cache para todos depois da primeira requisição.

Obtenha o limite de Berlim como GeoJSON

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

Ou descreva a á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íceis

O texto que quebra geocodificadores

Treze descrições, de uma frase de quatro palavras a avisos tarifários japoneses e decretos de táxi espanhóis, cada uma enviada exatamente como foi escrita. Cada mapa e veredito é a saída real da API, incluindo os recusados. Execute qualquer um deles você mesmo.

🇺🇸 Área da Baía de São Francisco, EUA

Uma região nomeada em quatro palavras

Aceito
SF Bay area counties
Alameda CountyContra Costa CountyMarin CountyNapa CountySan Francisco CountySan Mateo CountySanta Clara CountySolano CountySonoma CountySF Bay Area (9 counties)
Área
18.230 km²
Nível
metro

Partes

O problema

Nenhum condado, estado ou país é citado. “SF Bay area” precisa ser lido como a região padrão de nove condados.

O que o Geocode AI faz

Entende que o texto se refere aos EUA e mapeia os nove condados como uma única área só de terra: cerca de 18.200 km².

Aceito ou recusado. Nunca chutado.

Um território desenhado grande demais aplica um contrato onde ele não vale; um desenhado pequeno demais deixa lugares de fora. Por isso não há meio-termo: um polígono que você pode usar, ou um erro que explica o motivo.

  • Aceito

    Aceito

    Todos os lugares da descrição foram mapeados e o polígono passou na validação: a API retorna HTTP 200 com o GeoJSON.

  • Recusado · 422

    Recusado, com motivos

    Se algum lugar não puder ser mapeado, ou o resultado não passar na validação, não há polígono: o HTTP 422 diz exatamente o que não pôde ser mapeado e por quê.

Como o Áreas funciona

  1. 01

    Ler

    Lê a descrição e define quais lugares incluir e excluir: condados, cidades, distritos, aeroportos.

  2. 02

    Mapear

    Encontra o limite exato de cada lugar, recortado ao litoral, e verifica se é o tipo certo de lugar e se tem um tamanho plausível.

  3. 03

    Validar

    Tamanhos, seu ponto de referência, sobreposições e atualizações de áreas existentes são validados. Você só recebe um polígono se ele se sustentar.

De um PDF a uma zona que você pode consultar

Uma resolução tarifária real da Prefeitura de A Coruña. Extraia a cláusula que define onde ela se aplica, envie para a API e armazene o polígono. A partir daí, “esta tarifa se aplica aqui?” é uma consulta no seu próprio banco de dados.

  1. 01 · Extraia a cláusula

    resolucion.pdfp. 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"

    Qualquer ferramenta de PDF para texto serve. A cláusula entra como foi escrita, em galego.

  2. 02 · Envie para POST /v1/areas

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

    O município, não a comarca de 473 km² que a maioria dos datasets chama de “A Coruña”. Retornado como GeoJSON.

  3. 03 · Consulte na sua 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));
    Estação de trem de A Coruña

    43.3536, -8.4095

    Tarifa urbana
    Torre de Hércules

    43.3859, -8.4065

    Tarifa urbana
    Aeroporto de A Coruña, em Culleredo

    43.3021, -8.3773

    Fora da zona

    PostGIS no exemplo. Qualquer biblioteca GIS ou banco de dados que leia GeoJSON funciona.

Feito para agentes

Seu agente já sabe usar

Cada operação tem um nome e um schema de entrada iguais no REST, no MCP, na CLI e nos plugins, com descrições escritas para um modelo que está escolhendo uma ferramenta.

Casos de uso

Onde quer que uma regra siga uma divisa

Preços

Pague pela geometria, não pela busca

Uma unidade é uma geometria de limite, uma busca reversa, uma exportação ou 1.000 verificações de pontos. A busca e a hierarquia são grátis. Uma área descrita custa 50 unidades.

Free

Para protótipos e agentes experimentando.

US$ 0/ mês

  • 1.000 unidades por mês
  • 60 requisições por minuto
  • Até 20 áreas descritas
  • REST, MCP, CLI e plugins
  • Sem cartão

Pro

Para produção
Para apps em produção.

US$ 29/ mês

ou US$ 290 por ano, com dois meses grátis

  • 50.000 unidades por mês
  • 600 requisições por minuto
  • Até 1.000 áreas descritas
  • REST, MCP, CLI e plugins

Business

Para pipelines de alto volume e exportações em massa.

US$ 199/ mês

ou US$ 1.990 por ano, com dois meses grátis

  • 1.000.000 unidades por mês
  • 3.000 requisições por minuto
  • Até 20.000 áreas descritas
  • REST, MCP, CLI e plugins

Enterprise

Dados auto-hospedados, SLAs e conjuntos de limites personalizados.

Personalizado

  • Unidades ilimitadas
  • 10.000 requisições por minuto
  • Áreas por contrato
  • REST, MCP, CLI e plugins
  • Dados auto-hospedados, SLAs, conjuntos de limites personalizados

Comparar os planos em detalhe

Perguntas

Transforme nomes de lugares e letras miúdas em mapas confiáveis.

Territórios de atendimento, jurisdições tributárias, zonas tarifárias, áreas de cobertura: onde quer que uma regra seja definida por um lugar.