Пакетное геокодирование (Инструменты Геокодирование)

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

Асинхронно выполняет геокодирование большой таблицы или файла .csv с адресами или местоположениями с помощью batchGeocode REST API. Геокодированные результаты возвращаются в виде класса пространственных объектов и не требуют ArcGIS Pro для разбиения запроса на более мелкие пакеты.

При использовании этого инструмента геокодирование может быть изолировано и масштабировано на сервере независимо от других процессов. Например, при отправке задания в ArcGIS World Geocoding Service для обработки файла будет назначено выделенное оборудование, что приведет к более быстрому отклику. Вы можете выбрать ArcGIS World Geocoding Service, либо сервис, размещенный в ArcGIS Enterprise on Kubernetes 11.5 или более поздней версии, в составе настроенного кластера Kubernetes.

Примечание:

Для выполнения операций геокодирования с помощью ArcGIS World Geocoding Service требуется учетная запись организации ArcGIS и необходимы кредиты. Учетная запись организации должна иметь достаточное количество кредитов для выполнения всего запроса на геокодирование.

Оценка кредитов отображается в верхней части инструмента на панели Геообработка, когда активным порталом является ArcGIS Online.

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

При использовании ArcGIS World Geocoding Service в качестве значения параметра Входной пакетный сервис входная таблица или файл должны содержать не менее 100 000 записей.
При использовании ArcGIS World Geocoding Service в качестве значения параметра Входной пакетный сервис значение параметра Входная таблица временно сохраняется на вашем портале ArcGIS Online до завершения задания. После завершения задания временный файл будет удален с портала.
Максимальное число записей, поддерживаемых этим инструментом, 50 миллионов. Если таблица превышает 50 миллионов записей, разделите ее на несколько таблиц с 50 миллионами или менее записей. Если входными данными является файл .csv, он должен использовать кодировку UTF-8 с меткой порядка байтов (BOM).

Примечание:

Вы можете использовать стороннее приложение, например Microsoft Excel или Notepad++, чтобы добавить UTF-8 BOM в файл .csv.
Первая строка входного файла .csv используется в качестве имен полей для выходного класса пространственных объектов в дополнение к полям, добавленным из локатора. Имена полей не могут содержать пробелы или специальные символы, кроме подчеркивания.

Примечание:

При использовании инструмента в Python поля значения параметра table_field_name должны быть в том же регистре, что и поля значения параметра input_address_field для сопоставления полей с использованием параметра address_fields.
Когда локатор публикуется на ArcGIS Enterprise on Kubernetes с включенной функцией Пакетное геокодирование, создаются два сервиса: GeocodeServer и GPServer. При использовании инструмента в Python значение параметра in_batch_service должно быть GPServer, например, https://machinename.domain.com/server/rest/services/service_name/GPServer .
Результаты геокодирования сохраняются в той же пространственной привязке, что и сервис. Вы можете изменить пространственную привязку выходных данных, задав параметр среды Выходная система координат.
Результаты геокодирования будут содержать всю информацию о геокодировании, включая баллы, статус и сопоставленный адрес каждой записи, а также значения из исходной входной таблицы или файла. Результаты геокодирования этим инструментом содержат статический снимок исходной входной таблицы, поэтому, добавление или изменение значений в исходной таблице не приводит к обновлению результатов в выходном классе объектов. Перезапустите инструмент, чтобы создать выходной класс объектов, содержащий эти изменения.
Следующие параметры поддерживаются не для всех пакетных сервисов, используемых для значения параметра Входной пакетный сервис: Страна или регион, Предпочитаемый тип местоположения и Категория.
Этот инструмент не поддерживает выборки. Чтобы геокодировать часть таблицы, экспортируйте ту часть таблицы, которую вы хотите геокодировать, и запустите инструмент для новой таблицы меньшего размера.

