Построить матрицу Источник-Назначение (Готово к использованию)

Сводка

Инструмент Построить матрицу Источник-Назначение создает матрицу стоимости пути от источника к назначению (OD) из нескольких источников к нескольким назначениям. Матрица Источник-Назначение – это таблица, содержащая время и расстояние в пути от каждого исходного пункта к каждому пункту назначения. Также матрица присваивает ранги пунктам назначения, с которыми в порядке возрастания соединяется каждый начальный пункт на основании минимального времени или расстояния, необходимых для перемещения от данного начального пункта к каждому пункту назначения. Лучший путь по уличной сети определяется для каждой пары источник-назначение, а времена в пути и расстояния сохраняются в таблице атрибутов выходных линий. Несмотря на то, что с целью повышения производительности линии прямые, они всегда хранят время в пути и расстояния вдоль уличной сети, а не прямолинейные расстояния.

Внимание:

Актуальную информацию об инструменте см. в последней версии раздела веб-справки. ArcGIS Online регулярно выполняет функциональные обновления в сервисах, например, установленная на вашем компьютере справка может устареть.

Более подробно о выходных данных инструмента Построить матрицу Источник-Назначение

Иллюстрация

Решение матрицы стоимости Источник-Назначение

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

  • Инструменты в наборе инструментов Готовые к использованию это ArcGIS Onlineсервисы геообработки, которые ArcGIS Online используют данные и возможности анализа .

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

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

  • Вы можете добавить до 250 точечных барьеров. Вы можете добавить любое количество линейных или полигональных барьеров, но линейные барьеры не могут пересекать более 500 объектов-улиц, а полигональные – более 2000 объектов.

  • Вы можете использовать иерархию дорог, что позволит быстрее получить результаты, чем при вычислении точных маршрутов, но полученное решение может быть менее оптимальным.

  • Независимо от того, включен ли параметр Использовать иерархию (True), иерархия всегда используется, если Евклидово расстояние между любой парой остановок составляет более 50 миль (80,46 км).

  • Прямолинейное расстояние между любой парой источник-назначение не может быть больше, чем 50 миль (80,46 километров), при выборе режима передвижения Пешком или Пользовательский с ограничением Пешком.

  • Если расстояние между входной точкой и ближайшей проезжей улицей больше 12.42 миль (20 км), точка исключается из анализа.

  • При использовании этого сервиса расходуются кредиты. Подробнее см. в разделе Обзор сервисных кредитов.

Синтаксис

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})
ParameterОбъяснениеТип данных
Origins

Указывает начальные точки, из которых следует отправиться в пункты назначения.

Вы можете добавить до 1000 начальных точек.

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

Name

Имя источника. Имя может быть уникальным идентификатором исходной точки. Имя включается в выходные линии (как поле OriginName) и в выходные источники (как поле Name ) и может быть использовано для присоединения дополнительной информации из выходных данных инструмента к атрибутам ваших источников.

Если имя не указано, автоматически создается уникальное имя с префиксом Location.

TargetDestinationCount

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

Если это значение не указано, то вместо него используется значение, указанное для параметра Количество назначений для поиска.

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

Cutoff

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

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

CurbApproach

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

  • 0 (С любой стороны) – транспортное средство может отправляться от источника в любом направлении, т.е. в источнике разрешен разворот. Данный параметр можно выбрать, если для вашего транспортного средства возможно и желательно развернуться в источнике. Такое решение может зависеть от ширины дороги и интенсивности движения или от наличия в источнике места для стоянки, где транспортное средство может выполнить разворот.
  • 1 (Справа по направлению движения) – когда транспортное средство отправляется от источника, он должен находиться по правую сторону транспортного средства. Разворот запрещен. Эта опция обычно используется для таких транспортных средств, как автобусы, которые должны отправляться от автобусной остановки так, чтобы она находилась справа.
  • 2 (Слева по направлению движения) – когда транспортное средство отправляется от источника, бордюр должен находиться с левой стороны транспортного средства. Разворот запрещен. Эта опция обычно используется для таких транспортных средств, как автобусы, которые должны отправляться от автобусной остановки так, чтобы она находилась слева.
  • 3 (Разворот запрещен) – для данного инструмента это значение идентично значению 0 (С любой стороны).

Атрибут CurbApproach был разработан для работы с обоими типами национальных стандартов дорожного движения: правостороннего (США) и левостороннего (Великобритания). Сначала рассмотрим случай, когда источник находится с левой стороны транспортного средства. Это условие должно обязательно выполняться в независимости от того движется транспорт по левой или по правой полосе дороги. Вы можете выбрать, с какой из двух сторон отправиться от источника, независимо от национального стандарта дорожного движения, т.е. где будет находится точка заказа – справа или слева от транспортного средства. Например, если необходимо отъехать от источника так, чтобы он не был отделен от транспортного средства полосой движения, необходимо выбрать правую сторону транспортного средства (1) в США, и левую сторону транспортного средства (2) в Великобритании.

Bearing

Направление, в котором движется точка. Единицами измерения являются градусы, отсчитываются по часовой стрелке от истинного севера. Данное поле используется совместно с полем BearingTol.

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

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

Более подробно о направлении и допуске направления

BearingTol

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

Единицами измерения являются градусы; в качестве значения по умолчанию используется 30. Значения должны быть больше 0 и меньше 180. Значение, равное 30, означает, что когда Network Analyst предпринимает попытку добавить сетевое положение на ребро, диапазон допустимых значений направления создается в пределах 15 градусов с каждой стороны ребра (слева и справа) и в обоих направлениях оцифровки ребра.

Более подробно о направлении и допуске направления

NavLatency

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

