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

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

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

Выполнение операций геокодирования с использованием ArcGIS World Geocoding Service требует подписки организации ArcGIS Online и приводит к расходованию кредитов. Учетная запись организации должна иметь достаточное количество кредитов для выполнения всего запроса на геокодирование.

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

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

  • Некоторые локаторы поддерживают несколько входных полей адресов, например Address, Address2 и Address3. В этом случае компонент адреса может быть разделен на несколько полей, и поля адреса будут объединены во время геокодирования. Например, 100, Main St и Apt 140 в трех полях или 100 Main St и Apt 140 в двух полях в результате геокодирования образуют адрес в виде 100 Main St Apt 140.

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

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

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

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

Параметры

ПодписьОписаниеТип данных
Входная таблица

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

Table View
Входной локатор адресов

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

Примечание:

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

Address Locator
Входные поля адреса

Соответствие адресных полей, используемых локатором адресов, полям входной таблицы адресов. Выберите Одно поле, если полный адрес находится в одном поле входной таблицы, например, 303 Peachtree St NE, Atlanta, GA 30308. Выберите Несколько полей, если входной адрес разбит на несколько полей, например, Адрес, Город, Штат и Почтовый индекс, как для обычных почтовых адресов США.

Некоторые локаторы поддерживают несколько входных полей адресов, таких как Address, Address2 и Address3. В этом случае компонент адреса может быть разделен на несколько полей, и поля адреса будут объединены во время геокодирования. Например, 100, Main St и Apt 140 в трех полях или 100 Main St и Apt 140 в двух полях в результате геокодирования образуют адрес в виде 100 Main St Apt 140.

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

Field Info
Выходной класс пространственных объектов

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

Feature Class
Динамический выходной класс объектов
(Дополнительный)

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

Boolean
Страна
(Дополнительный)

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

Этот параметр ограничен для выбранной страны или стран. Если страна не указана, геокодирование выполняется по всем доступным странам локатора.

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

String
Предпочитаемый тип местоположения
(Дополнительный)

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

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

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

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

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

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

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

String
Выходные поля
(Дополнительный)

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

  • ВсеВключает все доступные выходные поля локатора в результаты геокодирования. Это значение по умолчанию
  • Только местоположениеСохраняет в результатах геокодирования поле Shape. Исходные имена полей из параметра Входная таблица сохраняются с исходными именами полей. Повторное сопоставление результатов геокодирования недоступно с этой опцией.
  • МинимальнаяДобавляются следующие поля, описывающие местоположение и то, насколько хорошо оно соответствует информации в сервисе локатора: Shape, Status, Score, Match_type, Match_addr и Addr_type. Исходные имена полей из параметра Входная таблица сохраняются с исходными именами полей.
String

arcpy.geocoding.GeocodeAddresses(in_table, address_locator, in_address_fields, out_feature_class, {out_relationship_type}, {country}, {location_type}, {category}, {output_fields})
ИмяОписаниеТип данных
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 для обычных почтовых адресов США.

Некоторые локаторы поддерживают несколько полей входных адресов, например Address, Address2 и Address3. В этом случае компонент адреса может быть разделен на несколько полей, и поля адреса будут объединены во время геокодирования. Например, 100, Main St и Apt 140 в трех полях или 100 Main St и Apt 140 в двух полях в результате геокодирования образуют адрес в виде 100 Main St Apt 140.

Если вы решите не сопоставлять необязательное входное адресное поле, используемое локатором адресов, с полем во входной таблице адресов, укажите, что отображение не требуется, выбрав <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 во Входном поле адреса, значение страны из Входной таблицы будет превалировать по сравнению со значением в параметре Страна.

Этот параметр ограничен для выбранной страны или стран. Если страна не указана, геокодирование выполняется по всем доступным странам локатора.

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

Укажите значение в виде 2-символьного или 3-символьного кода страны в списке, разделенном запятыми. См. столбец Поддерживаемые коды стран для использования входного значения.

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

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

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

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

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

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

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

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

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

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

Примечание:

