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

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

Конвертирует большие локальные таблицы адресов или мест в точки в класс объектов или автономную таблицу CSV или XLS. Этот инструмент использует локаторы, размещенные на портале ArcGIS Enterprise.

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

Этот инструмент поддерживает следующие форматы таблиц в качестве входных данных:
- Файл значений, разделенных запятыми (.csv)
- Таблицы файловой базы геоданных
- Рабочие листы Microsoft Excel (файлы .xls и .xlsx)
Для входных таблиц CSV первая строка входного файла используется в качестве имен полей для выходной таблицы в дополнение к полям, добавленным из локатора. Имена полей не могут содержать пробелы или специальные символы, такие как $ или *.

Узнайте больше о работе с файлами Microsoft Excel в ArcGIS Pro

Примечание:

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

Вы можете геокодировать адреса, которые хранятся в одном поле, разделены на несколько полей или хранятся в одном поле и поле страны. Одно входное поле содержит полный адрес, например, 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.7 или более новой версии.
Если локатор портала недоступен в качестве служебного сервиса на портале, попросите администратора портала [добавить локатор как служебный сервис портала]https://enterprise.arcgis.com/en/portal/12.0/administer/windows/configure-services.htm#ESRI_SECTION2_D655151F9E074E74BAB0D5572A358A10 и [настроить локатор для пакетного геокодирования]https://enterprise.arcgis.com/en/portal/12.0/administer/windows/configure-portal-to-geocode-addresses.htm#ESRI_SECTION2_712D9E6A9E0B47639A1E9BF31E22B68C.
Используйте локатор на портале ArcGIS Enterprise, который был настроен на использование нескольких потоков для повышения производительности геокодирования.
Результаты геокодирования сохраняется в той же пространственной привязке, что и локатор. Вы можете изменить пространственную привязку выходных данных, установив другую выходную систему координат в параметрах среды инструмента.
Результаты геокодирования будут содержать всю информацию геокодирования, такую как очки, статус и сопоставленный адрес каждой записи, а также значения из исходной входной таблицы. Результаты геокодирования этим инструментом содержат статический снимок исходной входной таблицы, поэтому, добавление или изменение значений в исходной таблице не приводит к обновлению результатов в выходном файле. Перезапустите инструмент, чтобы создать выходной файл, содержащий эти изменения.
Когда результаты геокодирования возвращаются как класс объектов, адреса могут повторно сопоставляться с помощью инструмента Повторно сопоставить адреса или опции Повторно сопоставить адреса, которая открывает панель Повторно сопоставить адреса.

Примечание:

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

Узнайте больше о повторном сопоставлении результатов геокодирования
При использовании входного локатора, построенного с использованием данных с z-значениями, инструмент вернет выходные данные, которые не поддерживают z-значения. Этот инструмент поддерживает только выходные 2D-данные.
Следующие параметры поддерживаются не для всех локаторов, используемых для значения параметра Локатор: Страна или регион, Предпочитаемый тип местоположения и Категория.
Инструмент не применяет настройки из представления локатора, созданного в ArcGIS Pro 3.2, когда оно используется как значение параметра Локатор.

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

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

Подпись	Объяснение	Тип данных
Выходной класс пространственных объектов	Выходной класс объектов.	Feature Class
Выходная таблица	Выходная таблица в формате CSV или XLS, в зависимости от значения Тип выходных данных.	Table

arcpy.geocoding.GeocodeFile(in_table, locator, address_fields, output_type, output_location, output_name, {country}, {location_type}, {category}, {output_fields})

Имя	Объяснение	Тип данных
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` для обычных почтовых адресов США. Вы также можете указать одно входное поле, в котором хранится полный адрес, например, 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_type	Задает тип файла, в который будут записаны результаты геокодирования. `CSV`–Будет возвращен файл `.csv`. `FEATURE_CLASS`–Будет возвращен класс пространственных объектов в файловой базе геоданных. `XLS`–Будет возвращен файл `.xls`.	String
output_location	Папка, в которую будут записаны выходные файлы с результатами геокодирования. Если выходными данными является файл `.csv` или `.xls`, выходной файл будет помещен в указанную папку. Если выходными данными является класс объектов, в указанной папке будет создана файловая база геоданных, в которой будет размещен геокодированный файл объектов. Выходная файловая база геоданных и класс объектов в ней будут иметь одинаковые имена.	Workspace
output_name	Имя выходных результатов геокодирования.	String
country [country,...] (Дополнительный)	Страна или страны, по которым будет проводиться поиск геокодированных адресов. Выбор страны зачастую помогает увеличить точность геокодирования. Если страна не указана, геокодирование выполняется по всем доступным странам локатора. Значение этого параметра будет переопределено, если поле в значении параметра `in_table` сопоставляется с полем `Country` в параметре `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` будет сохранено, если результатом геокодирования является класс пространственных объектов. Поля `Shape X` и `Shape Y` будут сохранены, если результатом является файл `.csv` или `.xls`. `MINIMAL`–Добавляет следующие поля, описывающие местоположение и то, насколько хорошо оно соответствует информации в сервисе локатора: `Shape`, `Status`, `Score`, `Match_type`, `Match_addr` и `Addr_type`. `MINIMAL_AND_USER`–Поля `MINIMAL`, а также любые выходные поля, заданные пользователем, будут добавлены и возвращены в результатах геокодирования.	String

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

Имя	Объяснение	Тип данных
out_feature_class	Выходной класс объектов.	Feature Class
out_table	Выходная таблица в формате CSV или XLS, в зависимости от значения Тип выходных данных.	Table

Пример кода

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

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

Примечание:

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

import arcpy

# Input is a local table
input_table = r"C:\data\customers.csv"

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

# The best way to generate a field mapping is to run the tool in ArcGIS
# Pro, 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 you select
# FEATURE_CLASS output_type, 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 должны быть права доступа на Выполнение анализа

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

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

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

Примечание:

Примечание:

Параметры

Примечание:

Примечание:

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

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

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

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