Единицы NavLatency совпадают с единицами вашего атрибута импеданса.

Feature Set
Destinations

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

Вы можете добавить до 200 1000.

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

Name

Имя – имя пункта назначения. Имя может быть уникальным идентификатором пункта назначения. Имя включается в выходные линии (как поле DestinationName) и в выходные пункты назначения (как поле Name) и может использоваться для присоединения дополнительной информации из выходных данных инструмента к атрибутам ваших пунктов назначения.

Если имя не указано, автоматически создается уникальное имя с префиксом Location.

CurbApproach

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

  • 0 (С любой стороны) – транспортное средство может прибыть в пункт назначения в любом направлении, т.е. в пункте назначения разрешен разворот. Данный параметр можно выбрать, если для вашего транспортного средства возможно и желательно развернуться в пункте назначения. Такое решение может зависеть от ширины дороги и интенсивности движения или от наличия в пункте назначения места для стоянки, где транспортное средство может выполнить разворот.
  • 1 (Справа по направлению движения) – когда транспортное средство прибывает в пункт назначения, пункт назначения должен находиться справа от транспортного средства. Разворот запрещен. Эта опция обычно используется для таких транспортных средств, как автобусы, которые должны отправляться от автобусной остановки так, чтобы она находилась справа.
  • 2 (Слева по направлению движения) – когда транспортное средство прибывает в пункт назначения, бордюр должен находиться слева от транспортного средства. Разворот запрещен. Эта опция обычно используется для таких транспортных средств, как автобусы, которые должны отправляться от автобусной остановки так, чтобы она находилась слева.
  • 3 (Разворот запрещен) – для данного инструмента это значение идентично значению 0 (С любой стороны).

Атрибут CurbApproach был разработан для работы с обоими типами национальных стандартов дорожного движения: правостороннего (США) и левостороннего (Великобритания). Сначала рассмотрим случай, когда источник находится с левой стороны транспортного средства. Это условие должно обязательно выполняться в независимости от того движется транспорт по левой или по правой полосе дороги. Вы можете выбрать, с какой из двух сторон отправиться от источника, независимо от национального стандарта дорожного движения, т.е. где будет находится точка заказа – справа или слева от транспортного средства. Например, если необходимо отъехать от источника так, чтобы он не был отделен от транспортного средства полосой движения, необходимо выбрать правую сторону транспортного средства (1) в США, и левую сторону транспортного средства (2) в Великобритании.

Bearing

Направление, в котором движется точка. Единицами измерения являются градусы, отсчитываются по часовой стрелке от истинного севера. Данное поле используется совместно с полем BearingTol.

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

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

Более подробно о направлении и допуске направления

BearingTol

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

Единицами измерения являются градусы; в качестве значения по умолчанию используется 30. Значения должны быть больше 0 и меньше 180. Значение, равное 30, означает, что когда Network Analyst предпринимает попытку добавить сетевое положение на ребро, диапазон допустимых значений направления создается в пределах 15 градусов с каждой стороны ребра (слева и справа) и в обоих направлениях оцифровки ребра.

Более подробно о направлении и допуске направления

NavLatency

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

Единицы NavLatency совпадают с единицами вашего атрибута импеданса.

Feature Set
Travel_Mode
(Дополнительный)

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

Для получения списка имен поддерживаемых режимов передвижения используйте то же подключение к ГИС-серверу, которое вы использовали для доступа к этому инструменту, и в наборе инструментов Утилиты запустите инструмент GetTravelModes. Инструмент GetTravelModes добавляет в приложение таблицу Поддерживаемых режимов передвижения. В качестве входных данных можно задать любое значение в поле Travel Mode Name таблицы Поддерживаемые режимы передвижения. Вы также можете указать в качестве входного значения значение из поля Travel Mode Settings. Это ускорит выполнение инструмента, поскольку инструмент не будет искать настройки на основании имени режима передвижения.

Пользовательский (значение по умолчанию) – позволяет настроить собственный режим передвижения при помощи параметров этого режима (Развороты в соединениях, Использовать иерархию, Ограничения, Значения Параметров атрибутов и Импеданс). Значения по умолчанию для модели параметров пользовательского режима передвижения на легковом автомобиле. Также можно выбрать Пользовательский и задать указанные выше параметры пользовательского режима передвижения для моделирования быстрой пешей ходьбы или передвижения грузового автомобиля с определенными габаритными (по высоте) и весовыми характеристиками, загруженного определенным опасным грузом. Можете попробовать различные настройки для получения нужных вам результатов анализа. После определения настроек анализа вам необходимо связаться с администратором вашей организации и сохранить эти настройки как часть нового или существующего режима передвижения, чтобы любой пользователь вашей организации мог перезапустить анализ с такими же настройками.

Внимание:

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

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

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

  • SecondsЕдиница времени – секунды.
  • MinutesЕдиница времени – минуты.
  • HoursЕдиница времени – часы.
  • DaysЕдиница времени – дни.
String
Distance_Units
(Дополнительный)

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

  • MetersЕдиницы расстояния – метры.
  • KilometersЕдиницы расстояния – километры.
  • FeetЕдиницы расстояния – футы.
  • YardsЕдиницы расстояния – ярды.
  • MilesЕдиницы расстояния – мили.
  • NauticalMilesЕдиницы расстояния – морские мили.
String
Analysis_Region
(Дополнительный)

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

Чтобы задать регион используйте одно из следующих значений:

  • EuropeРегион анализа - Европа.
  • JapanРегион анализа - Япония.
  • KoreaРегион анализа - Корея.
  • MiddleEastAndAfricaРегион анализа - Ближний Восток и Африка.
  • NorthAmericaРегион анализа - Северная Америка.
  • SouthAmericaРегион анализа - Южная Америка.
  • SouthAsiaРегион анализа - Южная Азия.
  • ThailandРегион анализа - Тайланд.
