Route input data types

The input data types that can be specified when performing a route analysis are described below.

Stops

Especifica las ubicaciones que visitará la ruta o rutas de salida.

The data type supports the following fields:

FieldDescriptionData type

Name

El nombre de la parada. El nombre se utiliza en las indicaciones sobre cómo llegar. Si no se proporciona el nombre, se genera automáticamente un nombre único con el prefijo Location en las paradas, rutas e indicaciones de salida.

Text

RouteName

El nombre de la ruta a la que pertenece la parada. Se agrupan las paradas con el mismo valor RouteName.

Al usar este campo, puede agrupar paradas en distintas rutas, mientras que la salida intenta generar una ruta para cada grupo de paradas.

  • Si algunas paradas tienen nombres de ruta, se agrupan en una ruta con el mismo nombre. Si algunas paradas tienen valores RouteName y otras no, aquellas sin nombres de ruta se enumeran como no asignadas en los resultados y se excluyen de la solución.
  • Si ninguna de las paradas tiene un valor de RouteName, todas las paradas pertenecen a la misma ruta y se genera una sola ruta.
  • RouteName Los valores no distinguen entre mayúsculas y minúsculas. Por ejemplo, Ruta 1 se interpretará como la misma ruta que RUTA 1.

Text

Sequence

Las rutas de salida visitan las paradas en el orden especificado con este atributo. En un grupo de paradas con el mismo valor de RouteName, el número de secuencia debe ser mayor que 0 y no superar el número total de paradas. Asimismo, el número de secuencia no debería estar duplicado.

If the findBestSequence property is set to True, all but possibly the first and last sequence values for each route name are ignored so the tool can find the sequence that minimizes overall travel for each route. The values for the preserveFirstStop, preserveLastStop, and returnToStart properties determine whether the first or last sequence values for each route are ignored.

Long

AdditionalTime

La cantidad de tiempo pasado en la parada, que se agrega al tiempo total de la ruta. El valor predeterminado es 0.

The units for this attribute value are specified by the timeUnits property of the analysis object.

You can account for the extra time it takes at the stop to complete a task, such as to repair an appliance, deliver a package, or inspect the premises.

Double

AdditionalDistance

La distancia adicional de viaje en las paradas, que se agrega a la distancia total de la ruta. El valor predeterminado es 0.

The units for this attribute value are specified by the distanceUnits property of the analysis object.

Generally, the location of a stop, such as a home, isn't exactly on the street; it is set back somewhat from the road. This attribute value can be used to model the distance between the actual stop location and its location on the street if it is important to include that distance in the total travel distance.

Double

AdditionalCost

El coste adicional que se gasta en la parada, que se agrega al coste total de la ruta. El valor predeterminado es 0.

Este valor de atributo debe utilizarse cuando el modo de desplazamiento para el análisis utiliza un atributo de impedancia que no se basa ni en el tiempo ni en la distancia. Las unidades de los valores de los atributos se interpretan como unidades desconocidas.

Double

TimeWindowStart

La hora más temprana en que se puede visitar la parada. Si se especifica una hora de inicio y de fin para la ventana de tiempo de una parada, se define cuándo puede pasar una ruta por la parada. Cuando el modo de viaje del análisis utiliza un atributo de impedancia basado en el tiempo, la especificación de los valores de la ventana de tiempo hace que el análisis busque una solución que minimice el tiempo total del viaje y llegue a la parada en la ventana de tiempo establecida.

The value for this attribute should be a date and time value and can be specified using a datetime Python object, such as datetime.datetime(2019, 5, 11, 8, 30, 0), which represents Saturday, May 11, 2019 at 08:30:00 a.m. The time zone for the value is specified by the timeZoneForTimeWindows property of the analysis object.

This field can contain a null value; a null value indicates a route can arrive at any time before the time indicated in the TimeWindowEnd attribute. If a null value is also present in TimeWindowEnd, a route can visit the stop at any time.

Date

TimeWindowEnd

La hora más tardía en que se puede visitar la parada. Si se especifica una hora de inicio y de fin para la ventana de tiempo de una parada, se define cuándo puede pasar una ruta por la parada. Cuando el modo de viaje del análisis utiliza un atributo de impedancia basado en el tiempo, la especificación de los valores de la ventana de tiempo hace que el análisis busque una solución que minimice el tiempo total del viaje y llegue a la parada en la ventana de tiempo establecida.

