После успешного выполнения FindRoutes сервис возвращает наилучшие маршруты между остановками, а также статус, успешности анализа, используя описанные ниже выходные параметры.
output_routes
Обеспечивает доступ к построенным маршрутам.
Ниже в таблице приведен список полей, возвращаемых для выходных маршрутов:
| Поле | Описание |
|---|---|
Name | Имя маршрута берется из поля RouteName соответствующих остановок. Если входное поле RouteName не заполнено, имя составляется из значений поля Name первой и последней остановок. |
StopCount | Число остановок, назначенных маршруту. |
StartTime | Время начала маршрута, сообщаемое как местное время в первой остановке. |
EndTime | Время окончания маршрута, сообщаемое как местное время в последней остановке. |
StartTimeUTC | Время начала маршрута дается в формате Всемирного координированного времени (UTC). |
EndTimeUTC | Время окончания маршрута в формате Всемирного координированного времени (UTC). |
Total_Minutes | Суммарное время перемещения в минутах от начала первой остановки до окончания последней остановки на маршруте. Включает значения AdditionalTime для посещенных остановок, если эти значения указаны. Примечание:Дополнительное поле Total_[TimeUnits] включается в результат, если measurement_units основан на времени и его значение не Minutes. Значения полей указаны в единицах, заданных параметром measurement_units. Примечание:Дополнительные поля Total_[AccumulateAttributeName]_[TimeUnits] включаются в результат для каждого атрибута стоимости на основе времени, накапливаемого в ходе анализа. |
Total_Miles | Суммарное расстояние перемещения в милях от начала первой остановки до окончания последней остановки на маршруте. Включает значения AdditionalDistance для посещенных остановок, если эти значения указаны. Примечание:Дополнительное поле Total_[DistanceUnits] включается в результат, если параметр measurement_units основан на расстоянии и его значение не Miles или Kilometers. Значения полей указаны в единицах, заданных параметром measurement_units. Примечание:Дополнительные поля Total_[AccumulateAttributeName]_[DistanceUnits] включаются в результат для каждого атрибута стоимости на основе расстояния, накапливаемого в ходе анализа. |
Total_Kilometers | Суммарное расстояние перемещения в километрах от начала первой остановки до окончания последней остановки на маршруте. Включает значения AdditionalDistance для посещенных остановок, если эти значения указаны. |
Total_Other | Суммарная стоимость перемещения в неизвестных единицах от начала первой остановки до окончания последней остановки на маршруте. Включает значения AdditionalCost для посещенных остановок, если эти значения указаны. Это поле используется только, если режим передвижения, применяемый для анализа, использует атрибут импеданса, основанный ни на времени, ни на расстоянии. Примечание:Дополнительные поля Total_[AccumulateAttributeName]_Other включаются в результат для каждого атрибута стоимости, основанного ни на времени, ни на расстоянии, и накапливаемого в ходе анализа. |
TotalWait_Minutes | В этом поле хранится общее время ожидания на маршруте, то есть время, проведенное на остановках в ожидании открытия временных окон. В поле указывается пустое значение, если в анализе не используются временные окна. Примечание:Дополнительное поле TotalWait_[TimeUnits] включается в результат, если параметр measurement_units не установлен как Minutes. Значения полей указаны в единицах, заданных параметром measurement_units. Примечание:Дополнительные поля TotalWait_[AccumulateAttributeName]_[TimeUnits] включаются в результат для каждого атрибута стоимости на основе времени, накапливаемого в ходе анализа. |
TotalViolation_Minutes | В этом поле хранится общее время нарушений маршрута на остановках. Время превышения добавляется при прибытии маршрута на остановку после окончания временного окна, это разница между значениями в полях ArriveTime и TimeWindowEnd входных остановок. В поле указывается пустое значение, если в анализе не используются временные окна. Примечание:Дополнительное поле TotalViolation_[TimeUnits] включается в результат, если свойство timeUnits объекта анализа не установлено как TimeUnits.Minutes. Значения полей указаны в единицах, заданных свойством timeUnits. Дополнительные поля TotalViolation_[AccumulateAttributeName]_[TimeUnits] включаются в результат для каждого атрибута стоимости на основе времени, накапливаемого в ходе анализа. |
FirstStopOID | Значение ObjectID первой остановки маршрута. Это поле часто используется для присоединения к маршруту информации из входных остановок. |
LastStopOID | Значение ObjectID последней остановки маршрута. Это поле часто используется для присоединения к маршруту информации из входных остановок. |
output_directions
Обеспечивает доступ к пошаговому путевому листу для каждого маршрута.
Форма объектов путевого листа определяется геометрией улиц, лежащих в основе маршрута.
Параметры Язык путевого листа, Единицы измерения расстояний путевого листа и Имя стиля путевого листа определяют путевой лист перемещения. Параметр возвращает пустые объекты, если параметр Заполнить путевой лист задан как False.
Ниже приведена таблица со списком полей, возвращаемых для выходного путевого листа:
| Поле | Описание |
|---|---|
RouteName | Название маршрута, к которому применяется действие перемещения. Это значение совпадает со значением в поле Name выходных маршрутов. |
ArriveTime | Время дня для начала заданного действия перемещения. Если маршрут выполняется за несколько дней, то отображается дата и время дня. |
Type | Тип маневра, представленного объектом путевого листа, или типом текста путевого листа. Чтобы определить, обозначает ли Type тип маневра или тип строки направления, необходимо проверить значение поля SubItemType. Type может использоваться, например, для присвоения значка тексту направления, в зависимости от типа маневра, или для применения специального стиля форматирования, основанного на типе строки направления, при отображении направлений движения в вашем приложении. Значение Type является целым числом и соответствует значениям из списков Типы маневров или Типы строк путевого листа, приведенным ниже. Типы маневров
Типы строк путевого листа
|
SubItemType | Указывает, содержит ли поле Type целое число из таблицы Directions String Types или Maneuver Types.
|
Text | Текстовое описание путевого листа. |
ElaspsedTime | Время, в минутах, прошедшее с начала движения по текущему направлению до начала следующего или до тех пор, пока маршрут не закончится на последнем участке путевого листа |
DriveDistance | Расстояние, с которого началось текущее направление движения до начала следующего или до места, где маршрут закончится на последнем направлении движения. Значения указаны в единицах, заданных параметром Directions_Distance_Units. Данное значение равно нулю для участков путевого листа, которые происходят том же положении, где начинается другое. Например, DriveDistance равно 0 для текста участка путевого листа в начале маршрута. |
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_[TimeUnits] включается в результат, если параметр measurement_units основан на времени и его значение не Minutes. Значения полей указаны в единицах, заданных параметром measurement_units. Примечание:Дополнительные поля Cumul_[AccumulateAttributeName]_[TimeUnits] включаются в результат для каждого атрибута стоимости на основе времени, накапливаемого в ходе анализа. |
Cumul_Miles | Накопленная длина маршрута в милях от начала до остановки включительно. Значение, указанное здесь, – это накопленная длина маршрута до остановки, включая любое дополнительное расстояние на этой остановке и любых предшествующих. Примечание:Дополнительное поле Cumul_[DistanceUnits] включается в результат, если параметр measurement_units основан на расстоянии и его значение не Miles или Kilometers. Значения полей указаны в единицах, заданных параметром measurement_units. Примечание:Дополнительные поля Cumul_[AccumulateAttributeName]_[DistanceUnits] включаются в результат для каждого атрибута стоимости на основе расстояния, накапливаемого в ходе анализа. |
Cumul_Kilometers | Накопленная длина маршрута в километрах от начала до остановки включительно. Значение, указанное здесь, – это накопленная длина маршрута до остановки, включая любое дополнительное расстояние на этой остановке и любых предшествующих. |
Cumul_Cost | Накопленная стоимость маршрута от начала до остановки включительно. Указанное здесь значение – это накопленная стоимость маршрута до остановки, включая любую дополнительную стоимость на этой остановке и любых предшествующих. Это поле используется только, если режим передвижения, применяемый для анализа, использует атрибут импеданса, основанный ни на времени, ни на расстоянии. Значение указано в неизвестных единицах измерения. Примечание:Дополнительные поля Cumul_[AccumulateAttributeName]_Other включаются в результат для каждого атрибута стоимости, основанного ни на времени, ни на расстоянии, и накапливаемого в ходе анализа. |
Wait_Minutes | В этом поле хранится значение времени, потраченного на ожидание открытия временного окна, при раннем прибытии маршрута на остановку. В поле указывается пустое значение, если в анализе не используются временные окна. Примечание:Дополнительное поле Wait_[TimeUnits] включается в результат, если параметр measurement_units основан на времени и его значение не Minutes. Значения полей указаны в единицах, заданных параметром measurement_units. Примечание:Дополнительные поля Wait_[AccumulateAttributeName]_[TimeUnits] включаются в результат для каждого атрибута стоимости на основе времени, накапливаемого в ходе анализа. |
CumulWait_Minutes | В этом поле хранится суммарное время, потраченное на ожидание открытия временных окон. Это значение времени простоя. Оно включает в себя время ожидания на текущей остановке и всех предыдущих остановках, посещенных на маршруте. В поле указывается пустое значение, если в анализе не используются временные окна. Примечание:Дополнительное поле CumulWait_[TimeUnits] включается в результат, если параметр measurement_units основан на времени и его значение не Minutes. Значения полей указаны в единицах, заданных параметром measurement_units. Примечание:Дополнительные поля CumulWait_[AccumulateAttributeName]_[TimeUnits] включаются в результат для каждого атрибута стоимости на основе времени, накапливаемого в ходе анализа. |
Violation_Minutes | Это поле хранит значение времени опозданий прибытия маршрута после закрытия временного окна . А именно, в нем хранится величина времени между окончанием временного окна и прибытием маршрута на остановку. В поле указывается пустое значение, если в анализе не используются временные окна. Примечание:Дополнительное поле Violation_[TimeUnits] включается в результат, если параметр measurement_units основан на времени и его значение не Minutes. Значения полей указаны в единицах, заданных параметром measurement_units. Дополнительные поля Violation_[AccumulateAttributeName]_[TimeUnits] включаются для каждого атрибута стоимости на основе времени, который накапливается в процессе анализа. |
CumulViolation_Minutes | В этом поле хранится накопленное время нарушений на текущей остановке и всех предыдущих остановках, посещенных на маршруте. В поле указывается пустое значение, если в анализе не используются временные окна. Примечание:Дополнительное поле CumulViolation_[TimeUnits] включается в результат, если параметр measurement_units основан на времени и его значение не Minutes. Значения полей указаны в единицах, заданных параметром measurement_units. Примечание:Дополнительное поле CumulViolation_[TimeUnits] включено, если свойство объекта анализа timeUnits не задано как TimeUnits.Minutes. Значения полей указаны в единицах, заданных свойством timeUnits. Дополнительные поля 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_[TimeUnits] включается в результат, если параметр measurement_units основан на времени и его значение не Minutes. Значения полей указаны в единицах, заданных параметром measurement_units. |
Attr_Miles | Длина в милях пройденного участка нижележащего объекта улицы. Примечание:Дополнительное поле Attr_[DistanceUnits] включается в результат, если параметр measurement_units основан на расстоянии и его значение не Miles или Kilometers. Значения полей указаны в единицах, заданных параметром measurement_units. |
Attr_Kilometers | Длина в километрах пройденного участка нижележащего объекта улицы. |
Attr_Other | Стоимость поездки пройденного участка нижележащего объекта улицы. Это поле используется только, если режим передвижения, применяемый для анализа, использует атрибут импеданса, основанный ни на времени, ни на расстоянии. Значение указано в неизвестных единицах измерения. Примечание:Дополнительные поля Attr_[AccumulateAttributeName] включаются в результат для каждого атрибута стоимости, основанного ни на времени, ни на расстоянии, и накапливаемого в ходе анализа. |
Cumul_Minutes | Время проезда в минутах по маршруту от начала до конца пройденного участка нижележащего объекта улицы. Примечание:Дополнительное поле Cumul_[TimeUnits] включается в результат, если параметр measurement_units основан на времени и его значение не Minutes. Значения полей указаны в единицах, заданных параметром measurement_units. Примечание:Дополнительные поля Cumul_[AccumulateAttributeName] включаются в результат для каждого атрибута стоимости на основе времени, накапливаемого в ходе анализа. Значения указаны в тех же единицах времени, которые используются для анализа. |
Cumul_Miles | Длина маршрута в милях от начала до конца пройденного участка нижележащего объекта улицы. Примечание:Дополнительное поле Cumul_[DistanceUnits] включается в результат, если параметр measurement_units основан на расстоянии и его значение не Miles или Kilometers. Значения полей указаны в единицах, заданных параметром measurement_units. Примечание:Дополнительные поля Cumul_[AccumulateAttributeName] включаются в результат для каждого атрибута стоимости на основе расстояния, накапливаемого в ходе анализа. Значения указаны в тех же единицах расстояния, которые используются для анализа. |
Cumul_Kilometers | Длина маршрута в километрах от начала до конца пройденного участка нижележащего объекта улицы. |
Cumul_Other | Стоимость маршрута от начала до конца пройденного участка нижележащего объекта улицы. Это поле используется только, если режим передвижения, применяемый для анализа, использует атрибут импеданса, основанный ни на времени, ни на расстоянии. Значение указано в неизвестных единицах измерения. Примечание:Дополнительные поля Cumul_[AccumulateAttributeName] включаются в результат для каждого атрибута стоимости, основанного ни на времени, ни на расстоянии, и накапливаемого в ходе анализа. |
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 местоположение загруженного файла можно определить с помощью опции Копировать местоположение ниспадающего меню параметра Выходной слой сетевого анализа в соответствующей строке отчета о выполнении инструмента в окне Результаты геообработки.
Примечание:
Вы не можете работать с этим файлом напрямую, даже если вы откроете его в приложении ArcGIS Desktop, например, в ArcMap, поскольку его источник данных не будет корректным. Этот файл предназначен для отправки в техническую поддержку Esri для диагностики качества результатов, получаемых инструментом.