Геокодировать адреса (Инструменты Геокодирование)

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

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

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

Примечание:

В верхней части инструмента доступна оценка кредитов, если активный портал — это ArcGIS Online, а входной локатор — это ArcGIS World Geocoding Service.

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

Вы можете геокодировать адреса, которые хранятся в одном поле, разделены на несколько полей или хранятся в одном поле и поле страны. Одно входное поле содержит полный адрес, например, 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 World Geocoding Service требуется подписка на ArcGIS Online для организаций.
Следующие параметры поддерживаются не для всех локаторов, используемых для значения параметра Входной локатор адресов: Страна или регион, Предпочитаемый тип местоположения и Категория.
Чтобы построить правильный синтаксис Python, сначала запустите инструмент на панели Геообработка, используя соответствующую опцию параметра. Затем откройте меню Запуск и выберите опцию Скопировать команду Python.
При геокодировании таблицы адресов или мест с использованием локатора с поддержкой z-значений используйте этот инструмент в локальной сцене. Результаты геокодирования с поддержкой z-значений будут автоматически добавлены в локальную сцену со свойствами высоты, установленными в опции На абсолютной высоте ![] (../../icons/ElevationAbsoluteHeight16.png).

Если локальная сцена содержит поверхность высот, по которой были оцифрованы базовые данные, использованные при создании локатора, установите для свойства высот результатов геокодирования опцию На абсолютной высоте![]. Это можно сделать в диалоговом окне Свойства слоя на вкладке Высоты. Если поверхность высот, использованная для создания базовых данных, не находится в локальной сцене, установите для высот результатов геокодирования опцию Относительно уровня земли![].

Более подробно об определении высотных характеристик для слоев

Подпись	Объяснение	Тип данных
Входная таблица	Таблица адресов, которая будет геокодирована.	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. В ArcGIS Pro единственным допустимым значением является `STATIC`. Отмечено–Эта опция не используется в ArcGIS Pro. См. справку ArcGIS Desktop по этому инструменту. Не отмечено–Создает статическую копию входной таблицы адресов в выходном классе объектов. Это единственное допустимое значение.	Boolean
Страна или регион (Дополнительный)	Страна или страны, по которым будет проводиться поиск геокодированных адресов. Выбор страны зачастую помогает увеличить точность геокодирования. Если страна не указана, геокодирование выполняется по всем доступным странам локатора. Значение этого параметра будет переопределено, если вы зададите Одно поле и поле страны для параметра Входные поля адресов.	String
Предпочитаемый тип местоположения (Дополнительный)	Задает предпочитаемую выходную геометрию, которая будет возвращена для соответствий `PointAddress`. Если желаемое местоположение отсутствует в данных, будет возвращено местоположение адреса по умолчанию. См. веб-справку к ArcGIS REST API для получения подробной информации о параметре `locationType` для `geocodeAddresses`. Местоположение адреса–Возвращается геометрия для результатов геокодирования, которые представляют адреса таких элементов местоположений, как верхняя точка крыши, центроид участка или входная дверь. Используется по умолчанию. Местоположение маршрута–Будет возвращена геометрия результатов геокодирования, которые представляют местоположение рядом с обочиной улицы, которое может использоваться для маршрутизации транспортных средств.	String
Категория (Дополнительный)	Ограничивает типы мест, которые ищет локатор, что исключает ложноположительные совпадения, нежелательные совпадения на уровне адреса или устраняет неоднозначность поиска по координатам. Этот параметр может помочь ускорить процесс поиска. Если категория не используется, геокодирование будет осуществляться по всем поддерживаемым категориям. Не для всех локаторов и не для всех стран поддерживаются все значения категорий. См. веб-справку к ArcGIS REST API для получения сведений о фильтрации категорий.	String
Выходные поля (Дополнительный)	Задает выходные поля локатора, которые возвращаются в результатах геокодирования. Исходные имена полей из значения параметра Входная таблица будут сохранены, если заданы опции Только местоположение, Минимальные или Минимальные и пользовательские поля. Примечание: Этот параметр может быть использован со входными локаторами, созданными с помощью инструмента Создать локатор или Создать локатор объектов, которые хранятся на диске или опубликованы в Enterprise 10.9 или более новой версии. Составные локаторы, содержащие хотя бы один локатор, созданный с помощью инструмента Создать локатор адресов, не поддерживают этот параметр. Все–Включает все доступные выходные поля локатора в результаты геокодирования. Используется по умолчанию. Только местоположение–Сохраняет в результатах геокодирования поле `Shape`. Минимальный–Добавляет следующие поля, описывающие местоположение и то, насколько хорошо оно соответствует информации в сервисе локатора: `Shape`, `Status`, `Score`, `Match_type`, `Match_addr` и `Addr_type`. Минимальные и пользовательские поля–Поля `MINIMAL`, а также любые выходные поля, заданные пользователем, будут добавлены и возвращены в результатах геокодирования.	String
Описание сопоставления (Дополнительный)	Определяет, как описание сопоставления будет возвращено в выходном классе геокодированных объектов. Если значение параметра не задано, будет использоваться настройка свойства локатора Включить описание сопоставлений. Этот параметр может помочь лучше понять, как адреса были сопоставлены в классе геокодированных объектов. Подробнее о параметре returnMatchNarrative для geocodeAddresses см. в веб-справке ArcGIS REST API. Добавить описание сопоставлений к выходным данным–Поле с именем `MatchNarrative` будет добавлено к классу геокодированных объектов. Это поле содержит текст описания сопоставления для каждого сопоставленного адреса. Разделить описание сопоставлений на поля–Текст описания сопоставлений одного поля будет извлечен из объекта JSON. Текст описания сопоставлений будет обработан, разбит на отдельные поля и добавлен в класс геокодированных объектов.	String

arcpy.geocoding.GeocodeAddresses(in_table, address_locator, in_address_fields, out_feature_class, {out_relationship_type}, {country}, {location_type}, {category}, {output_fields}, {match_narrative})

Имя	Объяснение	Тип данных
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, и поле, хранящее страну, связанную с этим адресом, например, USA. Некоторые локаторы поддерживают несколько входных полей адреса, таких как `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`. `DYNAMIC`–Эта опция не используется в ArcGIS Pro. См. справку ArcGIS Desktop по этому инструменту. `STATIC`–Создает статическую копию входной таблицы адресов в выходном классе объектов. Это единственное допустимое значение.	Boolean
country [country,...] (Дополнительный)	Страна или страны, по которым будет проводиться поиск геокодированных адресов. Выбор страны зачастую помогает увеличить точность геокодирования. Если страна не указана, геокодирование выполняется по всем доступным странам локатора. Значение этого параметра будет переопределено, если поле в значении параметра `in_table` сопоставляется с полем `Country` в параметре `in_address_fields`. Укажите значение как двухсимвольный или трехсимвольный код страны в списке, разделенном запятыми. См. столбец Поддерживаемые коды стран для использования входного значения.	String
location_type (Дополнительный)	Задает предпочитаемую выходную геометрию, которая будет возвращена для соответствий `PointAddress`. Если предпочитаемое местоположение отсутствует в данных, будет возвращено местоположение `ADDRESS_LOCATION` по умолчанию. См. веб-справку к ArcGIS REST API для получения подробной информации о параметре `locationType` для `geocodeAddresses`. `ADDRESS_LOCATION`–Возвращается геометрия для результатов геокодирования, которые представляют адреса таких элементов местоположений, как верхняя точка крыши, центроид участка или входная дверь. Используется по умолчанию. `ROUTING_LOCATION`–Будет возвращена геометрия результатов геокодирования, которые представляют местоположение рядом с обочиной улицы, которое может использоваться для маршрутизации транспортных средств.	String
category [category,...] (Дополнительный)	Ограничивает типы мест, которые ищет локатор, что исключает ложноположительные совпадения, нежелательные совпадения на уровне адреса или устраняет неоднозначность поиска по координатам. Этот параметр может помочь ускорить процесс поиска. Если категория не используется, геокодирование будет осуществляться по всем поддерживаемым категориям. Не для всех локаторов и не для всех стран поддерживаются все значения категорий. См. веб-справку к ArcGIS REST API для получения сведений о фильтрации категорий.	String
output_fields (Дополнительный)	Задает выходные поля локатора, которые возвращаются в результатах геокодирования. Исходные имена полей из значения параметра `in_table` будут сохранены, если заданы опции `LOCATION_ONLY`, `MINIMAL` или `MINIMAL_AND_USER`. Примечание: Этот параметр может быть использован со входными локаторами, созданными с помощью инструмента Создать локатор или Создать локатор объектов, которые хранятся на диске или опубликованы в Enterprise 10.9 или более новой версии. Составные локаторы, содержащие хотя бы один локатор, созданный с помощью инструмента Создать локатор адресов, не поддерживают этот параметр. `ALL`–Включает все доступные выходные поля локатора в результаты геокодирования. Используется по умолчанию. `LOCATION_ONLY`–Сохраняет в результатах геокодирования поле `Shape`. `MINIMAL`–Добавляет следующие поля, описывающие местоположение и то, насколько хорошо оно соответствует информации в сервисе локатора: `Shape`, `Status`, `Score`, `Match_type`, `Match_addr` и `Addr_type`. `MINIMAL_AND_USER`–Поля `MINIMAL`, а также любые выходные поля, заданные пользователем, будут добавлены и возвращены в результатах геокодирования.	String
match_narrative [match_narrative,...] (Дополнительный)	Определяет, как описание сопоставления будет возвращено в выходном классе геокодированных объектов. Если значение параметра не задано, будет использоваться настройка свойства локатора Включить описание сопоставлений. Этот параметр может помочь лучше понять, как адреса были сопоставлены в классе геокодированных объектов. Подробнее о параметре returnMatchNarrative для geocodeAddresses см. в веб-справке ArcGIS REST API. `ADD_MATCH_NARRATIVE`–Поле с именем `MatchNarrative` будет добавлено к классу геокодированных объектов. Это поле содержит текст описания сопоставления для каждого сопоставленного адреса. `SPLIT_MATCH_NARRATIVE`–Текст описания сопоставлений одного поля будет извлечен из объекта JSON. Текст описания сопоставлений будет обработан, разбит на отдельные поля и добавлен в класс геокодированных объектов.	String

Пример кода

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

В следующем скрипте показано, как использовать функцию 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 = r"C:\My_Output.gdb\geocode_result"

arcpy.geocoding.GeocodeAddresses(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:\My_Output.gdb\geocode_result"

arcpy.geocoding.GeocodeAddresses(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:\My_Output.gdb\geocode_result"

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

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

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

Примечание:

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

import arcpy

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

# Sign in to Portal
#arcpy.SignInToPortal("https://www.arcgis.com.", "MyUsername", "MyPassword")

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:\My_Output.gdb\geocode_result"

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

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

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

Примечание:

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

import arcpy

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

# Sign in to Portal
#arcpy.SignInToPortal("https://www.arcgis.com.", "MyUsername", "MyPassword")

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: Да

Геокодировать адреса (Инструменты Геокодирование)

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

Примечание:

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

Параметры

Примечание:

Примечание:

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

Примечание:

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

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

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