Cuando FindRoutes se ejecuta correctamente, el servicio devuelve las mejores rutas entre las paradas y el estado que indica si el análisis ha sido satisfactorio por medio de los parámetros de salida que se describen a continuación.
output_routes
Ofrece acceso a las rutas resultantes.
La siguiente tabla muestra los campos que se devuelven para las rutas de salida:
Campo | Descripción |
---|---|
Name | El nombre de la ruta se basa en el campo RouteName de las paradas asociadas. Si el campo RouteName de entrada es nulo, el nombre se deriva del campo Name de la primera y de la última parada. |
StopCount | El número de paradas asignadas a la ruta. |
StartTime | La hora de inicio de la ruta, indicada en la zona horaria en la que se encuentra la primera parada. |
EndTime | La hora de fin de la ruta, indicada en la zona horaria en la que se encuentra la última parada. |
StartTimeUTC | La hora de inicio de la ruta en la hora universal coordinada (UTC). |
EndTimeUTC | La hora de finalización de la ruta en la hora universal coordinada (UTC). |
Total_Minutes | El tiempo de viaje acumulado en minutos desde el principio de la primera parada hasta el final de la última parada de una ruta. Se incluye cualquier AdditionalTime para las paradas visitadas, si se especifica. |
Total_Miles | La distancia de viaje acumulada en millas desde el principio de la primera parada hasta el final de la última parada de una ruta. Se incluye cualquier AdditionalDistance para las paradas visitadas, si se especifica. |
Total_Kilometers | La distancia de viaje acumulada en kilómetros desde el principio de la primera parada hasta el final de la última parada de una ruta. Se incluye cualquier AdditionalDistance para las paradas visitadas, si se especifica. |
Total_Other | El coste de viaje acumulado en unidades desconocidas desde el principio de la primera parada hasta el final de la última parada de una ruta. Se incluye cualquier AdditionalCost para las paradas visitadas, si se especifica. Este campo únicamente se incluye cuando el modo de viaje que se utiliza para el análisis tiene un atributo de impedancia que no está basado ni en tiempo ni en distancia. |
TotalWait_Minutes | Este campo almacena el tiempo de espera total de la ruta, que es el tiempo transcurrido en las paradas esperando a que se abran las ventanas de tiempo. El campo presenta un valor nulo si no se usan ventanas de tiempo en el análisis. |
TotalViolation_Minutes | Este campo almacena el tiempo total de infracción de la ruta en las paradas. El tiempo de infracción se agrega cuando la ruta llega a una parada con la ventana de tiempo ya finalizada; es la diferencia entre los campos ArriveTime y TimeWindowEnd de las paradas de entrada. El campo presenta un valor nulo si no se usan ventanas de tiempo en el análisis. Se incluyen campos adicionales, TotalViolation_[AccumulateAttributeName]_[TimeUnits], para cada atributo de coste basado en el tiempo que se acumula durante el análisis. |
FirstStopOID | El valor ObjectID de la primera parada de la ruta. Este campo se utiliza a menudo para unir información de las paradas de entrada con las rutas. |
LastStopOID | El valor ObjectID de la última parada de la ruta. Este campo se utiliza a menudo para unir información de las paradas de entrada con las rutas. |
output_directions
Ofrece acceso a las indicaciones paso a paso para cada ruta resultante.
La forma de la entidad de indicaciones está determinada desde las calles subyacentes incluidas en la ruta.
Los parámetros Idioma de las indicaciones, Unidades de distancia de las indicaciones y Nombre del estilo de las indicaciones influyen en las indicaciones de viaje. El parámetro devuelve entidades vacías si el parámetro Rellenar indicaciones es Falso.
La siguiente tabla muestra los campos que se devuelven para las indicaciones de salida:
Campo | Descripción |
---|---|
RouteName | El nombre de la ruta a la que se aplica la acción de conducción. Este valor es el mismo que el del campo Name de las rutas de salida. |
ArriveTime | La hora del día para iniciar determinada acción de conducción. Si la ruta abarca varios días, la fecha y hora del día se muestran. |
Type | El tipo de maniobra que representa la entidad de indicaciones o el tipo de texto de las indicaciones. Para determinar si Type hace referencia a un tipo de maniobra o a un tipo de cadena de caracteres de las indicaciones, compruebe el valor del campo SubItemType. Type se puede utilizar, por ejemplo, para asignar un icono para un texto de indicación en función del tipo de maniobra, o usar un estilo de formato dependiendo del tipo de cadena de caracteres de las indicaciones cuando se visualizan las indicaciones de conducción en su aplicación. El valor Type es un valor entero de las siguientes listas Tipos de maniobra o Tipos de cadena de caracteres de las indicaciones. Tipos de maniobra
Tipos de cadena de caracteres de las indicaciones
|
SubItemType | Especifica si el campo Type hace referencia a un entero de la tabla Tipos de cadena de caracteres de las indicaciones o la tabla Tipos de maniobra.
|
Text | Una descripción de texto de las indicaciones de viaje. |
ElaspsedTime | El tiempo transcurrido en minutos desde el momento en que comienza la actual indicación de conducción hasta que empieza la próxima, o hasta que finaliza la ruta de la última indicación de conducción. |
DriveDistance | La distancia desde donde se produce la actual indicación de conducción a donde ocurre la siguiente, o donde finaliza la ruta para la última indicación de conducción. El valor está en las unidades que se especifican en el parámetro Directions_Distance_Units. Este valor es cero para las indicaciones de conducción que ocurren en la misma ubicación en la que comienza la próxima. Por ejemplo, DriveDistance es 0 para las indicaciones al inicio de la ruta. |
output_direction_points
Especifica las indicaciones paso a paso de salida para las rutas calculadas en el análisis, representadas como ubicaciones de puntos a lo largo de las rutas donde se producen eventos de indicaciones o maniobras específicos.
Nombre de campo | Descripción |
---|---|
RouteID | El ObjectID de la entidad de salida output_routes con la que está asociado este punto de indicación. |
Sequence | La secuencia de los puntos de indicación de la ruta, empezando por 1. |
DirectionPointType | El tipo de evento o maniobra de indicaciones descrito por el punto, designado por uno de los valores siguientes.
|
StopID | El ObjectID de la parada con la que está asociado este punto de indicación, si existe. Si el punto no representa una visita a una parada, el valor es nulo. |
DisplayText | El texto de las indicaciones que se va a mostrar en la aplicación que utiliza. |
ArrivalTime | La hora en la que ocurre el evento de indicaciones en la hora universal coordinada (UTC). |
ArrivalUTCOffset | La diferencia en minutos entre la hora local en la ubicación de maniobra y la hora UTC mostrada en el campo ArrivalTime, en minutos. |
Name | El nombre del punto de indicaciones. |
ExitName | El nombre de salida de carretera que aparece en la instrucción de las indicaciones. |
AlternateName | Nombre de origen alternativo que aparece en la instrucción de las indicaciones. |
IntersectingName | El nombre de la calle de intersección o de cruce que aparece en la instrucción de las indicaciones. |
BranchName | El nombre de rama del poste indicador que aparece en la instrucción de las indicaciones. |
TowardName | El nombre del poste indicador hacia el destino que aparece en la instrucción de las indicaciones. |
Level | El nivel de edificio en el que ocurre este evento de indicaciones. Este valor corresponde a la propiedad Level definida en el dataset de red utilizado para el análisis. Más información sobre la configuración de indicaciones de un dataset de red |
ShortVoiceInstruction | Texto corto que se utiliza como texto de la guía de voz en la aplicación que utiliza. |
VoiceInstruction | El texto de relleno, incluidas las abreviaturas expandidas y los plurales, para utilizarlo como texto de la guía de voz en la aplicación que utiliza. |
Azimuth | El rumbo en grados del vehículo que sale de este punto. El cero indica el norte. |
output_direction_lines
Especifica las líneas de ruta de salida calculadas en el análisis dividido en zonas para representar cada segmento de ruta entre ubicaciones de eventos o maniobras de DirectionPoints.
Nombre de campo | Descripción |
---|---|
DirectionPointID | El ObjectID de la entidad de la tabla output_direction_points con la que está asociada esta línea. |
RouteID | El ObjectID de la entidad de salida output_routes con la que está asociada esta línea de indicación. |
DirectionLineType | El tipo de situación de indicaciones descrito por esta línea, designado por uno de los siguientes valores.
|
Meters | La longitud del segmento de línea medida en metros. |
Minutes | El tiempo de viaje a lo largo del segmento de línea en minutos. |
FromLevel | El nivel de edificio en el que se inicia este evento de indicaciones. Este valor corresponde a la propiedad Level definida en el dataset de red utilizado para el análisis. Más información sobre la configuración de indicaciones de un dataset de red |
ToLevel | El nivel de edificio en el que finaliza este evento de indicaciones. Este valor corresponde a la propiedad Level definida en el dataset de red utilizado para el análisis. |
output_stops
Ofrece acceso a los atributos de las paradas que visitan las rutas, así como las paradas que no puede alcanzar ninguna de las rutas.
Puede usar los atributos de este parámetro, como el campo Status, para determinar el motivo por el que una parada no se asignó a ninguna ruta.
La tabla que aparece a continuación enumera los campos que se devuelven para las paradas de salida. Además de estos campos, el parámetro también incluye todos los campos de la clase de entidad de entrada que se utilizan como paradas del análisis.
Campo | Descripción |
Name | El nombre de la parada visitada por la ruta. Los valores de este campo se copian del campo Name de las paradas de entrada. |
RouteName | El nombre de la ruta a la que se ha asignado la parada. Las paradas de entrada que tienen el mismo nombre de ruta en el momento en el que se ejecuta la herramienta, se agrupan y se visitan por una ruta, asignando ese nombre a la ruta. Cuando hay más de un nombre de ruta presente en las paradas de entrada, la herramienta puede generar varias rutas: una para cada nombre de ruta. Si no hay presente ningún nombre, todas las paradas pertenecen a la misma ruta. |
Sequence | El orden en el que la ruta asignada visita las paradas, que aparece en el campo RouteName. |
TimeWindowStart | Hora más temprana a la que la ruta puede visitar la parada. Los valores de este campo se copian del campo TimeWindowStart de las paradas de entrada. |
TimeWindowEnd | Hora más tardía a la que la ruta puede visitar la parada. Los valores de este campo se copian del campo TimeWindowEnd de las paradas de entrada. |
ArriveCurbApproach | De qué lado del vehículo está el bordillo al llegar a la parada. |
DepartCurbApproach | De qué lado del vehículo está el bordillo al salir de la parada. |
ArriveTime | El valor de la fecha y la hora de llegada a la parada. La zona horaria de este valor de hora del día se toma del elemento de red en el que se encuentra la parada. |
DepartTime | El valor de la fecha y la hora que indican la hora de salida de la parada. La zona horaria de este valor de hora del día se toma del elemento de red en el que se encuentra la parada. |
ArriveTimeUTC | El valor de la fecha y la hora de llegada a la parada. La zona horaria de este valor de hora del día se toma del elemento de red en el que se encuentra la parada. |
DepartTimeUTC | El valor de la fecha y la hora de salida expresado en la hora universal coordinada (UTC) |
LocationType | El tipo de parada. Los valores de este campo se copian del campo LocationType de las paradas de entrada. |
SourceID | El identificador numérico de la clase de entidad de origen del dataset de red donde se ubica el punto de entrada. |
SourceOID | El ObjectID de la entidad del origen donde se ubica el punto de entrada. |
PosAlong | La posición a lo largo de la dirección digitalizada de la entidad de línea de origen. Este valor se almacena como ratio. Este campo es nulo si la ubicación de red hace referencia a un cruce. |
SideOfEdge | El lado del eje respecto a la dirección digitalizada de la entidad de línea. Este campo se limita a un dominio de dos valores: lado derecho (1) y lado izquierdo (2). |
CurbApproach | Dirección en la que un vehículo puede llegar a la parada y partir de ella. Los valores de este campo se copian del campo CurbApproach de las paradas de entrada. |
Status | Indica el estado del punto con respecto a su ubicación en la red y el resultado del análisis. Los posibles valores son los siguientes:
|
SnapX | La coordenada x de la posición en el dataset de red donde se ubica el punto, en el sistema de coordenadas del dataset de red. |
SnapY | La coordenada y de la posición en el dataset de red donde se ubica el punto, en el sistema de coordenadas del dataset de red. |
SnapZ | La coordenada z de la posición en el dataset de red donde se ubica el punto, en el sistema de coordenadas del dataset de red. El campo SnapZ es 0 si la red es bidimensional. |
DistanceToNetworkInMeters | La distancia en metros entre la ubicación geográfica del punto y la posición en la que se ubicaba en la red. |
AdditionalTime | Tiempo añadido al tiempo total de la ruta al visitar esta parada. Los valores de este campo se copian del campo AdditionalTime de las paradas de entrada. |
AdditionalDistance | Distancia añadida a la distancia total de la ruta al visitar esta parada. Los valores de este campo se copian del campo AdditionalDistance de las paradas de entrada. |
AdditionalCost | El coste agregado al coste total de la ruta cuando se visita esta parada. Los valores de este campo se copian del campo AdditionalCost de las paradas de entrada. Este campo únicamente se incluye cuando el modo de viaje que se utiliza para el análisis tiene un atributo de impedancia que no está basado ni en tiempo ni en distancia. |
Cumul_Minutes | La duración acumulada de la ruta en minutos desde el origen, incluida la parada. El valor detallado aquí es el tiempo acumulado de la ruta hasta la parada, incluido cualquier tiempo adicional en la parada y en cualquier parada anterior. Por ejemplo, si un análisis de ruta determina que se tardan 10 minutos en visitar dos paradas y la segunda parada tiene un valor AdditionalTime de 5, el valor Cumul_Minutes será 15 minutos. |
Cumul_Miles | La distancia acumulada de la ruta en millas desde el origen, incluida la parada. El valor detallado aquí es la distancia acumulada de la ruta hasta la parada, incluida cualquier distancia adicional en la parada y en cualquier parada anterior. |
Cumul_Kilometers | La distancia acumulada de la ruta en kilómetros desde el origen, incluida la parada. El valor detallado aquí es la distancia acumulada de la ruta hasta la parada, incluida cualquier distancia adicional en la parada y en cualquier parada anterior. |
Cumul_Cost | El coste acumulado de la ruta desde el origen, incluida la parada. El valor detallado aquí es el coste acumulado de la ruta hasta la parada, incluido cualquier coste adicional en la parada y en cualquier parada anterior. Este campo únicamente se incluye cuando el modo de viaje que se utiliza para el análisis tiene un atributo de impedancia que no está basado ni en tiempo ni en distancia. El valor está en unidades desconocidas. |
Wait_Minutes | Este campo almacena el tiempo invertido en esperar a que la ventana de tiempo se abra cuando la ruta llega temprano a la parada. El campo presenta un valor nulo si no se usan ventanas de tiempo en el análisis. |
CumulWait_Minutes | Este campo almacena la suma del tiempo que se espera a que se abran las ventanas de tiempo. Mide el tiempo inactivo. Incluye el tiempo de espera desde la parada actual y desde todas las paradas anteriores visitadas por la ruta. El campo presenta un valor nulo si no se usan ventanas de tiempo en el análisis. |
Violation_Minutes | Este campo es una medida del retraso de la ruta una vez cerrada la ventana de tiempo. Específicamente, almacena la cantidad de tiempo entre el fin de la ventana de tiempo y el momento en que la ruta llegó a la parada. El campo presenta un valor nulo si no se usan ventanas de tiempo en el análisis. Se incluyen campos Violation_[AccumulateAttributeName]_[TimeUnits] adicionales para cada atributo de coste basado en el tiempo que se acumula durante el análisis. |
CumulViolation_Minutes | Este campo almacena el tiempo de infracción acumulativo desde la parada actual y desde todas las paradas anteriores visitadas por la ruta. El campo presenta un valor nulo si no se usan ventanas de tiempo en el análisis. Se incluyen campos CumulViolation_[AccumulateAttributeName]_[TimeUnits] adicionales para cada atributo de coste basado en el tiempo que se acumula durante el análisis. |
ORIG_FID | El ObjectID de la parada de entrada. Este campo se puede usar para unir atributos de las paradas de salida con las paradas de entrada o viceversa. |
Bearing | Los valores de este campo se copian del campo Bearing de las paradas de entrada. |
BearingTol | Los valores de este campo se copian del campo BearingTol de las paradas de entrada. |
NavLatency | Los valores de este campo se copian del campo NavLatency de las paradas de entrada. |
output_route_edges
Ofrece acceso a los ejes de red individuales por los que viajan las rutas.
Este parámetro solo tiene un valor si el parámetro populate_route_edges tiene el valor True.
La siguiente tabla muestra los campos que admiten los ejes de la ruta de salida:
Campo | Descripción |
---|---|
SourceName | El nombre de la clase de entidad de origen de borde desde la que se generó la línea. |
SourceOID | El ObjectID de la entidad de calle del trazado poligonal. En resumen, los valores de este campo ofrecen información de utilidad como, por ejemplo, el número de veces que una entidad de calle concreta se incluye en todas las rutas. |
RouteEdgeID | ID que representa el eje que forma la entidad de calle. Dado que puede haber más de un eje por entidad de calle, el campo SourceOID se puede utilizar para identificar de forma única la entidad de calle del trazado poligonal, mientras que el campo RouteEdgeID se puede utilizar para identificar de forma única el eje dentro de la entidad de calle atravesada. |
FromPosition | Especifica dónde comienza la entidad de RouteEdges de salida en referencia con la dirección digitalizada de la entidad de calle subyacente.
|
ToPosition | Especifica dónde finaliza la entidad de RouteEdges de salida en referencia a la dirección digitalizada de la entidad de calle subyacente.
|
RouteID | Identifica de manera única la ruta que atravesó el eje. El valor RouteID corresponde a un valor ObjectID de las rutas de salida. |
Attr_Minutes | Tiempo de viaje en minutos de la parte atravesada de la entidad de calle subyacente. |
Attr_Miles | Longitud en millas de la parte atravesada de la entidad de calle subyacente. |
Attr_Kilometers | Longitud en kilómetros de la parte atravesada de la entidad de calle subyacente. |
Attr_Other | El coste de viaje de la parte atravesada de la entidad de calle subyacente. Este campo únicamente se incluye cuando el modo de viaje que se utiliza para el análisis tiene un atributo de impedancia que no está basado ni en tiempo ni en distancia. El valor está en unidades desconocidas. |
Cumul_Minutes | Tiempo de viaje en minutos de la ruta desde su origen hasta el final de la parte atravesada de esta entidad de calle subyacente. |
Cumul_Miles | Longitud en millas de la ruta desde su origen hasta el final de la parte atravesada de esta entidad de calle subyacente. |
Cumul_Kilometers | Longitud en kilómetros de la ruta desde su origen hasta el final de la parte atravesada de esta entidad de calle subyacente. |
Cumul_Other | El coste de viaje de la ruta desde su origen hasta el final de la parte atravesada de esta entidad de calle subyacente. Este campo únicamente se incluye cuando el modo de viaje que se utiliza para el análisis tiene un atributo de impedancia que no está basado ni en tiempo ni en distancia. El valor está en unidades desconocidas. |
Attr_[Soft Restriction Attribute Name] | Especifica si el borde atravesado utiliza el atributo de restricción no estricta al que hace referencia en el nombre de este campo.
Por ejemplo, si el análisis se realizó usando la restricción no estricta Evitar carreteras con peaje, se crea un campo Attr_Avoid_Toll_Roads para esta restricción no estricta. Un valor de 1 en este campo representaría las carreteras con peaje de la ruta. |
solve_succeeded
Utilice este parámetro para determinar si el análisis se realizó correctamente.
output_result_file
Utilice este parámetro para acceder a los resultados del análisis en un archivo .zip que contiene uno o varios archivos para cada salida. El formato de los archivos individuales viene especificado por el parámetro Formato de salida. El valor del parámetro no se rellena si el parámetro Formato de salida está definido como Conjunto de entidades.
Cuando se especifica un formato de salida basado en archivos —como archivo JSON o archivo GeoJSON—, no se agrega ninguna salida a la visualización, dado que la aplicación, (por ejemplo, ArcMap o ArcGIS Pro) no puede dibujar el contenido del archivo de resultados. En cambio, el archivo de resultados se descarga en un directorio temporal en su equipo. En ArcGIS Pro, la ubicación del archivo descargado se puede determinar visualizando el valor del parámetro Archivo de resultados de salida en la entrada correspondiente a la ejecución de la herramienta en el historial de geoprocesamiento del proyecto. En ArcMap, la ubicación del archivo se puede determinar accediendo a la opción Copiar ubicación del menú de acceso directo del parámetro Archivo de resultados de salida de la entrada correspondiente a la ejecución de la herramienta en la ventana Resultados de geoprocesamiento.
output_route_data
Use este parámetro para acceder a un archivo .zip que contiene una geodatabase de archivos que alberga las entradas y las salidas del análisis en un formato que se puede usar para compartir las capas de ruta con ArcGIS Online o Portal for ArcGIS. El valor del parámetro se rellena únicamente si el parámetro Guardar datos de ruta está definido como Verdadero.
El archivo se descarga a un directorio temporal en su equipo. En ArcGIS Pro, la ubicación del archivo descargado se puede determinar visualizando el valor del parámetro Datos de ruta de salida en la entrada correspondiente a la ejecución de la herramienta en el historial de geoprocesamiento del proyecto. En ArcMap, la ubicación del archivo se puede determinar accediendo a la opción Copiar ubicación del menú contextual del parámetro Datos de ruta de salida de la entrada correspondiente a la ejecución de la herramienta en la ventana Resultados de geoprocesamiento.
output_network_analysis_layer
Use este parámetro para acceder al archivo de capa de análisis de red que almacena la configuración de análisis y las entradas y salidas utilizadas para el análisis. El valor del parámetro se rellena únicamente si el parámetro Guardar capa de análisis de red de salida está definido como Verdadero.
El archivo se descarga a un directorio temporal en su equipo. En ArcGIS Pro, la ubicación del archivo descargado se puede determinar visualizando el valor del parámetro Capa de análisis de red de salida en la entrada correspondiente a la ejecución de la herramienta en el historial de geoprocesamiento del proyecto. En ArcMap, la ubicación del archivo se puede determinar accediendo a la opción Copiar ubicación del menú de acceso directo del parámetro Capa de análisis de red de salida de la entrada correspondiente a la ejecución de la herramienta en la ventana Resultados de geoprocesamiento.