ArcMap

Создать локатор адресов

Сводка

Создает локатор адресов. Локатор адресов может применяться для поиска местоположения адреса, геокодирования таблицы адресов, а также для получения адреса точечного местоположения.

Более подробно об общих задачах геокодирования

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

  • Локатор адресов может быть создан в любой указанной вами папке.

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

    • Главная таблица – определяет первичный класс объектов базового набора данных для локатора, таких как класс объектов центральных линий улицы. Эта таблица – обязательная.
    • Таблица альтернативных городских названий – определяет таблицу альтернативных городских названий, которая содержит альтернативные названия городов или местоположений. Данная таблица должна содержать JoinID для соединения с основной таблицей. Эта таблица не является обязательной.
    • Таблица альтернативных названий – определяет таблицу альтернативных названий улиц, которая содержит альтернативные названия улиц или точечных объектов. Данная таблица должна содержать JoinID для соединения с основной таблицей. Эта таблица не является обязательной.
    • Таблица псевдонимов – определяет таблицу географических псевдонимов, которая содержит географические названия и действительные адреса для этих названий. Пользователь может найти местоположение либо по географическому названию, такому, как Полевой музей, либо по адресу 1400 S Lakeshore Drive Chicago, IL 60605. Эта таблица не является обязательной.

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

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

Синтаксис

arcpy.geocoding.CreateAddressLocator(in_address_locator_style, in_reference_data, in_field_map, out_address_locator, {config_keyword}, {enable_suggestions})
ПараметрОбъяснениеТип данных
in_address_locator_style

Стиль локатора адресов, на основе которого будет создан новый локатор.

  • US Address-Dual Ranges – используется, когда базовые данные являются классом линейных объектов, содержащим диапазоны номеров домов с обеих сторон сегмента улицы, и требуется выполнить поиск адреса на определенной стороне улицы или перекрестка улиц.
  • US Address-One Range – используется, когда базовые данные являются классом линейных объектов с одним диапазоном номеров домов для каждого сегмента улицы, и вы хотите найти адрес (где сторона не нужна) или пересечение улиц.
  • US Address-Single House – используется, когда базовые данные являются классом точечных или полигональных объектов, где каждый объект представляет один адрес, и вы хотите найти точный адрес участка, здания или точки адреса.
  • US Address-Single House Subaddress – используется, когда базовые данные являются классом точечных или полигональных объектов, где каждый объект представляет один адрес с дополнительными элементами субадресации, и вы хотите искать квартиры, таунхаусы, дуплексы или магазины в торговом центре.
  • US Address-Street Name – используется, когда базовые данные являются классом линейных объектов, и вы хотите искать адреса, вводя только название улицы. Информация о диапазоне адресов не требуется.
  • US Address-City State – используется, когда базовые данные являются классом точечных или полигональных объектов, и вы хотите найти определенный город в штате.
  • US Address-ZIP 5 Digit – используется, когда базовые данные являются классом точечных или полигональных объектов, где каждый объект представляет собой центроид или географическую область с почтовым индексом, и вы хотите найти определенное местоположение почтового индекса.
  • General-Gazetteer – используется, когда базовые данные являются классом точечных или полигональных объектов, где каждый объект представляет какой-либо уникальный объект, и вы хотите найти имя места, ориентир, счетчик воды или любое уникальное значение.
Address Locator Style
in_reference_data
[[Reference Data, {Role}],...]

Классы объектов и таблицы базовых данных, которые будут использоваться локатором адресов, вместе с их ролями.

  • Главная таблица – определяет первичный класс объектов базового набора данных для локатора, таких как класс объектов центральных линий улицы. Эта таблица – обязательная.
  • Таблица альтернативных городских названий – определяет таблицу альтернативных городских названий, которая содержит альтернативные названия городов или местоположений. Данная таблица должна содержать JoinID для соединения с основной таблицей. Эта таблица не является обязательной.
  • Таблица альтернативных названий – определяет таблицу альтернативных названий улиц, которая содержит альтернативные названия улиц или точечных объектов. Данная таблица должна содержать JoinID для соединения с основной таблицей. Эта таблица не является обязательной.
  • Таблица псевдонимов – определяет таблицу географических псевдонимов, которая содержит географические названия и действительные адреса для этих названий. Пользователь может найти местоположение либо по географическому названию, такому, как Полевой музей, либо по адресу 1400 S Lakeshore Drive Chicago, IL 60605. Эта таблица не является обязательной.

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

Value Table
in_field_map

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

# <locator field alias> <dataset field name> VISIBLE NONE

# This shows as an example:
reference_data_field_map = """
"'Feature ID' FeatureID VISIBLE NONE;'*From Left' L_F_ADD VISIBLE NONE;
'*To Left' L_T_ADD VISIBLE NONE;'*From Right' R_F_ADD VISIBLE NONE;
'*To Right' R_T_ADD VISIBLE NONE;'Prefix Direction' PREFIX VISIBLE NONE;
'Prefix Type' PRE_TYPE VISIBLE NONE;'*Street Name' NAME VISIBLE NONE;
'Suffix Type' TYPE VISIBLE NONE;'Suffix Direction' SUFFIX VISIBLE NONE"""

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

VISIBLE – поле отображается; NONE – геометрия является копией исходного значения.

Если вы решите не сопоставлять необязательное поле базовых данных, которое используется стилем локатора адресов, с полем в наборе базовых данных, то надо указать, что сопоставление не требуется, введя значение <None> вместо имени поля.

Field Info
out_address_locator

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

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

Ключевое слово конфигурации, определяющее параметры хранения таблицы в РСУБД – только в многопользовательских и файловых базах геоданных.

String
enable_suggestions
(Дополнительный)

Разрешает автоматический поиск вариантов по мере ввода пользователем символов в клиентском приложении. Эта возможность облегчает процесс интерактивного поиска, уменьшая количество символов, которые требуется ввести до получения соответствия. Идея заключается в том, что клиентское приложение предлагает список вариантов, обновляемый с каждым введенным пользователем символом, пока список не отобразит искомое слово.

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

  • ENABLED —Для локатора активированы предложения.
  • DISABLED —Для локатора не активированы предложения. Используется по умолчанию.
Boolean

Пример кода

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

Скрипт Python, демонстрирующий использование функции CreateAddressLocator.

# Create a street address locator using a street centerline feature class 
# in a file geodatabase as reference data.
# The new address locator will be created in a separate file folder.

# Import system modules
import arcpy

arcpy.env.workspace = "C:/ArcTutor/Geocoding/atlanta.gdb"
Atlanta_AddressLocator_OutputPath = "C:/ArcTutor/Geocoding/Atlanta"

arcpy.CreateAddressLocator_geocoding("US Address - Dual Ranges", "streets 'Primary Table'", "'Feature ID' OBJECTID VISIBLE NONE;'*From Left' L_F_ADD VISIBLE NONE;'*To Left' L_T_ADD VISIBLE NONE;'*From Right' R_F_ADD VISIBLE NONE;'*To Right' R_T_ADD VISIBLE NONE;'Prefix Direction' PREFIX VISIBLE NONE;'Prefix Type' PRE_TYPE VISIBLE NONE;'*Street Name' NAME VISIBLE NONE;'Suffix Type' TYPE VISIBLE NONE;'Suffix Direction' SUFFIX VISIBLE NONE;'Left City or Place' CITYL VISIBLE NONE;'Right City or Place' CITYR VISIBLE NONE;'Left ZIP Code' ZIPL VISIBLE NONE;'Right ZIP Code' ZIPR VISIBLE NONE;'Left State' STATE_ABBR VISIBLE NONE;'Right State' STATE_ABBR VISIBLE NONE", Atlanta_AddressLocator_OutputPath, "", "DISABLED")

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

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

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

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