Crear localizador de direcciones compuesto (Geocodificación)

Resumen

Crea un localizador compuesto. Un localizador compuesto consta de dos o más localizadores individuales que permiten hacer coincidir direcciones y lugares utilizando varios localizadores.

Más información sobre los localizadores compuestos

Uso

  • Antes de crear localizadores compuestos, utilice la herramienta Crear localizador o la herramienta Crear localizador de entidades para crear los localizadores participantes.

  • Se requiere la referencia espacial para un localizador 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.

  • Utilice la opción Ordenar por rol y puntuación para el parámetro Orden de resultados para un localizador multirrol, un localizador ArcGIS StreetMap Premium (por ejemplo) y varios localizadores de roles únicos. Esta opción ordena los localizadores y roles en un orden de reserva óptimo.

  • Para generar la sintaxis correcta Python para el parámetro in_result_ordering, ejecute primero la herramienta desde el panel Geoprocesamiento con la opción adecuada del parámetro Orden de resultados. A continuación, abra el menú Ejecutar y seleccione Copiar comando de Python.

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.

Incluye los campos y el contenido de campo generados por los localizadores participantes. Cada uno de los campos de entrada únicos se enumera en el parámetro Mapa de campo. A la izquierda en la columna Campos de entrada, hay una lista de todos los campos de entrada para el localizador compuesto. Cuando selecciona un campo, puede ver los campos de cada localizador participante asignado a ese campo en las columnas Subcampo y Propiedades. Estos campos son los campos de entrada para el localizador compuesto.

Precaución:

No elimine ningún campo de localizador del parámetro Mapa de campo. Un localizador compuesto creado sin todos los campos de localizador no es válido.

Field Mappings
Criterios de selección
(Opcional)

Los 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 compuesto, puede especificar qué localizadores 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
Orden de resultados
(Opcional)

Especifica el orden alternativo de los localizadores participantes con los que se pueden cotejar las direcciones para aumentar la probabilidad de encontrar la mejor coincidencia al geocodificar.

  • Usar orden de localizador: los localizadores participantes estarán en el orden en que se agregaron y se ajustarán al orden alternativo descrito en Combinar varios localizadores en un localizador compuesto. Esta es la opción predeterminada.
  • Ordenar por rol y puntuación: los localizadores participantes se agruparán por rol y en orden alternativo.
  • Orden personalizado: se utilizará un orden alternativo personalizable para los localizadores participantes que le permite insertar localizadores entre los roles de un localizador multirrol.
String

arcpy.geocoding.CreateCompositeAddressLocator(in_address_locators, in_field_map, {in_selection_criteria}, out_composite_address_locator, {in_result_ordering})
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, formatee la información del campo como en esta cadena 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)

Los criterios de selección para cada localizador participante. Solo se admite un criterio de selección para cada localizador 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
in_result_ordering
(Opcional)

Especifica el orden alternativo de los localizadores participantes con los que se pueden cotejar las direcciones para aumentar la probabilidad de encontrar la mejor coincidencia al geocodificar.

  • Use locator order: los localizadores participantes estarán en el orden en que se agregaron y se ajustarán al orden alternativo descrito en Combinar varios localizadores en un localizador compuesto. Esta es la opción predeterminada.
    • La sintaxis es una cadena de caracteres de nombres de localizador delimitada por comas.
    • Para un localizador compuesto que contiene dos localizadores (Atlanta.loc y Memphis.loc, por ejemplo), la sintaxis debe ser "Atlanta, Memphis"
  • Order by role and score: los localizadores participantes se agruparán por rol y en orden alternativo.
    • La sintaxis es una cadena de caracteres de grupos de roles delimitada por comas estructurada como [LocatorRole1](LocatorName1.LocatorRole1, LocatorName2.LocatorRole1).
    • Para un localizador compuesto que contiene dos localizadores multirrol (Atlanta.loc y Memphis.loc, por ejemplo), cada uno con un rol PointAddress y un rol StreetAddress, la sintaxis debe ser "[PointAddress](Atlanta.PointAddress, Memphis.PointAddress),[StreetAddress](Memphis.StreetAddress,Atlanta.StreetAddress)".
    • Los roles se deben ordenar del más preciso al menos preciso.
  • Custom order: se utilizará un orden alternativo personalizable para los localizadores participantes que le permite insertar localizadores entre los roles de un localizador multirrol.
    • La sintaxis es una cadena de caracteres delimitada por comas de nombres y roles de localizador estructurada como LocatorName.LocatorRole.
    • Para un localizador compuesto que contiene dos localizadores multirrol (Atlanta.loc y Memphis.loc, por ejemplo), cada uno con un rol PointAddress y un rol StreetAddress, la sintaxis debe ser "Atlanta.StreetAddress,Memphis.PointAddress,Memphis.StreetAddres,Atlanta.PointAddress".
    • Los localizadores y roles se pueden colocar en cualquier orden, pero colocar los roles menos precisos antes de realizar roles más precisos puede dar lugar a un comportamiento inesperado.

Para generar la sintaxis correcta de Python, ejecute primero la herramienta desde el panel Geoprocesamiento. A continuación, abra el menú Ejecutar y seleccione Copiar comando de Python.

String

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.geocoding.CreateCompositeAddressLocator("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