Skip To Content

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

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

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

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

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

  • Для работы этого инструмента требуется ArcGIS Enterprise 10.6 или более новой версии.

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

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

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

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

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

  • Для геокодирования таблицы адресов с использованием ArcGIS World Geocoding Service в качестве прокси-сервера на портале ArcGIS Enterprise необходима подписка ArcGIS Online for organizations. Дополнительные сведения см. в разделе Работа с сервисом геокодирования ArcGIS Online World Geocoding Service.

Синтаксис

GeocodeLocationsFromTable_geocoding (in_table, in_address_locator, address_fields, output_name, {country}, {location_type}, {category})
ПараметрОбъяснениеТип данных
in_table

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

Record Set
in_address_locator

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

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

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 для обычных почтовых адресов США.

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

Field Info
output_name

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

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

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

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

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

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

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

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

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

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

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

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

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

String

Пример кода

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

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

import arcpy
table_url = "https://myportal.domain.com/portal/rest/services/Hosted/customers/FeatureServer/0"
locator_url = "http://myportal.domain.com/portal/rest/services/Altanta/GeocodeServer"
field_mapping = "'Street or Intersection' <None> VISIBLE NONE;'City or Placename' City VISIBLE NONE;State State VISIBLE NONE;'ZIP Code' ZIP VISIBLE NONE"
output_name_on_portal = "customers_geocoded"
country = None
preferred_location_type = "ROUTING_LOCATION"
arcpy.geocoding.GeocodeLocationsFromTable(table_url, locator_url, field_mapping, 
                                          output_name_on_portal, country, 
                                          preferred_location_type)

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

  • ArcGIS Desktop Basic: Требует Права доступа Ваша учетная запись в ArcGIS Enterprise содержит права доступа на Выполнение анализа
  • ArcGIS Desktop Standard: Требует Права доступа Ваша учетная запись в ArcGIS Enterprise содержит права доступа на Выполнение анализа
  • ArcGIS Desktop Advanced: Требует Права доступа Ваша учетная запись в ArcGIS Enterprise содержит права доступа на Выполнение анализа

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