Прежние версии:

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

  • Greece изменится на Europe
  • India изменится на SouthAsia
  • Oceania изменится на SouthAsia
  • SouthEastAsia изменится на SouthAsia
  • Taiwan изменится на SouthAsia

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

Максимальное число пунктов назначения, которые нужно найти для каждого источника. Если значение для этого параметра не указано, то выходная матрица будет включать стоимости перемещения от каждого источника до каждого пункта назначения. Отдельные источники могут иметь собственные значения (указанные в виде поля TargetDestinationCount), которые будут переписывать значение параметра Количество назначений для поиска.

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

Указывает значение времени в пути или расстояния, при которых следует прекратить поиск пунктов назначения из данного источника. Назначение, выходящее за значение предела, не будет рассматриваться. Отдельные источники могут иметь собственные значения (указанные в виде поля Cutoff), которые будут переписывать значение параметра Предельное значение.

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

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

Указывает время и дату начала маршрутов.

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

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

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

Инструмент игнорирует этот параметр, если в Единицах измерения не выбрано время.

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

Указывает часовой пояс параметра Время суток.

  • Geographically LocalЗначение параметра Время суток относится к часовому поясу, в котором находится первая остановка маршрута. Если вы создаете несколько маршрутов в различных часовых поясах, время начала будет отсчитываться от Всемирного координированного времени (UTC). Например, значение Время суток равное 10:00 утра 2 января, означает время начала маршрута в 10:00 утра по восточному стандартному времени (UTC-3:00) для маршрутов, начинающихся в восточном часовом поясе, и 10:00 утра по центральному стандартному времени (UTC-4: 00) для маршрутов, начинающихся в Центральном часовом поясе. Время начала по UTC будет отличаться на один час. Время и дата прибытия и отправления, записанные в выходном классе объектов-остановок, будут соответствовать часовому поясу первой остановки каждого маршрута.
  • UTCЗначения параметра Время суток указываются во Всемирном координированном времени (UTC). Используйте эту опцию, если вы хотите создать маршрут для определенного времени, например текущего, но точно не знаете, в каком часовом поясе будет находиться первая остановка. Если вы создаете несколько маршрутов, охватывающих различные часовые пояса, время начала по UTC будет синхронизировано. Например, значение Время дня равное 10:00 утра 2 января, означает время начала маршрута в 5:00 утра по восточному стандартному времени (UTC-5:00) для маршрутов, начинающихся в восточном часовом поясе, и 4:00 утра по центральному стандартному времени (UTC-6: 00) для маршрутов, начинающихся в центральном часовом поясе. Оба маршрута начнутся в 10:00 утра по UTC. Время и дата прибытия и отправления, записанные в выходном классе объектов-остановок, будут соответствовать времени UTC.
String
Point_Barriers

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

Инструмент может накладывать ограничение до 250 точек, добавленных в качестве барьеров.

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

Name

Имя барьера.

BarrierType

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

  • 0 (Запрет) – Запрещает прохождение через барьер. Барьер, действующий как запрещающий, рассматривается как ограничительный точечный барьер.

  • 2 (добавленная стоимость) – прохождение через барьер увеличивает время в пути или расстояние на значение, указанное в полях Additional_Time, Additional_Distance и Additional_Cost. Этот тип барьера называется барьером дополнительной стоимости.

Additional_Time

Время поездки, которое добавляется при прохождении барьера. Это поле применимо только для барьеров дополнительной стоимости.

Значение этого поля должно быть больше или равно нулю, а его единицы измерения соответствуют заданным в параметре Единицы измерения.

Additional_Distance

Расстояние, которое добавляется при прохождении барьера. Это поле применимо только для барьеров дополнительной стоимости.

Значение этого поля должно быть больше или равно нулю, а его единицы измерения соответствуют заданным в параметре Единицы измерения.

Additional_Cost

Стоимость поездки, которая добавляется при прохождении барьера. Это поле применимо только для барьеров дополнительной стоимости.

FullEdge

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

  • (0) False – разрешает путь по ребру до барьера, но не через него. Это значение используется по умолчанию.
  • 1 (True) – Запрещает путь повсюду в связанном ребре.

CurbApproach

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

  • 0 (Любая сторона транспортного средства) – Барьер влияет на перемещение по ребру в обоих направлениях.
  • 1 (Правая сторона транспортного средства) – Распространяется только на те транспортные средства, для которых барьер находится с правой стороны по ходу движения. Барьер не влияет на автомобили, которые передвигаются по этому же ребру, но при этом барьер находится слева от них.
  • 2 (Левая сторона транспортного средства) – Распространяется только на те транспортные средства, для которых барьер находится с левой стороны по ходу движения. Барьер не распространяется на автомобили, которые передвигаются по этому же ребру, но при этом барьер находится справа от них.

Так как соединения являются точками и не имеют сторон, барьеры на соединениях влияют на все транспортные средства независимо от стороны подъезда.

Свойство CurbApproach было разработано для работы с обоими типами национальных стандартов дорожного движения: правостороннего (США) и левостороннего (Великобритания). Сначала рассмотрим случай, когда пункт обслуживания располагается с левой стороны транспортного средства. Это условие должно обязательно выполняться в независимости от того движется транспорт по левой или по правой полосе дороги. От национального стандарта дорожного движения будет зависеть ваше решение, с какой из двух сторон подъехать к пункту обслуживания, т.е. должен ли он находиться с правой или левой стороны транспортного средства. Например, если необходимо подъехать к пункту обслуживания так, чтобы он не был отделен от транспортного средства полосой движения, необходимо выбрать правую сторону транспортного средства (1) в США, и левую сторону транспортного средства (2) в Великобритании.

