| Etiqueta | Explicación | Tipo de datos |
Entidades de entrada | Las entidades de punto, línea o polígono de entrada. | Feature Layer |
Entidades de ruta de entrada | Las rutas con las que se intersecará el valor del parámetro Entidades de entrada. | Feature Layer |
Campo Identificador de rutas | El campo que contiene los valores que identifican de manera única cada ruta. El campo puede ser un campo numérico, de texto o GUID. | Field |
Radio de búsqueda | Si el valor del parámetro Entidades de entrada son puntos, el radio de búsqueda será un valor numérico que define hasta qué distancia alrededor de cada punto se realizará una búsqueda para encontrar una ruta de destino. Si el valor del parámetro Entidades de entrada son líneas, la tolerancia de búsqueda será una tolerancia clúster, que es un valor numérico que representa la máxima distancia tolerada entre las líneas de entrada y las rutas de destino. Si el valor del parámetro Entidades de entrada son polígonos, este parámetro se ignora y no se utilizará radio de búsqueda. | Linear Unit |
Tabla de eventos de salida | La tabla que se creará. | Table |
Propiedades de la Tabla de eventos de salida | Los campos de ubicación de ruta y el tipo de eventos que se escribirán en la tabla de eventos de salida.
| Route Measure Event Properties |
Mantener solo la ubicación de ruta más próxima (Opcional) | Especifica si la ubicación de la ruta más cercana o todas las ubicaciones de la ruta dentro del radio de búsqueda se escribirán en el valor del parámetro Tabla de eventos de salida. Cuando se localizan puntos a lo largo de rutas, puede haber más de una ruta dentro del radio de búsqueda de cualquier punto dado. Este parámetro se ignora cuando se localizan líneas o polígonos a lo largo de las rutas.
| Boolean |
Incluir campo de distancia en tabla de salida (Opcional) | Especifica si se agregará un campo DISTANCE al valor del parámetro Tabla de eventos de salida. Los valores de este campo se encuentran en las unidades del radio de búsqueda especificado. Este parámetro se ignora cuando se localizan líneas o polígonos a lo largo de las rutas.
| Boolean |
Mantener los eventos de línea de longitud cero (Opcional) | Especifica si los eventos de línea de longitud cero se escribirán en la salida. Cuando localiza los polígonos a lo largo de las rutas, se pueden crear eventos en los que el valor de la medición inicial es igual al valor de la medición final. Este parámetro se ignora cuando se localizan puntos o líneas a lo largo de las rutas.
| Boolean |
Incluir todos los campos de la entrada (Opcional) | Especifica si el valor del parámetro Tabla de eventos de salida contendrá campos de ubicación de ruta y todos los atributos del valor del parámetro Entidades de entrada.
| Boolean |
Utilizar desplazamiento de dirección M (Opcional) | Especifica si la distancia de desplazamiento calculada se basará en la dirección M o en la dirección digitalizada. Las distancias se incluyen en el parámetro Tabla de eventos de salida si el parámetro Incluir campo de distancia en tabla de salida está activado.
| Boolean |
Resumen
Computa la intersección de las entidades de entrada (punto, línea o polígono) y las entidades de ruta, y escribe la ruta e información de medición para una nueva tabla de eventos.
Uso
La tabla de salida puede ser un archivo .dbf o una tabla de geodatabase.
Cuando el valor del parámetro Entidades de entrada es puntos, el valor de Tipo de evento debe establecerse en Punto. Cuando el valor del parámetro Entidades de entrada es líneas o polígonos, el valor de Tipo de evento debe establecerse en Línea.
Para obtener los mejores resultados, las entidades de entrada y las rutas de destino deben superponerse.
Precaución:
Si utiliza un radio de búsqueda o una tolerancia cluster grande para superar las discrepancias entre las entidades de entrada y las rutas de destino, se pueden producir resultados inesperados.
Para reducir el número de entidades de entrada que se procesarán con esta herramienta, puede escribir capas que tengan selecciones.
-
La tabla de salida se puede visualizar en un mapa utilizando la herramienta Crear capa de eventos de ruta.
Parámetros
arcpy.lr.LocateFeaturesAlongRoutes(in_features, in_routes, route_id_field, radius_or_tolerance, out_table, out_event_properties, {route_locations}, {distance_field}, {zero_length_events}, {in_fields}, {m_direction_offsetting})| Nombre | Explicación | Tipo de datos |
in_features | Las entidades de punto, línea o polígono de entrada. | Feature Layer |
in_routes | Las rutas con las que se intersecará el valor del parámetro in_features. | Feature Layer |
route_id_field | El campo que contiene los valores que identifican de manera única cada ruta. El campo puede ser un campo numérico, de texto o GUID. | Field |
radius_or_tolerance | Si el valor del parámetro in_features son puntos, el radio de búsqueda será un valor numérico que define hasta qué distancia alrededor de cada punto se realizará una búsqueda para encontrar una ruta de destino. Si el valor del parámetro in_features son líneas, la tolerancia de búsqueda será una tolerancia clúster, que es un valor numérico que representa la máxima distancia tolerada entre las líneas de entrada y las rutas de destino. Si el valor del parámetro in_features son polígonos, este parámetro se ignora y no se utilizará radio de búsqueda. | Linear Unit |
out_table | La tabla que se creará. | Table |
out_event_properties | Los campos de ubicación de ruta y el tipo de eventos que se escribirán en la tabla de eventos de salida.
| Route Measure Event Properties |
route_locations (Opcional) | Especifica si la ubicación de la ruta más cercana o todas las ubicaciones de la ruta dentro del radio de búsqueda se escribirán en el valor del parámetro out_table. Cuando se localizan puntos a lo largo de rutas, puede haber más de una ruta dentro del radio de búsqueda de cualquier punto dado. Este parámetro se ignora cuando se localizan líneas o polígonos a lo largo de las rutas.
| Boolean |
distance_field (Opcional) | Especifica si se agregará un campo DISTANCE al valor del parámetro out_table. Los valores de este campo se encuentran en las unidades del radio de búsqueda especificado. Este parámetro se ignora cuando se localizan líneas o polígonos a lo largo de las rutas.
| Boolean |
zero_length_events (Opcional) | Especifica si los eventos de línea de longitud cero se escribirán en la salida. Cuando localiza los polígonos a lo largo de las rutas, se pueden crear eventos en los que la medición inicial es igual a la medición final. Este parámetro se ignora cuando se localizan puntos o líneas a lo largo de las rutas.
| Boolean |
in_fields (Opcional) | Especifica si el valor del parámetro out_table contendrá campos de ubicación de ruta y todos los atributos del valor del parámetro in_features.
| Boolean |
m_direction_offsetting (Opcional) | Especifica si la distancia de desplazamiento calculada se basará en la dirección M o en la dirección digitalizada. Las distancias se incluyen en el valor del parámetro out_table si el parámetro distance_field está configurado en DISTANCE.
| Boolean |
Muestra de código
En la siguiente secuencia de comandos de Python se muestra cómo utilizar la función LocateFeaturesAlongRoutes en la ventana de Python.
import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.LocateFeaturesAlongRoutes("rail_segments.shp", "rail_routes.shp",
"rkey", "0.5 Feet", "locate_lines",
"rkey LINE fmp tmp")En el siguiente script de Python se muestra cómo utilizar la función LocateFeaturesAlongRoutes en un script independiente de Python.
# Name: LocateFeaturesAlongRoutes_Example2.py
# Description: Locate shapefile lines along shapefile routes.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data"
# Set local variables
feats = "rail_segments.shp"
rts = "rail_routes.shp"
rid = "rkey"
tol = "0.5 Feet"
tbl = "locate_lines"
props = "rkey LINE fmp tmp"
# Run LocateFeaturesAlongRoutes
arcpy.lr.LocateFeaturesAlongRoutes(feats, rts, rid, tol, tbl, props)En la siguiente secuencia de comandos de Python se muestra cómo utilizar la función LocateFeaturesAlongRoutes en una secuencia de comandos independiente de Python utilizando datos de geodatabase de archivos.
# Name: LocateFeaturesAlongRoutes_Example3.py
# Description: Locate personal geodatabase points along file geodatabase routes.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data/Pitt.gdb"
# Set local variables
feats = "rail/crossings" # crossings is in the rail feature dataset
rts = "rail/routes" # routes is in the rail feature dataset
rid = "rkey"
rad = "10 Feet"
tbl = "locate_points"
props = "rkey POINT mp"
# Run LocateFeaturesAlongRoutes
arcpy.lr.LocateFeaturesAlongRoutes(feats, rts, rid, rad, tbl, props)La siguiente secuencia de comandos de Python se muestra cómo utilizar la función LocateFeaturesAlongRoutes en una secuencia de comandos de Python independiente utilizando datos de geodatabase corporativa.
# Name: LocateFeaturesAlongRoutes_Example4.py
# Description: Locate enterprise geodatabase polygons along enterprise geodatabase routes.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"
# Set local variables
feats = arcpy.ValidateTableName("counties", wkspc) # stand-alone feature class
rts = arcpy.ValidateTableName("rail_routes", wkspc) # stand-alone feature class
rid = "rkey"
tbl = "locate_polys"
props = "rkey LINE fmp tmp"
# Run LocateFeaturesAlongRoutes
arcpy.lr.LocateFeaturesAlongRoutes(feats, rts, rid, "#", tbl, props, "#", "#",
"NO_ZERO", "M_DIRECTON")Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí