Сводка
Конвертирует большие локальные таблицы адресов или местоположений в точечные пространственные объекты или автономную таблицу .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, 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, поддерживающем несколько потоков для пакетного геокодирования.
Более подробно о повторном сопоставлении результатов геокодирования
Синтаксис
arcpy.geocoding.GeocodeFile(in_table, locator, address_fields, output_type, output_location, output_name, {country}, {location_type}, {category}, {output_fields})| 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 | Задает тип файла, в который будут записаны результаты геокодирования.
| String |
output_location | Папка, в которую будут записаны выходные файлы с результатами геокодирования. Если выходные данные представлены в виде файла .csv или .xls, выходной файл будет сохранен в указанную папку. Если выходные данные представлены в виде класса объектов, в указанной папке будет создана выходная файловая база геоданных, которая и будет содержать класс объектов с результатами геокодирования. Выходная файловая база геоданных и класс объектов будут названы одинаково. | Workspace |
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 | Объяснение | Тип данных |
| out_feature_class | Выходной класс объектов. | Класс пространственных объектов |
| out_table | Таблица выхода в формате CSV или XLS, в зависимости от значения Тип выходных данных. | Таблица |
Пример кода
В следующем скрипте 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 to run 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, 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)Environments
Информация о лицензиях
- Basic: Требуется Права доступа Ваша учетная запись в ArcGIS Enterprise содержит права доступа на Выполнение анализа
- Standard: Требуется Права доступа Ваша учетная запись в ArcGIS Enterprise содержит права доступа на Выполнение анализа
- Advanced: Требуется Права доступа Ваша учетная запись в ArcGIS Enterprise содержит права доступа на Выполнение анализа