Automatizar con ETL

Geocodificar y validar direcciones

Busque cada dirección de una lista en sus propios conjuntos de datos de direcciones, obtenga sus coordenadas y la dirección encontrada, y revise las filas sin coincidencia.

Actualizado 2026-11-1512 minutos de lectura
Antes de comenzar
  • One or more address layers in your project
  • A flow you can edit in ETL Builder

La etapa Geocodificador busca cada dirección de una lista en sus propios conjuntos de datos de referencia, y da a cada fila sus coordenadas, la dirección encontrada y una confianza de coincidencia. Los datos son suyos; la etapa no aporta ninguno.

Diccionario

Los conjuntos de datos de referencia que el geocodificador usa para geocodificar y validar direcciones.

  1. Elija el País.
  2. Elija Agregar un conjunto de datos y tome una capa de direcciones. O elija Copiar de una API de direcciones para partir de los conjuntos de datos y la asignación de campos de una API creada en API Builder; la etapa guarda su propia copia.
  3. En Campos de dirección, indique qué campo contiene cada parte de una dirección. Sugerir asignación completa las partes que reconoce por los nombres de campo, y Muestra enseña un valor de cada campo; revise cada una antes de guardar. Asigne Dirección completa, o Nombre de la calle y las partes que tenga. También se buscan otros nombres de calle y de localidad (un número de carretera, una ciudad postal, un nombre anterior, un barrio).
  4. Elija la Ubicación (la geometría de la capa, o campos de latitud y longitud) y, si tiene uno, el Identificador del registro.

Los conjuntos de datos se consultan en el orden de la lista. El siguiente solo se consulta para una dirección que los anteriores no encuentran, así que una dirección que contienen dos conjuntos recibe una sola respuesta, la del primero.

Entrada

Indique dónde está la dirección en las filas que llegan a la etapa:

  • Una columna contiene la dirección completa.
  • Líneas de dirección: la línea de dirección 1 contiene el número y la calle juntos; la ciudad, el estado o provincia y el código postal están en sus propias columnas.
  • Partes separadas: cada parte en su propia columna.

Salida

Listas contiene las filas cuya dirección se encontró. Su único ajuste es la Confianza mínima: una fila está lista cuando su coincidencia es al nivel de la dirección (se encontró el número de casa) y al menos así de segura. Cada fila lista recibe estas columnas, y su geometría pasa a ser el punto encontrado (WGS 84):

ColumnaContiene
matched_latitude, matched_longitudeLa ubicación de la dirección encontrada
matched_address, matched_id, matched_datasetLa dirección encontrada, el identificador de su registro y el conjunto de datos del que viene
match_statusmatched
match_confidenceDe 0 a 1

¿Necesita otros campos del registro encontrado? Una el conjunto de datos por matched_id.

Por revisar contiene las filas cuya dirección no se encontró, sin cambios, con el motivo. Su único ajuste es Coincidencias cercanas conservadas. Cada fila por revisar recibe review_reason, match_status, match_confidence y closest_matches.

match_status dice qué encontró la etapa:

EstadoSignifica
Coincidencia (matched)Una dirección coincidió.
Varias coincidencias (multiple_matches)Más de una dirección coincidió igual de bien.
Sin coincidencia (no_match)Ninguna dirección coincidió.
MotivoQué hacer
La fila no tiene dirección.Complete la dirección en su origen, o filtre esas filas antes de la etapa.
Sin coincidencia: ninguna dirección coincidió.Revise la escritura, o agregue la dirección a un conjunto de datos del diccionario.
Varias coincidencias: más de una dirección coincidió igual de bien.Lea las coincidencias cercanas y agregue lo que las distingue: una ciudad, un código postal, una unidad.
Calle encontrada, número de casa no encontrado.Corrija el número de casa.
La coincidencia está por debajo de la confianza mínima.Baje la confianza mínima, o revise esas filas a mano.
El diccionario no contiene direcciones de esta región.La fila nombra un estado o provincia que sus conjuntos de datos no cubren.