Создать слой анализа Доставка до двери (Network Analyst)

Краткая информация

Создает слой сетевого анализа доставки до двери и задает его свойства. Слой анализа доставки до двери используется при оптимизации маршрутов движения транспортных средств. Слой можно создать, используя локальный набор сетевых данных или сервис, размещенный онлайн или на портале.

Использование

  • Сеть анализа, используемая для анализа доставки до двери, должна иметь по крайней мере один режим перемещения, один атрибут стоимости с единицами измерения времени и один атрибут стоимости с единицами измерения расстояния, а также атрибут часового пояса.

  • После создания слоя анализа при помощи данного инструмента, вы можете добавлять в него объекты сетевого анализа при помощи инструмента Добавить положения, выполнять анализ при помощи инструмента Расчет и сохранять результаты на диске при помощи инструмента Сохранить в файл слоя.

  • При использовании данного инструмента в моделях геообработки, если модель запускается как инструмент, то выходной слой сетевого анализа должен быть задан в качестве параметра модели, в противном случае слой не добавится в содержание карты.

  • Хотя этот инструмент можно запустить в Python, лучший способ автоматизировать рабочие процессы доставки до двери в Python - использовать объект механизма расчета LastMileDelivery в модуле arcpy.nax Network Analyst.

Параметры

ПодписьОписаниеТип данных
Источник сетевых данных

Набор сетевых данных или сервис, для которого выполняется сетевой анализ. Для сервиса используйте URL-адрес портала.

Сеть должна иметь по крайней мере один режим перемещения, один атрибут стоимости с единицами измерения времени и один атрибут стоимости с единицами измерения расстояния, а также атрибут часового пояса.

Network Dataset Layer;String
Имя слоя
(Дополнительный)

Имя слоя сетевого анализа, который будет создан.

String
Режим передвижения
(Дополнительный)

Имя режима передвижения, используемого для выполнения анализа. Режим передвижения представляет собой набор сетевых настроек, например, ограничений передвижения и правил разворотов, определяющих, как пешеход, легковой или грузовой автомобиль или другое средство транспорта передвигается по сети. Режимы передвижения определяются вашим источником сетевых данных.

Объект arcpy.na.TravelMode и строка, содержащая действительное представление JSON режима перемещения, также могут использоваться как ввод для этого параметра.

Атрибут импеданса режима передвижения должен содержать единицы измерения времени.

String
Единицы времени
(Дополнительный)

Задает единицы измерения времени, которые будут использоваться свойствами слоя анализа и временными полями подслоев и таблиц слоя анализа (классы сетевого анализа). Это значение не обязательно должно соответствовать единицам атрибута временной стоимости.

  • МинутыЕдиницы времени даются в минутах. Это значение по умолчанию
  • СекундыЕдиницы времени даются в секундах.
  • ЧасыЕдиницы времени даются в часах.
  • ДниЕдиницы времени даются в днях.
String
Единицы расстояния
(Дополнительный)

Задает единицы измерения расстояния, которые будут использоваться свойствами слоя анализа и полями расстояний подслоев и таблиц слоя анализа (классы сетевого анализа). Это значение не обязательно должно соответствовать единицам дополнительного атрибута стоимости по расстоянию.

Внимание:
Опции Дюймы, Сантиметры, Миллиметры и Дециметры недоступны, если источником сетевых данных является сервис.

  • МилиЕдиницами измерения расстояния будут мили. Это значение по умолчанию
  • КилометрыЕдиницами измерения расстояния будут километры.
  • ФутыЕдиницами измерения расстояния будут футы.
  • ЯрдыЕдиницами измерения расстояния будут ярды.
  • МетрыЕдиницами измерения расстояния будут метры.
  • ДюймыЕдиницами измерения расстояния будут дюймы.
  • СантиметрыЕдиницами измерения расстояния будут сантиметры.
  • МиллиметрыЕдиницами измерения расстояния будут миллиметры.
  • ДециметрыЕдиницами измерения расстояния будут дециметры.
  • Морские милиЕдиницами измерения расстояния будут морские мили.
String
Самая ранняя дата начала маршрута
(Дополнительный)

Самая ранняя дата начала маршрута по умолчанию. Эта дата используется для всех маршрутов, для которых в поле EarliestStartDate подслоя Routes находится значение null. Если значение параметра не указано, все строки в подслое Routes должны содержать значение в поле EarliestStartDate.

