Skip To Content

Геокодировать адреса

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

Геокодирует таблицу с адресами. Для этого процесса требуется таблица, в которой хранятся адреса, которые вы хотите геокодировать, а также локатор адресов или составной локатор адресов. Этот инструмент сопоставляет адреса с локатором адресов и сохраняет результат для каждой входной записи в новом классе точечных пространственных объектов. При использовании сервиса ArcGIS World Geocoding Service, эта операция может потреблять кредиты.

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

  • Вы можете геокодировать адреса, хранящиеся в одном поле или в нескольких полях. Одно входное поле содержит полный адрес, например, 303 Peachtree St NE, Atlanta, GA 30308. Несколько полей поддерживаются, если входной адрес разбит на несколько полей, например, Address, City, State и ZIP для обычных почтовых адресов США.

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

  • Выходной класс объектов по умолчанию сохраняет копию входного адреса и дополнительную информацию – количество набранных очков, статус и сопоставленный адрес каждой записи. Адреса могут повторно сопоставляться с помощью инструмента Повторно сопоставить адреса или диалогового окна Интерактивное сопоставление, которое открывается на панели Повторно сопоставить адреса. Редактирование адресов во входной таблице адресов не изменит результат в выходном классе объектов, когда будет завершен процесс сопоставления и создан класс пространственных объектов.

    Более подробно о повторном сопоставлении результатов геокодирования

  • Для геокодирования таблицы адресов с помощью сервиса ArcGIS Online for organizations необходима подписка ArcGIS World Geocoding Service. Дополнительные сведения см. в разделе Работа с сервисом геокодирования ArcGIS Online World Geocoding Service.

Синтаксис

GeocodeAddresses_geocoding (in_table, address_locator, in_address_fields, out_feature_class, {out_relationship_type}, {country}, {location_type}, {category})
ПараметрОбъяснениеТип данных
in_table

Таблица адресов для геокодирования

Table View
address_locator

Локатор адресов для геокодирования таблицы адресов.

Примечание:

Включение дополнительного модуля .loc после имени локатора в конце пути локатора является дополнительным.

Address Locator
in_address_fields
[input_address_field, table_field_name]

Сопоставление каждого поля в данном параметре производится в формате input_address_field, table_field_name, где input_address_field – имя поля входного адреса, указанного локатором адресов, а table_field_name – имя соответствующего поля в таблице адресов, для которой вы производите геокодирование.

Вы можете указать одно входное поле, которое содержит полный адрес, например, 303 Peachtree St NE, Atlanta, GA 30308. Или, можно указать несколько полей, если входной адрес разбит на несколько полей, например, Address, City, State и ZIP для обычных почтовых адресов США.

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

Field Info
out_feature_class

Выходной геокодированный класс пространственных объектов или шейп-файл.

Feature Class
out_relationship_type
(Дополнительный)

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

  • STATICСоздает статическую копию входной таблицы адресов в выходном классе объектов. Это единственное допустимое значение.
  • DYNAMICЭто опция не используется в ArcGIS Pro. См. справку ArcGIS Desktop по этому инструменту.
Boolean
country
[country,...]
(Дополнительный)

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

При этом применяется ограничение по выбранной стране или странам, а если страна не задана, геокодирование выполняется по всем поддерживаемым локатором странам. Входное значение должно быть указано как ISO 3166-1 3-значный код страны.

Страна поддерживается не для всех локаторов.

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

Задает предпочитаемую выходную геометрию для соответствия POINT_ADDRESS. Варианты этого параметра - ROUTING_LOCATION, сторона улицы, которую можно использовать для построения маршрутов, либо ADDRESS_LOCATION, местоположение, находящееся на крыше здания или в центре земельного участка. Если предпочитаемое местоположение отсутствует в данных, вместо него будет возвращено местоположение ROUTING_LOCATION по умолчанию. Для результатов геокодирования с Addr_type=PointAddress, атрибутивные значения x,y соответствуют координатам адреса, а значения DisplayX и DisplayY описывают координаты верхней точки крыши или центроида здания. См. справочную онлайн-систему REST API для получения подробной информации о параметре locationType для reverseGeocode.

Этот параметр не поддерживается для всех локаторов.

  • ADDRESS_LOCATIONВозвращает геометрию для результатов геокодирования, которые представляют адреса таких элементов местоположений, как верхняя точка крыши, центроид участка или входная дверь.
  • ROUTING_LOCATIONВозвращает геометрию результатов геокодирования, которая может отобразить местоположение, находящееся рядом с улицей и использующееся для построения маршрутов. Используется по умолчанию.
String
category
[category,...]
(Дополнительный)

Ограничивает типы местоположений, в которых локатором выполняется поиск, это убирает ложно положительные совпадения и ускоряет процесс поиска. Если категория не используется, геокодирование будет осуществляться по всем поддерживаемым категориям. Не для всех локаторов и не для всех стран поддерживаются все значения категорий. В целом, этот параметр используется для:

  • Ограничения совпадений уровнями адресов или определенными типами местоположений
  • Недопущения совпадений на нежелательных уровнях адресов
  • Неточный поиск координат

Этот параметр не поддерживается для всех локаторов.

См. веб-справку к REST API для получения сведений о фильтрации категорий.

String

Пример кода

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

В следующем скрипте в окне Python показано, как использовать функцию GeocodeAddress для геокодирования таблицы адресов.

import arcpy
arcpy.env.workspace = "C:\ArcTutor\Geocoding\atlanta"
# Set local variables:
address_table = "customers.dbf"
address_locator = "Atlanta_AddressLocator"
address_fields = "Street Address;City City;State State;ZIP Zip"
geocode_result = "geocode_result.shp"
arcpy.GeocodeAddresses_geocoding(address_table, address_locator, address_fields, 
                                 geocode_result, 'STATIC')

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

  • ArcGIS Desktop Basic: Ограничено
  • ArcGIS Desktop Standard: Да
  • ArcGIS Desktop Advanced: Да

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