Вычислить положения (Network Analyst)—ArcGIS Pro

Сводка

Помещает входные объекты в сеть и добавляет во входные объекты поля, описывающие эти сетевые местоположения. Инструмент используется для сохранения сведений о сетевом положении в виде атрибутов для быстрой загрузки объектов как входных объектов для сетевого анализа.

Более подробно о добавлении объектов в сети.

Использование

Это инструмент используется для вычисления полей положений, которые могут быть введены в инструмент Добавить положения. Это инструмент применяется в отношении объектов, которые используются в качестве входных в слое сетевого анализа более одного раза. После вычисления положения для быстрой загрузки объектов, как новых положений, можно использовать параметр Использовать поля сетевых положений вместо геометрии инструмента Добавить положения.
Это инструмент также можно использовать для пересчета сетевых положений, не расположенных в слое сетевого анализа при использовании другого набора параметров поиска. Например, если остановки на маршруте изначально были добавлены в слой сетевого анализа с допуском при поиске в 500 метров, и некоторые из них не были размещены с точными координатами, можно выбрать эти неразмещенные остановки, например, с помощью инструмента Выбрать в слое по атрибуту и выполнить операцию повторно, указав подслой остановок в качестве Входного объекта с повышенной точностью поиска.
Данный инструмент работает значительно быстрее, если классы пространственных объектов, используемые в качестве сетевых источников в наборе сетевых данных, имеют корректный и актуальный пространственный индекс.

Синтаксис

CalculateLocations(in_point_features, in_network_dataset, {search_tolerance}, {search_criteria}, {match_type}, {source_ID_field}, {source_OID_field}, {position_field}, {side_field}, {snap_X_field}, {snap_Y_field}, {distance_field}, {snap_Z_field}, {location_field}, {exclude_restricted_elements}, {search_query}, {travel_mode})

Parameter	Объяснение	Тип данных
in_point_features	Входные объекты, на основании которых будут вычислены сетевые положения. Для линейных и полигональных объектов поддерживаются только классы объектов баз геоданных, поскольку сведения о сетевых положениях хранятся в поле BLOB (указанном в параметре Поле диапазона положений).	Table View
in_network_dataset	Набор сетевых данных, который будет использоваться для вычисления местоположений. Если в качестве входного объекта используется подслой слоя сетевого анализа, параметр следует связывать с набором сетевых данных, упомянутым в слое сетевого анализа.	Network Dataset Layer
search_tolerance (Дополнительный)	Допуск поиска, который будет использоваться для обнаружения входных объектов в сети. Объекты, находящиеся вне диапазона поиска, остаются неразмещенными. Параметр включает значение и единицы измерения допуска. По умолчанию 5000 метров. Этот параметр не используется при вычислении положений для линейных и полигональных объектов.	Linear Unit
search_criteria [[Source, SnapType],...] (Дополнительный)	Источники в наборе сетевых данных, поиск которых будет осуществляться при обнаружении местоположений и частей геометрии (известных как типы замыкания), которые будут использоваться. Значение параметра указывается в виде списка с вложенными списками. Вложенный список состоит из двух значений, указывающих на имя и тип замыкания для каждого источника сети. Тип замыкания указывается с использованием ключевых слов SHAPE, MIDDLE, END или NONE. SHAPE – точка будет расположена на ближайшей точке элемента этого сетевого источника. MIDDLE – точка будет расположена на ближайшей средней точке элемента этого сетевого источника. END – точка будет расположена на ближайшей конечной точке элемента этого сетевого источника. NONE – точка не будет расположена на элементах этого сетевого источника. Например, при поиске положений, значение параметра [["Streets","SHAPE"],["Streets_ND_Junctions","NONE"]] указывает, что поиск может быть выполнен по геометрии источника Streets, но не источника Streets_ND_Junctions. Для указания нескольких типов замыкания для отдельного источника сети, используйте сочетание ключевых слов для типа замыкания, разделенных знаком подчеркивания. Например, MIDDLE_END указывает, что положения могут быть замкнуты на среднюю или конечную точку источника сети. Для наборов сетевых данных базы геоданных типы замыкания могут быть указаны для каждого подтипа источника сети (["Streets : Local Streets","SHAPE"]). При вычислении положений для линейного или полигонального объекта используется только тип замыкания SHAPE, даже в том случае, если указаны другие типы. Любой не включенный в этот список сетевой источник будет использовать тип замыкания по умолчанию. Самый безопасный способ – включить все сетевые источники в ваш список и явно задать тип замыкания для каждого из них. Значение по умолчанию SHAPE для всех сетевых источников, кроме системных соединений, где применяется значение по умолчанию NONE.	Value Table
match_type (Дополнительный)	MATCH_TO_CLOSEST —Новые сетевые положения будут сопоставляться с ближайшим источником сети среди всех источников, которые имели тип замыкания, указанный в критерии поиска. Это значение по умолчанию. PRIORITY —Новые сетевые положения будут сопоставляться с первым источником сети, имеющим тип замыкания, указанный в критерии поиска. Поиск источников выполняется в приоритетном порядке, поиск останавливается после нахождения положения в пределах допуска поиска. Этот параметр не используется при вычислении положений для линейных и полигональных объектов.	Boolean
source_ID_field (Дополнительный)	Имя поля, которое будет создаваться или обновляться с помощью ID источника для вычисленного сетевого положения. Поле с именем SourceID создается или обновляется по умолчанию. Этот параметр не используется при вычислении положений для линейных и полигональных объектов.	Field
source_OID_field (Дополнительный)	Имя поля, которое будет создаваться или обновляться с помощью OID источника для вычисленного сетевого положения. Поле с именем SourceOID создается или обновляется по умолчанию. Этот параметр не используется при вычислении положений для линейных и полигональных объектов.	Field
position_field (Дополнительный)	Имя поля, которое будет создано или обновлено в процентах вместе с вычисленным сетевым положением. Поле с именем PosAlong создается или обновляется по умолчанию. Этот параметр не используется при вычислении положений для линейных и полигональных объектов.	Field
side_field (Дополнительный)	Имя поля, которое будет создано или обновлено с использованием стороны ребра, на котором расположен точечный объект в вычисленном сетевом положении. Поле с именем SideOfEdge создается или обновляется по умолчанию. Этот параметр не используется при вычислении положений для линейных и полигональных объектов.	Field
snap_X_field (Дополнительный)	Имя поля, которое будет создаваться или обновляться с помощью координаты х вычисленного сетевого положения. Поле с именем SnapX создается или обновляется по умолчанию. Этот параметр не используется при вычислении положений для линейных и полигональных объектов.	Field
snap_Y_field (Дополнительный)	Имя поля, которое будет создаваться или обновляться с помощью координаты у вычисленного сетевого положения. Поле с именем SnapY создается или обновляется по умолчанию. Этот параметр не используется при вычислении положений для линейных и полигональных объектов.	Field
distance_field (Дополнительный)	Имя поля, которое будет создано или обновлено с учетом расстояния точечного объекта от вычисленного сетевого положения. Поле Distance создается и обновляется по умолчанию. Выходное поле содержит значения в метрах. Этот параметр не используется при вычислении положений для линейных и полигональных объектов.	Field
snap_Z_field (Дополнительный)	Имя поля, которое будет создаваться или обновляться с помощью координаты z вычисленного сетевого положения. Поле с именем SnapZ создается или обновляется по умолчанию. Этот параметр не используется при вычислении положений для линейных и полигональных объектов. При вычислении положений для точечных объектов параметры используется только в случае поддержки набором сетевых данных связей на основе значений z-координат источников. В остальных случаях используйте в качестве значения параметра "#".	Field
location_field (Дополнительный)	Имя поля, которое будет создано или обновлено, используя диапазоны положений, для вычисляемых сетевых положений для линейных и полигональных объектов. Поле с именем Locations создается или обновляется по умолчанию. Параметр используется только при вычислении положений для линейных и полигональных объектов. Для точечных входных объектов используйте значение параметра "#".	Field
exclude_restricted_elements (Дополнительный)	Определяет, будет ли исключаться части сети с ограничениями при размещении входных объектов. Точки не будут размещены на элементах, для которых в указанном режиме передвижения действует ограничение. Если режим передвижения не указан, будут использованы ограничения, использующиеся в сети по умолчанию. EXCLUDE —Сетевые положения размещаются только на проходимых участках сети. Это предотвратит размещение сетевых положений на элементах, которых нельзя достичь из-за ограничений или барьеров. Чтобы получить ожидаемые результаты, перед перемещением сетевых положений с использованием этого параметра, убедитесь в том, что в слой сетевого анализа уже добавлены все ограничивающие барьеры. Это значение используется по умолчанию. INCLUDE —Сетевые положения размещаются на всех элементах сети. Сетевые положения, перемещаемые с использованием этого параметра, могут быть недоступны в процессе решения, если они размещены на ограниченных элементах.	Boolean
search_query [[Source, Expression],...] (Дополнительный)	Определяет запрос, который ограничивает поиск поднабором объектов в исходном классе объектов. Эта опция полезна, если вы не хотите находить объекты, которые могут не подходить для сетевого положения. Например, если вы загружаете центроиды полигонов, и не хотите размещать их на дорогах местного значения, вы можете задать запрос, по которому будет выполняться поиск только для основных магистралей. Значение параметра указывается в виде списка с вложенными списками. Вложенный список состоит из двух значений, указывающих имя и выражение SQL для всех источников сети. Синтаксис выражения SQL несколько различается в зависимости от типа класса объектов источника сети. Например, если вы выполняете запрос к исходному классу объектов, хранящемуся в файловой или многопользовательской базе геоданных, шейп-файлам, SDC, то имена полей необходимо заключить в двойные кавычки: "CFCC". Если вы выполняете запрос к исходному классу объектов, хранящемуся в персональной базе геоданных, заключите поля в квадратные скобки: [CFCC]. Если запрос для конкретного источника указывать не нужно, используйте "#" в качестве значения для выражения SQL, или исключите имя источника и выражение SQL из значения параметра. Если запрос для всех источников сети указывать не нужно, используйте "#" в качестве значения параметра. Например, значение параметра [["Streets","\"CFCC\" = 'A15'"], ["Streets_ND_Junctions",""]] определяет выражение SQL для исходного класса объектов Streets и отсутствие выражения для исходного класса объектов Streets_ND_Junctions. Обратите внимание, что двойные кавычки, окружающие имя поля CFCC, можно проигнорировать, добавив символы обратной косой черты, что позволит избежать ошибки анализа в интерпретаторе Python. По умолчанию запрос не используется.	Value Table
travel_mode (Дополнительный)	Имя режима передвижения, который будет использован для выполнения анализа. Если вы выбрали режим передвижения, настройки режима передвижения, такие как ограничения или атрибуты импеданса будут учтены при вычислении полей положений. Например, если ближайшее к входной точке ребро сети закрыто для передвижения грузового транспорта, а режим передвижения установлен на грузовую перевозку, функция Вычислить положения расположит точку на ближайшем ребре сети, передвижение грузового транспорта по которому разрешено. Доступные режимы передвижения зависят от значения параметра in_network_dataset. Если в качестве входного объекта используется подслой слоя сетевого анализа, параметр Режим передвижения должен быть установлен в слое сетевого анализа.	String

Производные выходные данные

Name	Объяснение	Тип данных
out_point_feature_class	Обновленные входные объекты.	Представление таблицы

Пример кода

CalculateLocations, пример 1 (окно Python)

Использование параметра Вычислить положения для точечных объектов только с обязательными параметрами.

stores = "C:/Data/SanFrancisco.gdb/Analysis/Hospitals/Analysis/Stores"
network = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
arcpy.na.CalculateLocations(stores, network, "5000 Meters",
                            [["Streets", "SHAPE"],
                            ["Streets_ND_Junctions", "NONE"]])

CalculateLocations, пример 2 (окно Python)

Вычислить положения для точечных объектов на объектах улиц, но не на других источниках сетевых данных.

warehouses = "C:/Data/Paris.gdb/Analysis/Warehouses"
network = "C:/Data/Paris.gdb/Transportation/ParisMultimodal_ND"
arcpy.na.CalculateLocations(warehouses, network, "5000 Meters",
    [["Metro_Lines", "NONE"], ["Streets", "SHAPE"],
    ["Transfer_Stations", "NONE"], ["Metro_Entrances", "NONE"],
    ["Metro_Stations", "NONE"], ["ParisMultimodal_ND_Junctions", "NONE"]],
    "MATCH_TO_CLOSEST", "SID", "SOID", "PA", "SOE", "SnapX", "SnapY",
    "Distance")

CalculateLocations, пример 3 (окно Python)

Использование Вычислить положения для полигональных объектов.

parks = "C:/Data/SanFrancisco.gdb/Analysis/Hospitals/Basemap/Parks"
network = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
arcpy.na.CalculateLocations(parks, network, "", [["Streets", "SHAPE"],
                            ["Streets_ND_Junctions", "NONE"]],
                            location_field="Locations")

CalculateLocations, пример 4 (автономный скрипт Python)

Следующий скрипт Python является примером использования инструмента CalculateLocations в автономном скрипте.

# Name: CalculateLocations_ex04.py
# Description: Calculate network locations for fire stations. Make sure that the
#              fire stations are not located on the freeways.
# Requirements: Network Analyst Extension

#Import system modules
import arcpy
from arcpy import env

try:
    #Set environment settings
    env.workspace = "C:/Data/SanFrancisco.gdb"

    #Set local variables
    in_features = "Analysis/FireStations"
    network = "Transportation/Streets_ND"
    search_tolerance = "2000 Meters"
    search_criteria = [["Streets", "SHAPE"], ["Streets_ND_Junctions", "NONE"]]
    search_query = [["Streets", '"FREEWAY" = 0'], ["Streets_ND_Junctions", ""]]

    #Calculate network locations and store them in defaut field names
    arcpy.na.CalculateLocations(in_features, network, search_tolerance,
                                search_criteria, "MATCH_TO_CLOSEST",
                                exclude_restricted_elements="EXCLUDE",
                                search_query=search_query)

    print("Script completed successfully.")

except Exception as e:
    # If an error occurred, print line number and error message
    import traceback, sys
    tb = sys.exc_info()[2]
    print(("An error occurred on line %i" % tb.tb_lineno))
    print((str(e)))

Environments

Текущая рабочая область

Информация о лицензиях

Basic: Да
Standard: Да
Advanced: Да

Связанные разделы

Отзыв по этому разделу?