Bearing

Направление, в котором движется точка. Единицами измерения являются градусы, отсчитываются по часовой стрелке от истинного севера. Данное поле используется совместно с полем BearingTol.

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

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

Более подробно о направлении и допуске направления

BearingTol

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

Единицами измерения являются градусы; в качестве значения по умолчанию используется 30. Значения должны быть больше 0 и меньше 180. Значение, равное 30, означает, что когда Network Analyst предпринимает попытку добавить сетевое положение на ребро, диапазон допустимых значений направления создается в пределах 15 градусов с каждой стороны ребра (слева и справа) и в обоих направлениях оцифровки ребра.

Более подробно о направлении и допуске направления

NavLatency

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

Единицы NavLatency совпадают с единицами вашего атрибута импеданса.

Feature Set
Line_Barriers

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

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

При указании линейных барьеров вы можете задать свойства имени и типа барьера для каждого из них с помощью атрибутов:

Name

Имя барьера.

Feature Set
Polygon_Barriers

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

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

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

Name

Имя барьера.

BarrierType

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

  • 0 (Ограничение) – запрещает прохождение через любую часть барьера. Этот барьер называется запрещающим полигональным барьером, поскольку он запрещает перемещение по пересекаемым улицам. Одним из применений этого типа барьеров является моделирование наводнений, покрывающих улицы, и перемещение по ним становится невозможным.

  • 1 (Масштабированная стоимость) – масштабирует стоимость перемещения (время в пути или расстояние) по соответствующим улицам на коэффициент, указанный в поле ScaledTimeFactor или ScaledDistanceFactor. Если улицы частично покрыты барьером, время в пути или расстояние будет соответственно разделены, а затем масштабированы. Например, коэффициент 0,25 означает, что ожидаемое время перемещения по соответствующим улицам в четыре раза меньше обычного. Коэффициент 3,0 означает, что ожидаемое время перемещения будет в три раза дольше обычного. Этот тип барьера называется полигональным барьером масштабируемой стоимости. Он может использоваться для моделирования погодных условий, из-за которых скорость перемещения в указанных регионах снижается.

ScaledTimeFactor

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

Это поле применимо только для барьеров масштабированной стоимости.

ScaledDistanceFactor

Это коэффициент, на который умножается длина пути по улицам, пересеченным барьером. Значение поля должно быть больше нуля.

Это поле применимо только для барьеров масштабированной стоимости.

ScaledCostFactor

Это коэффициент, на который умножается стоимость пути по улицам, пересеченным барьером. Значение поля должно быть больше нуля.

Это поле применимо только для барьеров масштабированной стоимости.

Feature Set
UTurn_at_Junctions
(Дополнительный)

Определяет поведение при развороте на перекрестках. При разрешении разворотов неявно предполагается, что механизм расчета позволяет поворот на соединении и продолжение движения по той же улице в обратную сторону. Учитывая, что соединения представляют собой пересечения улиц и тупики, различные транспортные средства могут разворачиваться на некоторых соединениях, но не на всех – это зависит от того, является ли соединение перекрестком или тупиком. Чтобы учесть это, поведение при развороте неявно определяется числом ребер, которые соединяются с соединением, т.е. валентностью соединения. Ниже приведены допустимые значения для данного параметра; каждое из них сопровождается описанием значения в терминах валентности соединения.

  • AllowedРазвороты разрешены в соединениях с любым количеством смежных ребер. Это значение используется по умолчанию.
  • Not AllowedРазвороты запрещены во всех соединениях, вне зависимости от их валентности. Обратите внимание, что, даже при выборе этой опции развороты в сетевых положениях по-прежнему разрешены. Запретить развороты в отдельных сетевых положениях можно с помощью свойства местоположения CurbApproach.
  • Allowed Only at Dead EndsРазвороты запрещены во всех соединениях, кроме тех, у которых имеется только одно смежное ребро (тупик).
  • Allowed Only at Intersections and Dead EndsРазвороты запрещены в соединениях с ровно двумя смежными ребрами, но разрешены на перекрестках (в соединениях с тремя смежными ребрами или более) и в тупиках (соединениях с ровно одним смежным ребром). Часто сети имеют избыточные соединения в середине сегмента дороги. Эта опция позволяет запретить развороты транспортных средств в таких местах.

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

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

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

  • Отмечено (True в Python) – при поиске маршрутов будет использоваться иерархия. Когда используется иерархия, инструмент предпочитает улицы более высокого порядка, такие как скоростные автострады, улицам более низкого порядка, таким как местные дороги, и может использоваться для моделирования предпочтения водителей передвигаться по автострадам, а не местным дорогам, даже если это удлиняет путь. Особенно это относится к тем случаям, когда нужно определить маршруты к удаленным местам, поскольку водители предпочитают использовать в дальних поездках скоростные автострады без светофоров, перекрестков и поворотов. Использование иерархии ускоряет вычисления, особенно в случае междугородних поездок, поскольку инструмент выбирает лучший маршрут из сравнительно небольшого поднабора улиц.
  • Не отмечено (False в Python) – при поиске маршрутов будет не использоваться иерархия. Если иерархия не используется, инструмент перебирает при определении маршрута все улицы и не отдает предпочтение улицам более высокого порядка. Этот вариант обычно используется при нахождении коротких маршрутов в пределах города.

Инструмент автоматически начинает использовать иерархию, если расстояние по прямой между пунктами обслуживания и точками спроса превышает 50 миль (80,46 км), даже если в этом параметре указано иное (укажите False в Python).

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

Boolean
Restrictions
[Restrictions,...]
(Дополнительный)

Ограничения, которые должны учитываться инструментом при нахождении наилучшего маршрута.

Ограничение представляет собой предпочтение или требование во время поездки. В большинстве случаев ограничения запрещают использование тех или иных дорог. Например, использование ограничения Избегать платных дорог приведет к тому, что платные дороги будут использоваться, только если это абсолютно необходимо для подъезда к инциденту или пункту обслуживания. Ограничение по высоте позволяет прокладывать маршрут в обход всех объектов с пролетами, меньшими, чем высота транспортного средства. Если транспортное средство перевозит коррозионные вещества, применение ограничения Any Hazmat Prohibited (Вредные вещества запрещены) предотвратит перевозку таких материалов по тем дорогам, по которым это запрещено.

Примечание:

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

Примечание:

Использование некоторых ограничений требует ввода дополнительных значений. Это значение должно быть связано с именем ограничения и определенным параметром, предназначенным для его работы. Вы можете идентифицировать такие ограничения по их названиям, отображающимся под столбцом AttributeName в параметре Attribute Parameter Values. Поле ParameterValue следует использовать в параметре Attribute Parameter Values для правильного использования ограничения при поиске доступных дорог.

Примечание:

Некоторые ограничения поддерживаются только в определенных странах; их доступность по регионам указана в списке ниже. Кроме доступности ограничений по регионам, можно проверить его доступность в определенной стране по таблице в разделе Список стран Покрытия сетевого анализа. Если для страны указано значениеYes в столбце Атрибуты логистики, то будут проверены ограничения, которые есть для всего региона, в котором находится страна. Если вы задаете имена ограничений, которые недоступны в стране, где находятся инциденты, сервис игнорирует их. Сервис также игнорирует ограничения, где значение параметра Использование ограничений находится в пределах от 0 до 1 (см. параметр Значение параметра атрибутов). Он запрещает все ограничения, чье значение параметра Использование ограничения больше 0.

Инструмент поддерживает следующие ограничения:

  • Any Hazmat ProhibitedВ маршрут не включаются дороги, по которым запрещена перевозка любых видов опасных веществ. Доступность: Выберите страны в Северной Америке и Европе
  • Avoid Carpool RoadsВ маршрут не будут включаться дороги, предназначенные исключительно для пассажирских перевозок (автобусы и т.д.). Доступность: Все страны
  • Avoid Express LanesВ маршрут не будут включаться дороги, предназначенные для скоростного передвижения. Доступность: Все страны
  • Avoid FerriesВ маршруте не будут использоваться паромные переправы. Доступность: Все страны
  • Avoid GatesВ маршрут не будут включаться дороги, на которых имеются ворота для въезда по пропуску или охраняемые въезды.Доступность: Все страны
  • Avoid Limited Access RoadsВ маршрут не будут включаться дороги с ограниченным доступом.Доступность: Все страны
  • Avoid Private RoadsВ маршрут не будут включаться частные дороги.Доступность: Все страны
  • Avoid Roads Unsuitable for PedestriansВ маршрут не будут включаться дороги, не предназначенные для движения по ним пешеходов.Доступность: Все страны
  • Avoid StairwaysВ маршрут для пешехода не будут включаться все лестницы.Доступность: Все страны
  • Avoid Toll RoadsВ маршруте для легковых автомобилей не будут использоваться платные дороги.Доступность: Все страны
  • Avoid Toll Roads for TrucksВ маршруте для легковых автомобилей не будут использоваться платные дороги.Доступность: Все страны
  • Avoid Truck Restricted RoadsВ результатах будут отсутствовать соответствующие дороги если только на них не находится точка доставки.Доступность: Все страны
  • Avoid Unpaved RoadsВ маршрут не будут включаться дороги без покрытия (например, грунтовые, с гравийным покрытием и т.д.). Доступность: Все страны
  • Axle Count RestrictionВ маршрут не будут включаться дороги, на которых запрещены грузовики с указанным числом осей. Число осей задается параметром Number of Axles.Доступность: Выберите страны в Северной Америке и Европе
  • Driving a BusВ маршрут не будут включаться дороги, по которым запрещено перемещение на автобусах. Использование этого ограничения также позволяет учитывать в маршруте дороги с односторонним движением. Доступность: Все страны
  • Driving a TaxiВ маршрут не будут включаться дороги, по которым запрещено перемещение на такси. Использование этого ограничения также позволяет учитывать в маршруте дороги с односторонним движением. Доступность: Все страны
  • Driving a TruckВ маршрут не будут включаться дороги, по которым запрещено перемещение на грузовиках. Использование этого ограничения также позволяет учитывать в маршруте дороги с односторонним движением. Доступность: Все страны
  • Driving an AutomobileВ маршрут не будут включаться дороги, по которым запрещено перемещение на автомобилях. Использование этого ограничения также позволяет учитывать в маршруте дороги с односторонним движением. Доступность: Все страны
  • Driving an Emergency VehicleВ маршрут не будут включаться дороги, по которым запрещено перемещение аварийно-спасательных автомобилей. Использование этого ограничения также позволяет учитывать в маршруте дороги с односторонним движением.Доступность: Все страны
  • Height RestrictionВ маршрут не будут включаться дороги, по которым запрещено движение автомобилей больше разрешенной высоты. Высота транспортного средства задается параметром Vehicle Height (в метрах). Доступность: Выберите страны в Северной Америке и Европе
  • Kingpin to Rear Axle Length RestrictionВ маршрут не будут включаться дороги, по которым запрещено движение всех грузовиков с шириной заноса задней оси больше разрешенной. Это значение задается параметром Vehicle Kingpin to Rear Axle Length (метры). Доступность: Выберите страны в Северной Америке и Европе
  • Length RestrictionВ маршрут не будут включаться дороги, по которым запрещено движение автомобилей больше разрешенной длины. Длина транспортного средства задается параметром Vehicle Length (в метрах). Доступность: Выберите страны в Северной Америке и Европе
  • Preferred for PedestriansВ маршрут будут предпочтительно включаться дороги, подходящие для передвижения пешеходов. Доступность: Выберите страны в Северной Америке и Европе
  • Riding a MotorcycleВ маршрут не будут включаться дороги, по которым запрещено перемещение на мотоциклах. Использование этого ограничения также позволяет учитывать в маршруте дороги с односторонним движением.Доступность: Все страны
  • Roads Under Construction ProhibitedВ маршрут не будут включаться ремонтируемые дороги.Доступность: Все страны
  • Semi or Tractor with One or More Trailers ProhibitedВ маршрут не будут включаться дороги, на которых запрещено движение тягачей с одним или более трейлерами. Доступность: Выберите страны в Северной Америке и Европе
  • Single Axle Vehicles ProhibitedВ маршрут не будут включаться дороги, на которых запрещены одноосные транспортные средства.Доступность: Выберите страны в Северной Америке и Европе
  • Tandem Axle Vehicles ProhibitedВ маршрут не будут включаться дороги, на которых запрещены транспортные средства со сдвоенными осями.Доступность: Выберите страны в Северной Америке и Европе
  • Through Traffic ProhibitedВ маршрут не включаются дороги, по которым запрещен сквозной (не локальный) проезд.Доступность: Все страны
  • Truck with Trailers RestrictionВ маршрут не будут включаться дороги, на которых запрещены грузовики с прицепом. Число прицепов задается параметром Number of Trailers on Truck.Доступность: Выберите страны в Северной Америке и Европе
  • Use Preferred Hazmat RoutesМаршрут пройдет по дорогам, которые предназначены для перевозки опасных веществ. Доступность: Выберите страны в Северной Америке и Европе
  • Use Preferred Truck RoutesМаршруты будут, по возможности, проходить по дорогам, которые предназначены для грузовиков, например, по дорогам, которые являются частью национальной дорожной сети, как указано в National Surface Transportation Assistance Act для США, или по дорогам, которые предназначены для грузовиков в штатах или провинциях, или по дорогам, которые предпочитают водители.Доступность: Выберите страны в Северной Америке и Европе
  • WalkingВ маршрут не будут включаться дороги, по которым запрещено перемещение пешеходов.Доступность: Все страны
  • Weight RestrictionВ маршрут не будут включаться дороги, по которым запрещено движение автомобилей больше разрешенной массы. Вес транспортного средства задается параметром Vehicle Weight (в килограммах).Доступность: Выберите страны в Северной Америке и Европе
  • Weight per Axle RestrictionВ маршрут не будут включаться дороги, по которым запрещено движение автомобилей с нагрузкой на ось больше разрешенной. Нагрузка на ось задается параметром Vehicle Weight per Axle (в килограммах).Доступность: Выберите страны в Северной Америке и Европе
  • Width RestrictionВ маршрут не будут включаться дороги, по которым запрещено движение автомобилей больше разрешенной ширины. Ширина транспортного средства задается параметром Vehicle Width (в метрах).Доступность: Выберите страны в Северной Америке и Европе
String
Attribute_Parameter_Values
(Дополнительный)

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

Примечание:

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

Если вы задаете параметр Значения атрибутивного параметра из класса пространственных объектов, имена полей класса пространственных объектов должны соответствовать следующим:

  • AttributeName – указывает имя ограничения.
  • ParameterName – имя параметра, связанного с ограничением. В зависимости от целей ограничения, оно может иметь одно или несколько значений поля ParameterName.
  • ParameterValue - значение для ParameterName, используемое инструментом при оценке ограничения.

Значения атрибутивного параметра зависят от параметра Ограничения. Поле ParameterValue применяется, только если в качестве значения параметра Ограничения указано имя ограничения.

В параметре Значения атрибутивного параметра каждое ограничение (указанное, как AttributeName) содержит значение поля ParameterName, Использование ограничения, определяющее запрет, нежелательность или предпочтительность использования дорог, для которых установлено ограничение, а также степень нежелательности или предпочтительности использования дорог. Поле Использование ограничения ParameterName может иметь одно из следующих строковых значений или эквивалентных числовых значений, указанных в скобках:

  • PROHIBITED (-1) – передвижение по дорогам, имеющим это ограничение, полностью запрещено.
  • AVOID_HIGH (5) – Крайне маловероятно, что инструмент включит в маршрут дороги с этим ограничением.
  • AVOID_MEDIUM (2) – маловероятно, что инструмент включит в маршрут дороги с этим ограничением.
  • AVOID_LOW (1.3) – достаточно маловероятно, что инструмент включит в маршрут дороги с этим ограничением.
  • PREFER_LOW (0.8) – достаточно вероятно, что инструмент включит в маршрут дороги с этим ограничением.
  • PREFER_MEDIUM (0,5) – вероятно, что инструмент включит в маршрут дороги с этим ограничением.
  • PREFER_HIGH (0,2) – Крайне вероятно, что инструмент включит в маршрут дороги с этим ограничением.

