Crear capa de análisis de entrega de última milla (Herramientas de Network Analyst)

Resumen

Crea una capa de análisis de red de entrega de última milla y establece sus propiedades de análisis. Una capa de análisis de entrega de última milla resulta útil para optimizar un conjunto de rutas con una flota de vehículos. La capa se puede crear utilizando un dataset de red local o un servicio alojado en línea o en un portal.

Uso

Esta herramienta suele utilizarse como primer paso en un proceso de análisis de redes. Una vez creada la capa, puede agregarle entradas mediante la herramienta Agregar ubicaciones y resolver el análisis con la herramienta Resolver.

Más información sobre el flujo de trabajo de la capa de análisis de redes
La red de análisis utilizada para un análisis de entrega de última milla debe tener al menos un modo de viaje, un atributo de coste con unidades de tiempo y un atributo de coste con unidades de distancia, así como un atributo de zona horaria.
Al usar ArcGIS Online o un portal de ArcGIS Enterprise cuyos servicios de generación de rutas estén configurados con ArcGIS Online como fuente de datos de red de entrada, resolver el análisis consumirá créditos y estará sujeto a determinados límites, como el número de entradas permitidas.

Más información sobre el consumo de créditos y los límites de análisis del análisis de red
De forma predeterminada, los datos de la nueva capa de análisis se crearán en un nuevo dataset de entidades con nombre automático en el entorno de geoprocesamiento del Espacio de trabajo actual, que suele ser la geodatabase del proyecto. Los datos basados en tablas se crearán en el nivel raíz de la misma geodatabase, ya que las tablas no se pueden almacenar en un dataset de entidades. Puede anular este comportamiento utilizando los parámetros Geodatabase de análisis y Nombre del dataset de entidades de análisis.
Aunque esta herramienta se puede utilizar en un script de Python, la práctica recomendada para realizar análisis de redes en Python es utilizar las clases de resolución del módulo arcpy.nax.

Más información sobre cómo realizar el análisis de red en Python.

