Crear localizador de direcciones compuesto (Geocodificación)

Resumen

Crea un localizador de direcciones compuesto. Un localizador compuesto consta de dos o más localizadores individuales que permiten correlacionar las direcciones con varios localizadores.

Más información sobre los localizadores compuestos

Uso

  • Antes de crear localizadores de direcciones compuestos, use la herramienta Crear localizador para crear localizadores de direcciones participantes.

  • Se requiere la referencia espacial para un localizador de direcciones compuesto. Si no se especifica un sistema de coordenadas de salida diferente en la configuración del entorno de la herramienta, se utiliza la referencia espacial del primer localizador de direcciones participante.

Parámetros

EtiquetaExplicaciónTipo de datos
Localizadores de direcciones

Los localizadores se utilizarán para crear el localizador compuesto. El orden de los localizadores participantes determina cómo se buscan los candidatos y cómo se correlaciona un lugar o dirección. Al geocodificar una sola dirección o lugar, la dirección o lugar se correlacionará con todos los localizadores participantes a menos que el localizador se especifique con un criterio de selección. Todos los candidatos que se encontraron se mostrarán en función del orden de los localizadores participantes enumerados. Si geocodifica una tabla de direcciones o lugares, las direcciones o lugares se correlacionan automáticamente con el mejor candidato que se encuentre en los primeros localizadores participantes. Si la dirección o lugar no se correlacionan, recaerá en el subsiguiente localizador de la lista.

Se requiere un nombre de referencia para cada localizador participante. Este es el nombre del localizador al que hace referencia el localizador compuesto. No utilice espacios ni símbolos especiales en el nombre. La longitud máxima del nombre es de 14 caracteres.

Value Table
Mapa de campo

La asignación de los campos de entrada que utilizó cada localizador participante para los campos de entrada del localizador compuesto.

Los campos y el contenido de campo generados por los localizadores participantes. Cada uno de los campos de entrada únicos se enumera en la sección Mapa de campo. Al expandir la sección, se muestra una lista de todas instancias de campos de entrada (subcampos) para cada localizador de direcciones participante. Estos campos son los campos de entrada para el localizador de direcciones compuesto. Si hay campos duplicados tales como ZIP y Postcode debido a los nombres únicos que se completaron desde los localizadores de direcciones participantes, puede agrupar los subcampos arrastrándolos al campo adecuado o utilizando los botones Flecha hacia arriba o Flecha hacia abajo para mover el subcampo.

Field Mappings
Criterios de selección
(Opcional)

Criterios de selección para cada localizador participante. Solo se admite un criterio de selección para cada localizador participante.

Durante la creación de un localizador de direcciones compuesto, puede especificar qué localizadores de direcciones se utilizan en función de los valores de los campos de dirección de entrada. Por ejemplo, si el localizador de direcciones compuesto utiliza un localizador que contiene datos de calles para una ciudad específica, puede filtrar las direcciones o lugares que no tengan el nombre de la ciudad. Al utilizar criterios de selección se descalificarán los localizadores de direcciones participantes que no reúnan los criterios para una dirección concreta de modo que el proceso de geocodificación será más eficiente. Por ejemplo, si un localizador de direcciones de calles se especifica con un criterio de selección como "City" = 'Atlanta', solo se geocodificarán las direcciones que contengan el nombre de ciudad "Atlanta" usando este localizador.

Para especificar un criterio de selección, active la casilla de verificación bajo la columna Criterios de selección para la que desee aplicar el criterio. Puede introducir una expresión tal como "City" = 'Atlanta' en el cuadro de texto o hacer clic en el botón Más para abrir el cuadro de diálogo Especificar criterios de selección de localizadores y definir los criterios.

Value Table
Localizador de direcciones compuesto de salida

El localizador de direcciones compuesto que se creará. ArcGIS Pro solo permite guardar localizadores en una carpeta de archivos.

Address Locator

arcpy.geocoding.CreateCompositeAddressLocator(in_address_locators, in_field_map, {in_selection_criteria}, out_composite_address_locator)
NombreExplicaciónTipo de datos
in_address_locators
[[in_address_locator, name],...]

Los localizadores se utilizarán para crear el localizador compuesto. El orden de los localizadores participantes determina cómo se buscan los candidatos y cómo se correlaciona un lugar o dirección. Al geocodificar una sola dirección o lugar, la dirección o lugar se correlacionará con todos los localizadores participantes a menos que el localizador se especifique con un criterio de selección. Todos los candidatos que se encontraron se mostrarán en función del orden de los localizadores participantes enumerados. Si geocodifica una tabla de direcciones o lugares, las direcciones o lugares se correlacionan automáticamente con el mejor candidato que se encuentre en los primeros localizadores participantes. Si la dirección o lugar no se correlacionan, recaerá en el subsiguiente localizador de la lista.

