Сводка
Геокодирует таблицы, используя локаторы, размещенные на портале ArcGIS Enterprise, при этом создается размещенный векторный слой, содержащий результаты геокодирования.
Этот инструмент автоматизирует процесс геокодирования таблиц, опубликованных на портале, и сохраняет выходные данные на портале. Если вам не нужно сохранять результаты геокодирования на портале, используйте панель Геокодирования таблицы или инструмент Геокодировать адреса.
Примечание:
Для запуска этого инструмента у вас должны быть права издателя или администратора на портале. Если вы являетесь участником с настраиваемой ролью, убедитесь, что администратор портала предоставил вам право на публикацию размещенных веб-слоев.
Использование
Вы можете геокодировать адреса, хранящиеся в одном поле или в нескольких полях. В одном входном поле хранится полный адрес, например, 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 Enterprise 10.6 или более новой версии.
Использование локатора на портале ArcGIS Enterprise который настроен для работы в многопотоковом режиме повысить производительность геокодирования.
Инструменту необходимо, чтобы в качестве входной таблицы использовалась таблица, размещенная или опубликованная на портале ArcGIS Enterprise. Размещенные таблицы рассматриваются как часть размещенных слоев объектов и должны быть созданы как элемент портала, прежде чем их можно будет использовать с инструментом. Подробнее, см. в Публикация размещенных слоев объектов.
Выходной размещенный слой объектов сохраняется в той же пространственной привязке, что и локатор адресов. Вы можете изменить пространственную привязку выходного векторного слоя, установив другую выходную систему координат в параметрах среды инструмента.
Выходной размещенный слой объектов будет содержать всю необходимую для геокодирования информацию, такую как очки, статус и сопоставленный адрес каждой записи, а также значения из исходной входной таблицы. Адреса могут повторно сопоставляться с помощью инструмента Повторно сопоставить адреса или диалогового окна Интерактивное сопоставление, которое открывается на панели Повторно сопоставить адреса. Результаты геокодирования этим инструментом содержат статический снимок исходной входной таблицы, поэтому, добавление или изменение любых значений в исходной таблице не приводит к обновлению результатов в выходном сервисе объектов. Инструмент необходимо перезапустить, чтобы создать новый выходной сервис пространственных объектов, содержащий эти изменения.
Более подробно о повторном сопоставлении результатов геокодирования
Синтаксис
arcpy.geocoding.GeocodeLocationsFromTable(in_table, in_address_locator, address_fields, output_name, {country}, {location_type}, {category}, {output_fields})| Parameter | Объяснение | Тип данных |
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 для общего адреса в США. Некоторые локаторы поддерживают несколько полей входных адресов, например, 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,...] (Дополнительный) | Страна или страны, в которых проводится поиск геокодированных адресов. Этот параметр доступен для локаторов, поддерживающих параметр страны, и позволяет ограничить область геокодирования выбранными странами. Выбрав страну, вы, как правило, сможете увеличить точность геокодирования. Если поле, представляющее страны в параметре Входной таблицы, сопоставлено с полем входного адреса Country, значение страны из параметра Входной таблицы будет иметь приоритет над параметром Страны. Если страна не указана, геокодирование выполняется с использованием всех поддерживаемых стран локатора. Укажите входное значение как трех символьный код страны ISO 3166-1. Параметр Страна не поддерживается для всех локаторов. | String |
location_type (Дополнительный) | Задает предпочитаемую выходную геометрию для соответствия POINT_ADDRESS. Варианты этого параметра – ROUTING_LOCATION, сторона улицы, которую можно использовать для построения маршрутов, либо ADDRESS_LOCATION, местоположение, находящееся на крыше здания или в центре земельного участка. Если предпочтительное местоположение не существует в данных, будет возвращено расположение ROUTING_LOCATION по умолчанию. Для результатов геокодирования с Addr_type=PointAddress атрибутивные значения x,y соответствуют координатам адреса, а значения DisplayX и DisplayY описывают координаты верхней точки крыши или центроида здания. См. Веб-справку по REST API для получения подробной информации параметре locationType для reverseGeocode. Этот параметр не поддерживается для всех локаторов.
| String |
category [category,...] (Дополнительный) | Ограничивает типы местоположений, в которых локатором выполняется поиск, это убирает ложно положительные совпадения и ускоряет процесс поиска. Если категория не используется, геокодирование выполняется с использованием всех поддерживаемых категорий. Не для всех локаторов и не для всех стран поддерживаются все значения категорий. В целом, параметр Категория используется для:
Этот параметр не поддерживается для всех локаторов. См. веб-справку к REST API для получения сведений о фильтрации категорий. | String |
output_fields (Дополнительный) | Задает выходные поля локатора, которые возвращаются в результатах геокодирования. Примечание:Этот параметр может быть использован со входными локаторами, созданными с помощью инструмента Создать локатор или Создать локатор объектов, которые опубликованы на Enterprise версии 10.9 или более новой. Составные локаторы, содержащие хотя бы один локатор, созданный с помощью инструмента Создать локатор объектов, не поддерживают этот параметр.
| String |
Производные выходные данные
| Name | Объяснение | Тип данных |
| output_layer | Гиперссылка на выходной слой объектов результатов геокодирования на портале. Имя векторного слоя происходит от значения Выходные данные имени векторного слоя. | Набор объектов |
Пример кода
На примере автономного скрипта показано, как использовать функцию GeocodeLocationsFromTable для геокодирования размещенного табличного слоя.
import arcpy
arcpy.SignInToPortal("https://<machine_name>/<portal_web_adaptor_name>",
'<username>', '<password>')
# 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 by running 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
# Note that 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)Environments
Информация о лицензиях
- Basic: Требуется Права доступа Ваша учетная запись в ArcGIS Enterprise содержит права доступа на Выполнение анализа
- Standard: Требуется Права доступа Ваша учетная запись в ArcGIS Enterprise содержит права доступа на Выполнение анализа
- Advanced: Требуется Права доступа Ваша учетная запись в ArcGIS Enterprise содержит права доступа на Выполнение анализа