После успешного выполнения FindRoutes, сервис возвращает наилучшие маршруты между остановками, а также статус успешности анализа, используя выходные параметры описанные ниже.
output_routes
Обеспечивает доступ к построенным маршрутам.
Ниже в таблице приведен список полей, возвращаемых для выходных маршрутов:
| Поле | Описание |
|---|---|
Name | Имя маршрута основано на поле RouteName соответствующих остановок. Если входное поле RouteName не заполнено, имя составляется из значений поля Name первой и последней остановок. |
StopCount | Число остановок, назначенных маршруту. |
StartTime | Время начала маршрута, сообщаемое как местное время в первой остановке. |
EndTime | Время окончания маршрута, сообщаемое как местное время в последней остановке. |
StartTimeUTC | Время начала маршрута дается в формате Всемирного координированного времени (UTC). |
EndTimeUTC | Время окончания маршрута в формате Всемирного координированного времени (UTC). |
Total_Minutes | Суммарное время перемещения в минутах от начала первой остановки до окончания последней остановки на маршруте. Оно включает все значения AdditionalTime для посещенных остановок, если они заданы. |
Total_Miles | Суммарное расстояние перемещения в милях от начала первой остановки до окончания последней остановки на маршруте. Оно включает все значения AdditionalDistance для посещенных остановок, если они заданы. |
Total_Kilometers | Суммарное расстояние перемещения в километрах от начала первой остановки до окончания последней остановки на маршруте. Оно включает все значения AdditionalDistance для посещенных остановок, если они заданы. |
Total_Other | Суммарная стоимость перемещения в неизвестных единицах от начала первой остановки до окончания последней остановки на маршруте. Оно включает все значения AdditionalCost для посещенных остановок, если они заданы. Это поле используется только, если режим передвижения, применяемый для анализа, использует атрибут импеданса, основанный ни на времени, ни на расстоянии. |
TotalWait_Minutes | В этом поле хранится общее время ожидания на маршруте, то есть время, проведенное на остановках в ожидании открытия временных окон. В поле указывается пустое значение, если в анализе не используются временные окна. |
TotalViolation_Minutes | В этом поле хранится общее время нарушений маршрута на остановках. Время превышения добавляется при прибытии маршрута на остановку после окончания временного окна, это разница между значениями в полях ArriveTime и TimeWindowEnd входных остановок. В поле указывается пустое значение, если в анализе не используются временные окна. Дополнительные поля TotalViolation_[AccumulateAttributeName]_[TimeUnits] включаются в результат для каждого атрибута стоимости на основе времени, накапливаемого в ходе анализа. |
FirstStopOID | Значение ObjectID первой остановки маршрута. Это поле часто используется для присоединения к маршруту информации из входных остановок. |
LastStopOID | Значение ObjectID последней остановки маршрута. Это поле часто используется для присоединения к маршруту информации из входных остановок. |
output_directions
Обеспечивает доступ к пошаговому путевому листу для каждого маршрута.
Форма объектов путевого листа определяется геометрией улиц, лежащих в основе маршрута.
Параметры Язык путевого листа, Единицы измерения расстояний путевого листа и Имя стиля путевого листа определяют путевой лист перемещения. Параметр возвращает пустые объекты, если параметр Заполнить путевой лист задан как False.
Ниже приведена таблица со списком полей, возвращаемых для выходного путевого листа:
| Поле | Описание |
|---|---|
RouteName | Название маршрута, к которому применяется действие перемещения. Значение совпадает с полем Name выходных маршрутов. |
ArriveTime | Время дня для начала заданного действия перемещения. Если маршрут выполняется за несколько дней, то отображается дата и время дня. |
Type | Тип маневра, представленного объектом путевого листа, или типом текста путевого листа. Чтобы определить, обозначает ли Type тип маневра или тип строки путевого листа, необходимо проверить значение поля SubItemType. Type может использоваться, например, для присвоения значка тексту направления, в зависимости от типа маневра, или для применения специального стиля форматирования, основанного на типе строки направления, при отображении направлений движения в вашем приложении. Значение Type это целое число из списков Типы маневров или Типы строк путевого листа, приведенных ниже. Типы маневров
Типы строк путевого листа
|
SubItemType | Указывает, содержит ли поле Type целое число из таблиц Типы маневров или Типы строк путевого листа,
|
Text | Текстовое описание путевого листа. |
ElaspsedTime | Время, в минутах, прошедшее с начала движения по текущему направлению до начала следующего или до тех пор, пока маршрут не закончится на последнем участке путевого листа |
DriveDistance | Расстояние, с которого началось текущее направление движения до начала следующего или до места, где маршрут закончится на последнем направлении движения. Значения указаны в единицах, заданных в параметре Directions_Distance_Units. Данное значение равно нулю для направлений движения, которые происходят том же положении, где начинается другое. Например, DriveDistance равно 0 для текста путевого листа в начале маршрута. |
output_direction_points
Задает выходные пошаговые направления для маршрутов, вычисленных в ходе анализа, представленные в виде точечных местоположений вдоль маршрутов, где происходят определенные события или маневры.
| Имя поля | Описание |
|---|---|
RouteID | ObjectID выходного объекта output_routes, с которым связана эта точка направления. |
Sequence | Последовательность точек направления для маршрута, начиная с 1. |
DirectionPointType | Тип события или маневра направления, описываемого точкой, обозначенной одним из приведенных ниже значений.
|
StopID | ObjectID остановки, с которой связана эта точка направления, если есть. Если точка не представляет собой посещение остановки, то значение равно нулю. |
DisplayText | Текст указаний для отображения в использующем приложении. |
ArrivalTime | Время, когда событие направления происходит в универсальном координированном времени (UTC). |
ArrivalUTCOffset | Разница в минутах между местным временем в месте маневра и временем UTC, показанным в поле ArrivalTime, в минутах. |
Name | Имя точки направления. |
ExitName | Название съезда с шоссе, которое появляется в инструкции направления движения. |
AlternateName | Альтернативное название для источника, которое появляется в инструкции направления движения. |
IntersectingName | Название пересекающейся или поперечной улицы, которое появляется в инструкции направления движения. |
BranchName | Название ветви указателя, которое появляется в инструкции направления движения. |
TowardName | Название указателя к месту назначения, которое появляется в инструкции направления движения. |
Level | Уровень здания, на котором происходит это событие направления. Это значение соответствует свойству Level, определенному в наборе сетевых данных, используемом для анализа. Более подробно о конфигурации направлений набора сетевых данных |
ShortVoiceInstruction | Короткий текст для голосового руководства в использующем приложении. |
VoiceInstruction | Заполните текст, включая расширенные аббревиатуры и множественное число, для голосового руководства в использующем приложении. |
Azimuth | Направление в градусах транспортного средства, отходящего от этой точки. Ноль указывает на север. |
output_direction_lines
Задает выходные линии маршрута, вычисленные в ходе анализа так, чтобы представлять каждый сегмент маршрута между местоположениями событий DirectionPoints или маневров.
| Имя поля | Описание |
|---|---|
DirectionPointID | ObjectID объекта в таблице output_direction_points, с которым связана эта линия. |
RouteID | ObjectID выходного объекта output_routes, с которым связана эта линия направления. |
DirectionLineType | Тип ситуации направления, описываемого этой линией, обозначенной одним из приведенных ниже значений.
|
Meters | Длина сегмента линии измеряется в метрах. |
Minutes | Время в пути по сегменту линии в минутах. |
FromLevel | Уровень здания, на котором начинается это событие направления. Это значение соответствует свойству Level, определенному в наборе сетевых данных, используемом для анализа. Более подробно о конфигурации направлений набора сетевых данных |
ToLevel | Уровень здания, на котором заканчивается это событие направления. Это значение соответствует свойству Level, определенному в наборе сетевых данных, используемом для анализа. |
output_stops
Обеспечивает доступ к атрибутам остановок, пройденных по маршруту, а также остановок, которые не могут быть посещены ни на одном из маршрутов.
Вы можете использовать атрибуты из этого параметра, например, поле Status, чтобы определить, почему остановка не была назначена ни одному из маршрутов.
Ниже в таблице приведен список полей, возвращаемых для выходных остановок. Помимо указанных полей тип данных также включает все поля из входного класса объектов, который используется в качестве остановок для анализа.
Поле | Описание |
Name | Имя остановок, посещаемых на маршруте. Значения для этого поля копируются из поля Name входных остановок. |
RouteName | Имя маршрута, для которого назначена остановка. Входные остановки, имеющие одинаковое название маршрута при запуске инструмента, группируются вместе и посещаются одним маршрутом, а маршрут получает это имя. Если во входных остановках присутствует более одного имени маршрута, инструмент может выдать несколько выходных маршрутов – по одному на каждое уникальное имя маршрута. Если имена отсутствуют, то все остановки принадлежат одному маршруту. |
Sequence | Порядок, в котором остановки посещаются на назначенном маршруте, что перечислено в поле RouteName. |
TimeWindowStart | Самое раннее время, в которое можно посетить остановку в рамках маршрута. Значения для этого поля копируются из поля TimeWindowStart входных остановок. |
TimeWindowEnd | Самое позднее время, в которое можно посетить остановку в рамках маршрута. Значения для этого поля копируются из поля TimeWindowEnd входных остановок. |
ArriveCurbApproach | Сторона транспортного средства, с которой должен находиться бордюр при прибытии на остановку. |
DepartCurbApproach | Сторона транспортного средства, с которой должен находиться бордюр при отправлении с остановки. |
ArriveTime | Значение даты и времени, указывающее время прибытия на остановку. Временная зона для этого значения времени дня берется из элемента сети, на котором расположена остановка. |
DepartTime | Значение даты и времени, указывающее время отправления с остановки. Временная зона для этого значения времени дня берется из элемента сети, на котором расположена остановка. |
ArriveTimeUTC | Значение даты и времени, указывающее время прибытия на остановку. Временная зона для этого значения времени дня берется из элемента сети, на котором расположена остановка. |
DepartTimeUTC | Значение даты и времени, указывающее время отправления в формате Всемирного координированного времени (UTC) |
LocationType | Тип остановки. Значения для этого поля копируются из поля LocationType входных остановок. |
SourceID | Числовой идентификатор исходного класса пространственных объектов набора сетевых данных, в котором находится входная точка. |
SourceOID | ObjectID объекта в источнике, на котором расположена входная точка. |
PosAlong | Положение направления оцифровки исходного линейного объекта. Это значение хранится как доля. Это поле пустое, если сетевое местоположение ссылается на соединение. |
SideOfEdge | Сторона грани по отношению к направлению оцифровки линейного объекта. Это поле ограничено доменом из двух значений: Правая сторона (1), и Левая сторона (2). |
CurbApproach | Направление, в котором транспортное средство может подъехать или отъехать от остановки. Значения для этого поля копируются из поля CurbApproach входных остановок. |
Status | Указывает статус точки относительно ее местоположения в сети и результат анализа. Список возможных значений следующий:
|
SnapX | Координата x положения точки в наборе сетевых данных в системе координат набора сетевых данных. |
SnapY | Координата y положения точки в наборе сетевых данных в системе координат набора сетевых данных. |
SnapZ | Координата z положения точки в наборе сетевых данных в системе координат набора сетевых данных. Поле SnapZ равно 0, если сеть двухмерная. |
DistanceToNetworkInMeters | Расстояние в метрах между географическим положением точки и положением, где она находилась в сети. |
AdditionalTime | Количество времени, добавляемое к общему времени маршрута при посещении этой остановки. Значения для этого поля копируются из поля AdditionalTime входных остановок. |
AdditionalDistance | Расстояние, добавляемое к общему расстоянию маршрута при посещении этой остановки. Значения для этого поля копируются из поля AdditionalDistance входных остановок. |
AdditionalCost | Стоимость, добавляемая к общей стоимости маршрута при посещении этой остановки. Значения для этого поля копируются из поля AdditionalCost входных остановок. Это поле используется только, если режим передвижения, применяемый для анализа, использует атрибут импеданса, основанный ни на времени, ни на расстоянии. |
Cumul_Minutes | Накопленная продолжительность маршрута в минутах от начала до остановки включительно. Значение, указанное здесь, – это накопленное время маршрута до остановки, включая любое дополнительное время, проведенное на этой остановке и любых предшествующих. Например, если в анализе маршрута указывается, что для посещения двух остановок будет затрачено 10 минут, а вторая остановка имеет значение AdditionalTime равным 5, то значение Cumul_Minutes будет равно 15 минутам. |
Cumul_Miles | Накопленная длина маршрута в милях от начала до остановки включительно. Значение, указанное здесь, – это накопленная длина маршрута до остановки, включая любое дополнительное расстояние на этой остановке и любых предшествующих. |
Cumul_Kilometers | Накопленная длина маршрута в километрах от начала до остановки включительно. Значение, указанное здесь, – это накопленная длина маршрута до остановки, включая любое дополнительное расстояние на этой остановке и любых предшествующих. |
Cumul_Cost | Накопленная стоимость маршрута от начала до остановки включительно. Указанное здесь значение – это накопленная стоимость маршрута до остановки, включая любую дополнительную стоимость на этой остановке и любых предшествующих. Это поле используется только, если режим передвижения, применяемый для анализа, использует атрибут импеданса, основанный ни на времени, ни на расстоянии. Значение указано в неизвестных единицах измерения. |
Wait_Minutes | В этом поле хранится значение времени, потраченного на ожидание открытия временного окна, при раннем прибытии маршрута на остановку. В поле указывается пустое значение, если в анализе не используются временные окна. |
CumulWait_Minutes | В этом поле хранится суммарное время, потраченное на ожидание открытия временных окон. Это значение времени простоя. Оно включает в себя время ожидания на текущей остановке и всех предыдущих остановках, посещенных на маршруте. В поле указывается пустое значение, если в анализе не используются временные окна. |
Violation_Minutes | Это поле хранит значение времени опозданий прибытия маршрута после закрытия временного окна . А именно, в нем хранится величина времени между окончанием временного окна и прибытием маршрута на остановку. В поле указывается пустое значение, если в анализе не используются временные окна. Дополнительные поля Violation_[AccumulateAttributeName]_[TimeUnits] включаются в результат для каждого атрибута стоимости на основе времени, накапливаемого в ходе анализа. |
CumulViolation_Minutes | В этом поле хранится накопленное время нарушений на текущей остановке и всех предыдущих остановках, посещенных на маршруте. В поле указывается пустое значение, если в анализе не используются временные окна. Дополнительные поля CumulViolation_[AccumulateAttributeName]_[TimeUnits] включаются в результат для каждого атрибута стоимости на основе времени, накапливаемого в ходе анализа. |
ORIG_FID | ObjectID входной остановки. Это поле можно использовать для присоединения атрибутов из выходных остановок к таблице входных остановок или от входных остановок к выходным остановкам. |
Bearing | Значения для этого поля копируются из поля Bearing входных остановок. |
BearingTol | Значения для этого поля копируются из поля BearingTol входных остановок. |
NavLatency | Значения для этого поля копируются из поля NavLatency входных остановок. |
output_route_edges
Обеспечивает доступ к отдельным ребрам сети, по которым проходят маршруты.
Этот параметр имеет значение, только если параметр populate_route_edges задан как True.
В таблице ниже приведен список полей, поддерживаемых выходными ребрами маршрута:
| Поле | Описание |
|---|---|
SourceName | Имя исходного класса объектов-ребер, на основе которого была создана линия. |
SourceOID | ObjectID пересекаемых объектов улиц. Суммирование значений этого поля может позволить получить вам полезную информацию, например, число вхождений во все маршруты определенного объекта (элемента) улицы. |
RouteEdgeID | Этот ID представляет ребро, соответствующее объекту улицы. Так как возможно наличие более одного ребра на объект улицы, поле SourceOID может быть использовано для уникальной идентификации проходимого объекта улицы, а поле RouteEdgeID можно использовать для уникальной идентификации ребра в пределах объекта улицы. |
FromPosition | Указывает, где начинается выходной объект RouteEdges относительно направления оцифровки объекта улицы, лежащего в основе.
|
ToPosition | Указывает, где заканчивается выходной объект RouteEdges относительно направления оцифровки объекта улицы, лежащего в основе.
|
RouteID | Уникально идентифицирует маршрут, прошедший по ребру. Значение RouteID соответствует значению ObjectID выходного класса объектов маршрутов. |
Attr_Minutes | Время проезда в минутах или длина пройденного участка нижележащего объекта улицы. |
Attr_Miles | Длина в милях пройденного участка нижележащего объекта улицы. |
Attr_Kilometers | Длина в километрах пройденного участка нижележащего объекта улицы. |
Attr_Other | Стоимость поездки пройденного участка нижележащего объекта улицы. Это поле используется только, если режим передвижения, применяемый для анализа, использует атрибут импеданса, основанный ни на времени, ни на расстоянии. Значение указано в неизвестных единицах измерения. |
Cumul_Minutes | Время проезда в минутах по маршруту от начала до конца пройденного участка нижележащего объекта улицы. |
Cumul_Miles | Длина маршрута в милях от начала до конца пройденного участка нижележащего объекта улицы. |
Cumul_Kilometers | Длина маршрута в километрах от начала до конца пройденного участка нижележащего объекта улицы. |
Cumul_Other | Стоимость маршрута от начала до конца пройденного участка нижележащего объекта улицы. Это поле используется только, если режим передвижения, применяемый для анализа, использует атрибут импеданса, основанный ни на времени, ни на расстоянии. Значение указано в неизвестных единицах измерения. |
Attr_[Soft Restriction Attribute Name] | Определяет, использовало ли пройденное ребро атрибут мягкого ограничения, указанный в имени поля.
Например, если анализ выполнялся с использованием мягкого ограничения Избегать платных дорог, для этого ограничения создается поле с именем Attr_Avoid_Toll_Roads. Значение 1 в этом поле означает платную дорогу на маршруте. |
solve_succeeded
Используйте этот параметр для определения, успешным ли был анализ.
output_result_file
Данный параметр используется для доступа к результатам анализа в виде файла .zip, содержащего один или несколько файлов для каждого из выходных данных. Формат отдельного файла задается параметром Выходной формат. Значение параметра не заполнено, если для параметра Выходной формат задано Набор объектов.
Если задан файловой выходной формат, например, файл JSON или файл GeoJSON, к отображению не будут добавлены выходные данные, так как приложения, такие как ArcMap или ArcGIS Pro, не могут отображать содержимое полученных файлов. Напротив, файл загружается в временную директорию вашего компьютера. В ArcGIS Pro местоположение загруженного файла можно определить, просмотрев значение параметра Выходной результирующий файл в соответствующей строке отчета о выполнении инструмента в истории геообработки вашего проекта. В ArcMap местоположение файла можно определить с помощью опции Копировать местоположение ниспадающего меню параметра Выходной результирующий файл в соответствующей строке отчета о выполнении инструмента в окне Результаты геообработки.
output_route_data
Используйте данный параметр для доступа к файлу .zip, содержащему файловую базу геоданных, в которой хранятся входные и выходные данные анализа в формате, который может быть использован для дальнейшей публикации слоев маршрутов на ArcGIS Online или Portal for ArcGIS. Значение параметра заполняется, только если для параметра Сохранить данные маршрута задано True.
Файл загружается в временную директорию вашего компьютера. В ArcGIS Pro местоположение загруженного файла можно определить, просмотрев значение параметра Выходные данные маршрута в соответствующей строке отчета о выполнении инструмента в истории геообработки вашего проекта. В ArcMap местоположение загруженного файла можно определить с помощью опции Копировать местоположение ниспадающего меню параметра Выходные данные маршрута в соответствующей строке отчета о выполнении инструмента в окне Результаты геообработки.
output_network_analysis_layer
Используйте этот параметр для доступа к файлу слоя сетевого анализа, хранящий настройки, а также входные и выходные данные анализа. Значение параметра заполняется, только если для параметра Сохранить выходной слой сетевого анализа задано True.
Файл загружается в временную директорию вашего компьютера. В ArcGIS Pro местоположение загруженного файла можно определить, просмотрев значение параметра Выходной слой сетевого анализа в соответствующей строке отчета о выполнении инструмента в истории геообработки вашего проекта. В ArcMap местоположение загруженного файла можно определить с помощью опции Копировать местоположение ниспадающего меню параметра Выходной слой сетевого анализа в соответствующей строке отчета о выполнении инструмента в окне Результаты геообработки.