Etiqueta	Explicación	Tipo de datos
Fuente de datos de red	El servicio o dataset de red en el que se realizará el análisis de red. El parámetro se puede especificar usando lo siguiente: La ruta del catálogo a un dataset de red Una capa de dataset de red La URL de ArcGIS Online o de un portal de ArcGIS Enterprise configurado con servicios de cálculo de rutas estándar Para usar una URL de portal, debe iniciar sesión en el portal con una cuenta que tenga privilegios de generación de rutas. Más información sobre el análisis de red mediante servicios de generación de rutas Al usar ArcGIS Online o un portal de ArcGIS Enterprise cuyos servicios de generación de rutas estén configurados con ArcGIS Online como la red de entrada, resolver el análisis consumirá créditos y estará sujeto a determinados límites, como el número de entradas permitidas. Más información sobre el consumo de créditos y los límites de análisis del análisis de red La red debe tener al menos un modo de viaje, un atributo de coste con unidades de tiempo y un atributo de coste con unidades de distancia, así como un atributo de zona horaria.	Network Dataset Layer; String
Nombre de capa (Opcional)	Nombre de la capa de análisis de red que se creará.	String
Modo de viaje (Opcional)	Nombre del modo de viaje que se utilizará en el análisis. El modo de viaje representa un conjunto de parámetros de red como, por ejemplo, restricciones del viaje y las normas sobre cambios de sentido, que determina cómo un peatón, un coche, un camión u otro medio de transporte se desplaza por la red. Los modos de viaje se definen en su fuente de datos de red. También se puede utilizar como entrada de este parámetro un objeto `arcpy.na.TravelMode` y una cadena que contenga la representación JSON válida de un modo de viaje. El atributo de impedancia del modo de viaje debe tener unidades de tiempo.	String
Unidades de tiempo (Opcional)	Especifica las unidades de tiempo que utilizarán las propiedades de la capa de análisis y los campos temporales de las subcapas y tablas de la capa de análisis (clases de análisis de red). Este valor no necesita coincidir con las unidades del atributo de coste de tiempo. Minutos—Se usarán los minutos como unidad de tiempo. Esta es la opción predeterminada. Segundos—Se usarán los segundos como unidad de tiempo. Horas—Se usarán las horas como unidad de tiempo. Días—Se usarán los días como unidad de tiempo.	String
Unidades de distancia (Opcional)	Especifica las unidades de distancia que utilizarán las propiedades de la capa de análisis y los campos de distancia de las subcapas y tablas de la capa de análisis (clases de análisis de red). Este valor no necesita coincidir con las unidades del atributo de coste de distancia opcional. Precaución: Las opciones Pulgadas, Centímetros, Milímetros y Decímetros no están disponibles cuando la fuente de datos de la red es un servicio. Millas—Se usarán las millas como unidades de distancia. Esta es la opción predeterminada. Kilómetros—Se usarán los kilómetros como unidades de distancia. Pies—Se usarán los pies como unidades de distancia. Yardas—Se usarán las yardas como unidades de distancia. Metros—Se usarán los metros como unidades de distancia. Pulgadas—Se usarán las pulgadas como unidades de distancia. Centímetros—Se usarán los centímetros como unidades de distancia. Milímetros—Se usarán los milímetros como unidades de distancia. Decímetros—Se usarán los decímetros como unidades de distancia. Millas náuticas—Se usarán las millas náuticas como unidades de distancia.	String
Primera fecha de inicio de ruta (Opcional)	Primera fecha de inicio predeterminada para las rutas. Esta fecha se utiliza para todas las rutas para las que el campo `EarliestStartDate` de la subcapa `Routes` es nulo. Cuando no se especifica ningún valor de parámetro, todas las filas de la subcapa `Routes` deben especificar un valor en el campo `EarliestStartDate`. Aunque puede especificar tanto una fecha como una hora para este parámetro, solo se utiliza la fecha. Para establecer la primera hora de inicio para las rutas, utilice el parámetro Primera hora de inicio de ruta. Precaución: Aunque los otros solucionadores de Network Analyst permiten utilizar fechas especiales para modelar un día de la semana o la fecha actual en lugar de una fecha específica y estática, el solucionador de entrega de la última milla no lo permite. Debe elegir una fecha concreta.	Date
Hora de inicio más temprana de la ruta (Opcional)	Primera hora de inicio predeterminada para las rutas. Esta hora del día se utiliza para todas las rutas para las que el campo `EarliestStartTime` de la subcapa `Routes` es nulo. Cuando no se especifica ningún valor de parámetro, todas las filas de la subcapa `Routes` deben especificar un valor en el campo `EarliestStartTime`. Aunque puede especificar tanto una fecha como una hora para este parámetro, solo se utiliza la hora. Para establecer la primera fecha de inicio para las rutas, utilice el parámetro Primera fecha de inicio de ruta.	Date
Tiempo máximo total de ruta (Opcional)	El tiempo total máximo permitido para cada ruta. El valor puede ser cualquier número positivo. El valor se utiliza para todas las rutas para las que el campo `MaxTotalTime` de la subcapa `Routes` es nulo. Cuando no se especifica ningún valor de parámetro, todas las filas de la subcapa `Routes` deben especificar un valor en el campo `MaxTotalTime`. El valor se interpreta en las unidades que se especifican en el parámetro Unidades de tiempo.	Double
Zona horaria para campos de hora (Opcional)	Especifica la zona horaria que se utilizará para los campos de fecha/hora de entrada que admite la herramienta. Especificar valores de fecha y hora en UTC resulta útil si no conoce la zona horaria en la que se encuentran las órdenes o depósitos o cuando tiene órdenes y depósitos en varias zonas horarias y desea que todos los valores de fecha y hora empiecen simultáneamente. Hora local en ubicaciones—Los valores de fecha y hora asociados a las órdenes o depósitos estarán en la zona horaria en la que se encuentran las órdenes y depósitos. Para las rutas, los valores de fecha y hora están basados en la zona horaria en la que se encuentra el depósito inicial para la ruta. Si una ruta no tiene un depósito inicial, todas las órdenes y los depósitos de todas las rutas deben estar en una única zona horaria. Esta es la opción predeterminada. UTC—Los valores de fecha y hora asociados a las órdenes, depósitos y drutas estarán en hora universal coordinada (UTC) y no se basan en la zona horaria en la que se encuentran las órdenes o depósitos.	String
Espacio de secuencia (Opcional)	Espacio de valores numéricos a dejar en el campo `Sequence` en la subcapa Órdenes entre órdenes adyacentes cuando se resuelve el análisis. El valor actúa como multiplicador de la secuencia real de órdenes en cada ruta. Por ejemplo, si el espacio es 5, la primera orden de la ruta tendrá el valor 5 para el campo `Sequence`, la segunda orden de la ruta tendrá el valor 10 para el campo `Sequence`, la tercera tendrá el valor 15, y así sucesivamente. Este parámetro ayuda a insertar órdenes después de que se haya creado el plan de ruta inicial, ya que las nuevas órdenes se pueden insertar en los espacios de la secuencia. El valor debe ser un entero positivo. El valor predeterminado es 1. La primera vez que se resuelva el análisis, los valores del campo `Sequence` se rellenarán con valores secuenciales utilizando el espacio de secuencia designado. En las siguientes resoluciones del mismo análisis, se mantendrán los valores del campo `Sequence` de las órdenes existentes y se insertarán nuevas órdenes en los espacios utilizando los valores enteros disponibles para el campo `Sequence` que no estén siendo utilizados por otras órdenes. Si el espacio de secuencia se fija en 1, los valores de secuencia se actualizarán siempre a valores contiguos para cada resolución.	Long
Ignorar ubicaciones de orden no válidas al resolver (Opcional)	Especifica si se ignorarán las ubicaciones de orden no válidas. Activado—Las ubicaciones de orden no válidas se ignorarán para que el análisis se realice correctamente utilizando solo ubicaciones válidas. Desactivado—Las ubicaciones de orden no válidas no se ignorarán y harán que el análisis falle. Esta es la opción predeterminada.	Boolean
Forma de ruta de salida (Opcional)	Especifica el tipo de forma que se utilizará para las entidades de ruta que genere el análisis. Independientemente del tipo de forma de salida que especificado, la mejor ruta siempre se determina por la impedancia de la red, no por la distancia euclidiana. Esto significa que solo las formas de la ruta son diferentes, no los elementos transitables subyacentes de la red. A lo largo de la red—Las rutas de salida tendrán la misma forma que las fuentes de red subyacentes. La salida incluye mediciones de ruta para la referenciación lineal. Las mediciones aumentan desde la primera parada y registran la impedancia acumulada para llegar a una posición determinada. Sin líneas—No se generará ninguna forma para las rutas de salida. Líneas rectas—La forma de la ruta de salida será una línea recta simple entre las paradas. Esta es la opción predeterminada.	String
Generar indicaciones al resolver (Opcional)	Especifica si se generarán indicaciones al ejecutar el análisis. En el caso de un análisis en el que no sea necesario generar indicaciones paso a paso, desactive la generación de indicaciones para reducir el tiempo que tarda en resolver el análisis. Activado—Se generarán indicaciones paso a paso al resolver. Desactivado—No se generarán indicaciones paso a paso al resolver. Esta es la opción predeterminada.	Boolean
Geodatabase de análisis (Opcional)	El espacio de trabajo de la geodatabase de archivos en el que se almacenarán los datos de la subcapa de la nueva capa de análisis de redes. Si no se especifica este parámetro, los datos de la subcapa se crearán en el entorno de geoprocesamiento del espacio de trabajo actual, que suele ser la geodatabase del proyecto. Más información sobre la fuente de datos de análisis de una capa de análisis de red	Workspace
Nombre de dataset de entidades de análisis (Opcional)	El nombre que se utilizará para el nuevo dataset de entidades que la herramienta creará en la geodatabase de análisis para almacenar los datos de las subcapas de la capa de análisis de redes. Si no se especifica, el dataset de entidades se creará con un nombre único aleatorio. Más información sobre la fuente de datos de análisis de una capa de análisis de red	String