Подпись	Объяснение	Тип данных
Входная таблица	Таблица или файл `.csv` с адресами или местоположениями, которые будут геокодированы.	Table View
Входной пакетный сервис	Сервис геокодирования на портале с поддержкой пакетного геокодирования, который будет использоваться для геокодирования таблицы адресов и мест. Примечание: Если сервис является пользовательским локатором или локатором ArcGIS StreetMap Premium, он должен быть опубликован в ArcGIS Enterprise on Kubernetes 11.5 или более новой версии с включенной функцией Пакетное геокодирование.	String
Сопоставление полей адресов	Соответствие полей адреса, используемых локатором, полям входной таблицы или файла адресов. Укажите Одно поле, если полный адрес хранится в одном поле во входной таблице или файле, например: 303 Peachtree St NE, Atlanta, GA 30308. Укажите Несколько полей, если входные адреса разделены на несколько полей, например, `Address`, `City`, `State` и `ZIP` для общего адреса в США. Задайте Одно поле и поле страны, если полный адрес и страна разделены на несколько полей, например, `Address` (303 Peachtree St NE, Atlanta, GA 30308) и `Country` (USA). Некоторые местоположения поддерживают несколько входных полей адресов, таких как `Address`, `Address2` и `Address3`. В этом случае компонент адреса может быть разделен на несколько полей, и поля адреса будут объединены во время геокодирования. Например, 100, Main st и Apt 140 в трех полях или 100 Main st и Apt 140 в двух полях в результате геокодирования образуют адрес в виде 100 Main st Apt 140. Если вы не сопоставляете дополнительное входное поле адреса, используемое локатором адресов, с полем во входной таблице или файле адресов, укажите, что сопоставление не требуется, выбрав <None> вместо имени поля.	Field Info
Выходной класс пространственных объектов	Выходной геокодированный класс пространственных объектов. Примечание: Сохранение результатов в формате шейп-файлов не поддерживается в связи с ограничениями шейп-файлов.	Feature Class
Страна или регион	Страна или страны, по которым будет проводиться поиск геокодированных адресов. Выбор страны зачастую помогает увеличить точность геокодирования. Если страна не указана, геокодирование выполняется по всем доступным странам локатора. Значение этого параметра будет переопределено, если вы зададите Одно поле и поле Страна для параметра Сопоставление полей адресов.	String
Предпочитаемый тип местоположения (Дополнительный)	Задает предпочитаемую выходную геометрию, которая будет возвращена для соответствий `PointAddress`. Если предпочитаемое местоположение отсутствует в данных, будет возвращено местоположение по умолчанию. См. веб-справку к ArcGIS REST API для получения подробной информации о параметре `locationType` для `geocodeAddresses`. Местоположение адреса–Возвращается геометрия для результатов геокодирования, которые представляют адреса таких элементов местоположений, как верхняя точка крыши, центроид участка или входная дверь. Используется по умолчанию. Местоположение маршрута–Будет возвращена геометрия результатов геокодирования, которые представляют местоположение рядом с обочиной улицы, которое может использоваться для маршрутизации транспортных средств.	String
Категория (Дополнительный)	Ограничивает типы мест, которые ищет локатор, что исключает ложноположительные совпадения, нежелательные совпадения на уровне адреса или устраняет неоднозначность поиска по координатам. Этот параметр может помочь ускорить процесс поиска. Если категория не используется, геокодирование будет осуществляться по всем поддерживаемым категориям. Не для всех локаторов и не для всех стран поддерживаются все значения категорий. См. веб-справку к ArcGIS REST API для получения сведений о фильтрации категорий.	String
Выходные поля (Дополнительный)	Задает выходные поля локатора, которые возвращаются в результатах геокодирования. Исходные имена полей из значения параметра Входная таблица будут сохранены, если заданы опции Только местоположение, Минимальные или Минимальные и пользовательские поля. Все–Включает все доступные выходные поля локатора в результаты геокодирования. Используется по умолчанию. Только местоположение–Сохраняет в результатах геокодирования поле `Shape`. Минимальный–Добавляет следующие поля, описывающие местоположение и то, насколько хорошо оно соответствует информации в сервисе локатора: `Shape`, `Status`, `Score`, `Match_type`, `Match_addr` и `Addr_type`. Минимальные и пользовательские поля–Поля `MINIMAL`, а также любые выходные поля, заданные пользователем, будут добавлены и возвращены в результатах геокодирования.	String
Описание сопоставления (Дополнительный)	Определяет, как описание сопоставления будет возвращено в выходном классе геокодированных объектов. Если значение параметра не задано, будет использоваться настройка свойства локатора Включить описание сопоставлений. Этот параметр может помочь лучше понять, как адреса были сопоставлены в классе геокодированных объектов. Добавить описание сопоставлений к выходным данным–Поле с именем `MatchNarrative` будет добавлено к классу геокодированных объектов. Это поле содержит текст описания сопоставления для каждого сопоставленного адреса. Разделить описание сопоставлений на поля–Текст описания сопоставлений одного поля будет извлечен из объекта JSON. Текст описания сопоставлений будет обработан, разбит на отдельные поля и добавлен в класс геокодированных объектов.	String

arcpy.geocoding.BatchGeocode(in_table, in_batch_service, address_fields, out_feature_class, country, {location_type}, {category}, {output_fields}, {match_narrative})