The value for this attribute should be a date and time value and can be specified using a datetime Python object, such as datetime.datetime(2019, 5, 11, 17, 30, 0), which represents Saturday, May 11, 2019 at 05:30:00 p.m. The time zone for the value is specified by the timeZoneForTimeWindows property of the analysis object.

This field can contain a null value; a null value indicates a route can arrive at any time after the time indicated in the TimeWindowStart attribute. If a null value is also present in TimeWindowStart, a route can visit the stop at any time.

Date

CurbApproach

Especifica la dirección en la que un vehículo puede llegar a la parada y partir de ella. El valor de campo se especifica como uno de los siguientes enteros (use el código numérico, no el nombre entre paréntesis):

  • 0 (Cualquier lado del vehículo): El vehículo puede aproximarse a la parada y abandonarla en cualquier dirección, de modo que se admite un cambio de sentido en la parada. Puede utilizar esta configuración si es posible y práctico que un vehículo dé la vuelta en la parada. Esta decisión puede depender del ancho del camino y del volumen de tráfico, o de si la parada dispone de una zona estacionamiento en la que los vehículos pueden maniobrar.
  • 1 (Lado derecho del vehículo): cuando el vehículo se aproxima a la parada y parte de ella, el bordillo debe quedar a la derecha del vehículo. Los cambios de sentido están prohibidos. Esto se usa normalmente para vehículos como los autobuses que deben llegar con la parada a la derecha.
  • 2 (Lado izquierdo del vehículo): Cuando el vehículo se aproxima a la parada y la abandona, el bordillo debe estar a la izquierda del vehículo. Los cambios de sentido están prohibidos. Esto se usa normalmente para vehículos como los autobuses que deben llegar con la parada a la izquierda.
  • 3 (Sin giro en U): cuando el vehículo se aproxima a la parada, el bordillo puede estar a uno u otro lado del vehículo; no obstante, el vehículo debe partir sin cambiar de sentido.

El atributo CurbApproach trabaja con ambos estándares nacionales de circulación: por la derecha (Estados Unidos) y por la izquierda (Reino Unido). En primer lugar, considere una parada en el lado izquierdo de un vehículo. Siempre estará situada el lado izquierdo, independientemente de si el vehículo circula por la mitad izquierda o derecha del camino. Las normas de circulación nacionales pueden influir en su decisión de aproximarse a una parada desde una de las dos direcciones posibles, de modo que quede en el lado derecho o en el lado izquierdo del vehículo. Por ejemplo, para llegar a una parada y que no haya un carril de tráfico entre el vehículo y la parada, elija 1 (Lado derecho del vehículo) en Estados Unidos y 2 (Lado izquierdo del vehículo) en el Reino Unido.

Long

LocationType

Especifica el tipo de parada. El valor de campo se especifica como uno de los siguientes enteros (use el código numérico, no el nombre entre paréntesis):

  • 0 (Parada): una ubicación que la ruta va a visitar. Esta es la opción predeterminada.
  • 1 (Punto de referencia): una ubicación por la que viajará la ruta sin realizar ninguna parada. Los puntos de referencia se pueden utilizar para obligar a la ruta a que tome un camino específico (atravesar el punto de referencia) sin que se considere una parada real. Los puntos de referencia no aparecen en las indicaciones.

Long

Bearing

La dirección en la que está avanzando un punto. Las unidades son grados y se miden en sentido horario desde el norte verdadero. Este campo se utiliza junto con el campo BearingTol.

Los datos de rumbo normalmente se envían de forma automática desde un dispositivo móvil dotado de un receptor GPS. Intente incluir datos de rumbo si está cargando una ubicación de entrada que se mueve, como un peatón o un vehículo.

Utilizar este campo tiende a evitar agregar ubicaciones a los ejes equivocados, que puede ocurrir cuando un vehículo está cerca de una intersección o un paso elevado, por ejemplo. El rumbo también ayuda a la herramienta a determinar en qué lado de la calle está el punto.

Más información sobre el rumbo y la tolerancia de rumbo

Double

BearingTol

El valor de tolerancia de rumbo crea un rango de valores de rumbo aceptable al ubicar los puntos en movimiento en un eje con el campo Bearing. Si el valor del campo Bearing está dentro del rango de valores aceptables que se generan a partir de la tolerancia de rumbo en un eje, el punto se puede agregar como una ubicación de red ahí; de lo contrario, se evalúa el punto más cercano sobre el próximo eje más cercano.

Las unidades se expresan en grados y el valor predeterminado es 30. Los valores deben ser mayores que 0 y menores que 180. Un valor de 30 significa que, cuando Network Analyst intenta agregar una ubicación de red en un eje, se genera un rango de valores de rumbo aceptable 15 grados hacia cada lado del eje (izquierda y derecha) y en ambas direcciones digitalizadas del eje.

Más información sobre el rumbo y la tolerancia de rumbo

Double

NavLatency

Este campo solo se utiliza en el proceso de resolución si los campos Bearing y BearingTol también tienen valores. Sin embargo, la introducción de un valor de campo NavLatency es opcional, incluso cuando hay valores en Bearing y BearingTol. NavLatency indica cuánto coste se espera desde el momento en que se envía la información de GPS desde un vehículo en movimiento a un servidor y el momento en que el dispositivo de navegación del vehículo recibe la ruta procesada.

Las unidades de NavLatency son las mismas que las unidades del atributo de impedancia.

The time units of NavLatency are the same as the units specified by the timeUnits property of the analysis object.

Double

Network location fields

  • SourceID
  • SourceOID
  • PosAlong
  • SideOfEdge

Conjuntamente, estas propiedades describen el punto en la red donde se encuentra el objeto.

Obtener más información sobre ubicación de entradas en una red

PointBarriers

Utilice este parámetro para especificar uno o varios puntos que actuarán como restricciones temporales o representen el tiempo o la distancia adicionales que puede que se necesiten para viajar en las calles subyacentes. Por ejemplo, una barrera de punto se puede usar para representar un árbol caído en una calle o el retraso acumulado en un cruce de ferrocarril.

The data type supports the following fields:

FieldDescriptionData type

Name

El nombre de la barrera.

Text

BarrierType

Especifica si la barrera de punto restringe el recorrido completamente o agrega tiempo o distancia cuando se cruza. El valor de este atributo se especifica como uno de los siguientes enteros (use el código numérico, no el nombre entre paréntesis):

  • 0 (Restricción): prohíbe viajar por la barrera. La barrera se conoce como barrera de punto de restricción, ya que actúa como una restricción.

  • 2 (Coste agregado): viajar a través de la barrera aumenta el tiempo o la distancia de viaje en la cantidad especificada en el campo Additional_Time, Additional_Distance o AdditionalCost. Este tipo de barrera se denomina barrera de punto de coste añadido.

Long

Additional_Time

The added travel time when the barrier is traversed.

This field value must be greater than or equal to zero, and the values are interpreted to be in the units specified by the timeUnits property.

Double

Additional_Distance

The added distance when the barrier is traversed.

This field value must be greater than or equal to zero, and the values are interpreted to be in the units specified by the distanceUnits property.

Double

AdditionalCost

The added cost when the barrier is traversed.

This field value must be greater than or equal to zero, and the values are interpreted to be in unknown units.

Double

FullEdge

Especifica cómo se aplican las barreras de punto de restricción a los elementos de eje durante el análisis. El valor de campo se especifica como uno de los siguientes enteros (use el código numérico, no el nombre entre paréntesis):

  • 0 (Falso): permite viajar por el eje hasta la barrera, pero no a través de ella. Este es el valor predeterminado.
  • 1 (Verdadero): restringe el viaje a cualquier punto del eje asociado.

Long

CurbApproach

Especifica la dirección de tráfico que se ve afectada por la barrera. El valor de campo se especifica como uno de los siguientes enteros (use el código numérico, no el nombre entre paréntesis):

  • 0 (Cualquier lado del vehículo): la barrera afecta al viaje por el eje en ambas direcciones.
  • 1 (Lado derecho del vehículo): los vehículos solo se ven afectados si la barrera se encuentra a su lado derecho al acercase a ella. La barrera no afecta a los vehículos que atraviesan el mismo eje, pero se acercan la barrera por su lado izquierdo.
  • 2 (Lado izquierdo del vehículo): los vehículos solo se ven afectados si la barrera se encuentra a su lado izquierdo al acercase a ella. La barrera no afecta a los vehículos que atraviesan el mismo eje, pero se acercan la barrera por su lado derecho.

Debido a que los cruces son puntos y no tienen lados, las barreras sobre cruces afectan a todos los vehículos, independientemente de la aproximación a borde.

El atributo CurbApproach trabaja con los dos tipos de estándares nacionales de circulación: por la derecha (Estados Unidos) y por la izquierda (Reino Unido). En primer lugar, considere una instalación en el lado izquierdo de un vehículo. Siempre estará situada el lado izquierdo, independientemente de si el vehículo circula por la mitad izquierda o derecha del camino. Los estándares de circulación nacionales pueden influir en su decisión de aproximarse a una instalación por una de las dos direcciones posibles, de modo que quede en el lado derecho o en el lado izquierdo del vehículo. Por ejemplo, para llegar a una instalación y que no haya un carril entre el vehículo y la instalación, elija 1 (Lado derecho del vehículo) en Estados Unidos y 2 (Lado izquierdo del vehículo) en Reino Unido.

Long

Bearing

La dirección en la que está avanzando un punto. Las unidades son grados y se miden en sentido horario desde el norte verdadero. Este campo se utiliza junto con el campo BearingTol.

Los datos de rumbo normalmente se envían de forma automática desde un dispositivo móvil dotado de un receptor GPS. Intente incluir datos de rumbo si está cargando una ubicación de entrada que se mueve, como un peatón o un vehículo.

Utilizar este campo tiende a evitar agregar ubicaciones a los ejes equivocados, que puede ocurrir cuando un vehículo está cerca de una intersección o un paso elevado, por ejemplo. El rumbo también ayuda a la herramienta a determinar en qué lado de la calle está el punto.

Más información sobre el rumbo y la tolerancia de rumbo

Double

BearingTol

El valor de tolerancia de rumbo crea un rango de valores de rumbo aceptable al ubicar los puntos en movimiento en un eje con el campo Bearing. Si el valor del campo Bearing está dentro del rango de valores aceptables que se generan a partir de la tolerancia de rumbo en un eje, el punto se puede agregar como una ubicación de red ahí; de lo contrario, se evalúa el punto más cercano sobre el próximo eje más cercano.

Las unidades se expresan en grados y el valor predeterminado es 30. Los valores deben ser mayores que 0 y menores que 180. Un valor de 30 significa que, cuando Network Analyst intenta agregar una ubicación de red en un eje, se genera un rango de valores de rumbo aceptable 15 grados hacia cada lado del eje (izquierda y derecha) y en ambas direcciones digitalizadas del eje.

Más información sobre el rumbo y la tolerancia de rumbo

Double

NavLatency

Este campo solo se utiliza en el proceso de resolución si los campos Bearing y BearingTol también tienen valores. Sin embargo, la introducción de un valor de campo NavLatency es opcional, incluso cuando hay valores en Bearing y BearingTol. NavLatency indica cuánto coste se espera desde el momento en que se envía la información de GPS desde un vehículo en movimiento a un servidor y el momento en que el dispositivo de navegación del vehículo recibe la ruta procesada.

Las unidades de NavLatency son las mismas que las unidades del atributo de impedancia.

The time units of NavLatency are the same as the units specified by the timeUnits property of the analysis object.

Double

Network location fields

  • SourceID
  • SourceOID
  • PosAlong
  • SideOfEdge

Conjuntamente, estas propiedades describen el punto en la red donde se encuentra el objeto.

Obtener más información sobre ubicación de entradas en una red

LineBarriers

Utilice este parámetro para especificar una o varias líneas que prohíban viajar a cualquier ubicación en la que las líneas se intersequen con las calles. Por ejemplo, un desfile o una protesta que bloquee el tráfico por varios segmentos de calle se puede modelar con una barrera de línea. Una barrera de línea también puede cercar rápidamente varios caminos para que no se puedan atravesar, alejando así las posibles rutas de las partes no deseadas de la red de calles.

The data type supports the following fields:

FieldDescriptionData type

Name

El nombre de la barrera.

Text

BarrierType

Especifica si la barrera restringe el viaje completamente o si escala el coste (por ejemplo, el tiempo o la distancia) para viajar a través de ella. El valor de campo se especifica como uno de los siguientes enteros (use el código numérico, no el nombre entre paréntesis):

  • 0 (Restricción): prohíbe viajar por ningún punto en el que la barrera se interseque con la red de transporte. La barrera se conoce como una barrera de línea de restricción.

  • 1 (Coste en escala): escala el coste (por ejemplo, el tiempo o la distancia) requerido para recorrer las calles subyacentes por un factor especificado mediante el campo ScaledTimeFactor o ScaledDistanceFactor. Si las calles están parcialmente cubiertas por la barrera, el tiempo o la distancia del viaje se prorratea y se ajusta. Por ejemplo, un factor de 0,25 significa que se espera que el viaje por las calles subyacentes sea cuatro veces más rápido de lo normal. Un factor de 3,0 significa que se espera que el viaje por las calles subyacentes dure tres veces más de lo normal. Este tipo de barrera se denomina barrera de línea con coste en escala. Se puede utilizar para modelar ralentizaciones debidas al cierre de carriles de tráfico durante la construcción, por ejemplo.

Long

ScaledTimeFactor

Este es el factor por el cual se multiplica el tiempo de viaje de las calles que intersecan con la barrera. El valor del campo debe ser mayor que cero.

Double

ScaledDistanceFactor

Este es el factor por el cual se multiplica la distancia de las calles que intersecan con la barrera. El valor del campo debe ser mayor que cero.

Double

ScaledCostFactor

Este es el factor por el cual se multiplica el coste de las calles que se intersecan con la barrera. El valor del campo debe ser mayor que cero.

Double

Locations

La información de este campo define qué ejes y cruces de red cubre la línea o el polígono y la parte de cada elemento de eje cubierta. No puede leer ni editar directamente la información contenida en este campo, pero Network Analyst la interpreta al resolver un análisis.

Obtener más información sobre ubicación de entradas en una red

BLOB

PolygonBarriers

Utilice este parámetro para especificar polígonos que restrinjan completamente el viaje o ajusten de una forma proporcional el tiempo o la distancia que se requieren para viajar por las calles que se intersecan con los polígonos.

The data type supports the following fields:

FieldDescriptionData type

Name

El nombre de la barrera.

Text

BarrierType

Especifica si la barrera restringe el viaje completamente o si escala el coste (por ejemplo, el tiempo o la distancia) para viajar a través de ella. El valor de campo se especifica como uno de los siguientes enteros (use el código numérico, no el nombre entre paréntesis):

  • 0 (Restricción): prohíbe atravesar cualquier parte de la barrera. La barrera se conoce como barrera de polígono de restricción, ya que prohíbe viajar por las calles que se intersecan con la barrera. Un uso de este tipo de barrera consiste en modelar inundaciones cubriendo áreas de las calles que hacen inviables los viajes por esas calles.

  • 1 (Coste en escala): escala el coste (por ejemplo, el tiempo o la distancia) requerido para recorrer las calles subyacentes por un factor especificado mediante el campo ScaledTimeFactor o ScaledDistanceFactor. Si las calles están parcialmente cubiertas por la barrera, el tiempo o la distancia del viaje se prorratea y se ajusta. Por ejemplo, un factor de 0,25 significa que se espera que el viaje por las calles subyacentes sea cuatro veces más rápido de lo normal. Un factor de 3,0 significa que se espera que el viaje por las calles subyacentes dure tres veces más de lo normal. Este tipo de barrera se denomina barrera de polígono con coste en escala. Se puede utilizar para modelar tormentas que reducen las velocidades de viaje en regiones concretas, por ejemplo.

Long

ScaledTimeFactor

Este es el factor por el cual se multiplica el tiempo de viaje de las calles que intersecan con la barrera. El valor del campo debe ser mayor que cero.

Double

ScaledDistanceFactor

Este es el factor por el cual se multiplica la distancia de las calles que intersecan con la barrera. El valor del campo debe ser mayor que cero.

Double

ScaledCostFactor

Este es el factor por el cual se multiplica el coste de las calles que se intersecan con la barrera. El valor del campo debe ser mayor que cero.

Double

Locations

La información de este campo define qué ejes y cruces de red cubre la línea o el polígono y la parte de cada elemento de eje cubierta. No puede leer ni editar directamente la información contenida en este campo, pero Network Analyst la interpreta al resolver un análisis.

Obtener más información sobre ubicación de entradas en una red

BLOB