Datos de dirección listos para tu sistema

API de geocodificación de direcciones

Convierte direcciones en coordenadas y datos normalizados para logística, comercio electrónico, CRM y análisis espacial.

Solicitudes individuales y por lotesGeocodificación directa e inversaCalidad de coincidencia en la respuesta
Domaniewska 37, Warszawa52.18284, 21.0071318

Del texto a la decisión

Una dirección por sí sola no indica al sistema dónde está algo

La geocodificación añade una capa espacial a los datos. Permite calcular distancias, crear rutas, analizar zonas y mostrar objetos en un mapa.

01

Datos listos para usar

Convierte una dirección en coordenadas para un mapa, CRM, plan de entregas o análisis de cobertura.

02

Menos correcciones manuales

Normaliza distintas formas de escribir ciudades, calles y números antes del siguiente proceso.

03

Mejores decisiones espaciales

Asigna clientes a sucursales y trabaja con un punto en lugar de texto sin estructurar.

Un flujo sencillo

De la dirección al punto en tres pasos

El mismo patrón funciona en un formulario, una importación y una integración backend automatizada.

  1. 1

    Enviar la dirección

    El objeto address debe incluir city. country y street son opcionales; si country falta o es null, se usa PL por defecto. pcode y house ayudan a precisar la coincidencia.

  2. 2

    Recibir la coincidencia

    La API devuelve coordenadas, una dirección normalizada e información para evaluar la coincidencia.

  3. 3

    Utilizar el punto

    Guárdalo, muéstralo en un mapa o pásalo a rutas, matrices y análisis.

Del caso de uso al contrato

Pasa directamente de la explicación a una solicitud funcional

La página de geocodificación conecta la necesidad de negocio con los parámetros, la calidad de respuesta y el código listo para copiar.

  • Geocoder.geocode para direcciones individuales
  • Geocoder.geocodemulti para lotes
  • Geocoder.revgeocode para coordenadas
  • interpretación de quality y resultRadius
Abrir referencia de geocodificación
cURL
curl -X POST https://api.automapa.com/v3/Geocoder/geocode \
  -H "Content-Type: application/json" \
  -H "Session-Id: $AUTOMAPA_SESSION" \
  -d '{
    "address": {
      "country": "PL",
      "city": "Warszawa",
      "street": "Domaniewska",
      "house": "37",
      "maxResult": 1
    }
  }'
200 OK — envolvente de respuesta completa{ "result": [ { "quality": 9, "x": 21.0071318, "y": 52.18284, "city": "Warszawa", "street": "Domaniewska", "house": "37", "resultRadius": 0 } ] }Los valores del ejemplo ilustran el formato de respuesta. Las coordenadas y los datos de dirección dependen de la entrada y de los datos cartográficos actuales.

Métodos y servicios relacionados

La geocodificación suele ser la primera etapa de un proceso mayor

El punto resultante puede alimentar geocodificación inversa, sugerencias, rutas, matrices y análisis viarios.

Geocodificación por lotes

Geocoder.geocodemulti

Procesa varias direcciones en una sola solicitud.

Documentación

Geocodificación inversa

Geocoder.revgeocode

Convierte coordenadas en la dirección legible más cercana.

Documentación

Sugerencias de direcciones

Autocomplete.searchAddress

Ayuda a introducir una dirección coherente antes de geocodificar.

Documentación

Rutas y matrices

Routes.route / Routes.matrix

Utiliza puntos geocodificados para calcular tiempos y distancias.

Documentación

Casos de uso

La geocodificación forma parte del proceso, no es el objetivo final

Logística

Prepara las direcciones de recogida y entrega para calcular rutas y planificar entregas.

Comercio electrónico

Verifica ubicaciones de pedidos y reduce correcciones manuales.

Redes comerciales

Encuentra la sucursal más cercana y asigna clientes a regiones.

Calidad de datos

Normaliza bases históricas de direcciones antes de migrar o analizar.

Preguntas frecuentes

Fundamentos de geocodificación antes de integrar

¿Qué es la geocodificación?

Convierte una descripción de dirección en coordenadas geográficas que pueden mostrarse en un mapa o utilizarse en procesos de localización.

¿Qué campos son obligatorios?

El objeto address y su campo city son obligatorios para cada dirección, también en lotes. country y street son opcionales; si country falta o es null, se usa PL por defecto. pcode y house pueden mejorar la precisión.

¿Cómo evalúo el resultado?

La respuesta incluye calidad de coincidencia y radio. La documentación explica cómo interpretarlos.

¿Puedo procesar muchas direcciones?

Sí. Geocoder.geocodemulti está diseñado para lotes de direcciones.

¿La vista previa llama a la API de producción?

No. Presenta una respuesta de ejemplo; la documentación explica cómo realizar una solicitud autenticada a la API.