После успешного выполнения, сервис возвращает наилучший маршрут и направления движения между инцидентом и ближайшим пунктом обслуживания, а также статус, успешности анализа, используя следующие выходные параметры:
output_closest_facilities
Этот выходной параметр предоставляет доступ к пунктам обслуживания, которые являются ближайшими к инциденту. Он содержит информацию о местоположении пунктов обслуживания и атрибутивную информацию из соответствующих входных пунктов.
Ниже приведено описание полей, возвращаемых для каждого маршрута:
| Имя поля | Описание |
|---|---|
OID | Уникальный идентификатор маршрута. Этот идентификатор автоматически генерируется сервисом. |
FacilityOID | Значение ObjectID входного пункта обслуживания, представленного выходным пунктом. Это поле часто используется для присоединения информации из входных пунктов обслуживания. |
output_routes
Используйте этот параметр, чтобы получить доступ к итоговому маршруту между пунктами обслуживания и инцидентами. Параметры route_shape и route_line_simplification_tolerance оказывают значительное влияние на форму выходных маршрутов. Геометрия маршрута возвращается в пространственной привязке, заданной параметром env:outSR.
Ниже приведено описание полей, возвращаемых для каждого маршрута:
| Имя поля | Описание |
|---|---|
OID | Уникальный идентификатор маршрута. Этот идентификатор автоматически генерируется сервисом. |
Name | Имя маршрута к ближайшему пункту обслуживания основано на именах соответствующего пункта обслуживания и инцидента. Имя пункта обслуживания находится в начале, если параметру Facility to Incident задано travel_direction. Например, Facility 5—Incident 3 обозначает, что маршрут проходит от пункта обслуживания 5 к инциденту 3. Если для параметра Incident to Facility задано travel_direction, имя инцидента находится в начале, например, Incident 3—Facility 5. |
FacilityID | Уникальный идентификатор пункта обслуживания, к которому идет маршрут. Если атрибут ID использован при задании параметра facilities, значение FacilityID соответствует значению атрибута ID. Иначе, FacilityID содержит автоматически сгенерированный идентификатор. |
FacilityOID | Значение ObjectID входного пункта обслуживания, использованного для генерации маршрута. Это поле часто используется для присоединения к маршруту информации из пунктов обслуживания. |
FacilityRank | Ранг пункта обслуживания среди всех пунктов обслуживания, найденных для соответствующего инцидента; ранг ближайшего пункта обслуживания равен 1. |
FacilityCurbApproach | Описывает сторону транспортного средства, с которой находится пункт обслуживания во время прибытия в пункт обслуживания или отъезда от него. Значение 1 соответствует положению справа от транспортного средства, а значение 2 – слева от транспортного средства. |
IncidentID | Уникальный идентификатор инцидента, к которому идет маршрут. Если атрибут ID использован при задании параметра incidents, значение IncidentID соответствует значению атрибута ID. Иначе IncidentID содержит автоматически сгенерированный идентификатор. |
IncidentOID | Значение ObjectID входного инцидента, использованного для генерации маршрута. Это поле часто используется для присоединения к маршруту информации из инцидентов. |
IncidentCurbApproach | Описывает сторону транспортного средства, с которой находится инцидент во время прибытия к месту инцидента или отъезда от него. Значение 1 соответствует положению справа от транспортного средства, а значение 2 – слева от транспортного средства. |
Shape_Length | Длина маршрута в единицах измерения пространственной привязки, заданной для геометрии маршрутов. Если параметр env:outSR не задан, длина по умолчанию сообщается в десятичных градусах. |
Total_Minutes | Накопленное время в пути по маршруту, в минутах, между пунктом обслуживания и инцидентом. |
Total_Miles | Накопленное расстояние пути по маршруту, в милях, между пунктом обслуживания и инцидентом. |
Total_Kilometers | Накопленное расстояние пути маршрута, в километрах, между пунктом обслуживания и инцидентом. |
StartTime | Время начала маршрута, сообщаемое как местное время в первой остановке. |
EndTime | Время окончания маршрута, сообщаемое как местное время в последней остановке. |
StartTimeUTC | Время начала маршрута дается в формате Всемирного координированного времени (UTC). |
EndTimeUTC | Время окончания маршрута в формате Всемирного координированного времени (UTC). |
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, показанных ниже. Типы маневров
Типы строк направлений
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SubItemType | Указывает, содержит ли поле Type целое число из таблицы Directions String Types или Maneuver Types.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Text | Текстовое описание направления движения. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ElaspsedTime | Время, в минутах, прошедшее с начала текущего направления движения до начала следующего или до тех пор, пока маршрут не закончится на последнем направлении. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DriveDistance | Расстояние, с которого началось текущее направление движения до начала следующего или до места, где маршрут закончится на последнем направлении движения. Значения указаны в единицах, заданных параметром distance_units. Данное значение равно нулю для направлений движения, которые происходят том же положении, где начинается другое. Например, DriveDistance равно 0 для текста направлений в начале маршрута. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Shape_Length | Длина объекта-направления в единицах измерения пространственной привязки, заданной для маршрутов. Если параметр env:outSR не задан, длина по умолчанию сообщается в десятичных градусах. |
solve_succeeded
Используйте этот параметр, чтобы определить, смог ли сервис успешно найти маршруты. Сообщения об ошибках в случае сбоя можно получить, создав запрос для получения статуса задания.