Как правило, для поля Использование ограничения используется значение по умолчанию, PROHIBITED, если ограничение связано с характеристиками транспортного средства, например, с его высотой. Однако в некоторых случаях значение поля Использование ограничения будет зависеть от ваших предпочтений при выборе маршрута. Например, для ограничения Избегать платных дорог параметр Использование ограничения имеет по умолчанию значение AVOID_MEDIUM. Это означает, что, при наличии данного ограничения инструмент будет по возможности избегать использования платных дорог при построении маршрута. Значение AVOID_MEDIUM также указывает, насколько важно избегать использования платных дорог при поиске лучшего маршрута: это ограничение имеет средний приоритет. При выборе AVOID_LOW исключение платных дорог из маршрута будет иметь меньшее значение, а при выборе AVOID_HIGH – большее, поэтому сервис будет создавать более длинные маршруты, чтобы по возможности избежать использования платных дорог. При выборе PROHIBITED использование платных дорог будет полностью запрещено, и сервис не сможет включать их даже частично в маршрут. Имейте в виду, что в некоторых ситуациях важно избежать или запретить платные дороги, чтобы избежать платы за проезд. И наоборот, другие предпочитают ездить по платным дорогам, потому что движение без пробок для них более ценно, чем деньги, потраченные на платные дороги. В последнем случае для параметра Использование ограничения следует выбрать значения PREFER_LOW, PREFER_MEDIUM или PREFER_HIGH. Чем выше предпочтительность, тем в большей степени маршрут будет проходить по дорогам с этим ограничением.

Record Set
Impedance
(Дополнительный)

Задайте импеданс - значение, представляющее затраты или стоимость перемещения вдоль сегментов дорог или других частей транспортной сети.

Время в пути - это импеданс: для того чтобы проехать 1 милю по пустой дороге, машине может понадобиться минута. Время в пути может зависеть от режима перемещения: ту же милю пешеход пройдет за 20 минут, поэтому важно выбрать правильный импеданс для моделируемого режима.

Расстояние перемещения – это импеданс; длина дороги в километрах рассматривается как импеданс. В этом смысле расстояние аналогично для всех режимов – километр останется километром и для пешехода, и для машины. (Что может измениться, так это пути, по которым разрешено перемещаться в различных режимах, что влияет на расстояние между точками и моделируется настройками режима передвижения.)

Внимание:

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

  • TravelTimeИспользуются данные исторического трафика или трафика в режиме реального времени. Эта опция применяется для моделирования времени, которое требуется автомобилю для передвижения по дорогам в определенное время суток, при использовании данных текущего трафика, где это доступно. При использовании TravelTime вы можете дополнительно указать параметр TravelTime::Vehicle Maximum Speed (km/h), чтобы задать физическое ограничение скорости движения транспортного средства.
  • MinutesДанные о трафике в режиме реального времени не используются, но при этом используются средние исторические скорости передвижения автомобилей на данном участке.
  • TruckTravelTimeИспользуются данные исторического трафика или трафика в режиме реального времени, но скорость адаптирована в соответствии с максимальной разрешенной скоростью для грузовиков. Это применяется для моделирования времени, которое требуется грузовику для передвижения по дорогам в определенное время суток. При использовании TruckTravelTime вы можете дополнительно указать параметр TruckTravelTime::Vehicle Maximum Speed (km/h), чтобы задать физическое ограничение скорости движения грузовика.
  • TruckMinutesНе использует трафик в реальном времени, расчет выполняется на основе самой маленькой исторической средней скорости автомобилей и максимально допустимой скорости, заданной на каждом участке дорог, для грузовиков.
  • WalkTimeПо умолчанию задает скорость передвижения пешехода равной 5 км/ч, но это значение можно изменить с помощью параметра WalkTime::Walking Speed (km/h).
  • MilesХранит измерений длин дорог в милях и может использоваться при выполнении анализа, основанного на кратчайшем расстоянии
  • KilometersХранит измерений длин дорог в километрах и может использоваться при выполнении анализа, основанного на кратчайшем расстоянии.
  • TimeAt1KPHПо умолчанию скорость равна 1 км/ч на всех дорогах и путях. Эту скорость нельзя изменить с помощью атрибутивных параметров.
  • Drive TimeМоделирует время в пути на автомобиле. Это время является динамичным и изменяется в зависимости от транспортных потоков, если доступны данные трафика Это значение используется по умолчанию.
  • Truck TimeМоделирует время в пути на грузовике. Это время является статичным для каждой дороги и не зависит от трафика.
  • Walk TimeМоделирует время в пути пешехода.
  • Travel DistanceХранит измерения длин дорог и путей. Для моделирования расстояния пешком выберите эту опцию и убедитесь, что Пешком задано в параметре Ограничение. Аналогично, для моделирования расстояния поездки на машине или грузовике выберите здесь Расстояние пути и задайте соответствующие ограничения, чтобы транспортное средство перемещалось только по тем дорогам, по которым для разрешено движение.

Если вы выбираете импеданс, основанный на времени, например, TravelTime, TruckTravelTime, Minutes, TruckMinutes или WalkTime, то параметр Единицы измерения также должен быть указан для времени. Если вы выбираете импеданс, основанный на расстоянии, например, Miles или Kilometers, то Единицы измерения также должны указывать расстояние.

Прежние версии:

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

String
Origin_Destination_Line_Shape

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

  • Straight LineПрямые линии соединяют источники с пунктами назначения.
  • NoneНе возвращает никакой геометрии для линий, соединяющих источники и пункты назначений. Это удобно при большом количестве исходных и конечных пунктов, когда необходимо получить только табличные данные (без линий маршрутов).
String
Save_Output_Network_Analysis_Layer
(Дополнительный)

