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

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

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

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

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

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

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

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

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

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

Параметры

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

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

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

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

Примечание:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Feature Class
out_relationship_type
(Дополнительный)
Прежние версии:

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

В ArcGIS Pro единственно возможное значение - это STATIC.

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

Этот параметр доступен для локаторов, поддерживающих параметр страны, и позволяет ограничить область геокодирования выбранными странами. Указав страну, вы, как правило, сможете увеличить точность геокодирования. Если поле страны в параметре in_table сопоставляется с полем Country в значении параметра input_address_field, то значение страны из параметра in_table будет превалировать по сравнению со значением в параметре country.

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

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

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

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, пример (автономный скрипт)

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

import arcpy

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

# Set local variables
table = "customers.dbf"
locator = "Atlanta_AddressLocator.loc"
field_map = ("\'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(table, locator, 
                                 field_map, geocode_result)
GeocodeAddresses, пример 2 (автономный скрипт)

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

import arcpy

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

arcpy.GeocodeAddresses_geocoding(table, locator,
                                 field_map, geocode_result)
GeocodeAddresses, пример 3 (автономный скрипт)

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

Примечание:

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

import arcpy

# Set local variables
table = r"C:\data\Atlanta.gdb\customers"
locator = "https://machinename.domain.com/server/rest/services/service_name/GeocodeServer/portal_item_name"
field_map = ("\'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(table, locator, field_map, geocode_result)
GeocodeAddresses, пример 4 (автономный скрипт)

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

Примечание:

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

Примечание:

При использовании ArcGIS World Geocoding Service эта операция может потреблять кредиты.

import arcpy

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

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(table, locator, field_map, geocode_result)
GeocodeAddresses, пример 5 (автономный скрипт)

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

Примечание:

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

Примечание:

При использовании ArcGIS World Geocoding Service эта операция может потреблять кредиты.

import arcpy

# Set local variables
table = r"C:\Data\MyDatabase.gdb\DistributionCenters"

locator = "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer/ArcGIS World Geocoding Service"

field_map = "'Single Line Input' SingleLine VISIBLE NONE;Country Country VISIBLE NONE"

geocode_result = r"C:\Data\MyDatabase.gdb\DistributionCenters_Geocoded"

arcpy.geocoding.GeocodeAddresses(table, locator, field_map, geocode_result)

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

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

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