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

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

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

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

  • Этот инструмент может вырезать локатор на основе объектов слоя, выбранных объектов слоя или экстента. Выходные данные - новый локатор с меньшим экстентом.

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

  • Для вырезания локаторов ArcGIS StreetMap Premium требуется лицензия ArcGIS StreetMap Premium.

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

  • Сервисы геокодирования, которые являются участвующими локаторами в составном локаторе, не будут вырезаться.

Параметры

ПодписьОписаниеТип данных
Входной локатор

Локатор (файл .loc), который будет вырезан.

Примечание:

Сервисы геокодирования или составные локаторы, которые содержат сервисы геокодирования, включая сервисы из 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

Локатор (файл .loc), который будет вырезан.

Примечание:

Сервисы геокодирования или составные локаторы, которые содержат сервисы геокодирования, включая сервисы из ArcGIS Enterprise или ArcGIS Online, в качестве участвующих локаторов, не поддерживаются. Если сервис является участвующим локатором в составном локаторе, он не будет вырезаться.

Address Locator
out_locator

Вырезанный выходной локатор (файл .loc).

Address Locator
area_of_interest
(Дополнительный)

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

Этот параметр переопределяет параметр extent.

Feature Layer
extent
(Дополнительный)

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

  • DISPLAY – экстент будет равен видимому отображению.
  • Имя слоя - будет использоваться тот же экстент, что и в указанном слое.
  • Объект Extent — будет использоваться экстент указанного объекта.
  • Строка координат, разделенных пробелами – будет использоваться экстент из заданной строки. Координаты должны быть выражены в таком порядке: x-min, y-min, x-max, y-max.
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)

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

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