Хотя для этого параметра можно указать как дату, так и время, используется только дата. Чтобы задать самое раннее время начала маршрутов, используйте параметр Самое раннее время начала маршрута.

Внимание:
Хотя другие механизмы расчета Network Analyst позволяют использовать специальные даты для моделирования дня недели или текущей даты вместо определенной статической даты, механизм расчета доставки до двери этого не делает. Необходимо выбрать определенную дату.

Date
Самое раннее время начала маршрута
(Дополнительный)

Самое раннее время начала маршрута по умолчанию. Это время дня используется для всех маршрутов, для которых в поле EarliestStartTime подслоя Routes находится значение null. Если значение параметра не указано, все строки в подслое Routes должны содержать значение в поле EarliestStartTime.

Хотя для этого параметра можно указать как дату, так и время, используется только время. Чтобы задать самое раннее время начала маршрутов, используйте параметр Самое раннее время начала маршрута.

Date
Максимальное общее время маршрута
(Дополнительный)

Максимально допустимое общее время каждого маршрута. Это значение может быть любым положительным числом.

Это значение используется для всех маршрутов, для которых в поле MaxTotalTime подслоя Routes находится значение null. Если значение параметра не указано, все строки в подслое Routes должны содержать значение в поле MaxTotalTime.

Значение интерпретируется в единицах, заданных параметром Единицы времени.

Double
Часовой пояс для полей времени
(Дополнительный)

Задает часовой пояс входных полей даты-времени, поддерживаемых инструментом.

Указание значений даты-времени по времени UTC применяется, когда не известен часовой пояс, в котором расположены заказы или станции, или когда заказы или станции расположены в нескольких часовых поясах, а вы хотите, чтобы все значения даты-времени были синхронизированы.

  • Локальное время в местоположенияхЗначения даты и времени, связанные с заказами или станциями, будут находиться в часовом поясе, в котором расположены заказы и станции. Для маршрутов значения даты-времени основываются на часовом поясе, в котором расположено станция начала маршрута. Если у маршрута нет исходной станции, то все заказы и станции на всех маршрутах должны быть в одном часовом поясе. Это значение по умолчанию
  • UTCЗначения даты-времени, связанные с заказами, станциями и маршрутами, находятся в универсальном координированном времени UTC, и не основаны на часовом поясе, где находятся заказы или станции.
String
Разрыв последовательности
(Дополнительный)

Промежуток в числовых значениях, который необходимо оставить в поле Sequence подслоя Заказы между соседними заказами при завершении анализа. Значение действует как множитель для фактической последовательности заказов на каждом маршруте. Например, если разрыв равен 5, то первый заказ на маршруте будет иметь значение 5 в поле Sequence, второй заказ в поле Sequence - 10, третий - 15 и так далее. Этот параметр помогает поддерживать вставку заказов после создания первоначального плана маршрута, поскольку новые заказы могут быть вставлены в промежутки последовательности.

Значение должно быть положительным целым числом. Значение по умолчанию равно 1.

При первом выполнении анализа значения поля Sequence будут заполнены последовательными значениями с использованием указанного промежутка в последовательности. При последующих решениях того же анализа значения поля Sequence существующих заказов будут сохранены, а новые заказы будут вставлены в пробелы, используя доступные целочисленные значения для поля Sequence, которые не используются другими заказами. Если разрыв в последовательности установлен равным 1, значения последовательности всегда будут обновляться до непрерывных значений для каждого решения.

Long
Игнорировать некорректные местоположения заказов при расчете
(Дополнительный)

Указывает, будут ли игнорироваться неверные местоположения заказов.

  • Отмечено - неверные местоположения заказов будут игнорироваться, поэтому анализ будет успешным только при использовании допустимых местоположений.
  • Не отмечено - неверные местоположения заказов не будут игнорироваться, что приведет к сбою анализа. Это значение по умолчанию
Boolean
Форма выходного маршрута
(Дополнительный)

Определяет тип формы, который будет использоваться для объектов маршрута, получаемых в результате анализа.

Независимо от выбранного типа формы на выходе наилучший маршрут всегда определяется по сетевому импедансу, а не по евклидовому расстоянию. Это значит, что различаются только формы маршрута, а не соответствующее им прохождение сети.

  • По сетиПолученные маршруты будут иметь точную форму лежащих в основе источников сети. Выходные данные содержат данные линейных измерений маршрутов. Значения измерений увеличиваются от первой остановки и сохраняют общий импеданс до достижения заданного положения.
  • Без линийДля выходных маршрутов форма не создается.
  • Прямые линииВыходной формой маршрута будет прямая линия, соединяющая остановки.Это значение по умолчанию