Имя	Объяснение	Тип данных
in_table	Таблица или файл `.csv` с адресами или местоположениями, которые будут геокодированы.	Table View
in_batch_service	Сервис геокодирования на портале с поддержкой пакетного геокодирования, который будет использоваться для геокодирования таблицы адресов и мест. Примечание: Если сервис является пользовательским локатором или локатором ArcGIS StreetMap Premium, он должен быть опубликован в ArcGIS Enterprise on Kubernetes 11.5 или более новой версии с включенной функцией Пакетное геокодирование.	String
address_fields	Каждое сопоставление полей в этом параметре имеет формат `input_address_field, table_field_name`, где `input_address_field` — имя входного поля адреса, заданное локатором, а `table_field_name` — имя соответствующего поля в таблице или файле адресов, которые вы хотите геокодировать. Укажите одно входное поле, если полный адрес хранится в одном поле в значении `in_table`, например: 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. Если вы не сопоставляете необязательное входное поле адреса, используемое локатором адресов, с полем во входной таблице или файле адресов, укажите, что сопоставление отсутствует, используя вместо имени поля.	Field Info
out_feature_class	Выходной геокодированный класс пространственных объектов. Примечание: Сохранение результатов в формате шейп-файлов не поддерживается в связи с ограничениями шейп-файлов.	Feature Class
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`. `ALL`–Включает все доступные выходные поля локатора в результаты геокодирования. Используется по умолчанию. `LOCATION_ONLY`–Сохраняет в результатах геокодирования поле `Shape`. `MINIMAL`–Добавляет следующие поля, описывающие местоположение и то, насколько хорошо оно соответствует информации в сервисе локатора: `Shape`, `Status`, `Score`, `Match_type`, `Match_addr` и `Addr_type`. `MINIMAL_AND_USER`–Поля `MINIMAL`, а также любые выходные поля, заданные пользователем, будут добавлены и возвращены в результатах геокодирования.	String
match_narrative [match_narrative,...] (Дополнительный)	Определяет, как описание сопоставления будет возвращено в выходном классе геокодированных объектов. Если значение параметра не задано, будет использоваться настройка свойства локатора Включить описание сопоставлений. Этот параметр может помочь лучше понять, как адреса были сопоставлены в классе геокодированных объектов. `ADD_MATCH_NARRATIVE`–Поле с именем `MatchNarrative` будет добавлено к классу геокодированных объектов. Это поле содержит текст описания сопоставления для каждого сопоставленного адреса. `SPLIT_MATCH_NARRATIVE`–Текст описания сопоставлений одного поля будет извлечен из объекта JSON. Текст описания сопоставлений будет обработан, разбит на отдельные поля и добавлен в класс геокодированных объектов.	String

Пример кода

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

Следующий скрипт демонстрирует, как использовать функцию BatchGeocode для геокодирования файла .csv с помощью ArcGIS World Geocoding Service и возврата MINIMAL output_fields в результате геокодирования.

Примечание:

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

Примечание:

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

import arcpy

# Set local variables

# Input is a local file
in_table = r"C:\data\customers.csv"

# Sign in to Portal
#arcpy.SignInToPortal("https://www.arcgis.com.", "MyUsername", "MyPassword")

in_batch_service = "https://geocode.arcgis.com/arcgis/rest/services/World/GPServer/BatchGeocode/"

# One way to generate the value for the field mapping parameter is to first run the tool in ArcGIS
# Pro and right-click the green success ribbon and click "Copy Python command"
# The table_field_name fields must be in the same case as the input_address_field fields.

address_fields = """'Address or Place' Address VISIBLE NONE;Address2 <None> VISIBLE NONE;Address3 <None> VISIBLE NONE;
Neighborhood <None> VISIBLE NONE;City City VISIBLE NONE;County <None> VISIBLE NONE;State State VISIBLE NONE;
ZIP ZIPCODE VISIBLE NONE;ZIP4 <None> VISIBLE NONE;Country <None> VISIBLE NONE"""

geocode_result = r"C:\Mydata\results.gdb\geocode_results"

# Optional geocoding parameters. Only some are supported depending on the in_batch_service that you use.
country = USA
location_type = "ADDRESS_LOCATION"
category = "'Point Address'"
output_fields = "MINIMAL"

arcpy.geocoding.BatchGeocode(in_table, in_batch_service, address_fields, geocode_result,
                             country, location_type, category, output_fields)

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

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

Примечание:

import arcpy

# Set local variables

# Input is a local file
in_table = r"C:\data\mytables.gdb\restaurants"

in_batch_service = "https://machinename.domain.com/server/rest/services/service_name/GPServer/"

# One way to generate the value for the field mapping parameter is to first run the tool in ArcGIS
# Pro and right-click the green success ribbon and click "Copy Python command"
# The table_field_name fields must be in the same case as the input_address_field fields.

address_fields = """'Address or Place' Address VISIBLE NONE;Address2 <None> VISIBLE NONE;Address3 <None> VISIBLE NONE;
Neighborhood <None> VISIBLE NONE;City City VISIBLE NONE;County <None> VISIBLE NONE;State State VISIBLE NONE;
ZIP ZIPCODE VISIBLE NONE;ZIP4 <None> VISIBLE NONE;Country <None> VISIBLE NONE"""

geocode_result = r"C:\My_Output.gdb\geocode_result"

# Optional geocoding parameters. Only some are supported depending on the in_batch_service that you use.
country = USA
location_type = "ROUTING_LOCATION"
category = "'Point Address'"
output_fields = "ALL"

arcpy.geocoding.BatchGeocode(in_table, in_batch_service, address_fields, geocode_result,
                             country, location_type, category, output_fields)

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

Выходная система координат

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

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

Пакетное геокодирование (Инструменты Геокодирование)

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

Примечание:

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

Примечание:

Примечание:

Параметры

Примечание:

Примечание:

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

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

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