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

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

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 входного пункта обслуживания. Это поле часто используется для присоединения информации из входных пунктов обслуживания. Тип данных OutputFacilities включает поле 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 для текста участка путевого листа в начале маршрута.

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 для диагностики качества результатов, получаемых инструментом.