Pular para o conteúdo
POST AI agent ready /v1/geo/batch

API de geocodificação em lote - endereço em massa gratuito para coordenadas

Envie uma matriz de até 10 endereços de formato livre e receba as coordenadas de cada um. Os endereços são geocodificados em paralelo. Falhas individuais retornam uma mensagem de erro para esse endereço sem falhar no lote inteiro. A resposta inclui contagens totais, resolvidas e com falha.

Parameters

arrayrequired

Array of address strings to geocode (max 10).

Code examples

curl -X POST https://api.botoi.com/v1/geo/batch \
  -H "Content-Type: application/json" \
  -d '{"addresses":["London, UK","Paris, France","xyzzy nowhere"]}'

When to use this API

Trace a localização dos clientes em um mapa

Geocodifique uma lista de endereços de clientes da sua exportação de CRM. Use as coordenadas para colocar marcadores em um mapa para planejamento de território, roteamento de entrega ou análise de cobertura de vendas.

Enriqueça as importações de CSV com coordenadas

Processe arquivos CSV carregados contendo endereços. Geocodifique em lote a coluna de endereço e anexe latitude e longitude a cada linha antes de armazenar em seu banco de dados.

Validar vários endereços em um envio de formulário

Quando um usuário envia um formulário com vários endereços (por exemplo, cobrança + frete + alternativo), geocodifique todos os endereços em uma chamada de API. Sinalize qualquer problema que não seja resolvido antes de aceitar o envio.

Frequently asked questions

Qual é o número máximo de endereços por solicitação?
Você pode enviar até 10 endereços por solicitação. Para lotes maiores, divida sua lista em blocos de 10 e envie várias solicitações.
O que acontece se um endereço falhar?
Endereços com falha retornam lat: null, lng: null e uma mensagem de erro. O restante do lote é processado normalmente. Verifique a contagem de falhas na resposta para identificar endereços problemáticos.
As chamadas de geocodificação são feitas em paralelo?
Sim. Todos os endereços do lote são geocodificados simultaneamente para tempos de resposta mais rápidos. Um lote de 10 endereços leva aproximadamente o mesmo tempo que uma única solicitação de geocódigo.
Posso geocodificar mais de 10 endereços?
Não em um único pedido. Divida sua lista em lotes de 10 e envie várias solicitações. Com um plano pago, você pode enviar várias solicitações em lote por segundo.
Este é o mesmo geocodificador que /v1/geo/geocode?
Sim. O endpoint em lote usa o mesmo geocodificador OpenStreetMap Nominatim que o endpoint de endereço único. Os resultados são idênticos para a mesma entrada.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs