Generar matriz de coste origen-destino (Listo para usar)

Resumen

Crea una matriz de coste origen-destino (OD) de múltiples orígenes a múltiples destinos. Un matriz de coste OD es una tabla que contiene el tiempo y la distancia de viaje desde cada origen hasta cada destino. Además, clasifica en orden ascendente los destinos a los que se llega desde cada origen basándose en el tiempo o la distancia mínimos requeridos para viajar desde ese origen a cada destino. Se descubre la mejor ruta en la red de calles para cada par origen-destino y los tiempos de viaje y las distancias de viaje se almacenan como atributos de las líneas de salida. Aunque las líneas son rectas por razones de rendimiento, se almacena el tiempo y la distancia del viaje a lo largo de la red de calles, no la distancia en línea recta.

Heredado:
Esta es una herramienta obsoleta. Consulte el artículo de soporte para obtener más información sobre cómo llevar a cabo flujos de trabajo de Análisis de red desde la galería de Análisis de red.

Ilustración

Una solución de matriz de coste origen-destino

Uso

  • Las herramientas de la caja de herramientas listas para usar son servicios de geoprocesamiento de ArcGIS Online que usan datos alojados y funcionalidades de análisis de ArcGIS Online.

  • La herramienta encuentra las instalaciones más cercanas en función del tiempo de viaje si el valor del parámetro Unidades de medida está basado en el tiempo. Del mismo modo, la herramienta utiliza la distancia de viaje si las unidades de medida están basadas en la distancia.

  • Debe especificar al menos un origen y un destino para que la herramienta se ejecute correctamente. Puede cargar hasta 1.000 orígenes y 1.000 destinos.

  • Puede añadir hasta 250 barreras de punto. Puede añadir cualquier cantidad de barreras de línea o polígono, pero las barreras de línea no se pueden intersecar con más de 500 entidades de calle ni las barreras de polígono se pueden intersecar con más de 2000 entidades.

  • Se puede optar por usar la jerarquía de carreteras al resolver, de manera que los resultados se generen con mayor rapidez que las rutas exactas, pero la solución podría no ser óptima.

  • Con independencia de que el parámetro Utilizar jerarquía esté activado (True) o no, la jerarquía siempre se usa cuando la distancia en línea recta entre cualquier par de paradas es superior a 50 millas (80,46 kilómetros).

  • La distancia en línea recta entre cualquier origen-destino no puede superar las 50 millas (80,46 kilómetros) cuando el modo de viaje es a pie o cuando se configura en Personalizado y se utiliza la restricción Caminando.

  • Si la distancia entre un punto de entrada y la calle más próxima que se puede cruzar es mayor de 12,42 millas (20 kilómetros), el punto se excluye del análisis.

Parámetros

EtiquetaExplicaciónTipo de datos
Orígenes

Especifica los puntos de inicio desde los cuales desplazarse hasta los destinos.

Puede añadir hasta 1.000 orígenes.

Cuando se especifican los orígenes, se pueden definir propiedades para cada uno, como su nombre o el número de destinos a buscar desde el origen, mediante los siguientes atributos:

Name

El nombre del origen. El nombre puede ser un identificador único del origen. El nombre se incluye en las líneas de salida (como el campo OriginName) y en los orígenes de salida (como el campoName) y se puede utilizar para unir información adicional de las salidas de la herramienta a los atributos de los orígenes.

Si no se especifica el nombre, se genera automáticamente un nombre único con el prefijo de Location.

TargetDestinationCount

La cantidad máxima de destinos que se buscarán por origen.

Si no se especifica un valor, se utilizará el valor del parámetro Número de destinos para buscar.

Este campo permite especificar un número distinto de destinos que buscar para cada origen. Por ejemplo, con este campo puede encontrar los tres destinos más cercanos desde un origen y los dos destinos más cercanos desde otro origen.

Cutoff

El valor de impedancia en el que se debe detener la búsqueda de destinos de un origen dado. Este atributo permite especificar un valor límite distinto para cada destino. Por ejemplo, con este atributo puede especificar buscar destinos que se encuentren a cinco minutos de tiempo de viaje desde un origen y buscar destinos que se encuentren a ocho minutos de tiempo de viaje desde otro origen.

Las unidades del valor límite son las mismas que las unidades de su atributo de impedancia. Si no se especifica un valor, se utilizará el valor del parámetro Cutoff.

CurbApproach

Especifica la dirección en la que un vehículo puede partir del origen. 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 salir del origen en cualquier dirección, de modo que se admite un cambio de sentido en el origen. Puede elegir esta configuración si es posible y práctico que un vehículo dé la vuelta en el origen. Esta decisión puede depender del ancho del camino y del volumen de tráfico, o de si el origen dispone de una zona estacionamiento en la que los vehículos pueden maniobrar.
  • 1 (Lado derecho del vehículo): cuando el vehículo sale del origen, este 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 salir de la parada por la derecha.
  • 2 (Lado izquierdo del vehículo): cuando el vehículo sale del origen, 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 salir de la parada por la izquierda.
  • 3 (Sin cambios de sentido): para esta herramienta, este valor tiene el mismo efecto que 0 (Cualquier lado del vehículo).

El atributo CurbApproach se ha diseñado para trabajar 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 un origen que se encuentra 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 salir del origen 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, si desea partir de un origen y que no haya un carril entre el vehículo y el origen, elija 1 (Lado derecho del vehículo) en Estados Unidos y 2 (Lado izquierdo del vehículo) en Reino Unido.

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.

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.

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.

Feature Set
Destinos

Especifica las ubicaciones de puntos finales a las que desplazarse desde los orígenes.

Puede añadir hasta 1.000 destinos.

Cuando se especifican los destinos, se pueden definir propiedades para cada uno, como su nombre, mediante los siguientes atributos:

Name

El nombre del destino. El nombre puede ser un identificador único del destino. El nombre se incluye en las líneas de salida (como el campo DestinationName) y en los destinos de salida (como el campo Name) y se puede utilizar para unir información adicional de las salidas de la herramienta a los atributos de los destinos.

Si no se especifica el nombre, se genera automáticamente un nombre único con el prefijo de Location.

CurbApproach

Especifica la dirección en la que un vehículo puede llegar a un destino. 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 llegar al destino en cualquier dirección, de modo que se admite un cambio de sentido en el origen. Puede elegir esta configuración si es posible y práctico que un vehículo dé la vuelta en el destino. Esta decisión puede depender del ancho del camino y del volumen de tráfico, o de si el destino dispone de una zona estacionamiento en la que los vehículos pueden maniobrar.
  • 1 (Lado derecho del vehículo): cuando el vehículo llega al destino, este debe estar en el lado derecho del vehículo. Los cambios de sentido están prohibidos. Esto se usa normalmente para vehículos como los autobuses que deben salir de la parada por la derecha.
  • 2 (Lado izquierdo del vehículo): cuando el vehículo llega al destino, 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 salir de la parada por la izquierda.
  • 3 (Sin cambios de sentido): para esta herramienta, este valor tiene el mismo efecto que 0 (Cualquier lado del vehículo).

El atributo CurbApproach se ha diseñado para trabajar 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 un origen que se encuentra 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 salir del origen 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, si desea partir de un origen y que no haya un carril entre el vehículo y el origen, elija 1 (Lado derecho del vehículo) en Estados Unidos y 2 (Lado izquierdo del vehículo) en Reino Unido.

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.

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.

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.

Feature Set
Modo de viaje
(Opcional)

El modo de transporte que se debe modelar en el análisis. Los modos de viaje se administran en ArcGIS Online y el administrador de su organización puede configurarlos para reflejar los flujos de trabajo de la organización. Especifique el nombre de un modo de viaje que sea compatible con su organización.

Para obtener una lista de los nombres de modos de viaje admitidos, ejecute la herramienta Obtener modos de viaje de la caja de herramientas Utilidades en la misma conexión de servidor SIG que utilizó para acceder a la herramienta. La herramienta Obtener modos de viaje agrega una tabla, Supported Travel Modes, a la aplicación. Cualquier valor del campo Travel Mode Name de la tabla Supported Travel Modes se puede especificar como entrada. También puede especificar el valor del campo Travel Mode Settings como entrada. De esta forma, se acelera la ejecución de la herramienta, ya que esta no tiene que buscar la configuración a partir del nombre del modo de viaje.

El valor predeterminado, Personalizado, le permite configurar modo de viaje personalizado usando los parámetros de modo de viaje personalizado (Giros en U en cruces, Utilizar jerarquía, Restricciones, Valores de parámetro de atributos e Impedancia). Los valores predeterminados de los parámetros de modo de viaje personalizado se basan en viajes en coche. Puede elegir el modo Personalizado y establecer los parámetros de modo de viaje personalizado enumerados arriba para modelar un peatón con una velocidad de caminata rápida o un camión con una altura y un peso determinados y con una carga de ciertos materiales peligrosos. Puede probar distintas configuraciones hasta conseguir los resultados de análisis que desee. Una vez que haya identificado la configuración de análisis, trabaje con el administrador de su organización y guardar esta configuración como parte de un modo de viaje nuevo o existente para que todos los usuarios de su organización puedan ejecutar el análisis con la misma configuración.

Precaución:

Al elegir el modo Personalizado, los valores que establezca para los parámetros del modo de viaje personalizado se incluirán en el análisis. Si se especifica otro modo de viaje definido por su organización, se pasará por alto cualquier valor que haya establecido para los parámetros del modo de viaje personalizado; la herramienta los sobrescribirá con valores del modo de viaje especificado.

String
Unidades de tiempo
(Opcional)

Especifica las unidades que utilizarán para medir e indicar el tiempo total de viaje entre cada par de origen-destino.

  • SegundosLa unidad de tiempo es segundos.
  • MinutosLa unidad de tiempo es minutos.
  • HorasLa unidad de tiempo es horas.
  • DíasLa unidad de tiempo es días.
String
Unidades de distancia
(Opcional)

Especifica las unidades que utilizarán para medir e indicar la distancia total de viaje entre cada par de origen-destino.

  • MetrosLa unidad lineal es metros.
  • KilómetrosLa unidad lineal es kilómetros.
  • PiesLa unidad lineal es pies.
  • YardasLa unidad lineal es yardas.
  • MillasLa unidad lineal es millas.
  • Millas náuticasLa unidad lineal es millas náuticas.
String
Región del análisis
(Opcional)

La región en la que se realizará el análisis. Si no se especifica un valor para este parámetro, la herramienta calcula automáticamente el nombre de la región en función de la ubicación de los puntos de entrada. Es obligatorio definir el nombre de la región solamente si la detección automática del nombre de la región no es precisa para sus entradas.

Para especificar una región, utilice uno de los siguientes valores:

  • EuropaLa región de análisis será Europa.
  • JapónLa región de análisis será Japón.
  • CoreaLa región de análisis será Corea.
  • Oriente Medio y ÁfricaLa región de análisis será Oriente Medio y África.
  • NorteaméricaLa región de análisis será Norteamérica.
  • SudaméricaLa región de análisis será Sudamérica.
  • Sur de AsiaLa región de análisis será el Sur de Asia.
  • TailandiaLa región de análisis será Tailandia.
Heredado:

Ya no se admiten los siguientes nombres de regiones, que se eliminarán en versiones futuras. Si especifica uno de los nombres de región obsoletos, la herramienta asigna automáticamente un nombre compatible para la región.

  • Grecia redirige a Europa
  • India redirige a Asia del sur
  • Oceanía redirige a Asia del sur
  • Sureste asiático redirige a Asia del sur
  • Taiwán redirige a Asia del sur

String
Número de destinos para buscar
(Opcional)

La cantidad máxima de destinos que se buscarán por origen. Si no se especifica un valor para este parámetro, la matriz de salida incluirá los costes de viaje desde cada origen hasta cada destino. Determinados orígenes pueden tener sus propios valores (especificados como el campo TargetDestinationCount), que invalidan el valor del parámetro Número de destinos para buscar.

Long
Valor límite
(Opcional)

El valor de tiempo o de distancia de viaje en el cual se debe detener la búsqueda de destinos desde un origen determinado. Los destinos situados más allá del valor de punto crítico serán ignorados. Determinados orígenes pueden tener sus propios valores (especificados como el campo Cutoff), que invalidan el valor del parámetro Valor límite.

El valor debe estar expresado en las unidades especificadas en el parámetro Unidades de tiemposi el atributo de impedancia de su modo de viaje está basado en el tiempo, o bien en las unidades especificadas en el parámetro Unidades de distancia si el atributo de impedancia de su modo de viaje está basado en la distancia. Si no se especifica ningún valor, la herramienta no aplicará ningún límite de tiempo o distancia de viaje al buscar destinos.

Double
Hora del día
(Opcional)

La hora y la fecha en la cual comenzarán las rutas.

Si está modelando el modo de viaje de conducción y especifica la fecha y hora actuales como valor de este parámetro, la herramienta utilizará las condiciones del tráfico en tiempo real para encontrar las mejores rutas, y el tiempo de viaje total se basará en las condiciones del tráfico.

Al especificar una hora del día se obtienen rutas más precisas y mejores estimaciones del tiempo de viaje porque los tiempos de viaje tienen en cuenta las condiciones del tráfico aplicables a esa fecha y hora.

El parámetro Zona horaria para hora del día especifica si la fecha y la hora se refieren a UTC o a la zona horaria en la cual se encuentra la parada.

La herramienta ignora este parámetro cuando Unidades de medida no está configurada con una unidad de tiempo.

Date
Zona horaria para hora del día
(Opcional)

Especifica la zona horaria del parámetro Hora del día.

  • Geográficamente localEl parámetro Hora del día se refiere a la zona horaria donde se encuentra la primera parada de una ruta. Si va a generar muchas rutas que empiezan en varias zonas horarias, los tiempos de inicio se escalonarán en hora universal coordinada (UTC). Por ejemplo, un valor de Hora del día de 10:00 a.m., 2 de enero, equivale a una hora de inicio de 10:00 a.m. hora estándar del este (UTC-3:00) para las rutas que empiezan en la zona horaria del este y de 10:00 a.m. hora estándar central (UTC-4:00) para las rutas que empiezan en la zona horaria central. Las horas de inicio tienen una diferencia de una hora en UTC. Las horas de llegada y salida registradas en la clase de entidad de parada de salida se referirán a la zona horaria local de la primera parada de cada ruta.
  • UTCEl parámetro Hora del día hace referencia a UTC. Seleccione esta opción si desea generar una ruta para una hora determinada, como ahora, pero no está seguro de la zona horaria en que se encontrará la primera parada. Si va a generar muchas rutas que abarquen varias zonas horarias, las horas de inicio en UTC serán simultáneas. Por ejemplo, un valor de Hora del día de 10:00 a.m., 2 de enero, equivale a una hora de inicio de 5:00 a.m. hora estándar del este (UTC-5:00) para las rutas que empiezan en la zona horaria del este y de 4:00 a.m. hora estándar central (UTC-6:00) para las rutas que empiezan en la zona horaria central. Ambas rutas empiezan a las 10:00 a.m. UTC. Las horas de llegada y salida registradas en la clase de entidad Paradas de salida se referirán a UTC.
String
Barreras de punto

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.

La herramienta impone un límite de 250 puntos que se pueden añadir como barreras.

Cuando se especifican las barreras de punto, se pueden definir propiedades para cada una de ellas, como su nombre o el tipo de barrera, mediante el uso de los siguientes atributos:

Name

El nombre de la barrera.

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.

Additional_Time

El tiempo de viaje agregado cuando se realiza el trazado poligonal de la barrera. Este campo solo es aplicable para barreras con coste agregado y cuando el valor del parámetro Unidades de medida se basa en el tiempo.

El valor de este campo debe ser mayor o igual que cero, y sus unidades deben ser las mismas que las especificadas en el parámetro Unidades de medida.

Additional_Distance

La distancia agregada cuando se realiza el trazado poligonal de la barrera. Este campo solo es aplicable para barreras con coste agregado y cuando el valor del parámetro Unidades de medida se basa en la distancia.

El valor de campo debe ser mayor o igual que cero, y sus unidades deben ser las mismas que las especificadas en el parámetro Unidades de medida.

AdditionalCost

El coste agregado cuando se realiza el trazado poligonal de la barrera. Este campo solo es aplicable para barreras con coste agregado y cuando el valor del parámetro Unidades de medida no se basa en el tiempo ni en la distancia.

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.

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.

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.

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.

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.

Feature Set
Barreras de línea

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.

La herramienta impone un límite en el número de calles que se pueden restringir usando el parámetro Barreras de línea. Aunque no existe un límite para el número de líneas que se pueden especificar como barreras de línea, el número combinado de calles que se intersecan con todas las líneas no puede ser superior a 500.

Cuando se especifican las barreras de línea, puede definir propiedades de nombre y tipo de barrera para cada una de ellas mediante los siguientes atributos:

Name

El nombre de la barrera.

Feature Set
Barreras de polígono

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.

El servicio impone un límite en el número de calles que se pueden restringir usando el parámetro Barreras de polígono. Aunque no existe un límite para el número de polígonos que se pueden especificar como barreras de polígono, el número combinado de calles que se intersecan con todos los polígonos no puede ser superior a 2.000.

Cuando se especifican las barreras de polígono, se pueden definir propiedades para cada una de ellas, como su nombre o el tipo de barrera, mediante el uso de los siguientes atributos:

Name

El nombre de la barrera.

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.

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.

Este campo solo es aplicable para barreras con coste escalado y cuando el parámetro Unidades de medida se basa en tiempo.

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.

Este campo solo es aplicable para barreras con coste escalado y cuando el parámetro Unidades de medida se basa en distancia.

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.

Este campo solo es aplicable para barreras con coste escalado cuando el parámetro Unidades de medida no se basa ni en tiempo ni en distancia.

Feature Set
Cambios de sentido en cruces
(Opcional)

Especifica la política de cambios de sentido en los cruces. Permitir cambios de sentido implica que el solucionador puede dar la vuelta en un cruce y regresar por la misma calle. Debido a que los cruces representan intersecciones de calles y callejones sin salida, los diferentes vehículos pueden ser capaces de dar la vuelta en algunos cruces, pero no en otros, depende de que el cruce sea una intersección o un callejón sin salida. Para dar cabida a esta situación, el parámetro de la política de cambios de sentido se especifica implícitamente por la cantidad de ejes que se conectan en el cruce, lo que se conoce como valencia de cruce. Los valores aceptables para este parámetro se enumeran a continuación; cada uno seguido de una descripción de su significado en términos de valencia de cruce.

Este parámetro se ignora a menos que el parámetro Modo de viaje esté establecido en Personalizado.

  • PermitidoSe permiten los cambios de sentido en los cruces con cualquier cantidad de bordes adyacentes. Este es el valor predeterminado.
  • No permitidoLos cambios de sentido están prohibidos en todos los cruces, independientemente de la valencia de cruce. Sin embargo, los cambios de sentido seguirán estando permitidos en las ubicaciones de red, aunque haya elegido esta opción; pero también puede establecer el atributo CurbApproach de cada ubicación de red individual para prohibir los cambios de sentido en ella.
  • Permitido solo en calles sin salidaLos cambios de sentido están prohibidos en todos los cruces, excepto los que tienen solo un eje adyacente (una calle sin salida).
  • Permitido solo en intersecciones y calles sin salidaLos cambios de sentido están prohibidos en los cruces donde se encuentran dos bordes adyacentes, pero están permitidos en las intersecciones (cruces con tres o más bordes adyacentes) o calles sin salida (cruces con exactamente un borde adyacente). A menudo, las redes tienen cruces extraños en medio de segmentos de carretera. Esta opción evita que los vehículos hagan cambios de sentido en estas ubicaciones.
String
Utilizar jerarquía
(Opcional)

Especifica si se usará la jerarquía para buscar las rutas más cortas entre paradas.

  • Activado (True en Python): se usará la jerarquía al buscar las rutas. Cuando se usa una jerarquía, la herramienta identifica a las calles de orden superior (como las autovías) antes que las de orden inferior (como las carreteras locales), y se puede usar para simular la preferencia del conductor por viajar por autovías en lugar de carreteras locales, aunque esto signifique un viaje más largo. Esto resulta especialmente útil al buscar rutas hasta ubicaciones lejanas, porque los conductores que realizan viajes de larga distancia prefieren viajar por autovías y así evitar paradas, intersecciones y giros. Desde el punto de vista del cómputo, usar la jerarquía es más rápido, especialmente en rutas a distancias largas, porque la herramienta identifica la mejor ruta en un subconjunto de calles relativamente más pequeño.
  • Desactivado (False en Python): no se usará la jerarquía al buscar las rutas. Si no se utiliza la jerarquía, la herramienta tiene en cuenta todas las calles y no identifica necesariamente las calles de mayor orden al buscar una ruta. Se suele utilizar al buscar rutas cortas en una ciudad.

La herramienta vuelve automáticamente al uso de la jerarquía si la distancia en línea recta entre las instalaciones y los puntos de demanda es mayor que 50 millas (80,46 kilómetros), incluso si este parámetro está desactivado (definido como False en Python).

Este parámetro se ignora a menos que el parámetro Modo de viaje esté establecido en Personalizado. Cuando se modela un modo a pie personalizado, le recomendamos que desactive la jerarquía, ya que está diseñada para vehículos motorizados.

Boolean
Restricciones
(Opcional)

Las restricciones que la herramienta respetará a la hora de buscar las mejores rutas.

Una restricción representa una preferencia o un requisito de conducción. En la mayoría de los casos, las restricciones ocasionan la prohibición de carreteras. Por ejemplo, al usar la restricción Evitar carreteras con peaje, se generará una ruta que solo incluirá carreteras con peaje cuando sea necesario viajar por ellas para llegar a un incidente o a una instalación. Restricción de altura permite trazar una ruta evitando cualquier lugar con una distancia al suelo que sea inferior a la altura del vehículo. Si está transportando materiales corrosivos en el vehículo, utilizar la restricción Prohibidos todos los materiales peligrosos impide transportar los materiales en las carreteras en las que está marcado como ilegal hacerlo.

Nota:

Algunas restricciones requieren la especificación de un valor adicional para poder usarlas. Este valor se debe asociar con el nombre de la restricción y con un parámetro concreto creado para funcionar con la restricción. Puede identificar esas restricciones si sus nombres aparecen en la columna AttributeName del parámetro Valores de los parámetros de atributos. Especifique el campo ParameterValue en el parámetro Valores de los parámetros de atributos para que la restricción se use correctamente al buscar carreteras transitables.

Nota:

Algunas restricciones solo se admiten en ciertos países. Su disponibilidad se indica por región en la lista siguiente. Para las restricciones con una disponibilidad limitada dentro de una región, puede determinar si están disponibles en un país concreto revisando la tabla de la sección Lista de países de Cobertura de análisis de red. Si un país tiene el valor en la columna Atributos de logística, la restricción con disponibilidad de selección en la región se admite en ese país. Si se especifican nombres de restricción que no están disponibles en el país en el que se encuentran sus incidentes, el servicio pasa por alto las restricciones no válidas. El servicio también pasa por alto las restricciones cuando el valor del parámetro de atributos Uso de restricciones está comprendido entre 0 y 1 (consulte el parámetro Valor de parámetro de atributos). Prohíbe todas las restricciones cuando el valor del parámetro Uso de restricciones es mayor que 0.

La herramienta admite las siguientes restricciones:

  • Prohibido cualquier material peligrosoLos resultados no incluirán carreteras donde esté prohibido el transporte de cualquier material peligroso.Disponibilidad: Países concretos de Norteamérica y Europa
  • Evitar carreteras VAOLos resultados evitarán las carreteras designadas exclusivamente para los vehículos compartidos.Disponibilidad: Todos los países
  • Evitar carriles rápidosLos resultados evitarán las carreteras designadas como vías exprés.Disponibilidad: Todos los países
  • Evitar ferriesLos resultados evitarán los ferris.Disponibilidad: Todos los países
  • Evitar barrerasLos resultados evitarán las carreteras en las que haya puertas, como los accesos con clave o las entradas controladas por guardas.Disponibilidad: Todos los países
  • Evitar carreteras de acceso limitadoLos resultados evitarán las carreteras que sean de acceso limitado.Disponibilidad: Todos los países
  • Evitar carreteras privadasLos resultados evitarán las carreteras que no sean de propiedad y mantenimiento públicos.Disponibilidad: Todos los países
  • Evitar las carreteras no aptas para peatonesLos resultados evitarán las carreteras que no sean aptas para peatones.Disponibilidad: Todos los países
  • Evitar tramos de escaleraLos resultados evitarán todos los tramos de escalera de una ruta adecuada para peatones.Disponibilidad: Todos los países
  • Evitar carreteras de peajeLos resultados evitarán todas las carreteras de peaje para automóviles.Disponibilidad: Todos los países
  • Evitar carreteras de peaje para camionesLos resultados evitarán todas las carreteras de peaje para camiones.Disponibilidad: Todos los países
  • Evitar carreteras con restricciones para camionesLos resultados evitarán las carreteras donde no estén permitidos los camiones excepto para hacer entregas.Disponibilidad: Todos los países
  • Evitar carreteras sin pavimentarLos resultados evitarán las carreteras no pavimentadas (por ejemplo, de tierra, gravilla y similares).Disponibilidad: Todos los países
  • Restricción de número de ejesLos resultados no incluirán carreteras donde esté prohibida la circulación de camiones con el número de ejes especificado. El número de ejes se puede especificar mediante el parámetro de restricción Número de ejes.Disponibilidad: Países concretos de Norteamérica y Europa
  • Conducción de un autobúsLos resultados no incluirán carreteras donde estén prohibidos los autobuses. Usar esta restricción también garantizará que los resultados respetarán las calles con sentido único.Disponibilidad: Todos los países
  • Conducción de un taxiLos resultados no incluirán carreteras donde estén prohibidos los taxis. Usar esta restricción también garantizará que los resultados respetarán las calles con sentido único.Disponibilidad: Todos los países
  • Conducción de un camiónLos resultados no incluirán carreteras donde estén prohibidos los camiones. Usar esta restricción también garantizará que los resultados respetarán las calles con sentido único.Disponibilidad: Todos los países
  • Conducción de un automóvilLos resultados no incluirán carreteras donde esté prohibida la circulación de automóviles. Usar esta restricción también garantizará que los resultados respetarán las calles con sentido único.Disponibilidad: Todos los países
  • Conducción de un vehículo de emergenciaLos resultados no incluirán carreteras donde estén prohibidos los vehículos de emergencia. Usar esta restricción también garantizará que los resultados respetarán las calles con sentido único.Disponibilidad: Todos los países
  • Restricción de alturaLos resultados no incluirán las carreteras donde la altura del vehículo supere la altura máxima permitida por la carretera. La altura del vehículo se puede especificar usando el parámetro de restricción Altura del vehículo (metros).Disponibilidad: Países concretos de Norteamérica y Europa
  • Restricción de longitud de eje de dirección a eje traseroLos resultados no incluirán las carreteras donde la longitud del vehículo supere la distancia máxima entre el eje de dirección y el eje posterior permitida para todos los camiones que circulen por la carretera. La longitud entre el eje de dirección y el eje trasero se puede especificar usando el parámetro de restricción Longitud de eje de dirección a eje trasero del vehículo (metros).Disponibilidad: Países concretos de Norteamérica y Europa
  • Restricción de longitudLos resultados no incluirán las carreteras en las que la longitud del vehículo supere la longitud máxima permitida para la carretera. La longitud del vehículo se puede especificar usando el parámetro de restricción Longitud del vehículo (metros).Disponibilidad: Países concretos de Norteamérica y Europa
  • Preferido para peatonesLos resultados utilizarán rutas preferidas adecuadas para la navegación para peatones.Disponibilidad: Países concretos de Norteamérica y Europa
  • Conducción de una motocicletaLos resultados no incluirán carreteras donde estén prohibidas las motocicletas. Usar esta restricción también garantizará que los resultados respetarán las calles con sentido único.Disponibilidad: Todos los países
  • Carreteras en obras prohibidasLos resultados no incluirán las carreteras en obras.Disponibilidad: Todos los países
  • Prohibidos los camiones o tractores con uno o varios remolquesLos resultados no incluirán carreteras donde estén prohibidos los camiones o tractores con uno o varios remolques.Disponibilidad: Países concretos de Norteamérica y Europa
  • Prohibidos los vehículos con un solo ejeLos resultados no incluirán carreteras donde estén prohibidos los vehículos con un solo eje.Disponibilidad: Países concretos de Norteamérica y Europa
  • Prohibidos los vehículos con eje en tándemLos resultados no incluirán carreteras donde estén prohibidos los vehículos con ejes en tándem.Disponibilidad: Países concretos de Norteamérica y Europa
  • Prohibido el tráfico de pasoLos resultados no incluirán las carreteras donde no se permita el tráfico de paso (no local).Disponibilidad: Todos los países
  • Restricción de camiones con remolquesLos resultados no incluirán carreteras donde esté prohibida la circulación de camiones con el número de remolques especificado. El número de remolques del camión se puede especificar mediante el parámetro de restricción Número de remolques del camión.Disponibilidad: Países concretos de Norteamérica y Europa
  • Usar rutas preferidas para materiales peligrososLos resultados preferirán las carreteras designadas para el transporte de cualquier tipo de material peligroso.Disponibilidad: Países concretos de Norteamérica y Europa
  • Usar rutas preferidas para camionesLos resultados darán prioridad a las carreteras que se hayan diseñado como rutas para camiones, como las que forman parte de la red nacional descrita en la National Surface Transportation Assistance Act de Estados Unidos, las carreteras que se hayan diseñado como rutas de camiones en un estado o una provincia, o aquellas que prefieran los camioneros cuando conducen por un área.Disponibilidad: Países concretos de Norteamérica y Europa
  • CaminataLos resultados no incluirán carreteras donde los peatones estén prohibidos.Disponibilidad: Todos los países
  • Restricción de pesoLos resultados no incluirán las carreteras donde el peso del vehículo supere el peso máximo permitido por la carretera. El peso del vehículo se puede especificar usando el parámetro de restricción Peso del vehículo (kilogramos).Disponibilidad: Países concretos de Norteamérica y Europa
  • Restricción de peso por ejeLos resultados no incluirán las carreteras donde el peso por eje del vehículo supere el peso por eje máximo permitido por la carretera. El peso por eje del vehículo se puede especificar usando el parámetro de restricción Peso por eje del vehículo (kilogramos).Disponibilidad: Países concretos de Norteamérica y Europa
  • Restricción de anchoLos resultados no incluirán las carreteras donde la anchura del vehículo supere la anchura máxima permitida por la carretera. El ancho del vehículo se puede especificar usando el parámetro de restricción Ancho del vehículo (metros).Disponibilidad: Países concretos de Norteamérica y Europa
Nota:

Los valores introducidos para este parámetro se ignoran a menos que el parámetro Modo de viaje esté establecido en Personalizado.

String
Valores de los parámetros de atributo
(Opcional)

Utilice este parámetro para especificar valores adicionales requeridos por un atributo o restricción, como por ejemplo para especificar si la restricción prohíbe, evita o prefiere circular en carreteras restringidas. Si la restricción se ha ideado para evitar carreteras o darles preferencia, puede especificar en qué medida se deben evitar o se les debe dar preferencia usando este parámetro. Por ejemplo, puede elegir que nunca se usen carreteras de peaje, que se eviten en la medida de lo posible o que se les dé preferencia.

Nota:

Los valores introducidos para este parámetro se ignoran a menos que el parámetro Modo de viaje esté establecido en Personalizado.

Si especifica el parámetro Valores de los parámetros de atributos de una clase de entidad, los nombres de los campos de la clase de entidad deben coincidir con los campos que se describen a continuación:

  • AttributeName: el nombre de la restricción.
  • ParameterName: el nombre del parámetro asociado con la restricción. Una restricción puede tener uno o varios valores de campo ParameterName dependiendo del uso previsto para ella.
  • ParameterValue: el valor de ParameterName utilizado por la herramienta al evaluar la restricción.

El parámetro Valores de los parámetros de atributos depende del parámetro Restricciones. El campo ParameterValue solo se usa si el nombre de la restricción se ha especificado como valor del parámetro Restricciones.

En Valores de los parámetros de atributos, cada restricción (mostrada como AttributeName) tiene un valor de campo ParameterName, Uso de restricción, que especifica si la restricción prohíbe, evita o prefiere los viajes por las carreteras asociadas con la restricción, además de en qué medida las carreteras se evitan o tienen preferencia. El Uso de restricción ParameterName se puede asignar a cualquiera de los siguientes valores de cadena de caracteres o a los valores numéricos equivalentes que se muestran entre paréntesis:

  • PROHIBITED (-1): está totalmente prohibido viajar por las carreteras que usan la restricción.
  • AVOID_HIGH (5): es muy poco probable que la herramienta incluya en la ruta las carreteras asociadas a la restricción.
  • AVOID_MEDIUM (2): es poco probable que la herramienta incluya en la ruta las carreteras asociadas con la restricción.
  • AVOID_LOW (1.3): es algo improbable que la herramienta incluya en la ruta las carreteras asociadas con la restricción.
  • PREFER_LOW (0.8): es algo probable que la herramienta incluya en la ruta las carreteras asociadas con la restricción.
  • PREFER_MEDIUM (0.5): es probable que la herramienta incluya en la ruta las carreteras asociadas con la restricción.
  • PREFER_HIGH (0.2): es muy probable que la herramienta incluya en la ruta las carreteras asociadas a la restricción.

En la mayoría de casos, puede usar el valor predeterminado, PROHIBITED, como valor de Uso de restricción si la restricción depende de una característica del vehículo como su altura. Sin embargo, en algunos casos, el valor de Uso de restricción depende de las preferencias de generación de rutas del usuario. Por ejemplo, la restricción Evitar carreteras con peaje tiene el valor predeterminado AVOID_MEDIUM para el atributo Uso de restricción. Significa que, cuando se utilice la restricción, la herramienta creará rutas fuera de las carreteras con peaje siempre que sea posible. AVOID_MEDIUM también indica lo importante que es evitar las carreteras con peaje al buscar la mejor ruta; tiene una prioridad media. Si se selecciona AVOID_LOW, se da una importancia menor a evitar los peajes, mientras que si se selecciona AVOID_HIGH se le da más importancia y es más aceptable que el servicio genere rutas más largas para evitar los peajes. Elegir PROHIBITED no permite viajar en las carreteras con peaje y hará imposible que una ruta viaje por cualquier parte de una carretera de peaje. Tenga en cuenta que evitar o prohibir carreteras con peaje, y evitar los pagos de peaje, es el objetivo para algunos. En cambio, otros prefieren conducir en las carreteras con peaje porque evitar el tráfico es más valioso para ellos que el dinero gastado en los peajes. En el último caso, elija PREFER_LOW, PREFER_MEDIUM o PREFER_HIGH como valor de Uso de la restricción. Cuanto mayor sea la preferencia, más lejos irá la herramienta para viajar por las carreteras asociadas a la restricción.

Record Set
Impedancia
(Opcional)

Especifica la impedancia, que es un valor que representa el esfuerzo o el coste de viajar a lo largo de segmentos de carretera o en otras partes de la red de transporte.

El tiempo de viaje es una impedancia: un coche puede tardar 1 minuto en viajar un kilómetro a lo largo de una carretera vacía. Los tiempos de viaje pueden variar según el modo de viaje: un peatón puede tardar más de 20 minutos en caminar el mismo kilómetro, por lo que es importante elegir la impedancia correcta para el modo de viaje que se está modelando.

La distancia de viaje también puede ser una impedancia; la longitud de una carretera en kilómetros se puede considerar impedancia. En este sentido, la distancia de viaje es la misma para todos los modos: un kilómetro para un peatón es, igualmente, un kilómetro para un coche. (Lo que puede cambiar son los caminos por los que los diferentes modos tienen permitido viajar, lo cual afecta a la distancia entre puntos, que se modela mediante la configuración del modo de viaje.)

Si elige una impedancia basada en el tiempo, como TravelTime, TruckTravelTime, Minutes, TruckMinutes o WalkTime, el parámetro Unidades de medición se debe configurar con un valor basado en el tiempo. Si prefiere una impedancia basada en la distancia, como Miles o Kilometers, las Unidades de medida deben estar basadas en la distancia.

  • Tiempo de viajeSe utilizan datos de tráfico históricos y en directo. Esta opción resulta útil para modelar el tiempo que tardan los automóviles en desplazarse por carreteras a una hora concreta del día utilizando datos de velocidad del tráfico en directo si están disponibles. Si utiliza TravelTime, si lo desea puede definir el parámetro de atributos TravelTime::Vehicle Maximum Speed (km/h) para especificar los límites físicos de la velocidad a la que el vehículo es capaz de desplazarse.
  • MinutosNo se utilizan datos de tráfico en directo, sino velocidades medias históricas de los datos de automóviles.
  • Tiempo de viaje en camiónSe utilizan datos de tráfico históricos y en directo, pero se establece una velocidad máxima al límite de velocidad especificado para camiones. Resulta útil para modelar el tiempo que tardan los camiones en desplazarse por carreteras a una hora concreta del día. Si utiliza TruckTravelTime, si lo desea puede definir el parámetro de atributos TruckTravelTime::Vehicle Maximum Speed (km/h) para especificar los límites físicos de la velocidad a la que el camión es capaz de desplazarse.
  • Minutos de camiónNo utiliza datos de tráfico en directo, pero sí utiliza las velocidades más bajas del promedio histórico para automóviles y los límites de velocidad permitidos para camiones.
  • Tiempo de recorrido a pieEl valor predeterminado es una velocidad de 5 km/h en todas las carreteras y caminos, pero se puede configurar mediante el parámetro de atributos WalkTime::Walking Speed (km/h).
  • MillasLas mediciones de longitud de carreteras se almacenan en millas y se pueden utilizar para realizar análisis según la distancia más corta.
  • KilómetrosLas mediciones de longitud de carreteras se almacenan en kilómetros y se pueden utilizar para realizar análisis según la distancia más corta.
  • Tiempo a un kilómetro por horaEl valor predeterminado es 1 km/h en todas las carreteras y caminos. No es posible cambiar la velocidad con ningún parámetro de atributos.
  • Tiempo de conducciónSe modelan los tiempos de viaje para un coche. Estos tiempos de viaje son dinámicos y fluctúan según los flujos de tráfico en zonas para las que hay datos de tráfico disponibles. Este es el valor predeterminado.
  • Tiempo en camiónSe modelan los tiempos de viaje para un camión. Estos tiempos de viaje son estáticos para cada carretera y no fluctúan con el tráfico.
  • Tiempo de recorrido a pieSe modelan los tiempos de viaje para un peatón.
  • Distancia de viajeSe almacenan las mediciones de longitud a lo largo de carreteras y rutas. Para modelar la distancia a pie, elija esta opción y asegúrese de que A pie se ha definido en el parámetro Restricción. Del mismo modo, para modelar la distancia de conducción o de camión, elija Distancia de viaje aquí y establezca las restricciones apropiadas para que el vehículo viaje únicamente por carreteras en las que lo tiene permitido.
Precaución:

El valor introducido para este parámetro se ignora a menos que el parámetro Modo de viaje esté establecido en Personalizado, que es el valor predeterminado.

Heredado:

Los valores de impedancia de Tiempo de conducción, Tiempo en camión, Tiempo de recorrido a pie y Distancia de viaje ya no se admiten y se eliminarán en versiones futuras. Si utiliza uno de estos valores, la herramienta usa el valor del parámetro Impedancia de tiempo para valores basados en el tiempo y del parámetro Impedancia de distancia para valores basados en la distancia.

String
Forma de línea de origen-destino

Las líneas resultantes de una matriz de coste OD se pueden representar con geometría de línea o sin ninguna geometría. En ambos casos, la ruta siempre se calcula a lo largo de la red de calles minimizando el tiempo o la distancia de viaje; nunca usando la distancia en línea recta entre orígenes y destinos.

  • Línea rectaLíneas rectas conectan orígenes y destinos.
  • NingunaNo devuelva ninguna forma para las líneas que conectan orígenes y destinos. Esto es útil si tiene un gran número de orígenes y destinos y está interesado solo en la tabla de matriz de coste OD y no en las formas de las líneas de salida.
String
Guardar capa de análisis de red de salida
(Opcional)

Especifica la configuración del análisis se guardará como un archivo de capa de análisis de red. No puede trabajar directamente con este archivo, aunque lo abra en una aplicación de ArcGIS Desktop, por ejemplo, ArcMap. Se debe enviar al Soporte técnico de Esri para diagnosticar la calidad de los resultados devueltos por la herramienta.

  • Activado (True en Python): la salida se guardará como un archivo de capa de análisis de red. El archivo se descargará 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 al servicio 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 al servicio de la herramienta en la ventana Resultados de geoprocesamiento.
  • Desactivado (False en Python): la salida no se guardará como un archivo de capa de análisis de red. Esta es la opción predeterminada.

Boolean
Invalidaciones
(Opcional)

Nota:

Este parámetro es solo para uso interno.

String
Impedancia de tiempo
(Opcional)

El valor de impedancia basada en el tiempo representa el tiempo de viaje a lo largo de segmentos de carretera o en otras partes de la red de transporte.

  • MinutosLa impedancia de tiempo serán minutos.
  • Tiempo de viajeLa impedancia del tiempo será el tiempo de viaje.
  • Tiempo a un kilómetro por horaLa impedancia de tiempo será el tiempo a un kilómetro por hora.
  • Tiempo de recorrido a pieLa impedancia del tiempo será el tiempo de recorrido a pie.
  • Minutos de camiónLa impedancia de tiempo serán minutos de camión.
  • Tiempo de viaje en camiónLa impedancia del tiempo será el tiempo de viaje en camión.
Nota:
Si la impedancia del modo de viaje, según se especifica con el parámetro Impedancia, está basada en el tiempo, los valores de los parámetros Impedancia de tiempo e Impedancia deben ser los mismos. De lo contrario, el servicio devolverá un error.
String
Impedancia de distancia
(Opcional)

El valor de impedancia basada en la distancia representa la distancia de viaje a lo largo de segmentos de carretera o en otras partes de la red de transporte.

  • MillasLa impedancia de distancia serán millas.
  • KilómetrosLa impedancia de distancia serán kilómetros.
Nota:
Si la impedancia del modo de viaje, según se especifica con el parámetro Impedancia, está basada en la distancia, los valores de los parámetros Impedancia de distancia e Impedancia deben ser los mismos. De lo contrario, el servicio devolverá un error.
String
Formato de salida
(Opcional)

Especifica el formato en el que se devolverán las entidades de salida.

Cuando se especifica un formato de salida basado en archivos, como Archivo JSON o Archivo GeoJSON, no se agregará ninguna salida a la visualización, puesto 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 al funcionamiento 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 al funcionamiento de la herramienta en la ventana Resultados de geoprocesamiento.

  • Conjunto de entidadesLas entidades de salida se generarán como tablas y clases de entidad. Esta es la opción predeterminada.
  • Archivo JSONLas entidades de salida se devolverán como un archivo comprimido que contiene la representación JSON de las salidas. Si se especifica esta opción, la salida será un archivo único (con una extensión .zip) que contiene uno o varios archivos JSON (con una extensión .json) para cada una de las salidas que crea el servicio.
  • Archivo GeoJSONLas entidades de salida se devolverán como un archivo comprimido que contiene la representación GeoJSON de las salidas. Si se especifica esta opción, la salida será un archivo único (con una extensión .zip) que contiene uno o varios archivos GeoJSON (con una extensión .geojson) para cada una de las salidas que crea el servicio.
  • Archivo CSVLas entidades de salida se devolverán como un archivo comprimido que contiene una representación de valores separados por comas (CSV) de las salidas. Si se especifica esta opción, la salida será un archivo único (con una extensión .zip) que contiene uno o varios archivos CSV (con una extensión .csv) para cada una de las salidas que crea el servicio.
String
Ignorar ubicaciones no válidas
(Opcional)

Especifica si se ignorarán las ubicaciones de entrada no válidas.

  • Activado: las ubicaciones de red no ubicadas se ignorarán y el análisis se ejecutará únicamente utilizando ubicaciones de red válidas. El análisis también continuará si las ubicaciones están en elementos no transitables o tienen otros errores. Esta opción es útil si usted sabe que las ubicaciones de red no son todas correctas, pero desea ejecutar el análisis con las ubicaciones de red que son válidas. Esta es la opción predeterminada.
  • Desactivado: las ubicaciones no válidas no se ignorarán. No ejecute el análisis si hay ubicaciones no válidas. Corrija las ubicaciones no válidas y vuelva a ejecutar el análisis.
Boolean
Localizar configuración
(Opcional)

Use este parámetro para especificar configuraciones que afecten a cómo se ubican las entradas, como la máxima distancia de búsqueda que se usa al localizar las entradas en la red, o las fuentes de red que se usan para localizar.

Más información sobre la localización de entradas

El objeto JSON del localizador tiene las siguientes propiedades:

  • tolerance y toleranceUnits: permite controlar la distancia máxima de búsqueda al localizar las entradas. Si no se encuentra ninguna ubicación de red válida dentro de esta distancia, la entidad de entrada se considerará no ubicada. Una pequeña tolerancia de búsqueda disminuye la probabilidad de ubicarse en la calle equivocada, pero aumenta la probabilidad de no encontrar ninguna ubicación de red válida. El valor del parámetro toleranceUnits se puede especificar como uno de los siguientes valores:
    • esriCentimeters
    • esriDecimalDegrees
    • esriDecimeters
    • esriFeet
    • esriInches
    • esriIntFeet
    • esriIntInches
    • esriIntMiles
    • esriIntNauticalMiles
    • esriIntYards
    • esriKilometers
    • esriMeters
    • esriMiles
    • esriMillimeters
    • esriNauticalMiles
    • esriYards
  • sources: le permite controlar qué fuente de red se puede utilizar para la ubicación. Por ejemplo, puede configurar el análisis para localizar entradas en calles, pero no en aceras. La lista de posibles fuentes en las que localizar es específica del dataset de red al que hace referencia este servicio. Solo se usan para ubicar las fuentes que estén presentes en la matriz de fuentes. Las fuentes se especifican como una matriz de objetos, cada uno con la siguiente propiedad:
    • name: el nombre de la clase de entidad de la fuente de red que se puede usar para ubicar entradas
  • allowAutoRelocate: permite controlar si las entradas con campos de ubicación de red existentes se pueden reubicar automáticamente al solucionar para garantizar que se disponga de campos de ubicación enrutables y válidos para el análisis. Si el valor es true, los puntos ubicados en elementos de red restringidos y los puntos afectados por las barreras se reubicarán en la ubicación enrutable más cercana. Si el valor es false, los campos de ubicación de red se utilizarán como están, aunque los puntos no sean accesibles, y esto puede hacer que la resolución falle. Aunque el valor sea false, las entradas sin campos de ubicación o campos de ubicación incompletos se localizarán durante la operación de resolución.
Nota:
Actualmente, no puede especificar nombres de fuente diferentes para la matriz sources. Además, allowAutoRelocate siempre está configurado como true ya que el servicio no admite campos de ubicación.

El valor de parámetro se especifica como un objeto JSON. El objeto JSON le permite especificar un JSON de localizador para todas las entidades de entrada en el análisis o puede especificar una excepción para una entrada concreta. La excepción le permite tener diferentes ajustes para cada entrada de análisis. Por ejemplo, es posible no permitir que las paradas se ubiquen en las rampas de autopista y permitir que las barreras de punto se ubiquen en las rampas de autopista. Al especificar el JSON Locate_Settings, deberá proporcionar las propiedades tolerance, toleranceUnits y allowAutoRelocate. Si necesita proporcionar un JSON de localizador diferente para una clase de entrada en particular, debe incluir la propiedad de invalidaciones para esa entrada. El nombre de propiedad debe coincidir con el nombre del parámetro de entrada. El JSON del localizador de una entrada concreta no tiene que incluir todas las propiedades; solo tiene que incluir las propiedades que son distintas de las propiedades del JSON del localizador predeterminado.

String

Salida derivada

EtiquetaExplicaciónTipo de datos
La operación de solución se realizó correctamente

Determina si el servicio generó correctamente la matriz de coste origen-destino.

Boolean
Líneas de origen-destino de salida

Ofrece acceso a las líneas que conectan los orígenes con los destinos.

Feature Set
Orígenes de salida

Ofrece información sobre los orígenes utilizados en el análisis, como la cantidad total de destinos a los que se llega desde un origen determinado, o los orígenes que no se pueden incluir en el análisis.

Feature Set
Destinos de salida

Ofrece información sobre los destinos utilizados en el análisis, como la cantidad total de orígenes a los que se llegó desde un origen determinado, o los destinos que no se pueden incluir en el análisis.

Feature Set
Capa de análisis de red de salida

La capa de análisis de red con propiedades configuradas en los parámetros de la herramienta que se puede utilizar para análisis posteriores o para depurar el mapa.

File
Archivo de resultados de salida

Un archivo .zip que contiene los resultados del análisis, con uno o varios archivos para cada salida. El formato de los archivos individuales viene especificado por el parámetro Formato de salida.

File
Paquete de capas de análisis de red de salida

Un paquete de capas que incluye una capa de análisis de red con los datos y la configuración utilizados en el análisis.

File
Coste de uso

Este parámetro devuelve los créditos consumidos por el análisis.

Nota:

Cada análisis puede generar una cantidad diferente de objetos facturables y, por tanto, consumirá una cantidad diferente de créditos. Si el servicio no puede determinar los créditos, el parámetro usage_cost devuelve un valor de -1 para credits.

JSON

arcpy.agolservices.GenerateOriginDestinationCostMatrix(Origins, Destinations, {Travel_Mode}, {Time_Units}, {Distance_Units}, {Analysis_Region}, {Number_of_Destinations_to_Find}, {Cutoff}, {Time_of_Day}, {Time_Zone_for_Time_of_Day}, Point_Barriers, Line_Barriers, Polygon_Barriers, {UTurn_at_Junctions}, {Use_Hierarchy}, {Restrictions}, {Attribute_Parameter_Values}, {Impedance}, Origin_Destination_Line_Shape, {Save_Output_Network_Analysis_Layer}, {Overrides}, {Time_Impedance}, {Distance_Impedance}, {Output_Format}, {Ignore_Invalid_Locations}, {Locate_Settings})
NombreExplicaciónTipo de datos
Origins

Especifica los puntos de inicio desde los cuales desplazarse hasta los destinos.

Puede añadir hasta 1.000 orígenes.

Cuando se especifican los orígenes, se pueden definir propiedades para cada uno, como su nombre o el número de destinos a buscar desde el origen, mediante los siguientes atributos:

Name

El nombre del origen. El nombre puede ser un identificador único del origen. El nombre se incluye en las líneas de salida (como el campo OriginName) y en los orígenes de salida (como el campoName) y se puede utilizar para unir información adicional de las salidas de la herramienta a los atributos de los orígenes.

Si no se especifica el nombre, se genera automáticamente un nombre único con el prefijo de Location.

TargetDestinationCount

La cantidad máxima de destinos que se buscarán por origen.

Si no se especifica un valor, se utilizará el valor del parámetro Número de destinos para buscar.

Este campo permite especificar un número distinto de destinos que buscar para cada origen. Por ejemplo, con este campo puede encontrar los tres destinos más cercanos desde un origen y los dos destinos más cercanos desde otro origen.

Cutoff

El valor de impedancia en el que se debe detener la búsqueda de destinos de un origen dado. Este atributo permite especificar un valor límite distinto para cada destino. Por ejemplo, con este atributo puede especificar buscar destinos que se encuentren a cinco minutos de tiempo de viaje desde un origen y buscar destinos que se encuentren a ocho minutos de tiempo de viaje desde otro origen.

Las unidades del valor límite son las mismas que las unidades de su atributo de impedancia. Si no se especifica un valor, se utilizará el valor del parámetro Cutoff.

CurbApproach

Especifica la dirección en la que un vehículo puede partir del origen. 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 salir del origen en cualquier dirección, de modo que se admite un cambio de sentido en el origen. Puede elegir esta configuración si es posible y práctico que un vehículo dé la vuelta en el origen. Esta decisión puede depender del ancho del camino y del volumen de tráfico, o de si el origen dispone de una zona estacionamiento en la que los vehículos pueden maniobrar.
  • 1 (Lado derecho del vehículo): cuando el vehículo sale del origen, este 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 salir de la parada por la derecha.
  • 2 (Lado izquierdo del vehículo): cuando el vehículo sale del origen, 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 salir de la parada por la izquierda.
  • 3 (Sin cambios de sentido): para esta herramienta, este valor tiene el mismo efecto que 0 (Cualquier lado del vehículo).

El atributo CurbApproach se ha diseñado para trabajar 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 un origen que se encuentra 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 salir del origen 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, si desea partir de un origen y que no haya un carril entre el vehículo y el origen, elija 1 (Lado derecho del vehículo) en Estados Unidos y 2 (Lado izquierdo del vehículo) en Reino Unido.

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.

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.

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.

Feature Set
Destinations

Especifica las ubicaciones de puntos finales a las que desplazarse desde los orígenes.

Puede añadir hasta 1.000 destinos.

Cuando se especifican los destinos, se pueden definir propiedades para cada uno, como su nombre, mediante los siguientes atributos:

Name

El nombre del destino. El nombre puede ser un identificador único del destino. El nombre se incluye en las líneas de salida (como el campo DestinationName) y en los destinos de salida (como el campo Name) y se puede utilizar para unir información adicional de las salidas de la herramienta a los atributos de los destinos.

Si no se especifica el nombre, se genera automáticamente un nombre único con el prefijo de Location.

CurbApproach

Especifica la dirección en la que un vehículo puede llegar a un destino. 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 llegar al destino en cualquier dirección, de modo que se admite un cambio de sentido en el origen. Puede elegir esta configuración si es posible y práctico que un vehículo dé la vuelta en el destino. Esta decisión puede depender del ancho del camino y del volumen de tráfico, o de si el destino dispone de una zona estacionamiento en la que los vehículos pueden maniobrar.
  • 1 (Lado derecho del vehículo): cuando el vehículo llega al destino, este debe estar en el lado derecho del vehículo. Los cambios de sentido están prohibidos. Esto se usa normalmente para vehículos como los autobuses que deben salir de la parada por la derecha.
  • 2 (Lado izquierdo del vehículo): cuando el vehículo llega al destino, 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 salir de la parada por la izquierda.
  • 3 (Sin cambios de sentido): para esta herramienta, este valor tiene el mismo efecto que 0 (Cualquier lado del vehículo).

El atributo CurbApproach se ha diseñado para trabajar 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 un origen que se encuentra 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 salir del origen 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, si desea partir de un origen y que no haya un carril entre el vehículo y el origen, elija 1 (Lado derecho del vehículo) en Estados Unidos y 2 (Lado izquierdo del vehículo) en Reino Unido.

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.

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.

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.

Feature Set
Travel_Mode
(Opcional)

El modo de transporte que se debe modelar en el análisis. Los modos de viaje se administran en ArcGIS Online y el administrador de su organización puede configurarlos para reflejar los flujos de trabajo de la organización. Especifique el nombre de un modo de viaje que sea compatible con su organización.

Para obtener una lista de los nombres de modos de viaje admitidos, ejecute la herramienta Obtener modos de viaje de la caja de herramientas Utilidades en la misma conexión de servidor SIG que utilizó para acceder a la herramienta. La herramienta Obtener modos de viaje agrega una tabla, Supported Travel Modes, a la aplicación. Cualquier valor del campo Travel Mode Name de la tabla Supported Travel Modes se puede especificar como entrada. También puede especificar el valor del campo Travel Mode Settings como entrada. De esta forma, se acelera la ejecución de la herramienta, ya que esta no tiene que buscar la configuración a partir del nombre del modo de viaje.

El valor predeterminado, Personalizado, le permite configurar modo de viaje personalizado usando los parámetros de modo de viaje personalizado (Giros en U en cruces, Utilizar jerarquía, Restricciones, Valores de parámetro de atributos e Impedancia). Los valores predeterminados de los parámetros de modo de viaje personalizado se basan en viajes en coche. Puede elegir el modo Personalizado y establecer los parámetros de modo de viaje personalizado enumerados arriba para modelar un peatón con una velocidad de caminata rápida o un camión con una altura y un peso determinados y con una carga de ciertos materiales peligrosos. Puede probar distintas configuraciones hasta conseguir los resultados de análisis que desee. Una vez que haya identificado la configuración de análisis, trabaje con el administrador de su organización y guardar esta configuración como parte de un modo de viaje nuevo o existente para que todos los usuarios de su organización puedan ejecutar el análisis con la misma configuración.

Precaución:

Al elegir el modo Personalizado, los valores que establezca para los parámetros del modo de viaje personalizado se incluirán en el análisis. Si se especifica otro modo de viaje definido por su organización, se pasará por alto cualquier valor que haya establecido para los parámetros del modo de viaje personalizado; la herramienta los sobrescribirá con valores del modo de viaje especificado.

String
Time_Units
(Opcional)

Especifica las unidades que utilizarán para medir e indicar el tiempo total de viaje entre cada par de origen-destino.

  • SecondsLa unidad de tiempo es segundos.
  • MinutesLa unidad de tiempo es minutos.
  • HoursLa unidad de tiempo es horas.
  • DaysLa unidad de tiempo es días.
String
Distance_Units
(Opcional)

Especifica las unidades que utilizarán para medir e indicar la distancia total de viaje entre cada par de origen-destino.

  • MetersLa unidad lineal es metros.
  • KilometersLa unidad lineal es kilómetros.
  • FeetLa unidad lineal es pies.
  • YardsLa unidad lineal es yardas.
  • MilesLa unidad lineal es millas.
  • NauticalMilesLa unidad lineal es millas náuticas.
String
Analysis_Region
(Opcional)

La región en la que se realizará el análisis. Si no se especifica un valor para este parámetro, la herramienta calcula automáticamente el nombre de la región en función de la ubicación de los puntos de entrada. Es obligatorio definir el nombre de la región solamente si la detección automática del nombre de la región no es precisa para sus entradas.

Para especificar una región, utilice uno de los siguientes valores:

  • EuropeLa región de análisis será Europa.
  • JapanLa región de análisis será Japón.
  • KoreaLa región de análisis será Corea.
  • MiddleEastAndAfricaLa región de análisis será Oriente Medio y África.
  • NorthAmericaLa región de análisis será Norteamérica.
  • SouthAmericaLa región de análisis será Sudamérica.
  • SouthAsiaLa región de análisis será el Sur de Asia.
  • ThailandLa región de análisis será Tailandia.
Heredado:

Ya no se admiten los siguientes nombres de regiones, que se eliminarán en versiones futuras. Si especifica uno de los nombres de región obsoletos, la herramienta asigna automáticamente un nombre compatible para la región.

  • Grecia redirige a Europa
  • India redirige a Asia del sur
  • Oceanía redirige a Asia del sur
  • Sureste asiático redirige a Asia del sur
  • Taiwán redirige a Asia del sur

String
Number_of_Destinations_to_Find
(Opcional)

La cantidad máxima de destinos que se buscarán por origen. Si no se especifica un valor para este parámetro, la matriz de salida incluirá los costes de viaje desde cada origen hasta cada destino. Determinados orígenes pueden tener sus propios valores (especificados como el campo TargetDestinationCount), que invalidan el valor del parámetro Número de destinos para buscar.

Long
Cutoff
(Opcional)

El valor de tiempo o de distancia de viaje en el cual se debe detener la búsqueda de destinos desde un origen determinado. Los destinos situados más allá del valor de punto crítico serán ignorados. Determinados orígenes pueden tener sus propios valores (especificados como el campo Cutoff), que invalidan el valor del parámetro Valor límite.

El valor debe estar expresado en las unidades especificadas en el parámetro Unidades de tiemposi el atributo de impedancia de su modo de viaje está basado en el tiempo, o bien en las unidades especificadas en el parámetro Unidades de distancia si el atributo de impedancia de su modo de viaje está basado en la distancia. Si no se especifica ningún valor, la herramienta no aplicará ningún límite de tiempo o distancia de viaje al buscar destinos.

Double
Time_of_Day
(Opcional)

La hora y la fecha en la cual comenzarán las rutas.

Si está modelando el modo de viaje de conducción y especifica la fecha y hora actuales como valor de este parámetro, la herramienta utilizará las condiciones del tráfico en tiempo real para encontrar las mejores rutas, y el tiempo de viaje total se basará en las condiciones del tráfico.

Al especificar una hora del día se obtienen rutas más precisas y mejores estimaciones del tiempo de viaje porque los tiempos de viaje tienen en cuenta las condiciones del tráfico aplicables a esa fecha y hora.

El parámetro Zona horaria para hora del día especifica si la fecha y la hora se refieren a UTC o a la zona horaria en la cual se encuentra la parada.

La herramienta ignora este parámetro cuando Unidades de medida no está configurada con una unidad de tiempo.

Date
Time_Zone_for_Time_of_Day
(Opcional)

Especifica la zona horaria del parámetro Hora del día.

  • Geographically LocalEl parámetro Hora del día se refiere a la zona horaria donde se encuentra la primera parada de una ruta. Si va a generar muchas rutas que empiezan en varias zonas horarias, los tiempos de inicio se escalonarán en hora universal coordinada (UTC). Por ejemplo, un valor de Hora del día de 10:00 a.m., 2 de enero, equivale a una hora de inicio de 10:00 a.m. hora estándar del este (UTC-3:00) para las rutas que empiezan en la zona horaria del este y de 10:00 a.m. hora estándar central (UTC-4:00) para las rutas que empiezan en la zona horaria central. Las horas de inicio tienen una diferencia de una hora en UTC. Las horas de llegada y salida registradas en la clase de entidad de parada de salida se referirán a la zona horaria local de la primera parada de cada ruta.
  • UTCEl parámetro Hora del día hace referencia a UTC. Seleccione esta opción si desea generar una ruta para una hora determinada, como ahora, pero no está seguro de la zona horaria en que se encontrará la primera parada. Si va a generar muchas rutas que abarquen varias zonas horarias, las horas de inicio en UTC serán simultáneas. Por ejemplo, un valor de Hora del día de 10:00 a.m., 2 de enero, equivale a una hora de inicio de 5:00 a.m. hora estándar del este (UTC-5:00) para las rutas que empiezan en la zona horaria del este y de 4:00 a.m. hora estándar central (UTC-6:00) para las rutas que empiezan en la zona horaria central. Ambas rutas empiezan a las 10:00 a.m. UTC. Las horas de llegada y salida registradas en la clase de entidad Paradas de salida se referirán a UTC.
String
Point_Barriers

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.

La herramienta impone un límite de 250 puntos que se pueden añadir como barreras.

Cuando se especifican las barreras de punto, se pueden definir propiedades para cada una de ellas, como su nombre o el tipo de barrera, mediante el uso de los siguientes atributos:

Name

El nombre de la barrera.

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.

Additional_Time

El tiempo de viaje agregado cuando se realiza el trazado poligonal de la barrera. Este campo solo es aplicable para barreras con coste agregado y cuando el valor del parámetro Unidades de medida se basa en el tiempo.

El valor de este campo debe ser mayor o igual que cero, y sus unidades deben ser las mismas que las especificadas en el parámetro Unidades de medida.

Additional_Distance

La distancia agregada cuando se realiza el trazado poligonal de la barrera. Este campo solo es aplicable para barreras con coste agregado y cuando el valor del parámetro Unidades de medida se basa en la distancia.

El valor de campo debe ser mayor o igual que cero, y sus unidades deben ser las mismas que las especificadas en el parámetro Unidades de medida.

AdditionalCost

El coste agregado cuando se realiza el trazado poligonal de la barrera. Este campo solo es aplicable para barreras con coste agregado y cuando el valor del parámetro Unidades de medida no se basa en el tiempo ni en la distancia.

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.

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.

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.

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.

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.

Feature Set
Line_Barriers

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.

La herramienta impone un límite en el número de calles que se pueden restringir usando el parámetro Barreras de línea. Aunque no existe un límite para el número de líneas que se pueden especificar como barreras de línea, el número combinado de calles que se intersecan con todas las líneas no puede ser superior a 500.

Cuando se especifican las barreras de línea, puede definir propiedades de nombre y tipo de barrera para cada una de ellas mediante los siguientes atributos:

Name

El nombre de la barrera.

Feature Set
Polygon_Barriers

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.

El servicio impone un límite en el número de calles que se pueden restringir usando el parámetro Barreras de polígono. Aunque no existe un límite para el número de polígonos que se pueden especificar como barreras de polígono, el número combinado de calles que se intersecan con todos los polígonos no puede ser superior a 2.000.

Cuando se especifican las barreras de polígono, se pueden definir propiedades para cada una de ellas, como su nombre o el tipo de barrera, mediante el uso de los siguientes atributos:

Name

El nombre de la barrera.

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.

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.

Este campo solo es aplicable para barreras con coste escalado y cuando el parámetro Unidades de medida se basa en tiempo.

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.

Este campo solo es aplicable para barreras con coste escalado y cuando el parámetro Unidades de medida se basa en distancia.

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.

Este campo solo es aplicable para barreras con coste escalado cuando el parámetro Unidades de medida no se basa ni en tiempo ni en distancia.

Feature Set
UTurn_at_Junctions
(Opcional)

Especifica la política de cambios de sentido en los cruces. Permitir cambios de sentido implica que el solucionador puede dar la vuelta en un cruce y regresar por la misma calle. Debido a que los cruces representan intersecciones de calles y callejones sin salida, los diferentes vehículos pueden ser capaces de dar la vuelta en algunos cruces, pero no en otros, depende de que el cruce sea una intersección o un callejón sin salida. Para dar cabida a esta situación, el parámetro de la política de cambios de sentido se especifica implícitamente por la cantidad de ejes que se conectan en el cruce, lo que se conoce como valencia de cruce. Los valores aceptables para este parámetro se enumeran a continuación; cada uno seguido de una descripción de su significado en términos de valencia de cruce.

  • AllowedSe permiten los cambios de sentido en los cruces con cualquier cantidad de bordes adyacentes. Este es el valor predeterminado.
  • Not AllowedLos cambios de sentido están prohibidos en todos los cruces, independientemente de la valencia de cruce. Sin embargo, los cambios de sentido seguirán estando permitidos en las ubicaciones de red, aunque haya elegido esta opción; pero también puede establecer el atributo CurbApproach de cada ubicación de red individual para prohibir los cambios de sentido en ella.
  • Allowed Only at Dead EndsLos cambios de sentido están prohibidos en todos los cruces, excepto los que tienen solo un eje adyacente (una calle sin salida).
  • Allowed Only at Intersections and Dead EndsLos cambios de sentido están prohibidos en los cruces donde se encuentran dos bordes adyacentes, pero están permitidos en las intersecciones (cruces con tres o más bordes adyacentes) o calles sin salida (cruces con exactamente un borde adyacente). A menudo, las redes tienen cruces extraños en medio de segmentos de carretera. Esta opción evita que los vehículos hagan cambios de sentido en estas ubicaciones.

Este parámetro se ignora a menos que el parámetro Modo de viaje esté establecido en Personalizado.

String
Use_Hierarchy
(Opcional)

Especifica si se usará la jerarquía para buscar las rutas más cortas entre paradas.

  • Activado (True en Python): se usará la jerarquía al buscar las rutas. Cuando se usa una jerarquía, la herramienta identifica a las calles de orden superior (como las autovías) antes que las de orden inferior (como las carreteras locales), y se puede usar para simular la preferencia del conductor por viajar por autovías en lugar de carreteras locales, aunque esto signifique un viaje más largo. Esto resulta especialmente útil al buscar rutas hasta ubicaciones lejanas, porque los conductores que realizan viajes de larga distancia prefieren viajar por autovías y así evitar paradas, intersecciones y giros. Desde el punto de vista del cómputo, usar la jerarquía es más rápido, especialmente en rutas a distancias largas, porque la herramienta identifica la mejor ruta en un subconjunto de calles relativamente más pequeño.
  • Desactivado (False en Python): no se usará la jerarquía al buscar las rutas. Si no se utiliza la jerarquía, la herramienta tiene en cuenta todas las calles y no identifica necesariamente las calles de mayor orden al buscar una ruta. Se suele utilizar al buscar rutas cortas en una ciudad.

La herramienta vuelve automáticamente al uso de la jerarquía si la distancia en línea recta entre las instalaciones y los puntos de demanda es mayor que 50 millas (80,46 kilómetros), incluso si este parámetro está desactivado (definido como False en Python).

Este parámetro se ignora a menos que el parámetro Modo de viaje esté establecido en Personalizado. Cuando se modela un modo a pie personalizado, le recomendamos que desactive la jerarquía, ya que está diseñada para vehículos motorizados.

Boolean
Restrictions
[Restrictions,...]
(Opcional)

Las restricciones que la herramienta respetará a la hora de buscar las mejores rutas.

Una restricción representa una preferencia o un requisito de conducción. En la mayoría de los casos, las restricciones ocasionan la prohibición de carreteras. Por ejemplo, al usar la restricción Evitar carreteras con peaje, se generará una ruta que solo incluirá carreteras con peaje cuando sea necesario viajar por ellas para llegar a un incidente o a una instalación. Restricción de altura permite trazar una ruta evitando cualquier lugar con una distancia al suelo que sea inferior a la altura del vehículo. Si está transportando materiales corrosivos en el vehículo, utilizar la restricción Prohibidos todos los materiales peligrosos impide transportar los materiales en las carreteras en las que está marcado como ilegal hacerlo.

Nota:

Los valores introducidos para este parámetro se ignoran a menos que el parámetro Modo de viaje esté establecido en Personalizado.

Nota:

Algunas restricciones requieren la especificación de un valor adicional para poder usarlas. Este valor se debe asociar con el nombre de la restricción y con un parámetro concreto creado para funcionar con la restricción. Puede identificar esas restricciones si sus nombres aparecen en la columna AttributeName del parámetro Valores de los parámetros de atributos. Especifique el campo ParameterValue en el parámetro Valores de los parámetros de atributos para que la restricción se use correctamente al buscar carreteras transitables.

Nota:

Algunas restricciones solo se admiten en ciertos países. Su disponibilidad se indica por región en la lista siguiente. Para las restricciones con una disponibilidad limitada dentro de una región, puede determinar si están disponibles en un país concreto revisando la tabla de la sección Lista de países de Cobertura de análisis de red. Si un país tiene el valor en la columna Atributos de logística, la restricción con disponibilidad de selección en la región se admite en ese país. Si se especifican nombres de restricción que no están disponibles en el país en el que se encuentran sus incidentes, el servicio pasa por alto las restricciones no válidas. El servicio también pasa por alto las restricciones cuando el valor del parámetro de atributos Uso de restricciones está comprendido entre 0 y 1 (consulte el parámetro Valor de parámetro de atributos). Prohíbe todas las restricciones cuando el valor del parámetro Uso de restricciones es mayor que 0.

La herramienta admite las siguientes restricciones:

  • Any Hazmat ProhibitedLos resultados no incluirán carreteras donde esté prohibido el transporte de cualquier material peligroso.Disponibilidad: Países concretos de Norteamérica y Europa
  • Avoid Carpool RoadsLos resultados evitarán las carreteras designadas exclusivamente para los vehículos compartidos.Disponibilidad: Todos los países
  • Avoid Express LanesLos resultados evitarán las carreteras designadas como vías exprés.Disponibilidad: Todos los países
  • Avoid FerriesLos resultados evitarán los ferris.Disponibilidad: Todos los países
  • Avoid GatesLos resultados evitarán las carreteras en las que haya puertas, como los accesos con clave o las entradas controladas por guardas.Disponibilidad: Todos los países
  • Avoid Limited Access RoadsLos resultados evitarán las carreteras que sean de acceso limitado.Disponibilidad: Todos los países
  • Avoid Private RoadsLos resultados evitarán las carreteras que no sean de propiedad y mantenimiento públicos.Disponibilidad: Todos los países
  • Avoid Roads Unsuitable for PedestriansLos resultados evitarán las carreteras que no sean aptas para peatones.Disponibilidad: Todos los países
  • Avoid StairwaysLos resultados evitarán todos los tramos de escalera de una ruta adecuada para peatones.Disponibilidad: Todos los países
  • Avoid Toll RoadsLos resultados evitarán todas las carreteras de peaje para automóviles.Disponibilidad: Todos los países
  • Avoid Toll Roads for TrucksLos resultados evitarán todas las carreteras de peaje para camiones.Disponibilidad: Todos los países
  • Avoid Truck Restricted RoadsLos resultados evitarán las carreteras donde no estén permitidos los camiones excepto para hacer entregas.Disponibilidad: Todos los países
  • Avoid Unpaved RoadsLos resultados evitarán las carreteras no pavimentadas (por ejemplo, de tierra, gravilla y similares).Disponibilidad: Todos los países
  • Axle Count RestrictionLos resultados no incluirán carreteras donde esté prohibida la circulación de camiones con el número de ejes especificado. El número de ejes se puede especificar mediante el parámetro de restricción Número de ejes.Disponibilidad: Países concretos de Norteamérica y Europa
  • Driving a BusLos resultados no incluirán carreteras donde estén prohibidos los autobuses. Usar esta restricción también garantizará que los resultados respetarán las calles con sentido único.Disponibilidad: Todos los países
  • Driving a TaxiLos resultados no incluirán carreteras donde estén prohibidos los taxis. Usar esta restricción también garantizará que los resultados respetarán las calles con sentido único.Disponibilidad: Todos los países
  • Driving a TruckLos resultados no incluirán carreteras donde estén prohibidos los camiones. Usar esta restricción también garantizará que los resultados respetarán las calles con sentido único.Disponibilidad: Todos los países
  • Driving an AutomobileLos resultados no incluirán carreteras donde esté prohibida la circulación de automóviles. Usar esta restricción también garantizará que los resultados respetarán las calles con sentido único.Disponibilidad: Todos los países
  • Driving an Emergency VehicleLos resultados no incluirán carreteras donde estén prohibidos los vehículos de emergencia. Usar esta restricción también garantizará que los resultados respetarán las calles con sentido único.Disponibilidad: Todos los países
  • Height RestrictionLos resultados no incluirán las carreteras donde la altura del vehículo supere la altura máxima permitida por la carretera. La altura del vehículo se puede especificar usando el parámetro de restricción Altura del vehículo (metros).Disponibilidad: Países concretos de Norteamérica y Europa
  • Kingpin to Rear Axle Length RestrictionLos resultados no incluirán las carreteras donde la longitud del vehículo supere la distancia máxima entre el eje de dirección y el eje posterior permitida para todos los camiones que circulen por la carretera. La longitud entre el eje de dirección y el eje trasero se puede especificar usando el parámetro de restricción Longitud de eje de dirección a eje trasero del vehículo (metros).Disponibilidad: Países concretos de Norteamérica y Europa
  • Length RestrictionLos resultados no incluirán las carreteras en las que la longitud del vehículo supere la longitud máxima permitida para la carretera. La longitud del vehículo se puede especificar usando el parámetro de restricción Longitud del vehículo (metros).Disponibilidad: Países concretos de Norteamérica y Europa
  • Preferred for PedestriansLos resultados utilizarán rutas preferidas adecuadas para la navegación para peatones.Disponibilidad: Países concretos de Norteamérica y Europa
  • Riding a MotorcycleLos resultados no incluirán carreteras donde estén prohibidas las motocicletas. Usar esta restricción también garantizará que los resultados respetarán las calles con sentido único.Disponibilidad: Todos los países
  • Roads Under Construction ProhibitedLos resultados no incluirán las carreteras en obras.Disponibilidad: Todos los países
  • Semi or Tractor with One or More Trailers ProhibitedLos resultados no incluirán carreteras donde estén prohibidos los camiones o tractores con uno o varios remolques.Disponibilidad: Países concretos de Norteamérica y Europa
  • Single Axle Vehicles ProhibitedLos resultados no incluirán carreteras donde estén prohibidos los vehículos con un solo eje.Disponibilidad: Países concretos de Norteamérica y Europa
  • Tandem Axle Vehicles ProhibitedLos resultados no incluirán carreteras donde estén prohibidos los vehículos con ejes en tándem.Disponibilidad: Países concretos de Norteamérica y Europa
  • Through Traffic ProhibitedLos resultados no incluirán las carreteras donde no se permita el tráfico de paso (no local).Disponibilidad: Todos los países
  • Truck with Trailers RestrictionLos resultados no incluirán carreteras donde esté prohibida la circulación de camiones con el número de remolques especificado. El número de remolques del camión se puede especificar mediante el parámetro de restricción Número de remolques del camión.Disponibilidad: Países concretos de Norteamérica y Europa
  • Use Preferred Hazmat RoutesLos resultados preferirán las carreteras designadas para el transporte de cualquier tipo de material peligroso.Disponibilidad: Países concretos de Norteamérica y Europa
  • Use Preferred Truck RoutesLos resultados darán prioridad a las carreteras que se hayan diseñado como rutas para camiones, como las que forman parte de la red nacional descrita en la National Surface Transportation Assistance Act de Estados Unidos, las carreteras que se hayan diseñado como rutas de camiones en un estado o una provincia, o aquellas que prefieran los camioneros cuando conducen por un área.Disponibilidad: Países concretos de Norteamérica y Europa
  • WalkingLos resultados no incluirán carreteras donde los peatones estén prohibidos.Disponibilidad: Todos los países
  • Weight RestrictionLos resultados no incluirán las carreteras donde el peso del vehículo supere el peso máximo permitido por la carretera. El peso del vehículo se puede especificar usando el parámetro de restricción Peso del vehículo (kilogramos).Disponibilidad: Países concretos de Norteamérica y Europa
  • Weight per Axle RestrictionLos resultados no incluirán las carreteras donde el peso por eje del vehículo supere el peso por eje máximo permitido por la carretera. El peso por eje del vehículo se puede especificar usando el parámetro de restricción Peso por eje del vehículo (kilogramos).Disponibilidad: Países concretos de Norteamérica y Europa
  • Width RestrictionLos resultados no incluirán las carreteras donde la anchura del vehículo supere la anchura máxima permitida por la carretera. El ancho del vehículo se puede especificar usando el parámetro de restricción Ancho del vehículo (metros).Disponibilidad: Países concretos de Norteamérica y Europa
