Pregunta

¿Cómo puedo geocodificar grandes cantidades de datos de direcciones o posiciones utilizando la API de Geocodificación y Lugares de PTV Developer?

Respuesta

PTV ofrece geocodificación masiva a través de trabajos por lotes asíncronos en la API de Geocodificación y Lugares. Puede enviar hasta 1,000 entradas (direcciones, texto libre o coordenadas) por trabajo y recuperar los resultados después del procesamiento.

Flujo básico de trabajo:

1. Enviar un trabajo
   Utilice uno de los siguientes endpoints:
   • /locations/by-addresses
   • /locations/by-texts
   • /locations/by-positions
     → La respuesta incluye un jobId
2. Consultar el estado del trabajo
   Use GET /locations/by-*/status/{jobId}
   Consulte hasta que el estado sea SUCCEEDED o FAILED
3. Recuperar los resultados
   Use GET /locations/by-*/{jobId}
4. (Opcional) Eliminar el trabajo
   Use DELETE /locations/by-*/{jobId}
   Los trabajos se mantienen durante 24 horas si no se eliminan manualmente.

Consejos adicionales

Tamaño recomendado del lote: Hasta 1,000 entradas por trabajo

Límites de tasa:

• Hasta 100 llamadas de creación/resultados por minuto
• Hasta 25,000 llamadas de estado por minuto

Clave API requerida en los encabezados: apiKey: YOUR_API_KEY

Utilice el Portal de PTV Developer para pruebas

📦 SDKs oficiales disponibles en Java, .NET y TypeScript

📂 Los trabajos expiran automáticamente después de 24 horas

Artículos relacionados

Documentación de procesamiento por lotes de la API de Geocodificación y Lugares

Blog de PTV – Introducción a la geocodificación masiva

SDKs de PTV para geocodificación por lotes (GitHub)

Preguntas frecuentes – Límites de tasa de la API

• ...