Salida derivada

Etiqueta	Explicación	Tipo de datos
Capa de Network Analyst	La nueva capa de análisis de red.	Network Analyst Layer

arcpy.na.MakeLastMileDeliveryAnalysisLayer(network_data_source, {layer_name}, {travel_mode}, {time_units}, {distance_units}, {earliest_route_start_date}, {earliest_route_start_time}, {max_route_total_time}, {time_zone_for_time_fields}, {sequence_gap}, {ignore_invalid_order_locations}, {line_shape}, {generate_directions_on_solve}, {analysis_geodatabase}, {analysis_feature_dataset_name})

Nombre	Explicación	Tipo de datos
network_data_source	El servicio o dataset de red en el que se realizará el análisis de red. El parámetro se puede especificar usando uno de los siguientes: La ruta del catálogo al dataset de red Un objeto de capa de dataset de red El nombre de la cadena de caracteres de la capa del dataset de red La URL de ArcGIS Online o de un portal de ArcGIS Enterprise configurado con servicios de cálculo de rutas estándar Para usar una URL de portal, debe iniciar sesión en el portal con una cuenta que tenga privilegios de generación de rutas. Más información sobre cómo iniciar sesión en un portal de Python Más información sobre el análisis de red mediante servicios de generación de rutas Al usar ArcGIS Online o un portal de ArcGIS Enterprise cuyos servicios de generación de rutas estén configurados con ArcGIS Online como la red de entrada, resolver el análisis consumirá créditos y estará sujeto a determinados límites, como el número de entradas permitidas. Más información sobre el consumo de créditos y los límites de análisis del análisis de red La red debe tener al menos un modo de viaje, un atributo de coste con unidades de tiempo y un atributo de coste con unidades de distancia, así como un atributo de zona horaria.	Network Dataset Layer; String
layer_name (Opcional)	Nombre de la capa de análisis de red que se creará.	String
travel_mode (Opcional)	Nombre del modo de viaje que se utilizará en el análisis. El modo de viaje representa un conjunto de parámetros de red como, por ejemplo, restricciones del viaje y las normas sobre cambios de sentido, que determina cómo un peatón, un coche, un camión u otro medio de transporte se desplaza por la red. Los modos de viaje se definen en su fuente de datos de red. También se puede utilizar como entrada de este parámetro un objeto `arcpy.na.TravelMode` y una cadena que contenga la representación JSON válida de un modo de viaje. El atributo de impedancia del modo de viaje debe tener unidades de tiempo.	String
time_units (Opcional)	Especifica las unidades de tiempo que utilizarán las propiedades de la capa de análisis y los campos temporales de las subcapas y tablas de la capa de análisis (clases de análisis de red). Este valor no necesita coincidir con las unidades del atributo de coste de tiempo. `Minutes`—Se usarán los minutos como unidad de tiempo. Esta es la opción predeterminada. `Seconds`—Se usarán los segundos como unidad de tiempo. `Hours`—Se usarán las horas como unidad de tiempo. `Days`—Se usarán los días como unidad de tiempo.	String
distance_units (Opcional)	Especifica las unidades de distancia que utilizarán las propiedades de la capa de análisis y los campos de distancia de las subcapas y tablas de la capa de análisis (clases de análisis de red). Este valor no necesita coincidir con las unidades del atributo de coste de distancia opcional. Precaución: Las opciones `Inches`, `Centimeters`, `Millimeters` y `Decimeters` no están disponibles cuando la fuente de datos de la red es un servicio. `Miles`—Se usarán las millas como unidades de distancia. Esta es la opción predeterminada. `Kilometers`—Se usarán los kilómetros como unidades de distancia. `Feet`—Se usarán los pies como unidades de distancia. `Yards`—Se usarán las yardas como unidades de distancia. `Meters`—Se usarán los metros como unidades de distancia. `Inches`—Se usarán las pulgadas como unidades de distancia. `Centimeters`—Se usarán los centímetros como unidades de distancia. `Millimeters`—Se usarán los milímetros como unidades de distancia. `Decimeters`—Se usarán los decímetros como unidades de distancia. `NauticalMiles`—Se usarán las millas náuticas como unidades de distancia.	String
earliest_route_start_date (Opcional)	Primera fecha de inicio predeterminada para las rutas. Esta fecha se utiliza para todas las rutas para las que el campo `EarliestStartDate` de la subcapa `Routes` es nulo. Cuando no se especifica ningún valor de parámetro, todas las filas de la subcapa `Routes` deben especificar un valor en el campo `EarliestStartDate`. Utilice un objeto `datetime.date` para especificar este parámetro. Precaución: Aunque los otros solucionadores de Network Analyst permiten utilizar fechas especiales para modelar un día de la semana o la fecha actual en lugar de una fecha específica y estática, el solucionador de entrega de la última milla no lo permite. Debe elegir una fecha concreta.	Date
earliest_route_start_time (Opcional)	Primera hora de inicio predeterminada para las rutas. Esta hora del día se utiliza para todas las rutas para las que el campo `EarliestStartTime` de la subcapa `Routes` es nulo. Cuando no se especifica ningún valor de parámetro, todas las filas de la subcapa `Routes` deben especificar un valor en el campo `EarliestStartTime`. Utilice un objeto `datetime.time` para especificar este parámetro.	Date
max_route_total_time (Opcional)	El tiempo total máximo permitido para cada ruta. El valor puede ser cualquier número positivo. El valor se utiliza para todas las rutas para las que el campo `MaxTotalTime` de la subcapa `Routes` es nulo. Cuando no se especifica ningún valor de parámetro, todas las filas de la subcapa `Routes` deben especificar un valor en el campo `MaxTotalTime`. El valor se interpreta en las unidades especificadas en el parámetro `time_units`.	Double
time_zone_for_time_fields (Opcional)	Especifica la zona horaria que se utilizará para los campos de fecha/hora de entrada que admite la herramienta. Especificar valores de fecha y hora en UTC resulta útil si no conoce la zona horaria en la que se encuentran las órdenes o depósitos o cuando tiene órdenes y depósitos en varias zonas horarias y desea que todos los valores de fecha y hora empiecen simultáneamente. `LOCAL_TIME_AT_LOCATIONS`—Los valores de fecha y hora asociados a las órdenes o depósitos estarán en la zona horaria en la que se encuentran las órdenes y depósitos. Para las rutas, los valores de fecha y hora están basados en la zona horaria en la que se encuentra el depósito inicial para la ruta. Si una ruta no tiene un depósito inicial, todas las órdenes y los depósitos de todas las rutas deben estar en una única zona horaria. Esta es la opción predeterminada. `UTC`—Los valores de fecha y hora asociados a las órdenes, depósitos y drutas estarán en hora universal coordinada (UTC) y no se basan en la zona horaria en la que se encuentran las órdenes o depósitos.	String
sequence_gap (Opcional)	Espacio de valores numéricos a dejar en el campo `Sequence` en la subcapa Órdenes entre órdenes adyacentes cuando se resuelve el análisis. El valor actúa como multiplicador de la secuencia real de órdenes en cada ruta. Por ejemplo, si el espacio es 5, la primera orden de la ruta tendrá el valor 5 para el campo `Sequence`, la segunda orden de la ruta tendrá el valor 10 para el campo `Sequence`, la tercera tendrá el valor 15, y así sucesivamente. Este parámetro ayuda a insertar órdenes después de que se haya creado el plan de ruta inicial, ya que las nuevas órdenes se pueden insertar en los espacios de la secuencia. El valor debe ser un entero positivo. El valor predeterminado es 1. La primera vez que se resuelva el análisis, los valores del campo `Sequence` se rellenarán con valores secuenciales utilizando el espacio de secuencia designado. En las siguientes resoluciones del mismo análisis, se mantendrán los valores del campo `Sequence` de las órdenes existentes y se insertarán nuevas órdenes en los espacios utilizando los valores enteros disponibles para el campo `Sequence` que no estén siendo utilizados por otras órdenes. Si el espacio de secuencia se fija en 1, los valores de secuencia se actualizarán siempre a valores contiguos para cada resolución.	Long
ignore_invalid_order_locations (Opcional)	Especifica si se ignorarán las ubicaciones de orden no válidas. `SKIP`—Las ubicaciones de orden no válidas se ignorarán para que el análisis se realice correctamente utilizando solo ubicaciones válidas. `HALT`—Las ubicaciones de orden no válidas no se ignorarán y harán que el análisis falle. Esta es la opción predeterminada.	Boolean
line_shape (Opcional)	Especifica el tipo de forma que se utilizará para las entidades de ruta que genere el análisis. Independientemente del tipo de forma de salida que especificado, la mejor ruta siempre se determina por la impedancia de la red, no por la distancia euclidiana. Esto significa que solo las formas de la ruta son diferentes, no los elementos transitables subyacentes de la red. `ALONG_NETWORK`—Las rutas de salida tendrán la misma forma que las fuentes de red subyacentes. La salida incluye mediciones de ruta para la referenciación lineal. Las mediciones aumentan desde la primera parada y registran la impedancia acumulada para llegar a una posición determinada. `NO_LINES`—No se generará ninguna forma para las rutas de salida. `STRAIGHT_LINES`—La forma de la ruta de salida será una línea recta simple entre las paradas. Esta es la opción predeterminada.	String
generate_directions_on_solve (Opcional)	Especifica si se generarán indicaciones al ejecutar el análisis. En el caso de un análisis en el que no sea necesario generar indicaciones paso a paso, desactive la generación de indicaciones para reducir el tiempo que tarda en resolver el análisis. `DIRECTIONS`—Se generarán indicaciones paso a paso al resolver. `NO_DIRECTIONS`—No se generarán indicaciones paso a paso al resolver. Esta es la opción predeterminada.	Boolean
analysis_geodatabase (Opcional)	El espacio de trabajo de la geodatabase de archivos en el que se almacenarán los datos de la subcapa de la nueva capa de análisis de redes. Si no se especifica este parámetro, los datos de la subcapa se crearán en el entorno de geoprocesamiento del espacio de trabajo actual, que suele ser la geodatabase del proyecto. Más información sobre la fuente de datos de análisis de una capa de análisis de red	Workspace
analysis_feature_dataset_name (Opcional)	El nombre que se utilizará para el nuevo dataset de entidades que la herramienta creará en la geodatabase de análisis para almacenar los datos de las subcapas de la capa de análisis de redes. Si no se especifica, el dataset de entidades se creará con un nombre único aleatorio. Más información sobre la fuente de datos de análisis de una capa de análisis de red	String

