Геокодировать файл (Геокодирование)

Сводка

Конвертирует большие локальные таблицы адресов или местоположений в точечные пространственные объекты или автономную таблицу .csv или .xls. Инструмент использует локаторы, размещенные на портале ArcGIS Enterprise.

Примечание:

Инструмент предназначен для работы в ArcGIS Pro 2.4 или более новой версии, совместно с ArcGIS Enterprise 10.7 или более новой версией портала.

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

  • Этот инструмент поддерживает в качестве входных данных таблицы в следующих форматах:

    • Файлы с разделителями запятыми (.csv)
    • Таблицы файловой базы геоданных
    • Рабочие листы Microsoft Excel (файл .xls и .xlsx)

    Для входных таблиц .csv первая строка используется в качестве имен полей в выходной таблице в дополнение к полям, присоединенным из локатора. Имена поля не должны содержать пробелов или специальных символов (например, $ или *).

    Более подробно о работе с файлами Microsoft Excel в ArcGIS Pro

    Примечание:

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

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

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

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

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

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

  • Когда результаты геокодирования возвращаются как класс объектов, адреса могут повторно сопоставляться с помощью инструмента Повторно сопоставить адреса или опции Повторно сопоставить адреса , которая открывает панель Повторно сопоставить адреса.

    Примечание:

    Таблица должна быть геокодирована с локатором на портале ArcGIS Enterprise 10.8, поддерживающем несколько потоков для пакетного геокодирования.

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

Синтаксис

GeocodeFile(in_table, locator, address_fields, output_type, output_location, output_name, {country}, {location_type}, {category})
ParameterОбъяснениеТип данных
in_table

Входная таблица, содержащая адреса или местоположения для геокодирования в формате CSV, XLS или XLSX или в таблице файловой базы геоданных.

Record Set
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 – имя соответствующего поля в таблице адресов, для которой вы производите геокодирование.

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

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

  • CSVВозвращает файлы значений, разделенных запятыми.
  • FEATURE_CLASSВозвращает класс объектов базы геоданных.
  • XLSВозвращает файл Microsoft Excel (.xls).
String
output_location

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

Если выходные данные представлены в виде файла .csv или .xls, выходной файл будет сохранен в указанную папку.

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

Workspace
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

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

NameОбъяснениеТип данных
out_feature_class

Выходной класс объектов.

Класс пространственных объектов
out_table

Выходная таблица формата CSV или XLS, в зависимости от выбранного Типа выходных данных.

Таблица

Пример кода

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

В следующем скрипте Python показано, как использовать функцию GeocodeFile в автономном скрипте.

import arcpy
arcpy.SignInToPortal("https://<machine_name>/<portal_web_adaptor_name>", 
                     '<username>', '<password>')
# Input is a local table
input_table = r"C:\data\customers.csv"
# this tool works with locators on your Portal
in_locator = "https://<machine_name>/server/rest/services/<service_name>/GeocodeServer/<service_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 = "'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 VISIBLE NONE;ZIP4 <None> VISIBLE NONE;Country <None> VISIBLE NONE"
output_type = "FEATURE_CLASS"
# Output folder for the output CSV, Excel, or GDB table. If user selects 
# FEATURE_CLASS output_type, then a new GDB will be created in the 
# output_folder with the geocoding results
output_folder = r"C:\data\outputs"
output_name = "Geocoding_output"
# Optional geocoding parameters. Only some are supported depending on the 
# in_locator that you use.
country = None
location_type = "ROUTING_LOCATION"
category = "'Street Address'"
arcpy.geocoding.GeocodeFile(input_table, in_locator, field_mapping, output_type, 
                            output_folder, output_name, country, location_type, 
                            category)

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

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

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