Сводка
Геокодирует таблицу с адресами. Для этого процесса требуется таблица, в которой хранятся адреса, которые вы хотите геокодировать, а также локатор адресов или составной локатор адресов. Этот инструмент сопоставляет адреса с локатором адресов и сохраняет результат для каждой входной записи в новом классе точечных пространственных объектов. При использовании сервиса ArcGIS World Geocoding Service эта операция может потреблять кредиты.
Иллюстрация
Использование
Вы можете геокодировать адреса, хранящиеся в одном поле или в нескольких полях. Одно входное поле содержит полный адрес, например, 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.
Выходной класс объектов сохраняется в той же пространственной привязке, что и локатор адресов. Изменить пространственную привязку для выходного класса пространственных объектов можно, задав другую выходную систему координат в параметрах среды инструмента.
Выходной класс объектов по умолчанию сохраняет копию входного адреса и дополнительную информацию – количество набранных очков, статус и сопоставленный адрес каждой записи. Адреса могут повторно сопоставляться с помощью инструмента Повторно сопоставить адреса или диалогового окна Интерактивное сопоставление в ArcMap. Редактирование адресов во входной таблице адресов не изменит результат в выходном классе объектов, когда будет завершен процесс сопоставления и создан класс пространственных объектов.
Включите опцию Динамический выходной класс объектов, если необходимо автоматически обновлять результат сопоставления в выходном классе объектов при обновлении входной таблицы адресов. Для входной таблицы и выходного класса объектов будет создан класс отношений. Если в течение сеанса редактирования в ArcMap адрес во входной таблице изменяется, адрес будет немедленно геокодирован повторно, а связанная с ним запись в выходном классе объектов будет обновлена новым результатом геокодирования. Автоматическое обновление поддерживается также при добавлении новой записи или при удалении существующей записи во входной таблице.
Для геокодирования таблицы адресов с помощью ArcGIS Online для организаций необходима подписка ArcGIS World Geocoding Service. Дополнительные сведения см. в разделе Работа с сервисом геокодирования ArcGIS Online World.
Синтаксис
arcpy.geocoding.GeocodeAddresses(in_table, address_locator, in_address_fields, out_feature_class, {out_relationship_type}, {country}, {location_type})| Параметр | Объяснение | Тип данных |
in_table | Таблица адресов для геокодирования | Table View |
address_locator | Локатор адресов для геокодирования таблицы адресов. | Address Locator |
in_address_fields [input_address_field, table_field_name] | Сопоставление каждого поля в данном параметре производится в формате input_address_field, table_field_name, где input_address_field – имя поля входного адреса, указанного локатором адресов, а table_field_name – имя соответствующего поля в таблице адресов, для которой вы производите геокодирование. Вы можете указать одно входное поле, которое содержит полный адрес, например, 303 Peachtree St NE, Atlanta, GA 30308. Или, можно указать несколько полей, если входной адрес разбит на несколько разных полей, например, Address, City, State, and ZIP и для обычных почтовых адресов США. Некоторые местоположения поддерживают несколько входных полей адресов, таких как Address, Address2 и Address3. В этом случае компонент адреса можно разделить на несколько полей, а поля адреса во время геокодирования будут объединены вместе. Например, 100, Main st и Apt 140 в трех полях или 100 Main st и Apt 140 в двух полях в результате геокодирования образуют адрес в виде 100 Main st Apt 140. Если вы решите не сопоставлять необязательное входное адресное поле, используемое локатором адресов, с полем во входной таблице адресов, укажите, что сопоставление не требуется, выбрав <None> вместо названия поля. | Field Info |
out_feature_class | Выходной геокодированный класс пространственных объектов или шейп-файл. | Feature Class |
out_relationship_type (Дополнительный) | Указывает, создавать ли статическую копию таблицы адресов внутри класса геокодированных объектов, или создать динамически обновляемый класс геокодированных объектов.
| Boolean |
country [country,...] (Дополнительный) | Геокодирование будет ограничено выбранными странами. Если страна не выбрана, геокодирование будет осуществляться для всех поддерживаемых стран. Указание конкретной страны, в большинстве случаев, повысит точность геокодирования. Если поле страны во Входной таблице обозначено как CountryCode во Входном поле адреса, значение страны из Входной таблицы будет превалировать по сравнению со значением в параметре Страна. Входное значение должно быть указано как ISO 3166-1 3-значный код страны. Этот параметр не поддерживается для всех локаторов. | String |
location_type (Дополнительный) | Определяет предпочитаемую выходную геометрию для совпадений PointAddress. Опции выбора стороны улицы, которые могут использоваться для маршрутизации, или крыши зданий либо центроиды участков для точки адреса. Если предпочитаемое местоположение не присутствует в данных, вместо него будет возвращено местоположение по умолчанию. Для геокодирования результатов с использованием Addr_type=PointAddress значения атрибутов X/Y описывают координаты адреса вдоль улицы, тогда как значения DisplayX/DisplayY - координаты крыши или центральной точки здания. См. веб-справку REST API для дополнительной информации о параметре locationType для geocodeAddresses. Этот параметр не поддерживается для всех локаторов.
| String |
Пример кода
GeocodeAddresses, пример (окно Python)
Пример скрипта окна Python для использования функции GeocodeAddress в режиме прямого запуска (геокодирование с несколькими полями адреса).
import arcpy
arcpy.env.workspace = "C:/ArcTutor/Geocoding/Atlanta.gdb"
# Set local variables:
address_table = "customers"
address_locator = "C:/ArcTutor/Geocoding/Atlanta"
address_fields = "Street Address;City City;State State;ZIP Zip"
geocode_result = "geocode_result"
arcpy.GeocodeAddresses_geocoding(address_table, address_locator, address_fields,
geocode_result, 'STATIC')
GeocodeAddresses, пример (окно Python)
Пример скрипта окна Python для использования функции GeocodeAddress в режиме прямого запуска (геокодирование с одним полем адреса).
import arcpy
arcpy.env.workspace = "C:/ArcTutor/Geocoding/Atlanta.gdb"
# Set local variables:
address_table = "customers"
address_locator = "C:/ArcTutor/Geocoding/Atlanta"
address_fields = "'Single Line Input' SINGLELINE"
geocode_result = "singleline_geocode_result"
arcpy.GeocodeAddresses_geocoding(address_table, address_locator, address_fields,
geocode_result, 'STATIC')
Параметры среды
Информация о лицензиях
- Basic: Ограничено
- Standard: Да
- Advanced: Да