String
Построить путевой лист при расчете
(Дополнительный)

Определяет, будут ли создаваться путевые листы в процессе анализа.

  • Отмечено – при расчете будет создан пошаговый путевой лист.
  • Не отмечено – во время расчета не будет создаваться пошаговый путевой лист. Это значение по умолчанию
Boolean

Производные выходные данные

ПодписьОписаниеТип данных
Слой Network Analyst

Новый слой сетевого анализа.

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})
ИмяОписаниеТип данных
network_data_source

Набор сетевых данных или сервис, для которого выполняется сетевой анализ. Для сервиса используйте URL-адрес портала.

Сеть должна иметь по крайней мере один режим перемещения, один атрибут стоимости с единицами измерения времени и один атрибут стоимости с единицами измерения расстояния, а также атрибут часового пояса.

Network Dataset Layer;String
layer_name
(Дополнительный)

Имя слоя сетевого анализа, который будет создан.

String
travel_mode
(Дополнительный)

Имя режима передвижения, используемого для выполнения анализа. Режим передвижения представляет собой набор сетевых настроек, например, ограничений передвижения и правил разворотов, определяющих, как пешеход, легковой или грузовой автомобиль или другое средство транспорта передвигается по сети. Режимы передвижения определяются вашим источником сетевых данных.

Объект arcpy.na.TravelMode и строка, содержащая действительное представление JSON режима перемещения, также могут использоваться как ввод для этого параметра.

Атрибут импеданса режима передвижения должен содержать единицы измерения времени.

String
time_units
(Дополнительный)

Задает единицы измерения времени, которые будут использоваться свойствами слоя анализа и временными полями подслоев и таблиц слоя анализа (классы сетевого анализа). Это значение не обязательно должно соответствовать единицам атрибута временной стоимости.

  • MinutesЕдиницы времени даются в минутах. Это значение по умолчанию
  • SecondsЕдиницы времени даются в секундах.
  • HoursЕдиницы времени даются в часах.
  • DaysЕдиницы времени даются в днях.
String
distance_units
(Дополнительный)

Задает единицы измерения расстояния, которые будут использоваться свойствами слоя анализа и полями расстояний подслоев и таблиц слоя анализа (классы сетевого анализа). Это значение не обязательно должно соответствовать единицам дополнительного атрибута стоимости по расстоянию.

  • MilesЕдиницами измерения расстояния будут мили. Это значение по умолчанию
  • KilometersЕдиницами измерения расстояния будут километры.
  • FeetЕдиницами измерения расстояния будут футы.
  • YardsЕдиницами измерения расстояния будут ярды.
  • MetersЕдиницами измерения расстояния будут метры.
  • InchesЕдиницами измерения расстояния будут дюймы.
  • CentimetersЕдиницами измерения расстояния будут сантиметры.
  • MillimetersЕдиницами измерения расстояния будут миллиметры.
  • DecimetersЕдиницами измерения расстояния будут дециметры.
  • NauticalMilesЕдиницами измерения расстояния будут морские мили.

Внимание:
Опции Inches, Centimeters, Millimeters и Decimeters недоступны, если источником сетевых данных является сервис.

String
earliest_route_start_date
(Дополнительный)

Самая ранняя дата начала маршрута по умолчанию. Эта дата используется для всех маршрутов, для которых в поле EarliestStartDate подслоя Routes находится значение null. Если значение параметра не указано, все строки в подслое Routes должны содержать значение в поле EarliestStartDate.

Задайте значение этого параметра с помощью объекта datetime.date.

Внимание:
Хотя другие механизмы расчета Network Analyst позволяют использовать специальные даты для моделирования дня недели или текущей даты вместо определенной статической даты, механизм расчета доставки до двери этого не делает. Необходимо выбрать определенную дату.

Date
earliest_route_start_time
(Дополнительный)

Самое раннее время начала маршрута по умолчанию. Это время дня используется для всех маршрутов, для которых в поле EarliestStartTime подслоя Routes находится значение null. Если значение параметра не указано, все строки в подслое Routes должны содержать значение в поле EarliestStartTime.

Задайте значение этого параметра с помощью объекта datetime.time.

Date
max_route_total_time
(Дополнительный)

Максимально допустимое общее время каждого маршрута. Это значение может быть любым положительным числом.

Это значение используется для всех маршрутов, для которых в поле MaxTotalTime подслоя Routes находится значение null. Если значение параметра не указано, все строки в подслое Routes должны содержать значение в поле MaxTotalTime.

Значение интерпретируется в единицах, заданных параметром time_units.

Double
time_zone_for_time_fields
(Дополнительный)

Задает часовой пояс входных полей даты-времени, поддерживаемых инструментом.

  • LOCAL_TIME_AT_LOCATIONSЗначения даты и времени, связанные с заказами или станциями, будут находиться в часовом поясе, в котором расположены заказы и станции. Для маршрутов значения даты-времени основываются на часовом поясе, в котором расположено станция начала маршрута. Если у маршрута нет исходной станции, то все заказы и станции на всех маршрутах должны быть в одном часовом поясе. Это значение по умолчанию
  • UTCЗначения даты-времени, связанные с заказами, станциями и маршрутами, находятся в универсальном координированном времени UTC, и не основаны на часовом поясе, где находятся заказы или станции.

Указание значений даты-времени по времени UTC применяется, когда не известен часовой пояс, в котором расположены заказы или станции, или когда заказы или станции расположены в нескольких часовых поясах, а вы хотите, чтобы все значения даты-времени были синхронизированы.

String
sequence_gap
(Дополнительный)

Промежуток в числовых значениях, который необходимо оставить в поле Sequence подслоя Заказы между соседними заказами при завершении анализа. Значение действует как множитель для фактической последовательности заказов на каждом маршруте. Например, если разрыв равен 5, то первый заказ на маршруте будет иметь значение 5 в поле Sequence, второй заказ в поле Sequence - 10, третий - 15 и так далее. Этот параметр помогает поддерживать вставку заказов после создания первоначального плана маршрута, поскольку новые заказы могут быть вставлены в промежутки последовательности.

Значение должно быть положительным целым числом. Значение по умолчанию равно 1.

При первом выполнении анализа значения поля Sequence будут заполнены последовательными значениями с использованием указанного промежутка в последовательности. При последующих решениях того же анализа значения поля Sequence существующих заказов будут сохранены, а новые заказы будут вставлены в пробелы, используя доступные целочисленные значения для поля Sequence, которые не используются другими заказами. Если разрыв в последовательности установлен равным 1, значения последовательности всегда будут обновляться до непрерывных значений для каждого решения.

Long
ignore_invalid_order_locations
(Дополнительный)

Указывает, будут ли игнорироваться неверные местоположения заказов.

  • SKIPНеверные местоположения заказов будут игнорироваться, поэтому анализ будет успешным только при использовании допустимых местоположений.
  • HALTНеверные местоположения заказов не будут игнорироваться, что приведет к сбою анализа. Это значение по умолчанию
Boolean
line_shape
(Дополнительный)

Определяет тип формы, который будет использоваться для объектов маршрута, получаемых в результате анализа.

  • ALONG_NETWORKПолученные маршруты будут иметь точную форму лежащих в основе источников сети. Выходные данные содержат данные линейных измерений маршрутов. Значения измерений увеличиваются от первой остановки и сохраняют общий импеданс до достижения заданного положения.
  • NO_LINESДля выходных маршрутов форма не создается.
  • STRAIGHT_LINESВыходной формой маршрута будет прямая линия, соединяющая остановки.Это значение по умолчанию

Независимо от выбранного типа формы на выходе наилучший маршрут всегда определяется по сетевому импедансу, а не по евклидовому расстоянию. Это значит, что различаются только формы маршрута, а не соответствующее им прохождение сети.

String
generate_directions_on_solve
(Дополнительный)

Определяет, будут ли создаваться путевые листы в процессе анализа.

  • DIRECTIONSПри расчете будет создан пошаговый путевой лист.
  • NO_DIRECTIONSПри расчете не будет создаваться пошаговый путевой лист. Это значение по умолчанию
Boolean

Производные выходные данные

ИмяОписаниеТип данных
out_network_analysis_layer

Новый слой сетевого анализа.

Network Analyst Layer

Пример кода

MakeLastMileDeliveryAnalysisLayer, пример 1 (окно Python)

Запуск инструмента с заданием подмножества параметров.

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"
)

Информация о лицензиях

  • Basic: Да
  • Standard: Да
  • Advanced: Да

Связанные разделы