Выходные данные инструмента Найти ближайшие пункты обслуживания

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

output_facilities и output_closest_facilities

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

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

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

Имя поляОписание

Name

Имя пункта обслуживания. Значения в этом поле копируются из поля Name входных пунктов обслуживания.

SourceID

Числовой идентификатор исходного класса пространственных объектов набора сетевых данных, в котором находится входная точка.

SourceOID

ObjectID объекта в источнике, на котором расположена входная точка.

PosAlong

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

SideOfEdge

Сторона грани по отношению к направлению оцифровки линейного объекта. Это поле ограничено доменом из двух значений: Правая сторона (1), и Левая сторона (2).

CurbApproach

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

Status

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

  • 0 (OK) – пункт обслуживания был успешно размещен на транспортной сети и проанализирован.
  • 1 (не расположен) – объект не был включен в анализ, поскольку в пределах максимального расстояния поиска от объекта не было найдено проходимой дороги.
  • 3 (элемент не проходим) – элемент сети, на котором располагается пункт обслуживания, не проходим. Это может произойти, когда сетевой элемент ограничен соответствующим атрибутом.
  • 4 (некорректные значения поля) – значения поля выходят за диапазон домена кодированных значений или интервального домена. Например, существует отрицательное значение, когда необходимы только положительные значения.
  • 5 (не достигнуто) – не удалось достичь пункта обслуживания из-за ограничений; например, направление подъезда задано так, что транспорт должен двигаться к пункту по улице с односторонним движением в противоположную сторону.
  • 7 (не размещено на ближайшем) - ближайшее сетевое местоположение к пункту обслуживания не проходимо из-за ограничения или барьера, поэтому выбран пункт обслуживания на ближайшем проходимом объекте сети.

SnapX

Координата x положения точки в наборе сетевых данных в системе координат набора сетевых данных.

SnapY

Координата y положения точки в наборе сетевых данных в системе координат набора сетевых данных.

SnapZ

Координата z положения точки в наборе сетевых данных в системе координат набора сетевых данных. Поле SnapZ равно 0, если сеть двухмерная.

DistanceToNetworkInMeters

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

AdditionalTime

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

AdditionalDistance

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

AdditionalCost

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

Cutoff

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

ID

Уникальный идентификатор пункта обслуживания. Значения этого поля копируются из поля ID входных пунктов обслуживания.

ORIG_FID

FacilityOID

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

Выходные данные ClosestFacilities включают поле ORIG_FID, а выходные данные Facilities включают поле FacilityOID.

Bearing

Значения в этом поле копируются из поля Bearing входных пунктов обслуживания.

BearingTol

Значения в этом поле копируются из поля BearingTol входных пунктов обслуживания.

NavLatency

Значения в этом поле копируются из поля NavLatency входных пунктов обслуживания.

output_routes

Предоставляет доступ к итоговому маршруту или маршрутам между пунктами обслуживания и инцидентами.

Параметры route_shape и route_line_simplification_tolerance влияют на форму выходных маршрутов.

Имя поляОписание

Name

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

Имя пункта обслуживания ставится впереди, если значение параметра travel_direction - Facility to Incident. Например, Facility 5 - Incident 3 обозначает, что маршрут проходит от пункта обслуживания 5 к инциденту 3.

Если в качестве значения для параметра Incident to Facility задано travel_direction, имя инцидента находится в начале, например, Incident 3 — Facility 5.

FacilityRank

Ранг пункта обслуживания среди всех пунктов обслуживания, найденных для соответствующего инцидента; ранг ближайшего пункта обслуживания равен 1.

FacilityID

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

FacilityOID

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

IncidentID

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

IncidentOID

Значение ObjectID входного инцидента, использованного для генерации маршрута. Это поле часто используется для присоединения к маршруту информации из инцидентов.

FacilityCurbApproach

Описывает сторону транспортного средства, с которой находится пункт обслуживания во время прибытия в пункт обслуживания или отъезда от него. Значение 1 означает правую сторону транспортного средства, а значение 2 - левую сторону транспортного средства.

IncidentCurbApproach

Описывает сторону транспортного средства, с которой находится инцидент во время прибытия к месту инцидента или отъезда от него. Значение 1 соответствует положению справа от транспортного средства, а значение 2 – слева от транспортного средства.

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_[DistanceUnits] включается в результат, если параметр measurement_units основан на расстоянии и его значение не Miles или Kilometers. Значения полей указаны в единицах, заданных параметром measurement_units.

Примечание:

Дополнительные поля Total_[AccumulateAttributeName]_[DistanceUnits] включаются в результат для каждого атрибута стоимости на основе расстояния, накапливаемого в ходе анализа.

Total_Other

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

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

Примечание:

Дополнительные поля Total_[AccumulateAttributeName]_Other включаются в результат для каждого атрибута стоимости, основанного ни на времени, ни на расстоянии, и накапливаемого в ходе анализа.