Salida derivada

Nombre	Explicación	Tipo de datos
out_network_analysis_layer	La nueva capa de análisis de red.	Network Analyst Layer

Muestra de código

Sugerencia:

Aunque esta herramienta se puede utilizar en un script de Python, la práctica recomendada para realizar análisis de redes en Python es utilizar las clases de resolución del módulo arcpy.nax. Más información sobre cómo realizar el análisis de red en Python.

Ejemplo 1 de MakeLastMileDeliveryAnalysisLayer (ventana de Python)

Ejecute la herramienta especificando un subconjunto de parámetros.

import datetime

arcpy.na.MakeLastMileDeliveryAnalysisLayer(
    r"C:\Data\SanFrancisco.gdb\Transportation\Streets_ND",
    "Package Delivery",
    "Trucking Time",
    time_units="Hours",
    earliest_route_start_date=datetime.date(2023, 11, 28),
    earliest_route_start_time=datetime.time(7, 30, 0),
    route_start_flexibility=1.5,
    line_shape="NO_LINES"
)

Entornos

Espacio de trabajo actual

Información de licenciamiento

Basic: Sí
Standard: Sí
Avanzado: Sí

Crear capa de análisis de entrega de última milla (Herramientas de Network Analyst)

Resumen

Uso

Parámetros

Precaución:

Precaución:

Salida derivada

Entornos

Información de licenciamiento

Temas relacionados