Геокодирование местоположений из таблицы (Геокодирование)

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

Геокодирует таблицы, используя локаторы, размещенные на портале ArcGIS Enterprise, при этом создается размещенный векторный слой, содержащий результаты геокодирования.

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

Примечание:

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

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

  • Вы можете геокодировать адреса, хранящиеся в одном поле или в нескольких полях, либо хранящиеся в одном поле и в поле страны. В одном входном поле хранится полный адрес, например, 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 Enterprise 10.6 или более новой версии.

  • Используйте локатор на портале ArcGIS Enterprise, который был настроен на использование нескольких потоков для повышения производительности геокодирования.

  • Входной должна быть таблица, размещенная или опубликованная на портале ArcGIS Enterprise. Размещенные таблицы рассматриваются как часть размещенных слоев объектов и должны быть созданы как элемент портала, прежде чем их можно будет использовать с инструментом. Подробнее, см. в Публикация размещенных слоев объектов.

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

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

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

  • При использовании входного локатора, построенного с использованием данных с z-значениями, инструмент вернет выходные данные, которые не поддерживают z-значения. Этот инструмент поддерживает только выходные 2D-данные.

  • Инструмент не применяет настройки из представления локатора, созданного в ArcGIS Pro 3.2, когда оно используется как значение параметра Локатор адресов.

Параметры

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

Таблица на портале, которая содержит адреса или места для геокодирования.

Record Set
Локатор адресов

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

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

Примечание:

ArcGIS World Geocoding Service для этого инструмента отключено. Воспользуйтесь инструментом Геокодировать адреса, если вам необходимо использовать ArcGIS World Geocoding Service.

Address Locator
Сопоставление полей адресов

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

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

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

Field Info
Имя выходного слоя объектов

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

String

Производные выходные данные

ПодписьОписаниеТип данных
Выходной слой

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

Feature Set

arcpy.geocoding.GeocodeLocationsFromTable(in_table, in_address_locator, address_fields, output_name, {country}, {location_type}, {category}, {output_fields})
ИмяОписаниеТип данных
in_table

Таблица на портале, которая содержит адреса или места для геокодирования.

Record Set
in_address_locator

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

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

Примечание:

ArcGIS World Geocoding Service для этого инструмента отключено. Воспользуйтесь инструментом Геокодировать адреса, если вам необходимо использовать ArcGIS World Geocoding Service.

Address Locator
address_fields
[input_locator_field, table_field_name]

Каждое сопоставление полей в этом параметре имеет формат input_locator_field, table_field_name, где input_locator_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
output_name

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

String
country
[country,...]
(Дополнительный)

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

Этот параметр доступен для локаторов, поддерживающих параметр страны, и позволяет ограничить область геокодирования указанными странами. Указав страну, вы, как правило, сможете увеличить точность геокодирования. Если поле страны в параметре in_table сопоставляется с полем Country в address_fields, то значение страны из параметра 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 будут сохранены.
  • MINIMAL_AND_USERДобавляет следующие поля, описывающие местоположение и то, насколько хорошо оно соответствует информации в локаторе в результатах геокодирования, а также любые пользовательские выходные поля, определенные пользователем: Shape, Status, Score, Match_type, Match_addr и Addr_type. Исходные имена полей из значения параметра in_table будут сохранены.
String

Производные выходные данные

ИмяОписаниеТип данных
output_layer

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

Feature Set

Пример кода

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

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

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

import arcpy

# Input is a hosted table
input_table = "https://<machine_name>/server/rest/services/Hosted/<item_name>/FeatureServer/<table_number>"

# This tool works with locators on your portal
in_locator = "https://<machine_name>/server/rest/services/<locator_name>/GeocodeServer/<locator_name>"

# The easiest way to generate a field mapping is to run the tool in ArcGIS 
# Pro and right-click the green success ribbon and click "Copy Python command"
field_mapping =  "'Street or Intersection' address VISIBLE NONE;'City or Placename' <None> VISIBLE NONE;State <None> VISIBLE NONE;'ZIP Code' zip VISIBLE NONE"
output_name = "geocoding_output"

# Optional geocoding parameters. Only some are supported depending on the 
# in_locator that you use.
country = None
location_type = None
category = None

# The output is a hosted feature layer on your portal. To retrieve the
# output, go to your portal and look for a new item with the output_name that 
# you entered.
arcpy.geocoding.GeocodeLocationsFromTable(input_table, in_locator, 
                                          field_mapping, output_name, country, 
                                          location_type, category)