Этот параметр может быть использован со входными локаторами, созданными с помощью инструмента Создать локатор или Создать локатор объектов, которые хранятся на диске или опубликованы на Enterprise версии 10.9 или более новой. Составные локаторы, содержащие хотя бы один локатор, созданный с помощью инструмента Создать локатор объектов, не поддерживают этот параметр.

  • ALLВключает все доступные выходные поля локатора в результаты геокодирования. Это значение по умолчанию
  • LOCATION_ONLYСохраняет в результатах геокодирования поле Shape. Исходные имена полей из параметра in_table сохраняются с исходными именами полей. Повторное сопоставление результатов геокодирования недоступно с этой опцией.
  • MINIMALДобавляются следующие поля, описывающие местоположение и то, насколько хорошо оно соответствует информации в сервисе локатора: Shape, Status, Score, Match_type, Match_addr и Addr_type. Исходные имена полей из параметра in_table сохраняются с исходными именами полей.
String

Пример кода

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

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

import arcpy

arcpy.env.workspace = "C:\ArcTutor\Geocoding\atlanta"

# Set local variables
address_table = "customers.dbf"
address_locator = "Atlanta_AddressLocator"
address_fields = ("\'Address or Place\' Address VISIBLE NONE;Address2 <None> VISIBLE NONE;Address3 <None> VISIBLE NONE;" +
                  "Neighborhood <None> VISIBLE NONE;City <None> VISIBLE NONE;County <None> VISIBLE NONE;" +
                  "State <None> VISIBLE NONE;ZIP ZIP <None> VISIBLE NONE;ZIP4 <None> VISIBLE NONE;" +
                  "Country <None> VISIBLE NONE")
geocode_result = "geocode_result.shp"

arcpy.GeocodeAddresses_geocoding(address_table, address_locator, 
                                 address_fields, geocode_result,
                                 'STATIC')
GeocodeAddresses, пример 2 (автономный скрипт)

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

import arcpy

# Set local variables:
address_table = r"C:\data\Atlanta.gdb\customers"
address_locator = r"C:\ags_connections\server_name.ags\Atlanta.GeocodeServer"
address_fields = "'Single Line Input' SingleLine VISIBLE NONE"
geocode_result = r"C:\outputs\geocode_result.shp"

arcpy.GeocodeAddresses_geocoding(address_table, address_locator,
                                 address_fields, geocode_result,
                                 'STATIC')
GeocodeAddresses, пример 3 (автономный скрипт)

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

Примечание:
Если вы работаете с локаторами на своем портале, убедитесь, что выполнили вход и задали его в качестве активного в ArcGIS Pro. Для доступа к локатору, расположенному на портале, отличном от активного, можно выполнить аутентификацию через SignInToPortal.

import arcpy

# Set local variables
address_table = r"C:\data\Atlanta.gdb\customers"
address_locator = "https://machinename.domain.com/server/rest/services/service_name/GeocodeServer/portal_item_name"
address_fields = ("\'Address or Place\' Address VISIBLE NONE;Address2 <None> VISIBLE NONE;Address3 <None> VISIBLE NONE;" +
                  "Neighborhood <None> VISIBLE NONE;City <None> VISIBLE NONE;County <None> VISIBLE NONE;" +
                  "State <None> VISIBLE NONE;ZIP ZIP <None> VISIBLE NONE;ZIP4 <None> VISIBLE NONE;" +
                  "Country <None> VISIBLE NONE")
geocode_result = r"C:\outputs\geocode_result.shp"

arcpy.GeocodeAddresses_geocoding(address_table, address_locator,
                                 address_fields, geocode_result,
                                 'STATIC')
GeocodeAddresses, пример 4 (автономный скрипт)

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

Примечание:
Если вы работаете с локаторами на своем портале, убедитесь, что выполнили вход и задали его в качестве активного в ArcGIS Pro. Для доступа к локатору, расположенному на портале, отличном от активного, можно выполнить аутентификацию через SignInToPortal.

import arcpy

# Set local variables
address_table = r"C:\data\Addresses.csv"

# Using the World Geocoding Service charges credits to the signed in account
address_locator = "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer/ArcGIS World Geocoding Service"
field_map = ("\'Address or Place\' Address VISIBLE NONE;Address2 <None> VISIBLE NONE;Address3 <None> VISIBLE NONE;" +
             "Neighborhood <None> VISIBLE NONE;City <None> VISIBLE NONE;Subregion <None> VISIBLE NONE;" +
             "Region <None> VISIBLE NONE;ZIP ZIP <None> VISIBLE NONE;ZIP4 <None> VISIBLE NONE;" +
             "Country <None> VISIBLE NONE")
geocode_result = r"C:\outputs\geocode_result.shp"

arcpy.GeocodeAddresses_geocoding(address_table, address_locator,
                                 address_fields, geocode_result,
                                 'STATIC')

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

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

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