Ir al contenido
POST AI agent ready /v1/geo/batch

API de codificación geográfica por lotes: dirección masiva gratuita a coordenadas

Envíe una serie de hasta 10 direcciones de formato libre y reciba las coordenadas de cada una. Las direcciones se geocodifican en paralelo. Las fallas individuales devuelven un mensaje de error para esa dirección sin fallar en todo el lote. La respuesta incluye recuentos totales, resueltos y fallidos.

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

Trazar las ubicaciones de los clientes en un mapa

Geocodifique una lista de direcciones de clientes de su exportación de CRM. Utilice las coordenadas para colocar marcadores en un mapa para la planificación territorial, la ruta de entrega o el análisis de cobertura de ventas.

Enriquezca las importaciones CSV con coordenadas

Procese archivos CSV cargados que contengan direcciones. Geocodifique por lotes la columna de dirección y agregue latitud y longitud a cada fila antes de almacenarla en su base de datos.

Validar varias direcciones en el envío de un formulario

Cuando un usuario envía un formulario con varias direcciones (por ejemplo, facturación + envío + alternativo), geocodifica todas las direcciones en una llamada API. Marque cualquiera que no se resuelva antes de aceptar el envío.

Frequently asked questions

¿Cuál es el número máximo de direcciones por solicitud?
Puede enviar hasta 10 direcciones por solicitud. Para lotes más grandes, divida su lista en partes de 10 y envíe varias solicitudes.
¿Qué sucede si falla una dirección?
Las direcciones fallidas devuelven lat: null, lng: null y un mensaje de error. El resto del lote se procesa normalmente. Verifique el recuento fallido en la respuesta para identificar direcciones problemáticas.
¿Las llamadas de geocodificación se realizan en paralelo?
Sí. Todas las direcciones del lote están geocodificadas simultáneamente para tiempos de respuesta más rápidos. Un lote de 10 direcciones tarda aproximadamente el mismo tiempo que una sola solicitud de geocodificación.
¿Puedo geocodificar más de 10 direcciones?
No en una sola solicitud. Divida su lista en lotes de 10 y envíe múltiples solicitudes. Con un plan pago, puedes enviar varias solicitudes por lotes por segundo.
¿Es este el mismo geocodificador que /v1/geo/geocode?
Sí. El punto final por lotes utiliza el mismo geocodificador OpenStreetMap Nominatim que el punto final de dirección única. Los resultados son idénticos para la misma 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