Se requiere un nombre de referencia para cada localizador participante. Este es el nombre del localizador al que hace referencia el localizador compuesto. No utilice espacios ni símbolos especiales en el nombre. La longitud máxima del nombre es de 14 caracteres.

Value Table
in_field_map

La asignación de los campos de entrada que utilizó cada localizador participante para los campos de entrada del localizador de direcciones compuesto.

Para cada campo de entrada de localizador, la información del campo debe tener el formato de esta cadena de caracteres de muestra: "Address 'Address or Intersection' true true false 4 Text 0 0 ,First,'#',Street". La información de esta cadena se compone de lo siguiente:

  • Nuevo nombre de campo (Address): el nuevo nombre de campo del localizador para el localizador compuesto.

    Un localizador del compuesto puede tener un campo Address y el otro localizador puede tener un campo Street Address. Puede designar el nuevo campo de localizador compuesto como Address, que hace referencia a ambos campos de localizador originales.

  • Alias para el nuevo nombre de campo ('Address or Intersection'): el nuevo alias del nombre de campo del localizador para el localizador compuesto.

    Para un localizador compuesto con el nuevo nombre de campo Address, puede designar un alias de 'Address or Intersection' para el campo.

  • IsEditable (true): especifica si el nuevo campo de localizador compuesto es editable. Las opciones son true o false.
  • Permitir valores nulos (true): especifica si el nuevo campo de localizador compuesto admite los valores nulos. Las opciones son true o false.
  • Requerido (false): especifica si el nuevo campo de localizador compuesto es un campo obligatorio. Las opciones son true o false.
  • Longitud (4): la longitud del nuevo campo de localizador compuesto.
  • Tipo (Text): el tipo de datos del nuevo campo de localizador compuesto. Este valor siempre debe ser Text para un localizador.
  • Escala (0): la escala del nuevo campo de localizador compuesto. Es posible utilizar cualquier valor entre 1 y 100. Este valor no se aplica a los localizadores, pero se debe usar un valor válido.
  • Precisión (0): la precisión del nuevo campo de localizador compuesto. Es posible utilizar cualquier valor entre 1 y 100. Este valor no se aplica a los localizadores, pero se debe usar un valor válido.
  • Regla de fusión (First): la regla de fusión para el nuevo campo de localizador compuesto. Se puede usar cualquier valor de regla de fusión. Este valor no se aplica a los localizadores, pero se debe usar un valor válido.
  • Delimitador ('#'): el delimitador para el nuevo campo de localizador compuesto. Se puede utilizar cualquier delimitador compatible.
  • Nombre de campo del localizador original (Street): el nombre de campo de localizador del localizador participante original.
Field Mappings
in_selection_criteria
[[in_address_locator, selection_criteria],...]
(Opcional)

Criterios de selección para cada localizador participante. Sólo se admite un criterio de selección para cada localizador de direcciones participante.

Al utilizar criterios de selección se descalificarán los localizadores de direcciones participantes que no reúnan los criterios para una dirección o lugar concretos de modo que el proceso de geocodificación será más eficiente. Consulte Principios básicos de combinar varios localizadores en un localizador compuesto para obtener más información sobre el uso de los criterios de selección en el proceso de geocodificación.

Value Table
out_composite_address_locator

El localizador de direcciones compuesto que se creará. ArcGIS Pro solo permite guardar localizadores en una carpeta de archivos.

Address Locator

Muestra de código

Ejemplo de CreateCompositeAddressLocator (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar la función CreateCompositeAddressLocator de modo inmediato.

# Create a composite address locator using the StreetMap US Streets and Tutorial Atlanta locators.

# Import system modules
import arcpy 

arcpy.env.workspace = "C:/ArcTutor/Geocoding/atlanta/"

# Set local variables:
US_Streets_locator = "C:/dm_stmap_dvd/streetmap_na/data/Street_Addresses_US"
Atlanta_locator = Atlanta
Atlanta_Composite = US_Atlanta_Composite

#Field mapping
address_field_map = "Address 'Street or Intersection' true true false 100 Text 0 0 ,First,#,Atlanta_locator,Address,0,0,US_Streets_locator,Street;"
city_field_map = "City 'City or Placename' true true false 40 Text 0 0 ,First,#,Atlanta_locator,City,0,0,US_Streets_locator,City;"
state_field_map = "State 'State' true true false 20 Text 0 0 ,First,#,Atlanta_locator,State,0,0,US_Streets_locator,State;"
zip_field_map = "Zip 'Zipcode' true true false 10 Text 0 0 ,First,#,Atlanta_locator,Zip,0,0,US_Streets_locator,ZIP"

composite_locator_field_map = address_field_map + city_field_map + state_field_map + zip_field_map

arcpy.CreateCompositeAddressLocator_geocoding("Atlanta_locator Atlanta;US_Streets_locator US_Streets", composite_loactor_field_map,"Atlanta '\"City\" = 'Atlanta'';US_Streets #",Atlanta_Composite)

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados