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

Сводка

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

Прежние версии:

Этот инструмент устарел. Теперь эта функциональность заменена инструментом Создать локатор.

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

  • Локаторы адресов можно создать в указанной вами папке с файлами. В ArcGIS Pro локаторы должны храниться в файловой папке, а не в базе геоданных.

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

    • Главная таблица – определяет первичный класс объектов базового набора данных для локатора, таких как класс объектов центральных линий улицы. Эта таблица – обязательная.
    • Таблица альтернативных городских названий – определяет таблицу альтернативных городских названий, которая содержит альтернативные названия городов или местоположений. Данная таблица должна иметь JoinID для соединения с главной таблицей. Эта таблица не является обязательной.
    • Таблица альтернативных названий – определяет таблицу альтернативных названий улиц, которая содержит альтернативные названия улиц или точечных объектов. Данная таблица должна иметь JoinID для соединения с главной таблицей. Эта таблица не является обязательной.
    • Таблица псевдонимов – определяет таблицу географических псевдонимов, которая содержит географические названия и действительные адреса для этих названий. Пользователи могут найти местоположение либо по географическому названию, такому, как Музей им. Филда (Field Museum), либо по адресу 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})
ParameterОбъяснениеТип данных
in_address_locator_style

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

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

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

  • Primary table – определяет основной класс объектов базового набора данных для локатора, таких как класс объектов центральных линий улиц. Эта таблица – обязательная.
  • Alternate City Name table – определяет таблицу альтернативных городских названий, которая содержит альтернативные названия городов или местоположений. Данная таблица должна иметь JoinID для соединения с главной таблицей. Эта таблица не является обязательной
  • Alternate Name table– определяет таблицу альтернативных названий улиц, которая содержит альтернативные названия улиц или точечных объектов. Данная таблица должна иметь JoinID для соединения с главной таблицей. Эта таблица не является обязательной.
  • Alias table – определяет таблицу географических псевдонимов, которая содержит географические названия и действительные адреса для этих названий. Пользователи могут найти местоположение либо по географическому названию, такому, как Музей им. Филда (Field Museum), либо по адресу 1400 S Lakeshore Drive Chicago, IL 60605. Эта таблица не является обязательной.

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

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

Примечание:

При создании локатора с базовыми данными, содержащими миллионы пространственных объектов, необходимо иметь по крайней мере в 3-4 раза больший размер свободного пространства на диске, где находится директория temp, поскольку файлы, используемые для создания локатора, записываются в это местоположение перед копированием локатора в выходное местоположение. Если у вас недостаточно места на жестком диске, произойдет сбой, когда свободное место закончится. Также, что при создании очень больших локаторов, на компьютере должно быть достаточное количество RAM для обработки процессов, занимающих большие объемы памяти.

Value Table
in_field_map

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

# <locator field alias> <dataset field name>
# This shows as an example:
reference_data_field_map = """
"'Feature ID' FeatureID;'*From Left' L_F_ADD;
'*To Left' L_T_ADD;'*From Right' R_F_ADD;
'*To Right' R_T_ADD;'Prefix Direction' PREFIX;
'Prefix Type' PRE_TYPE;'*Street Name' NAME;
'Suffix Type' TYPE;'Suffix Direction' SUFFIX;
'Left City or Place' CITYL;'Right City or Place' 
CITYR;'Left ZIP Code' ZIPL;'Right ZIP Code' 
ZIPR;'Left State' State_Abbr;'Right State' State_Abbr"
"""

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

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

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

Field Info
out_address_locator

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

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

Этот параметр не действует в ArcGIS Pro. Он остался в программе для обеспечения обратной совместимости .

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

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

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

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

Пример кода

Пример CreateAddressLocator (окно Python)

Окно 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 file folder.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/ArcTutor/Geocoding/atlanta"
arcpy.CreateAddressLocator_geocoding("US Address - Dual Ranges", "streets.shp 'Primary table'", "'Feature ID' FID;'*From Left' L_F_ADD;'*To Left' L_T_ADD;'*From Right' R_F_ADD;'*To Right' R_T_ADD;'Prefix Direction' PREFIX;'Prefix Type' PRE_TYPE;'*Street Name' NAME;'Suffix Type' TYPE;'Suffix Direction' SUFFIX;'Left City or Place' CITYL;'Right City or Place' CITYR;'Left ZIP Code' ZIPL;'Right ZIP Code' ZIPR;'Left State' State_Abbr;'Right State' State_Abbr", "Atlanta_AddressLocator", "", "DISABLED")

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

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

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