String
Attribute_Parameter_Values
(Opcional)

Utilice este parámetro para especificar valores adicionales requeridos por un atributo o restricción, como por ejemplo para especificar si la restricción prohíbe, evita o prefiere circular en carreteras restringidas. Si la restricción se ha ideado para evitar carreteras o darles preferencia, puede especificar en qué medida se deben evitar o se les debe dar preferencia usando este parámetro. Por ejemplo, puede elegir que nunca se usen carreteras de peaje, que se eviten en la medida de lo posible o que se les dé preferencia.

Nota:

Los valores introducidos para este parámetro se ignoran a menos que el parámetro Modo de viaje esté establecido en Personalizado.

Si especifica el parámetro Valores de los parámetros de atributos de una clase de entidad, los nombres de los campos de la clase de entidad deben coincidir con los campos que se describen a continuación:

  • AttributeName: el nombre de la restricción.
  • ParameterName: el nombre del parámetro asociado con la restricción. Una restricción puede tener uno o varios valores de campo ParameterName dependiendo del uso previsto para ella.
  • ParameterValue: el valor de ParameterName utilizado por la herramienta al evaluar la restricción.

El parámetro Valores de los parámetros de atributos depende del parámetro Restricciones. El campo ParameterValue solo se usa si el nombre de la restricción se ha especificado como valor del parámetro Restricciones.

En Valores de los parámetros de atributos, cada restricción (mostrada como AttributeName) tiene un valor de campo ParameterName, Uso de restricción, que especifica si la restricción prohíbe, evita o prefiere los viajes por las carreteras asociadas con la restricción, además de en qué medida las carreteras se evitan o tienen preferencia. El Uso de restricción ParameterName se puede asignar a cualquiera de los siguientes valores de cadena de caracteres o a los valores numéricos equivalentes que se muestran entre paréntesis:

  • PROHIBITED (-1): está totalmente prohibido viajar por las carreteras que usan la restricción.
  • AVOID_HIGH (5): es muy poco probable que la herramienta incluya en la ruta las carreteras asociadas a la restricción.
  • AVOID_MEDIUM (2): es poco probable que la herramienta incluya en la ruta las carreteras asociadas con la restricción.
  • AVOID_LOW (1.3): es algo improbable que la herramienta incluya en la ruta las carreteras asociadas con la restricción.
  • PREFER_LOW (0.8): es algo probable que la herramienta incluya en la ruta las carreteras asociadas con la restricción.
  • PREFER_MEDIUM (0.5): es probable que la herramienta incluya en la ruta las carreteras asociadas con la restricción.
  • PREFER_HIGH (0.2): es muy probable que la herramienta incluya en la ruta las carreteras asociadas a la restricción.

En la mayoría de casos, puede usar el valor predeterminado, PROHIBITED, como valor de Uso de restricción si la restricción depende de una característica del vehículo como su altura. Sin embargo, en algunos casos, el valor de Uso de restricción depende de las preferencias de generación de rutas del usuario. Por ejemplo, la restricción Evitar carreteras con peaje tiene el valor predeterminado AVOID_MEDIUM para el atributo Uso de restricción. Significa que, cuando se utilice la restricción, la herramienta creará rutas fuera de las carreteras con peaje siempre que sea posible. AVOID_MEDIUM también indica lo importante que es evitar las carreteras con peaje al buscar la mejor ruta; tiene una prioridad media. Si se selecciona AVOID_LOW, se da una importancia menor a evitar los peajes, mientras que si se selecciona AVOID_HIGH se le da más importancia y es más aceptable que el servicio genere rutas más largas para evitar los peajes. Elegir PROHIBITED no permite viajar en las carreteras con peaje y hará imposible que una ruta viaje por cualquier parte de una carretera de peaje. Tenga en cuenta que evitar o prohibir carreteras con peaje, y evitar los pagos de peaje, es el objetivo para algunos. En cambio, otros prefieren conducir en las carreteras con peaje porque evitar el tráfico es más valioso para ellos que el dinero gastado en los peajes. En el último caso, elija PREFER_LOW, PREFER_MEDIUM o PREFER_HIGH como valor de Uso de la restricción. Cuanto mayor sea la preferencia, más lejos irá la herramienta para viajar por las carreteras asociadas a la restricción.

Record Set
Impedance
(Opcional)

Especifica la impedancia, que es un valor que representa el esfuerzo o el coste de viajar a lo largo de segmentos de carretera o en otras partes de la red de transporte.

El tiempo de viaje es una impedancia: un coche puede tardar 1 minuto en viajar un kilómetro a lo largo de una carretera vacía. Los tiempos de viaje pueden variar según el modo de viaje: un peatón puede tardar más de 20 minutos en caminar el mismo kilómetro, por lo que es importante elegir la impedancia correcta para el modo de viaje que se está modelando.

La distancia de viaje también puede ser una impedancia; la longitud de una carretera en kilómetros se puede considerar impedancia. En este sentido, la distancia de viaje es la misma para todos los modos: un kilómetro para un peatón es, igualmente, un kilómetro para un coche. (Lo que puede cambiar son los caminos por los que los diferentes modos tienen permitido viajar, lo cual afecta a la distancia entre puntos, que se modela mediante la configuración del modo de viaje.)

Precaución:

El valor introducido para este parámetro se ignora a menos que el parámetro Modo de viaje esté establecido en Personalizado, que es el valor predeterminado.

  • TravelTimeSe utilizan datos de tráfico históricos y en directo. Esta opción resulta útil para modelar el tiempo que tardan los automóviles en desplazarse por carreteras a una hora concreta del día utilizando datos de velocidad del tráfico en directo si están disponibles. Si utiliza TravelTime, si lo desea puede definir el parámetro de atributos TravelTime::Vehicle Maximum Speed (km/h) para especificar los límites físicos de la velocidad a la que el vehículo es capaz de desplazarse.
  • MinutesNo se utilizan datos de tráfico en directo, sino velocidades medias históricas de los datos de automóviles.
  • TruckTravelTimeSe utilizan datos de tráfico históricos y en directo, pero se establece una velocidad máxima al límite de velocidad especificado para camiones. Resulta útil para modelar el tiempo que tardan los camiones en desplazarse por carreteras a una hora concreta del día. Si utiliza TruckTravelTime, si lo desea puede definir el parámetro de atributos TruckTravelTime::Vehicle Maximum Speed (km/h) para especificar los límites físicos de la velocidad a la que el camión es capaz de desplazarse.
  • TruckMinutesNo utiliza datos de tráfico en directo, pero sí utiliza las velocidades más bajas del promedio histórico para automóviles y los límites de velocidad permitidos para camiones.
  • WalkTimeEl valor predeterminado es una velocidad de 5 km/h en todas las carreteras y caminos, pero se puede configurar mediante el parámetro de atributos WalkTime::Walking Speed (km/h).
  • MilesLas mediciones de longitud de carreteras se almacenan en millas y se pueden utilizar para realizar análisis según la distancia más corta.
  • KilometersLas mediciones de longitud de carreteras se almacenan en kilómetros y se pueden utilizar para realizar análisis según la distancia más corta.
  • TimeAt1KPHEl valor predeterminado es 1 km/h en todas las carreteras y caminos. No es posible cambiar la velocidad con ningún parámetro de atributos.
  • Drive TimeSe modelan los tiempos de viaje para un coche. Estos tiempos de viaje son dinámicos y fluctúan según los flujos de tráfico en zonas para las que hay datos de tráfico disponibles. Este es el valor predeterminado.
  • Truck TimeSe modelan los tiempos de viaje para un camión. Estos tiempos de viaje son estáticos para cada carretera y no fluctúan con el tráfico.
  • Walk TimeSe modelan los tiempos de viaje para un peatón.
  • Travel DistanceSe almacenan las mediciones de longitud a lo largo de carreteras y rutas. Para modelar la distancia a pie, elija esta opción y asegúrese de que A pie se ha definido en el parámetro Restricción. Del mismo modo, para modelar la distancia de conducción o de camión, elija Distancia de viaje aquí y establezca las restricciones apropiadas para que el vehículo viaje únicamente por carreteras en las que lo tiene permitido.

Si elige una impedancia basada en el tiempo, como TravelTime, TruckTravelTime, Minutes, TruckMinutes o WalkTime, el parámetro Unidades de medición se debe configurar con un valor basado en el tiempo. Si prefiere una impedancia basada en la distancia, como Miles o Kilometers, las Unidades de medida deben estar basadas en la distancia.

Heredado:

Los valores de impedancia de Tiempo de conducción, Tiempo en camión, Tiempo de recorrido a pie y Distancia de viaje ya no se admiten y se eliminarán en versiones futuras. Si utiliza uno de estos valores, la herramienta usa el valor del parámetro Impedancia de tiempo para valores basados en el tiempo y del parámetro Impedancia de distancia para valores basados en la distancia.

String
Origin_Destination_Line_Shape

Las líneas resultantes de una matriz de coste OD se pueden representar con geometría de línea o sin ninguna geometría. En ambos casos, la ruta siempre se calcula a lo largo de la red de calles minimizando el tiempo o la distancia de viaje; nunca usando la distancia en línea recta entre orígenes y destinos.

  • Straight LineLíneas rectas conectan orígenes y destinos.
  • NoneNo devuelva ninguna forma para las líneas que conectan orígenes y destinos. Esto es útil si tiene un gran número de orígenes y destinos y está interesado solo en la tabla de matriz de coste OD y no en las formas de las líneas de salida.
String
Save_Output_Network_Analysis_Layer
(Opcional)

Especifica la configuración del análisis se guardará como un archivo de capa de análisis de red. No puede trabajar directamente con este archivo, aunque lo abra en una aplicación de ArcGIS Desktop, por ejemplo, ArcMap. Se debe enviar al Soporte técnico de Esri para diagnosticar la calidad de los resultados devueltos por la herramienta.

  • Activado (True en Python): la salida se guardará como un archivo de capa de análisis de red. El archivo se descargará 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 al servicio 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 al servicio de la herramienta en la ventana Resultados de geoprocesamiento.
  • Desactivado (False en Python): la salida no se guardará como un archivo de capa de análisis de red. Esta es la opción predeterminada.

Boolean
Overrides
(Opcional)

Nota:

Este parámetro es solo para uso interno.

String
Time_Impedance
(Opcional)