Указывает, будут ли параметры анализа сохранены в виде файла слоя сетевого анализа. Вы не можете работать с этим файлом напрямую, даже если вы откроете его в приложении ArcGIS Desktop, например, в ArcMap. Это предназначено для отправки в техническую поддержку Esri для диагностики качества результатов, получаемых инструментом.

  • Отмечено (True в Python) – результат будет сохранен в виде файла слоя сетевого анализа. Файл загружается в временную директорию вашего компьютера. В ArcGIS Pro местоположение загруженного файла можно определить, просмотрев значение параметра Выходной слой сетевого анализа в соответствующей строке отчета о выполнении инструмента в Истории геообработки на панели Проект. В ArcMap местоположение загруженного файла можно определить с помощью опции Копировать местоположение ниспадающего меню параметра Выходной слой сетевого анализа в соответствующей строке отчета о выполнении инструмента в окне Результаты геообработки.
  • Не отмечено (False в Python) – результат не будет сохранен в виде файла слоя сетевого анализа. Это значение по умолчанию.

Boolean
Overrides
(Дополнительный)

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

Значение этого параметра должно быть задано в JavaScript Object Notation (JSON). К примеру, допустимое значение имеет следующий вид: {"overrideSetting1" : "value1", "overrideSetting2" : "value2"}. Замещающее имя всегда заключено в двойные кавычки. Эти значения могут быть числовыми, булевыми или текстовыми.

Значение по умолчанию является пустым, что означает отсутствие замещения каких-либо настроек механизма расчета.

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

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

Импеданс на основе времени - это значение, которое задает время перемещения вдоль сегментов дорог или других частей транспортной сети.

Примечание:
Если импеданс для режима перемещения, указанный с помощью параметра Импеданс, основан на времени, значения параметров Импеданс времени и Импеданс должны быть идентичны. В противном случае сервис выдаст ошибку.
  • MinutesИмпеданс времени - минуты.
  • TravelTimeИмпеданс времени - время пути.
  • TimeAt1KPHИмпеданс времени - время при одном км в час.
  • WalkTimeИмпеданс времени - время пешком.
  • TruckMinutesИмпеданс времени - минуты на грузовике.
  • TruckTravelTimeИмпеданс времени - время пути на грузовике.
String
Distance_Impedance
(Дополнительный)

Импеданс на основе расстояния - это значение, которое задает расстояние перемещения вдоль сегментов дорог или других частей транспортной сети.

Примечание:
Если импеданс для режима перемещения, указанный с помощью параметра Импеданс, основан на расстоянии, значения параметров Импеданс расстояния и Импеданс должны быть идентичными. В противном случае сервис выдаст ошибку.
  • MilesИмпеданс расстояния в милях.
  • KilometersИмпеданс расстояния в километрах.
String
Output_Format
(Дополнительный)

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

  • Feature SetВыходные объекты возвращаются в виде классов объектов и таблиц. Это значение по умолчанию
  • JSON FileВыходные объекты возвращаются в виде сжатого файла, содержащего представление JSON выходных данных. Если выбрана эта опция, на выходе будет один файл (с расширением .zip), содержащий один или несколько файлов JSON (с расширением .json) - для каждого созданного сервисом выходного набора.
  • GeoJSON FileВыходные объекты возвращаются в виде сжатого файла, содержащего представление JSON выходных данных. Если выбрана эта опция, на выходе будет один файл (с расширением .zip), содержащий один или несколько файлов GeoJSON (с расширением .geojson) - для каждого созданного сервисом выходного набора.
  • CSV FileВыходные объекты будут возвращены в виде сжатого файла, содержащего представление выходных данных в виде значений, разделенных запятыми (CSV). Если этот параметр задан, выходные данные представляют собой один файл (с расширением .zip), содержащий один или несколько CSV-файлов (с расширением .csv) для каждого из выходных данных, созданных сервисом.

Если задан файловой выходной формат, например, файл JSON или файл GeoJSON, к отображению не будут добавлены выходные данные, так как приложения, такие как ArcMap или ArcGIS Pro, не знают, как отобразить содержимое полученного файла. Вместо этого файл загружается во временную директорию вашего компьютера. В ArcGIS Pro местоположение загруженного файла можно определить, просмотрев значение параметра Выходной результирующий файлв соответствующей строке отчета о выполнении инструмента в Истории геообработки на панели Проект. В ArcMap местоположение загруженного файла можно определить с помощью опции Копировать местоположение ниспадающего меню параметра Выходной результирующий файл в соответствующей строке отчета о выполнении инструмента в окне Результаты геообработки.

String

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

NameОбъяснениеТип данных
Solve_Succeeded

Определяет, успешно ли сервис создал матрицу стоимости источник-назначение.

Логическое
Output_Origin_Destination_Lines

Обеспечивает доступ к линиям, соединяющим источники и назначения.

Набор объектов
Output_Origins

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

Набор объектов
Output_Destinations

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

Набор объектов
Output_Network_Analysis_Layer

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

Файл
Output_Result_File

Файл .zip, содержащий результаты анализа, с одним или несколькими файлами для каждого результата. Формат отдельного файла задается параметром Выходной формат.

Файл

Пример кода

GenerateOriginDestinationCostMatrix, пример (автономный скрипт)

Следующий скрипт Python демонстрирует, как использовать инструмент Generate Origin Destination Cost Matrix в скрипте.

"""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.GenerateOriginDestinationCostMatrix_OriginDestinationCostMatrix(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)
GenerateOriginDestinationCostMatrix, пример 2 (автономный скрипт)

В следующем примере показано, как выполнить анализ матрицы стоимости Источник-Назначение, используя пользовательский режим передвижения.

"""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.GenerateOriginDestinationCostMatrix_OriginDestinationCostMatrix(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)

Environments

Этот инструмент не использует параметры среды геообработки

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