| 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 calles 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 punto de entrada que se utilizarán para vincular el punto a la calle, haga lo siguiente:
Los campos disponibles del componente de dirección son los siguientes:
| Value Table |
Entidades de calles | La clase de entidad o capa de la calle de entrada desde la que se asignarán atributos al valor del parámetro Entidades de puntos 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 calle 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 la 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 del componente de 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 calles 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 correlaciones mejora. El valor predeterminado es de 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 información sobre las direcciones, como los números de las casas y los nombres de las calles, así como la distancia, para encontrar el mejor candidato a entidad de calle 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 la dirección del punto y las entidades de calle, así como la distancia entre ellas. El mejor candidato es el que presenta más similitudes entre los nombres, pero también se espera que esté muy cerca. Una vez establecido el vínculo, se puede producir un Id. de objeto de calle, el lado de la calle y un nuevo punto cerca de la calle para la dirección del punto. También se pueden transferir atributos adicionales de la calle a la dirección puntual. Entre los casos de uso de esta herramienta están incorporar atributos de las calles a las direcciones de los puntos o viceversa; generar puntos que estén junto a la misma calle con nombre que pueden utilizarse después como ubicación de rutas; o producir diagramas de espina de pescado que ilustren la relación entre las direcciones de los puntos y su entidad de calle asociada.
Para más información, consulte Asignar calles a puntos en función de los nombres de las calles y la proximidad.
Ilustración
Uso
Esta herramienta aceptará como entrada clases de entidad de punto y de línea de una sola parte.
Esta herramienta puede ayudar a asignar un Id. conjunto para nombres alternativos de los datos de referencia de calles a los datos de referencia de puntos, de forma que ambos datasets tengan el mismo Id. de unión para establecer el vínculo con la tabla de nombres alternativos de calles.
Esta herramienta funciona mejor si las clases de entidad de punto y línea de entrada están almacenadas en una geodatabase y la salida se guarda en una geodatabase.
En los valores de los parámetros Asignación de campos de punto y Asignación de campos de calle, utilice la herramienta Dividir dirección en componentes en ambos datasets y emplee los resultados de salida de esa herramienta para los valores de los parámetros Entidades de puntos de entrada y Entidades de calles correspondientes a 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 estén escritos y formateados 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 si el localizador cuando la geometría de la característica del punto de entrada está en el tejado o en el centroide de la parcela.
Como ayuda 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, hará posible que el localizador muestre 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 desde la calle vinculada. Podría contener un campo de Id. de calle de la clase de entidad de calles de entrada.
La salida contendrá 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 de 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 punto 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 punto 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 calles 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 calles 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 podrá tener 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.
- NULL: el punto no está vinculado a una calle.
- Street_MatchReason: indica cómo se vincularon o correlacionaron los valores de las Entidades de punto de entrada con los de las Entidades de calles 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 correlacionar el punto con 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 correlacionar el punto con la calle.
- Match_StName_AddNum: solo se utilizó el componente del nombre de la calle para vincular el punto a 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 a 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 correlacionó con la calle en función de la distancia ni de los componentes de la dirección de la calle.
Nota:
Si el punto no se correlaciona con la calle, los campos de salida predeterminados y los campos de calle seleccionados tendrán atributos NULL, pero los campos InputPoint_X y InputPoint_Y se completará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 si el valor del campo Street_MatchReason es Match_Distance_AddNum, Match_Distance o Unmatched. La visualización de cómo los puntos están vinculados a la calle en el mapa facilita la consulta de los resultados.
Esta herramienta admite el procesamiento en paralelo. Si el entorno Factor de procesamiento en paralelo no está definido (predeterminado), el procesamiento 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 calle 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 agregan 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 correlaciones mejora. El valor predeterminado es de 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
En el siguiente script de Python se 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í