После успешного выполнения сервис возвращает лучшие маршруты между остановками, а также статус успешности анализа, используя следующие выходные параметры:
output_routes
Используйте этот параметр, чтобы получить доступ к итоговому маршруту между остановками.
Ниже приведено описание полей, возвращаемых для каждого маршрута:
| Имя поля | Описание |
|---|---|
OID | Уникальный идентификатор маршрута. Этот идентификатор автоматически генерируется сервисом. |
Name | Имя маршрута основано на поле RouteName соответствующих остановок. Если входное поле RouteName у остановок не заполнено, имя извлекается из поля Name первой и последней остановок. |
StopCount | Число остановок, назначенных маршруту. |
Total_Minutes | Накопленное время в пути по маршруту, в минутах, между остановками. |
FirstStopOID | Значение ObjectID первой остановки маршрута. Это поле часто используется для присоединения к маршруту информации из входных остановок. |
LastStopOID | Значение ObjectID последней остановки маршрута. Это поле часто используется для присоединения к маршруту информации из входных остановок. |
Total_Kilometers | Накопленное расстояние в пути по маршруту, в километрах, между остановками. |
Total_Miles | Накопленное расстояние в пути по маршруту, в милях, между остановками. |
Shape_Length | Длина маршрута в единицах измерения пространственной привязки, заданной для геометрии маршрутов. Если параметр env:outSR не задан, ,длина по умолчанию сообщается в десятичных градусах. |
output_directions
Используйте этот параметр, чтобы получить доступ к подробному путевому листу для каждого итогового маршрута между остановками. Параметр включает направления движения, а также геометрию объектов путевого листа, соответствующую тексту. Форма объектов путевого листа определяется геометрией улиц, лежащих в основе маршрута. Геометрия объекта возвращается в пространственной привязке, заданной параметром env:outSR. Объекты пусты, если параметр populate_directions имеет значение false. Параметры directions_language, directions_distance_units, и directions_style_name оказывают значительное влияние на направления движения.
Ниже приведено описание полей, возвращаемых для объектов-направлений:
| Имя поля | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
ObjectID | Уникальный идентификатор объекта-направления. Этот идентификатор автоматически генерируется сервисом. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
RouteName | Название маршрута , к которому применяется действие перемещения. Это значение совпадает с атрибутом Name из параметра output_routes. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ArriveTime | Время дня для начала заданного действия перемещения. Если маршрут выполняется за несколько дней, то отображается дата и время дня. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Type | Обозначает тип маневра, показанного объектом путевого листа или тип текста путевого листа. Чтобы определить, обозначает ли Type тип маневра или тип строки направления, необходимо проверить значение поля SubItemType. Type может использоваться, например, для присвоения другого значка тексту направления, в зависимости от типа маневра,, или для применения специального стиля форматирования, основанного на типе строки направления, при отображении направлений движения в вашем приложениях. Значение Type является целым числом из таблиц Maneuver Types или Directions String Types, показанных ниже. Типы маневров
Типы сtring трок путевого листа
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SubItemType | Указывает, содержит ли поле Type целое число из таблицы Directions String Types или Maneuver Types.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Text | Текстовое описание путевого листа. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ElaspsedTime | Время, в минутах, прошедшее с начала текущего направления движения до начала следующего или до тех пор, пока маршрут не закончится на последнем направлении. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DriveDistance | Расстояние, с которого началось текущее направление движения до начала следующего или до места, где маршрут закончится на последнем направлении движения. Значения указаны в единицах, заданных параметром distance_units. Данное значение равно нулю для направлений движения, которые происходят том же положении, где начинается другое. Например, DriveDistance равно 0 для текста направлений в начале маршрута. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Shape_Length | Длина объекта-направления в единицах измерения пространственной привязки, заданной для маршрутов. Если параметр env:outSR не задан, ,длина по умолчанию сообщается в десятичных градусах. |
output_stops
Используйте этот параметр для доступа к атрибутам остановки или остановок, по которым проходит маршрут, а также остановок, до которых ни один из маршрутов не доходит. Для тех остановок, которые могут быть достигнуты, в атрибутивной таблице перечислены названия маршрутов, назначенных остановкам, последовательность остановок, время прибытия и другая информация. Для тех остановок, которые не могут быть достигнуты, в атрибутивной таблице предоставляется информация о том, что было источником проблемы.
Ниже приведено описание атрибутов, возвращаемых для каждой остановки:
| Имя поля | Описание |
|---|---|
OID | Уникальный идентификатор остановки. Этот идентификатор автоматически генерируется сервисом. |
Name | Имя остановки, через которую прошел маршрут. |
RouteName | Имя маршрута, для которого назначена остановка. Входные остановки, имеющие одинаковое название маршрута при запуске инструмента, группируются вместе и посещаются одним маршрутом, ,а маршрут получает это имя. Если во входных остановках присутствует более одного имени маршрута, инструмент может выдать несколько выходных маршрутов — по одному на каждое уникальное имя маршрута. Если имена отсутствуют, то все остановки принадлежат одному маршруту. |
Sequence | Порядок, в котором остановки посещаются на назначенном маршруте, что перечислено в поле RouteName. |
TimeWindowStart | Самое раннее время, в которое по маршруту можно добраться до остановки. Значения для этого поля копируются из поля TimeWindowStart входных остановок. |
TimeWindowEnd | Самое позднее время, в которое по маршруту можно добраться до остановки. Значения для этого поля копируются из поля TimeWindowEnd входных остановок. |
ArriveCurbApproach | Указывает на сторону транспортного средства, с которой должен находиться бордюр при прибытии на остановку. |
DepartCurbApproach | Указывает на сторону транспортного средства, с которой должен находиться бордюр при отправлении с остановки. |
LocationType | Определяет тип остановки. Значения для этого поля копируются из поля LocationType входных остановок. |
CurbApproach | Направление, в котором транспортное средство может подъехать или отъехать от остановки. Значения для этого поля копируются из поля CurbApproach входных остановок. |
Status | Определяет, как остановка была получена в процессе анализа. Это поле применяется для определения, какие остановки не были привязаны к маршрутам. Список возможных значений следующий:
|
AdditionalTime | Количество времени, добавляемое к общему времени маршрута при посещении этой остановки. Значения для этого поля копируются из поля AdditionalTime входных остановок. Это поле включается только в случае, если значение параметра Measurement Units временное. |
AdditionalDistance | Расстояние, добавляемое к общему расстоянию маршрута при посещении этой остановки. Значения для этого поля копируются из поля AdditionalDistance входных остановок. Это поле включается только в случае, если значением параметра Measurement Units является мера длины. |
Cumul_Minutes | Накопленная продолжительность маршрута в минутах от начала до остановки включительно. Значение, указанное здесь, – это накопленное время маршрута до остановки, включая любое дополнительное время, проведенное на этой остановке и любых предшествующих. |
ORIG_FID | ObjectID входной остановки. Это поле можно использовать для присоединения атрибутов из выходных остановок ко входным остановкам или от входных остановок к выходным. |
Cumul_Kilometers | Накопленная длина маршрута в километрах от начала до остановки включительно. Значение, указанное здесь, – это накопленная длина маршрута до остановки, включая любое дополнительное расстояние на этой остановке и любых предшествующих. |
Cumul_Miles | Накопленная длина маршрута в милях от начала до остановки включительно. Значение, указанное здесь, – это накопленная длина маршрута до остановки, включая любое дополнительное расстояние на этой остановке и любых предшествующих. |
output_route_edges
Используйте этот параметр для доступа к отдельным сегментам дороги, по которым идет маршрут.
Ниже приведено описание атрибутов, возвращаемых для каждого ребра маршрута:
| Имя поля | Описание |
|---|---|
OID | Уникальный идентификатор ребра маршрута. Этот идентификатор автоматически генерируется сервисом. |
Shape | Поле геометрии указывает форму линий. |
SourceName | Имя исходного класса объектов-ребер, на основе которого была создана линия. |
SourceOID | ObjectID объекта проходимых объектов улиц. Суммирование значений этого поля может позволить получить вам полезную информацию, например, число вхождений во все маршруты определенного объекта (элемента) улицы. |
RouteEdgeID | ID, соответствующий ребру, формирующему объект улицы. поскольку объект улицы может состоять из нескольких ребер, можно использовать поле SourceOID для уникальной идентификации пройденного объекта улицы,, а поле RouteEdgeID - для уникальной идентификации ребра пройденного объекта улицы. |
FromPosition | Указывает, где начинаются выходные объекты RouteEdges относительно направления оцифровки объекта улицы, лежащего в основе.
|
ToPosition | Указывает, где заканчивается выходной объект RouteEdges по отношению к оцифрованному направлению объекта улицы.
|
RouteID | Уникально идентифицирует маршрут пройденный ребром. Значение RouteID соответствует значению ObjectID выходного output_routesкласса объектов маршрутов. |
Attr_Minutes | Время проезда в минутах или длина пройденного участка нижележащего объекта улицы. |
Attr_Miles | Длина в милях пройденного участка нижележащего объекта улицы. |
Attr_Kilometers. | Длина в километрах пройденного участка нижележащего объекта улицы. |
Cumul_Minutes | Время проезда в минутах по маршруту от начала до конца пройденного участка нижележащего объекта улицы. |
Cumul_Miles | Длина маршрута в милях от начала до конца пройденного участка нижележащего объекта улицы. |
Cumul_Kilometers | Длина маршрута в километрах от начала до конца пройденного участка нижележащего объекта улицы. |
Attr_[Soft Restriction Attribute Name] | Определяет, использовало ли пройденное ребро атрибут мягкого ограничения, указанный в имени поля.
К примеру, если анализ выполнялся с использованием мягкого ограничения Избегать платных дорог, для этого ограничения было создано поле Attr_Avoid_Toll_Roads. Значение 1 в этом поле означает платную дорогу на маршруте. |
Shape_Length | Длина ребра маршрута в единицах измерения пространственной привязки, заданной для геометрии маршрутов. |
solve_succeeded
Используйте этот параметр, чтобы определить, смог ли сервис успешно найти маршруты. Сообщения об ошибках в случае сбоя можно получить, создав запрос для получения статуса задания.