| 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 componente de la dirección de la calle, ciudad, estado, código de país y código de idioma de las entidades de calle que se utilizarán para comparar el nombre completo de la calle con el nombre completo de la calle del 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 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. Puede especificarse utilizando la opción <Como se defina en los datos> y asignando un valor de los parámetros Entidades de puntos de entrada y Entidades de calles en los parámetros Asignación de campos de puntos y Asignación de campos de calles, o puede aplicarse a todo el dataset especificando una opción de país.
| String |
Código de idioma (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. Puede especificarse utilizando la opción <Como se defina en los datos> y asignando un valor de los parámetros Entidades de puntos de entrada y Entidades de calles en los parámetros Asignación de campos de puntos y Asignación de campos de calles, o puede aplicarse a todo el dataset especificando una opción de idioma.
| String |
Resumen
Busca la mejor entidad de calle candidata 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 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.
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.
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.
Para 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 utilice los resultados de esa herramienta para los valores de los parámetros Entidades de puntos de entrada y Entidades de calles para la herramienta Asignar calles a puntos a fin de obtener asignaciones de calles optimizadas.
Para una correlación 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 correlación 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 del número de la casa y del nombre de la calle de las clases de entidades de punto y calle de entrada se especifican para los valores de los parámetros Asignación de campos de punto y Asignación de campos de calle.
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 del parámetro Entidades de punto de entrada con los valores del parámetro 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_Enhanced_AddNum: se utilizaron todos los componentes de la dirección de la calle y el número de casa 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_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 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}, {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 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 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. Puede especificarse utilizando la opción AS_DEFINED_IN_DATA y asignando un valor de los parámetros in_point_features y in_street_features en los parámetros point_field_mapping y street_field_mapping, o puede aplicarse a todo el dataset especificando el nombre de código de país de tres caracteres.
| 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. Puede especificarse utilizando la opción AS_DEFINED_IN_DATA y asignando un valor de los parámetros in_point_features y in_street_features en los parámetros point_field_mapping y street_field_mapping, o puede aplicarse a todo el dataset especificando un idioma mediante el código de idioma de tres caracteres.
| 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"
)