El valor de impedancia basada en el tiempo representa el tiempo de viaje a lo largo de segmentos de carretera o en otras partes de la red de transporte.

Nota:
Si la impedancia del modo de viaje, según se especifica con el parámetro Impedancia, está basada en el tiempo, los valores de los parámetros Impedancia de tiempo e Impedancia deben ser los mismos. De lo contrario, el servicio devolverá un error.
  • MinutesLa impedancia de tiempo serán minutos.
  • TravelTimeLa impedancia del tiempo será el tiempo de viaje.
  • TimeAt1KPHLa impedancia de tiempo será el tiempo a un kilómetro por hora.
  • WalkTimeLa impedancia del tiempo será el tiempo de recorrido a pie.
  • TruckMinutesLa impedancia de tiempo serán minutos de camión.
  • TruckTravelTimeLa impedancia del tiempo será el tiempo de viaje en camión.
String
Distance_Impedance
(Opcional)

El valor de impedancia basada en la distancia representa la distancia de viaje a lo largo de segmentos de carretera o en otras partes de la red de transporte.

Nota:
Si la impedancia del modo de viaje, según se especifica con el parámetro Impedancia, está basada en la distancia, los valores de los parámetros Impedancia de distancia e Impedancia deben ser los mismos. De lo contrario, el servicio devolverá un error.
  • MilesLa impedancia de distancia serán millas.
  • KilometersLa impedancia de distancia serán kilómetros.
String
Output_Format
(Opcional)

Especifica el formato en el que se devolverán las entidades de salida.

  • Feature SetLas entidades de salida se generarán como tablas y clases de entidad. Esta es la opción predeterminada.
  • JSON FileLas entidades de salida se devolverán como un archivo comprimido que contiene la representación JSON de las salidas. Si se especifica esta opción, la salida será un archivo único (con una extensión .zip) que contiene uno o varios archivos JSON (con una extensión .json) para cada una de las salidas que crea el servicio.
  • GeoJSON FileLas entidades de salida se devolverán como un archivo comprimido que contiene la representación GeoJSON de las salidas. Si se especifica esta opción, la salida será un archivo único (con una extensión .zip) que contiene uno o varios archivos GeoJSON (con una extensión .geojson) para cada una de las salidas que crea el servicio.
  • CSV FileLas entidades de salida se devolverán como un archivo comprimido que contiene una representación de valores separados por comas (CSV) de las salidas. Si se especifica esta opción, la salida será un archivo único (con una extensión .zip) que contiene uno o varios archivos CSV (con una extensión .csv) para cada una de las salidas que crea el servicio.

Cuando se especifica un formato de salida basado en archivos, como Archivo JSON o Archivo GeoJSON, no se agregará ninguna salida a la visualización, puesto 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 al funcionamiento 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 al funcionamiento de la herramienta en la ventana Resultados de geoprocesamiento.

String
Ignore_Invalid_Locations
(Opcional)

Especifica si se ignorarán las ubicaciones de entrada no válidas.

  • SKIPLas ubicaciones de red no ubicadas se ignorarán y el análisis se ejecutará únicamente utilizando ubicaciones de red válidas. El análisis también continuará si las ubicaciones están en elementos no transitables o tienen otros errores. Esta opción es útil si usted sabe que las ubicaciones de red no son todas correctas, pero desea ejecutar el análisis con las ubicaciones de red que son válidas. Esta es la opción predeterminada.
  • HALTLas ubicaciones no válidas no se ignorarán. No ejecute el análisis si hay ubicaciones no válidas. Corrija las ubicaciones no válidas y vuelva a ejecutar el análisis.
Boolean
Locate_Settings
(Opcional)

Use este parámetro para especificar configuraciones que afecten a cómo se ubican las entradas, como la máxima distancia de búsqueda que se usa al localizar las entradas en la red, o las fuentes de red que se usan para localizar.

Más información sobre la localización de entradas

El objeto JSON del localizador tiene las siguientes propiedades:

  • tolerance y toleranceUnits: permite controlar la distancia máxima de búsqueda al localizar las entradas. Si no se encuentra ninguna ubicación de red válida dentro de esta distancia, la entidad de entrada se considerará no ubicada. Una pequeña tolerancia de búsqueda disminuye la probabilidad de ubicarse en la calle equivocada, pero aumenta la probabilidad de no encontrar ninguna ubicación de red válida. El valor del parámetro toleranceUnits se puede especificar como uno de los siguientes valores:
    • esriCentimeters
    • esriDecimalDegrees
    • esriDecimeters
    • esriFeet
    • esriInches
    • esriIntFeet
    • esriIntInches
    • esriIntMiles
    • esriIntNauticalMiles
    • esriIntYards
    • esriKilometers
    • esriMeters
    • esriMiles
    • esriMillimeters
    • esriNauticalMiles
    • esriYards
  • sources: le permite controlar qué fuente de red se puede utilizar para la ubicación. Por ejemplo, puede configurar el análisis para localizar entradas en calles, pero no en aceras. La lista de posibles fuentes en las que localizar es específica del dataset de red al que hace referencia este servicio. Solo se usan para ubicar las fuentes que estén presentes en la matriz de fuentes. Las fuentes se especifican como una matriz de objetos, cada uno con la siguiente propiedad:
    • name: el nombre de la clase de entidad de la fuente de red que se puede usar para ubicar entradas
  • allowAutoRelocate: permite controlar si las entradas con campos de ubicación de red existentes se pueden reubicar automáticamente al solucionar para garantizar que se disponga de campos de ubicación enrutables y válidos para el análisis. Si el valor es true, los puntos ubicados en elementos de red restringidos y los puntos afectados por las barreras se reubicarán en la ubicación enrutable más cercana. Si el valor es false, los campos de ubicación de red se utilizarán como están, aunque los puntos no sean accesibles, y esto puede hacer que la resolución falle. Aunque el valor sea false, las entradas sin campos de ubicación o campos de ubicación incompletos se localizarán durante la operación de resolución.
Nota:
Actualmente, no puede especificar nombres de fuente diferentes para la matriz sources. Además, allowAutoRelocate siempre está configurado como true ya que el servicio no admite campos de ubicación.

El valor de parámetro se especifica como un objeto JSON. El objeto JSON le permite especificar un JSON de localizador para todas las entidades de entrada en el análisis o puede especificar una excepción para una entrada concreta. La excepción le permite tener diferentes ajustes para cada entrada de análisis. Por ejemplo, es posible no permitir que las paradas se ubiquen en las rampas de autopista y permitir que las barreras de punto se ubiquen en las rampas de autopista. Al especificar el JSON Locate_Settings, deberá proporcionar las propiedades tolerance, toleranceUnits y allowAutoRelocate. Si necesita proporcionar un JSON de localizador diferente para una clase de entrada en particular, debe incluir la propiedad de invalidaciones para esa entrada. El nombre de propiedad debe coincidir con el nombre del parámetro de entrada. El JSON del localizador de una entrada concreta no tiene que incluir todas las propiedades; solo tiene que incluir las propiedades que son distintas de las propiedades del JSON del localizador predeterminado.

String

Salida derivada

NombreExplicaciónTipo de datos
Solve_Succeeded

Determina si el servicio generó correctamente la matriz de coste origen-destino.

Boolean
Output_Origin_Destination_Lines

Ofrece acceso a las líneas que conectan los orígenes con los destinos.

Feature Set
Output_Origins

Ofrece información sobre los orígenes utilizados en el análisis, como la cantidad total de destinos a los que se llega desde un origen determinado, o los orígenes que no se pueden incluir en el análisis.

Feature Set
Output_Destinations

Ofrece información sobre los destinos utilizados en el análisis, como la cantidad total de orígenes a los que se llegó desde un origen determinado, o los destinos que no se pueden incluir en el análisis.

Feature Set
Output_Network_Analysis_Layer

La capa de análisis de red con propiedades configuradas en los parámetros de la herramienta que se puede utilizar para análisis posteriores o para depurar el mapa.

File
Output_Result_File

Un archivo .zip que contiene los resultados del análisis, con uno o varios archivos para cada salida. El formato de los archivos individuales viene especificado por el parámetro Formato de salida.

File
Output_Network_Analysis_Layer_Package

Un paquete de capas que incluye una capa de análisis de red con los datos y la configuración utilizados en el análisis.

File
Usage_Cost

Este parámetro devuelve los créditos consumidos por el análisis.

Nota:

Cada análisis puede generar una cantidad diferente de objetos facturables y, por tanto, consumirá una cantidad diferente de créditos. Si el servicio no puede determinar los créditos, el parámetro usage_cost devuelve un valor de -1 para credits.

JSON

Muestra de código

Ejemplo de GenerateOriginDestinationCostMatrix (script independiente)

En el siguiente script de Python se muestra cómo usar la herramienta Generate Origin Destination Cost Matrix en un script.

"""This example shows how to generate a matrix of travel times between origins and destinations."""

import sys
import time
import arcpy

username = "<your user name>"
password = "<your password>"
od_service = "https://logistics.arcgis.com/arcgis/services;World/OriginDestinationCostMatrix;{0};{1}".format(username, password)

# Add the geoprocessing service as a toolbox.
# Check https://pro.arcgis.com/en/pro-app/arcpy/functions/importtoolbox.htm for
# other ways in which you can specify credentials to connect to a geoprocessing service.
arcpy.ImportToolbox(od_service)

# Set the variables to call the tool
origins = "C:/data/Inputs.gdb/Warehouses"
destinations = "C:/data/Inputs.gdb/Stores"
output_od_lines = "C:/data/Results.gdb/ODLines"

# Call the tool
result = arcpy.OriginDestinationCostMatrix.GenerateOriginDestinationCostMatrix(origins,
                                                                               destinations,
                                                                               Origin_Destination_Line_Shape="Straight Line")
arcpy.AddMessage("Running the analysis with result ID: {}".format(result.resultID))

# Check the status of the result object every 1 second until it has a
# value of 4 (succeeded) or greater
while result.status < 4:
    time.sleep(1)

# print any warning or error messages returned from the tool
result_severity = result.maxSeverity
if result_severity == 2:
    arcpy.AddError("An error occured when running the tool")
    arcpy.AddError(result.getMessages(2))
    sys.exit(2)
elif result_severity == 1:
    arcpy.AddWarning("Warnings were returned when running the tool")
    arcpy.AddWarning(result.getMessages(1))

# Save the lines connecting origins to destinations in a geodatabase
result.getOutput(1).save(output_od_lines)
Ejemplo 2 de GenerateOriginDestinationCostMatrix (script independiente)

El siguiente ejemplo muestra cómo realizar un análisis de matriz de coste origen-destino con un modo de viaje personalizado.

"""This example shows how to perform an origin-destination cost matrix analysis using a custom travel mode
that models trucks carrying wide load."""

import sys
import time
import json
import arcpy

username = "<your user name>"
password = "<your password>"
od_service = "https://logistics.arcgis.com/arcgis/services;World/OriginDestinationCostMatrix;{0};{1}".format(username, password)

# Add the geoprocessing service as a toolbox.
arcpy.ImportToolbox(od_service)

# Set the variables to call the tool
origins = "C:/data/Inputs.gdb/Warehouses"
destinations = "C:/data/Inputs.gdb/Stores"
output_od_lines = "C:/data/Results.gdb/ODLines"

# Change Vehicle Width attribute parameter value to 4.5 (about 15 feet) for the Trucking Time travel mode
# used for the analysis
portal_url = "https://www.arcgis.com"
arcpy.SignInToPortal(portal_url, username, password)
travel_mode_list = arcpy.na.GetTravelModes(portal_url)
tt = travel_mode_list["Trucking Time"]
tt_json = str(tt)
tt_dict = json.loads(tt_json)
tt_dict["restrictionAttributeNames"].append("Width Restriction")

for attr_param in tt_dict["attributeParameterValues"]:
    if attr_param['attributeName'] == 'Width Restriction' and attr_param['parameterName'] == 'Vehicle Width (meters)':
        attr_param['value'] = 4.5
travel_mode = json.dumps(tt_dict)

# Call the tool
result = arcpy.OriginDestinationCostMatrix.GenerateOriginDestinationCostMatrix(origins, destinations,
                                                                               Travel_Mode=travel_mode,
                                                                               Origin_Destination_Line_Shape="Straight Line")

# Check the status of the result object every 1 second until it has a
# value of 4 (succeeded) or greater
while result.status < 4:
    time.sleep(1)

# print any warning or error messages returned from the tool
result_severity = result.maxSeverity
if result_severity == 2:
    arcpy.AddError("An error occured when running the tool")
    arcpy.AddError(result.getMessages(2))
    sys.exit(2)
elif result_severity == 1:
    arcpy.AddWarning("Warnings were returned when running the tool")
    arcpy.AddWarning(result.getMessages(1))

# Save the lines connecting origins to destinations in a geodatabase
result.getOutput(1).save(output_od_lines)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.