Вырезать локатор (Инструменты Геокодирование)

Краткая информация

Вырезает локатор на основе области интереса или экстента и создает локатор с меньшим экстентом и размером.

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

Этот инструмент может вырезать локатор на основе объектов слоя, выбранных объектов слоя или экстента. Выходные данные - новый локатор с меньшим экстентом.
При геокодировании местоположений в целевой области изучения используйте этот инструмент с целью вырезания локатора по этой области, чтобы уменьшить размер локатора и вернуть результаты геокодирования только в пределах меньшего экстента. Когда локатор вырезан, базовые данные, проиндексированные в локаторе, также будут вырезаны. При поиске адресов за пределами вырезанного локатора результаты не возвращаются.
Для обрезки локаторов ArcGIS StreetMap Premium требуется лицензия ArcGIS StreetMap Premium.
Если значение Входной локатор является составным локатором, участвующие локаторы составного локатора будут вырезаны и сохранены во вложенной папке выходного местоположения. Составной локатор будет сохранен в выходном местоположении.
Сервисы геокодирования, которые являются участвующими локаторами в составном локаторе, не будут вырезаться.

Подпись	Объяснение	Тип данных
Входной локатор	Локатор (файл ), который будет вырезан. Примечание: Сервисы геокодирования или составные локаторы, которые содержат сервисы геокодирования, включая сервисы из ArcGIS Enterprise или ArcGIS Online, в качестве участвующих локаторов, не поддерживаются. Если сервис является участвующим локатором в составном локаторе, он не будет вырезаться.	Address Locator
Выходной локатор	Вырезанный выходной локатор (файл `.loc`).	Address Locator
Область интереса (Дополнительный)	Полигональный слой, определяющий область интереса, которая будет использоваться для вырезания локатора. Этот параметр переопределяет параметр Экстент.	Feature Layer
Экстент (Дополнительный)	Определяет экстент, который будет использоваться для вырезания локатора. По умолчанию — экстент будет основан на экстенте карты на момент запуска инструмента. Используется по умолчанию. Экстент текущего отображения — экстент будет равен видимому отображению. Эта опция недоступна, если нет активной карты. Экстент не изменится, если после задания этой опции изменится карта. Как указано ниже — экстент будет основан на указанных минимальном и максимальном значениях экстента. Найти — экстент будет основан на существующем наборе данных.	Extent

arcpy.geocoding.ClipLocator(in_locator, out_locator, {area_of_interest}, {extent})

Имя	Объяснение	Тип данных
in_locator	Локатор (файл ), который будет вырезан. Примечание: Сервисы геокодирования или составные локаторы, которые содержат сервисы геокодирования, включая сервисы из ArcGIS Enterprise или ArcGIS Online, в качестве участвующих локаторов, не поддерживаются. Если сервис является участвующим локатором в составном локаторе, он не будет вырезаться.	Address Locator
out_locator	Вырезанный выходной локатор (файл `.loc`).	Address Locator
area_of_interest (Дополнительный)	Полигональный слой, определяющий область интереса, которая будет использоваться для вырезания локатора. Этот параметр замещает параметр `extent`.	Feature Layer
extent (Дополнительный)	Определяет экстент, который будет использоваться для вырезания локатора. `DISPLAY`—Экстент будет равен видимому отображению. Имя слоя — будет использоваться экстент указанного слоя. [`Extent`]объект (../../arcpy/classes/extent.yml) — будет использоваться экстент указанного объекта. Строка координат, разделенная пробелами – Будет использоваться экстент указанной строки. Координаты выражаются в порядке x-мин, y-мин, x-макс, y-макс.	Extent

Пример кода

ClipLocator, пример 1 (автономный скрипт)

Вырезать локатор США, используя полигон округа.

import arcpy

usa_locator = r"C:\Data\USA.loc"
my_clipped_locator = r"C:\Data\SanDiego.loc"
my_san_diego_polygon_layer = r"C:\Data\SanDiegoCounty.shp"

# Run ClipLocator
arcpy.geocoding.ClipLocator(usa_locator, my_clipped_locator, my_san_diego_polygon_layer)

ClipLocator пример 2 (автономный скрипт)

Вырезать локатор США, используя экстент.

import arcpy

usa_locator = r"C:\Data\USA.loc"
my_clipped_locator = r"C:\Data\SanDiego.loc"

# Define the extent using an arcpy Extent object
my_san_diego_extent = arcpy.Extent(
    -13115569.084655, 3826591.24577018, -12897364.810527, 3969918.09780486,
    spatial_reference=arcpy.SpatialReference('WGS 1984 Web Mercator (auxiliary sphere)'))

# Run ClipLocator
arcpy.geocoding.ClipLocator(usa_locator, my_clipped_locator, None, my_san_diego_extent)

Параметры среды

Этот инструмент не использует параметры среды геообработки.

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

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