output_incidents

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

Ниже приведена таблица со списком полей, возвращаемых для выходных инцидентов:

ПолеОписание

Name

Имя инцидента. Значения в этом поле копируются из поля Name входных пунктов обслуживания

TargetFacilityCount

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

SourceID

Числовой идентификатор исходного класса пространственных объектов набора сетевых данных, в котором находится входная точка.

SourceOID

ObjectID объекта в источнике, на котором расположена входная точка.

PosAlong

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

SideOfEdge

Сторона грани по отношению к направлению оцифровки линейного объекта. Это поле ограничено доменом из двух значений: Правая сторона (1), и Левая сторона (2).

CurbApproach

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

Status

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

  • 0 (OK) – инцидент был успешно размещен на транспортной сети и проанализирован.
  • 1 (не размещено) – инцидент не был включен в анализ, поскольку не была найдена проходимая дорога в пределах максимального расстояния поиска от инцидента.
  • 3 (элемент не проходим) – элемент сети, на котором располагается событие, не проходим. Это может произойти, если элемент имеет ограничения, заданные с помощью атрибута ограничения.
  • 4 (некорректные значения поля) – значения поля выходят за диапазон домена кодированных значений или интервального домена. Например, существует отрицательное значение, когда необходимы только положительные значения.
  • 5 (Не достигнуто) – не удалось достичь инцидента из-за ограничений; например, направление подъезда задано так, что транспорт должен двигаться к инциденту по улице с односторонним движением в противоположную сторону.
  • 7 (Не размещено на ближайшем) – Ближайшее сетевое местоположение к инциденту не проходимо из-за ограничений или барьера, поэтому инцидент был размещен на ближайшем проходимом сетевом элементе.

SnapX

Координата x положения точки в наборе сетевых данных в системе координат набора сетевых данных.

SnapY

Координата y положения точки в наборе сетевых данных в системе координат набора сетевых данных.

SnapZ

Координата z положения точки в наборе сетевых данных в системе координат набора сетевых данных. Поле SnapZ равно 0, если сеть двухмерная.

DistanceToNetworkInMeters

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

AdditonalTime

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

AdditionalDistance

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

AdditionalCost

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

Cutoff

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

IncidentOID

Значения ObjectID входного объекта. Это поле часто используется для присоединения информации из входных пунктов обслуживания.

Bearing

Значения в этом поле копируются из поля Bearing входных пунктов обслуживания.

BearingTol

Значения в этом поле копируются из поля BearingTol входных пунктов обслуживания.

NavLatency

Значения в этом поле копируются из поля NavLatency входных пунктов обслуживания.

output_directions

Обеспечивает доступ к пошаговому путевому листу для каждого маршрута.

Форма объектов путевого листа определяется геометрией улиц, лежащих в основе маршрута.

Параметры Язык путевого листа, Единицы измерения расстояний путевого листа и Имя стиля путевого листа определяют путевой лист перемещения. Параметр возвращает пустые объекты, если параметр Заполнить путевой лист задан как False.

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

ПолеОписание

RouteName

Название маршрута, к которому применяется действие перемещения. Это значение совпадает со значением в поле Name выходных маршрутов.

ArriveTime

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

Type

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

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

Значение Type является целым числом и соответствует значениям из списков Типы маневров или Типы строк путевого листа, приведенным ниже.

Типы маневров

  • 0: Неизвестный
  • 1: Прибытие на остановку
  • 2: Двигайтесь прямо
  • 3: Возьмите левее
  • 4: Возьмите правее
  • 5: Поверните налево
  • 6: Поверните направо
  • 7: Резко поверните налево
  • 8: Резко поверните направо
  • 9: Выполните разворот
  • 10: Переправьтесь на пароме
  • 11: Проезжайте по кругу
  • 12: Слияние с шоссе
  • 13: Съезд с шоссе
  • 14: Следуйте по другому шоссе
  • 15: На развилке держитесь центра
  • 16: На развилке возьмите левее
  • 17: На развилке возьмите правее
  • 18: Станция отправления
  • 19: Элемент планирования движения
  • 20: Конец паромной переправы
  • 21: Съезд направо
  • 22: Съезд налево
  • 23: Поверните налево и немедленно поверните направо
  • 24: Поверните направо и немедленно поверните налево
  • 25: Поверните направо и немедленно поверните направо
  • 26: Поверните налево и немедленно поверните налево

Типы строк путевого листа

  • 0: Тип строки путевого листа General
  • 1: Тип строки путевого листа Depart
  • 2: Тип строки путевого листа Arrive
  • 3: Тип строки путевого листа Length
  • 4: Тип строки путевого листа Time
  • 5: Тип строки путевого листа Time summary
  • 6: Тип строки путевого листа Time Window
  • 7: Тип строки путевого листа Violation Time
  • 8: Тип строки путевого листа Wait Time
  • 9: Тип строки путевого листа Service Time
  • 10: Тип строки путевого листа Estimated Arrival
  • 11: Тип строки путевого листа Cumulative Length
  • 12: Тип строки путевого листа Street name
  • 13: Тип строки путевого листа Alternate street name
  • 14: Тип строки путевого листа Sign branch information
  • 15: Тип строки путевого листа Sign toward information
  • 16: Тип строки путевого листа Cross street name
  • 17: Тип строки путевого листа Sign exit number

SubItemType

Указывает, содержит ли поле Type целое число из таблицы Directions String Types или Maneuver Types.

  • Если для параметра SubItemType указано значение 1, то значения Type берутся из таблицы Maneuver Types.
  • Если для параметра SubItemType указано значение 2, то значения Type берутся из таблицы Directions String Types.

Text

Текстовое описание путевого листа.

ElaspsedTime

Время, в минутах, прошедшее с начала движения по текущему направлению до начала следующего или до тех пор, пока маршрут не закончится на последнем участке путевого листа

DriveDistance

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

Значения указаны в единицах, заданных параметром Directions_Distance_Units.

Данное значение равно нулю для участков путевого листа, которые происходят том же положении, где начинается другое. Например, DriveDistance равно 0 для текста участка путевого листа в начале маршрута.

output_direction_points

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

Имя поляОписание

RouteID

ObjectID выходного объекта output_routes, с которым связана эта точка направления.

Sequence

Последовательность точек направления для маршрута, начиная с 1.

DirectionPointType

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

  • Заголовок (1)
  • Прибытие (50)
  • Отправление (51)
  • Прямо (52)
  • На пароме (100)
  • Не на пароме (101)
  • Центральная развилка (102)
  • Обход (103)
  • Разворот (104)
  • Дверь (150)
  • Лестница (151)
  • Лифт (152)
  • Эскалатор (153)
  • Пешеходная дорожка (154)
  • Левая развилка (200)
  • Левая пешеходная дорожка (201)
  • Обход по часовой стрелке (202)
  • Левый разворот (203)
  • Возьмите левее (204)
  • Левый поворот (205)
  • Резко влево (206)
  • Левый поворот и затем резкий левый поворот (207)
  • Левый поворот и затем резкий правый поворот (208)
  • Правая развилка (300)
  • Правая пешеходная дорожка (301)
  • Обход против часовой стрелки (302)
  • Правый разворот (303)
  • Держитесь правее (304)
  • Правый поворот (305)
  • Резко вправо (306)
  • Правый поворот и затем резкий левый поворот (307)
  • Правый поворот и затем резкий правый поворот (308)
  • Лифт вверх (400)
  • Эскалатор вверх (401)
  • Лестница вверх (402)
  • Лифт вниз (500)
  • Эскалатор вниз (501)
  • Лестница вниз (502)
  • Общее событие (1000)
  • Ориентир (1001)
  • Смена часового пояса (1002)
  • ДТП (1003)
  • Барьерное событие с масштабируемой стоимостью (1004)
  • Пересечение границы (1005)
  • Нарушение ограничения (1006)

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

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

  • Неизвестно (0)
  • Сегмент (1)
  • Маневр Сегмент (1)
  • Нарушение ограничения (3)
  • Барьер с масштабируемой стоимостью (4)
  • Интенсивное движение (5)
  • Медленное движение (6)
  • Умеренное движение (7)

Meters

Длина сегмента линии измеряется в метрах.

Minutes

Время в пути по сегменту линии в минутах.

FromLevel

Уровень здания, на котором начинается это событие направления. Это значение соответствует свойству Level, определенному в сетевом наборе данных, используемом для анализа. Более подробно о конфигурации направлений набора сетевых данных

ToLevel

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

solve_succeeded

Используйте этот параметр для определения, успешным ли был анализ.

output_route_data

Используйте данный параметр для доступа к файлу .zip, содержащему файловую базу геоданных, в которой хранятся входные и выходные данные анализа в формате, который может быть использован для дальнейшей публикации слоев маршрутов на ArcGIS Online или Portal for ArcGIS. Значение параметра заполняется, только если для параметра Сохранить данные маршрута задано True.

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

output_result_file

Данный параметр используется для доступа к результатам анализа, файл .zip содержит один или несколько файлов для каждого из выходных данных. Формат отдельного файла задается параметром Выходной формат. Значение параметра не заполнено, если для параметра Выходной формат задано Набор объектов.

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

output_network_analysis_layer

Используйте этот параметр для доступа к файлу слоя сетевого анализа, хранящий настройки, а также входные и выходные данные анализа. Значение параметра заполняется, только если для параметра Сохранить выходной слой сетевого анализа задано True.

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

Примечание:

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