| 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 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 70 metros. | Double |
Geometría de salida (Opcional) | Especifica la geometría que se incluirá en la clase de entidad de punto de salida.
| String |
Resumen
Utiliza la información de direcciones, como números de casas y nombres de calles, así como la distancia, para encontrar la mejor entidad de calle candidata para un punto. 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.
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 Asignar calles a puntos.
Para mejorar la calidad, asegúrese de que los nombres de las calles y los componentes de las direcciones de las calles se escriben y formatean de forma coherente en todas las clases de entidad de los puntos de entrada y las 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.
Para ayudar en los flujos de trabajo de generación de rutas, la salida proporciona un indicador del lado de la calle en el que 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 con 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 de las 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_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_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})| 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 70 metros. | Double |
output_geometry (Opcional) | Especifica la geometría que se incluirá en la clase de entidad de punto de salida.
| 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"
)