| Etiqueta | Explicación | Tipo de datos |
Entidades de puntos de entrada | La capa o clase de entidad de puntos de entrada. | Feature Layer |
Asignación de campos de puntos | La asignación de los campos componentes de la dirección de la calle de las entidades de punto que se utilizarán para comparar el nombre completo de la calle con el nombre completo de la calle en el valor del parámetro Entidades de calle para calcular el segmento de calle al que está vinculado el punto. Para seleccionar los componentes de dirección del valor del parámetro Entidades de puntos de entrada que se utilizarán para vincular el punto a la calle, haga lo siguiente:
Los campos disponibles componentes de la dirección son los siguientes:
| Value Table |
Entidades de calle | La clase de entidad o capa de calle de entrada desde la que se asignarán atributos al valor del parámetro Entidades de punto de entrada. | Feature Layer |
Asignación de campos de calles | La asignación de los campos componentes de la dirección de la calle, ciudad, estado, código de país y código de idioma de las entidades de calles que se utilizarán para comparar el nombre completo de la calle con el nombre completo de la calle en el valor del parámetro Entidades de puntos de entrada para calcular el segmento de calle al que está vinculado el punto. Para seleccionar los componentes de dirección del valor del parámetro Entidades de calle que se utilizarán para vincular el punto a la calle, haga lo siguiente:
Seleccione los campos de la clase de entidad de calle en la lista desplegable Campo de datos que correspondan al componente de dirección de la calle que aparece en la columna Nombre de campo. Los campos disponibles componentes de la dirección son los siguientes:
| Value Table |
Puntos de salida | La clase de entidad de punto de salida que contiene los campos de calle asignados al punto. | Feature Class |
Campo(s) de calles (Opcional) | Los campos del valor del parámetro Entidades de calle que se asignarán al valor del parámetro Puntos de salida. Seleccione campos de las entidades de calle de entrada que contengan atributos para asignar a las entidades de punto vinculadas, por ejemplo, un campo que contenga un valor de Id. de calle. Los campos seleccionados se agregarán al valor del parámetro Puntos de salida. | Field |
Distancia (Opcional) | La distancia que se utilizará para encontrar la entidad de calle más cercana a la entidad de punto. Cuanto mayor sea el límite de distancia, más tiempo tardará en ejecutarse la herramienta, pero la calidad de las correspondencias mejora. El valor predeterminado es 100 metros. | Double |
Geometría de salida (Opcional) | Especifica la geometría que se incluirá en la clase de entidad de punto de salida.
| String |
País o región (Opcional) | Especifica dónde se aplicará la lógica específica del país a los datos de entrada para asignar atributos de segmento de calle a las entidades de punto. El valor predeterminado es la configuración regional del sistema operativo. Se puede especificar utilizando la opción <Como se defina en los datos> y asignando un valor de los parámetros Entidades de punto de entrada y Entidades de calle en los parámetros Asignación de campo de punto y Asignación de campo de calle; también se puede aplicar a todo el dataset especificando una opción de país.
| String |
Código de lenguaje (Opcional) | Especifica dónde se aplicará la lógica específica del idioma a los datos de entrada para asignar atributos de segmento de calle a las entidades de punto. El valor predeterminado es la configuración regional del sistema operativo. Se puede especificar utilizando la opción <Como se defina en los datos> y asignando un valor de los parámetros Entidades de punto de entrada y Entidades de calle en los parámetros Asignación de campo de punto y Asignación de campo de calle; también se puede aplicar a todo el dataset especificando una opción de idioma.
| String |
Resumen
Busca la mejor entidad de calle para un punto utilizando la información de la dirección, como los números de las casas y los nombres de las calles, así como la distancia. La información de dirección se prioriza sobre la distancia.
Esta herramienta puede utilizarse para vincular direcciones de puntos con datos de calles. El vínculo se establece comparando la información de direcciones de las entidades de calle y de punto, así como la distancia entre ellas. La mejor candidata tiene la mayor similitud entre los nombres, pero también se espera que sea cercana. Una vez establecido el vínculo, se puede generar un Id. del objeto calle, un lado de calle y un nuevo punto cerca de la calle para la dirección del punto. También se pueden transferir atributos adicionales desde la calle a la dirección del punto. Los casos de uso de esta herramienta incluyen anexar atributos de calles a direcciones de puntos o viceversa, generar puntos que están cerca de la calle con el mismo nombre que luego se pueden usar como ubicación de ruta, o producir diagramas de espina de pescado que ilustran la relación entre las direcciones de los puntos y sus entidades de calle asociadas.
Para obtener más información, consulte Asignar calles a puntos según los nombres de las calles y la proximidad.
Ilustración
Uso
Esta herramienta aceptará como entrada clases simples de entidad de punto y de línea.
Esta herramienta puede ayudar a asignar un Id. de unión para nombres alternativos de los datos de referencia de calles a los datos de referencia de puntos, de modo que ambos datasets tengan el mismo Id. de unión para vincularse a la tabla de nombres alternativos de calles.
Utilice esta herramienta para guardar las coordenadas del punto correspondiente en la calle para trabajar con la propiedad Ubicación preferida para el localizador cuando la geometría de la entidad del punto de entrada esté en el tejado o en el centroide de parcela.
Esta herramienta funciona mejor cuando las clases de entidad de punto y línea de entrada se almacenan en una geodatabase y la salida se guarda en una geodatabase.
Para los valores de los parámetros Asignación de campos de puntos y Asignación de campos de calles, utilice la herramienta Dividir dirección en componentes en ambos datasets, y utilice los resultados de esa herramienta para los valores de los parámetros Entidades de puntos de entrada y Entidades de calle para la herramienta Asignar calles a puntos para obtener asignaciones de calles optimizadas.
Para una correspondencia totalmente optimizada, asegúrese de que los campos de ciudad, estado, código de país y código de idioma están asignados para los valores de los parámetros Asignación de campos de punto y Asignación de campos de calle. Para una coincidencia parcialmente optimizada, asegúrese de que los campos de código de país y código de idioma están asignados o especifique el país en el parámetro País o Región y el idioma en el parámetro Código de idioma.
Para mejorar la calidad, asegúrese de que los campos de número de casa y nombre de calle de las clases de entidades de punto y calle de entrada se especifican para los valores de los parámetros de Asignación de campo de punto y Mapeo de campo de calle.
Para ayudar en los flujos de trabajo de generación de rutas, la salida proporciona un indicador del lado de la calle donde se encuentra el punto. El uso de este indicador al construir un localizador lo habilitará para mostrar los resultados en el lado correcto de la calle.
La salida es una copia de todas las entidades y atributos de las entidades de punto de entrada con atributos de los campos especificados para el valor del parámetro Campo(s) de calles incorporado al punto de la calle vinculada. Puede incluir un campo Id. de calle de la clase de entidad de calles de entrada.
La salida incluirá los siguientes campos de forma predeterminada:
- Street_ObjectID—El Id. del objeto del segmento de calle a partir del valor del parámetro Entidades de calle vinculado a los puntos de entrada.
Nota:
Si la clase de entidad de calles de entrada contiene un campo con un Id. de calle, seleccione este campo como valor del parámetro Campo(s) de calles que puede utilizarse al consultar los resultados.
- InputPoint_X—La coordenada x del valor del parámetro Entidades de puntos de entrada en la referencia espacial de la clase de entidad de punto.
- InputPoint_Y—La coordenada y del valor del parámetro Entidades de puntos de entrada en la referencia espacial de la clase de entidad de punto.
- Street_X—La coordenada x de la ubicación del punto de entrada en la calle vinculada para el valor del parámetro Entidades de calle en la referencia espacial de la clase de entidad de punto.
- Street_Y—La coordenada y de la ubicación del punto de entrada en la calle vinculada para el valor del parámetro Entidades de calle en la referencia espacial de la clase de entidad de punto.
- Street_Side—El lado de la calle donde reside el punto de entrada con respecto a la dirección de digitalización de entidades. Este valor no es relativo a la dirección de viaje a lo largo de la calle. Este atributo tendrá uno de los siguientes valores:
- L: el punto está vinculado al lado izquierdo de la calle.
- R: el punto está vinculado al lado derecho de la calle.
- NULO: el punto no está vinculado a ninguna calle.
- Street_MatchReason—Indica cómo se vincularon o correlacionaron los valores de las Entidades de puntos de entrada con los valores del parámetro Entidades de calle tras ejecutar la herramienta. El atributo puede tener uno de los siguientes valores:
- Match_FullStAddr_AddNum: se utilizaron todos los componentes de la dirección de la calle para vincular el punto y la calle, y el número de la casa estaba dentro del rango de números de casa de la calle vinculada.
- Match_FullStAddr: se utilizaron todos los componentes de la dirección de la calle para vincular el punto y la calle.
- Match_Enhanced_AddNum: se utilizaron todos los componentes de la dirección de la calle y número de calle para vincular el punto y la calle.
- Match_StName_AddNum: solo se utilizó el componente del nombre de la calle para vincular el punto y la calle, y el número de la casa estaba dentro del rango de números de casa de la calle vinculada.
- Match_StName: solo se utilizó el componente del nombre de la calle para vincular el punto y la calle.
- Match_Distance_AddNum: se utilizó la distancia para vincular el punto a la calle porque los componentes del nombre de la calle entre los puntos y las calles no coincidían, pero el número de la casa estaba dentro del rango del número de la calle vinculada.
- Match_Distance: se utilizó la distancia para vincular el punto a la calle porque los valores del nombre de la calle entre los puntos y las calles no coincidían.
- Unmatched: el punto no se vinculó a la calle en función de la distancia o de los componentes de la dirección de la calle.
Nota:
Cuando el punto no está vinculado a la calle, los campos de salida predeterminados y los campos de calle seleccionados tendrán atributos NULO, pero los campos InputPoint_X y InputPoint_Y se rellenarán con las coordenadas de la clase de entidad del punto de entrada.
- Street_Distance: la distancia en metros desde el punto de entrada hasta la ubicación más cercana en la calle vinculada.
- Street_ObjectID—El Id. del objeto del segmento de calle a partir del valor del parámetro Entidades de calle vinculado a los puntos de entrada.
Consulte los resultados del valor del parámetro Puntos de salida cuando el valor del campo Street_MatchReason sea Match_Distance_AddNum, Match_Distance o Unmatched. Visualizar cómo los puntos están vinculados a la calle en el mapa facilita la revisión de los resultados.
Esta herramienta admite el procesamiento en paralelo. Cuando el entorno del Factor de procesamiento en paralelo no se ha configurado (el predeterminado), el procesamiento en paralelo se escala en función del tamaño de la tabla y del número de núcleos lógicos. Solo se utilizará un procesamiento para los datasets con menos de 50 filas.
Parámetros
arcpy.geocoding.AssignStreetsToPoints(in_point_features, point_field_mapping, in_street_features, street_field_mapping, out_points, {street_fields}, {distance}, {output_geometry}, {country_code}, {language_code})| Nombre | Explicación | Tipo de datos |
in_point_features | La capa o clase de entidad de puntos de entrada. | Feature Layer |
point_field_mapping [point_field_mapping,...] | La asignación de los campos componentes de la dirección de la calle de las entidades de punto que se utilizarán para comparar el nombre completo de la calle con el nombre completo de la calle en el valor del parámetro in_street_features para calcular el segmento de calle al que está vinculado el punto. Proporcione los nombres de los campos componentes de la dirección de la calle y los nombres de los campos de datos a partir del valor del parámetro in_point_features utilizando los componentes de dirección disponibles como se indica a continuación:
| Value Table |
in_street_features | La clase de entidad o capa de la calle de entrada desde la que se asignarán los atributos al valor del parámetro in_point_features. | Feature Layer |
street_field_mapping [street_field_mapping,...] | La asignación de los campos componentes de la dirección de la calle de las entidades de calles que se utilizarán para comparar el nombre completo de la calle con el nombre completo de la calle en el valor del parámetro in_point_features para calcular el segmento de calle al que está vinculado el punto. Proporcione los nombres de los campos componentes de la dirección de la calle y los nombres de los campos de datos a partir del valor del parámetro in_street_features utilizando los componentes de dirección disponibles como se indica a continuación:
| Value Table |
out_points | La clase de entidad de punto de salida que contiene los campos de calle asignados al punto. | Feature Class |
street_fields [street_fields,...] (Opcional) | Los campos del valor del parámetro in_street_features que se asignarán al valor del parámetro out_points. Especifique campos de las entidades de calle de entrada que contengan atributos para asignar a las entidades de punto vinculadas, por ejemplo, un campo que contenga un valor de Id. de calle. Los campos se agregarán al valor del parámetro out_points. | Field |
distance (Opcional) | La distancia que se utilizará para encontrar la entidad de calle más cercana a la entidad de punto. Cuanto mayor sea el límite de distancia, más tiempo tardará en ejecutarse la herramienta, pero la calidad de las correspondencias mejora. El valor predeterminado es 100 metros. | Double |
output_geometry (Opcional) | Especifica la geometría que se incluirá en la clase de entidad de punto de salida.
| String |
country_code (Opcional) | Especifica dónde se aplicará la lógica específica del país a los datos de entrada para asignar atributos de segmento de calle a las entidades de punto. Se puede utilizar especificando la opción AS_DEFINED_IN_DATA y asignando un valor de los parámetros in_point_features y in_street_features a los parámetros point_field_mapping y street_field_mapping; también se puede aplicar a todo el dataset especificando el código de país de tres letras.
| String |
language_code (Opcional) | Especifica dónde se aplicará la lógica específica del idioma a los datos de entrada para asignar atributos de segmento de calle a las entidades de punto. Se puede utilizar especificando la opción AS_DEFINED_IN_DATA y asignando un valor de los parámetros in_point_featuresy in_street_features a los parámetros point_field_mapping y street_field_mapping; también se puede aplicar a todo el dataset especificando un idioma mediante un código de idioma de tres caracteres.
| String |
Muestra de código
La siguiente secuencia de comandos Python muestra cómo utilizar la función AssignStreetsToPoints.
import arcpy
# Point Address Data from Tutorial Data
in_point_features = r"C:\Data\SanMarcos.gdb\Address_Points"
point_field_mapping = "STREET_FULL_NAME ADDRESS"
# Street Address Data from Tutorial Data
in_street_features = r"C:\Data\SanMarcos.gdb\Address_Lines"
street_field_mapping = "HOUSE_NUMBER_FROM_LEFT L_ADDNUM_FROM;HOUSE_NUMBER_TO_LEFT L_ADDNUM_TO;HOUSE_NUMBER_FROM_RIGHT R_ADDNUM_FROM;HOUSE_NUMBER_TO_RIGHT R_ADDNUM_TO;STREET_PREFIX_DIR STPREDIR;STREET_NAME STNAME;STREET_SUFFIX_TYPE STSUFFIX;STREET_SUFFIX_DIR STPOSTDIR"
output_data_path = r"C:\Data\SanMarcos.gdb\Street_Points"
arcpy.geocoding.AssignStreetsToPoints(
in_point_features,
point_field_mapping,
in_street_features,
street_field_mapping,
output_data_path,
street_fields=None,
distance=70,
output_geometry="STREET_POINT_GEOMETRY"
)Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí