Разбить адреса на компоненты (Геокодирование)

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

Разбивает информацию об улице в адресе на компоненте в адресе и создает таблицу или класс пространственных объектов с дополнительными компонентами в виде уникальных полей.

Иллюстрация

Иллюстрация инструмента Разбить адрес на компоненты

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

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

  • Вы можете хранить входной адрес улицы для разбиения в одном поле, например, StreetName или Address, которое выбирается поле входного адреса в инструменте.

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

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

  • Убедитесь, что значение параметра Файл исключений содержит строку для каждой записи, для которой вы хотите задать пользовательскую закономерность обработки. Отформатируйте файл так, чтобы он содержал поле входного адреса (если у вас более одного поля, объедините значения в одну строку), оканчивающееся ожидаемым символом разделения адреса. Имена полей для компонентов разбиения адреса должны совпадать со следующим:

    • AddNum
    • StPreDir
    • StPreType
    • StName
    • StType
    • StDir
    • UnitType
    • UnitName
    • BuildingType
    • BuildingUnit
    • LevelType
    • LevelName
    Примечание:

    Не все поля требуются; обязательны только необходимые для разбиения адреса на компоненты поля.

    Примечание:

    Для получения более подробной информации скачайте пример файла исключений.

    Первый адрес в файле, 123 South Beach Avenue, обычно разбивается на следующие поля:

    AddNumStPreDirStNameStType

    123

    Юг

    Пляж

    Avenue

    Файл исключений создаст следующую настраиваемую разбивку:

    AddNumStNameStType

    123

    South Beach

    Avenue

  • Этот инструмент поддерживает параллельную обработку. Если ваш компьютер имеет несколько процессоров или процессор с несколькими ядрами, может быть достигнута более высокая производительность, особенно при разделении адресов в больших наборах данных. Если параметр среды Коэффициент параллельной обработки не задан (по умолчанию), параллельная обработка масштабируется в зависимости от размера таблицы и количества логических ядер. Только один процесс используется для таблиц с менее чем 50 строками, но для таблиц с большим количеством строк инструмент масштабирует количество используемых процессов до количества логических процессоров на компьютере. Установка параметры среды равным 0 отключит параллельную обработку. Присвоение коэффициенту значения от 1 до 99 приведет к тому, что инструмент определит процент логических ядер для использования по формуле (Коэффициент параллельной обработки / 100 * Логические ядра), округлив результат до ближайшего целого значения. Если результат равен 0 или 1, параллельная обработка не будет включена.

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

Параметры

ПодписьОписаниеТип данных
Страна или регион

Указывает структуру страны в адресе, которая будет использоваться для разделения адресов на компоненты.

По умолчанию соответствует региональным настройкам операционной системы.

  • Австралия—Будет использоваться структура адресов Австралии.
  • Австрия—Будет использоваться структура адресов Австрии.
  • Бельгия—Будет использоваться структура адресов Бельгии.
  • Канада—Будет использоваться структура адресов Канады.
  • Швейцария—Будет использоваться структура адресов Швейцарии.
  • Чехия—Будет использоваться структура адресов Чехии.
  • Германия—Будет использоваться структура адресов Германии.
  • Испания—Будет использоваться структура адресов Испании.
  • Эстония—Будет использоваться структура адресов Эстонии.
  • Франция—Будет использоваться структура адресов Франции.
  • Великобритания—Будет использоваться структура адресов Великобритании.
  • Израиль—Будет использоваться структура адресов Израиля.
  • Италия—Будет использоваться структура адресов Италии.
  • Литва—Будет использоваться структура адресов Литвы.
  • Латвия—Будет использоваться структура адресов Латвии.
  • Нидерланды—Будет использоваться структура адресов Нидерландов.
  • Пуэрто-Рико—Будет использоваться структура адресов Пуэрто-Рико.
  • Швеция—Будет использоваться структура адресов Швеции.
  • США—Будет использоваться структура адресов США.
  • Южная Африка—Будет использоваться структура адресов ЮАР.
String
Входные адресные данные

Таблица или класс объектов, содержащие информацию об адресе, которая будет разбита на отдельные компоненты адреса.

Информация о зоне, такая как город, квартал, подрегион и почтовый округ, не поддерживается.

Table View
Входные поля адреса

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

Поля будут объединены в том порядке, в котором они были выбраны.

String
Выходные адресные данные

Выходной класс объектов или таблица, которые будут содержать разделенные данные адреса.

Dataset
Файл исключений
(Дополнительный)

Таблица, которая содержит исключения обработки адреса.

Таблица может быть поддержана в любом поддерживаемом формате.

Table View

arcpy.geocoding.SplitAddressIntoComponents(country_code, in_address_data, in_address_fields, out_address_data, {in_exceptions})
ИмяОписаниеТип данных
country_code

Указывает структуру страны в адресе, которая будет использоваться для разделения адресов на компоненты.

По умолчанию соответствует региональным настройкам операционной системы.

  • AUS—Будет использоваться структура адресов Австралии.
  • AUT—Будет использоваться структура адресов Австрии.
  • BEL—Будет использоваться структура адресов Бельгии.
  • CAN—Будет использоваться структура адресов Канады.
  • CHE—Будет использоваться структура адресов Швейцарии.
  • CZE—Будет использоваться структура адресов Чехии.
  • DEU—Будет использоваться структура адресов Германии.
  • ESP—Будет использоваться структура адресов Испании.
  • EST—Будет использоваться структура адресов Эстонии.
  • FRA—Будет использоваться структура адресов Франции.
  • GBR—Будет использоваться структура адресов Великобритании.
  • ISR—Будет использоваться структура адресов Израиля.
  • ITA—Будет использоваться структура адресов Италии.
  • LTU—Будет использоваться структура адресов Литвы.
  • LVA—Будет использоваться структура адресов Латвии.
  • NLD—Будет использоваться структура адресов Нидерландов.
  • PRI—Будет использоваться структура адресов Пуэрто-Рико.
  • SWE—Будет использоваться структура адресов Швеции.
  • USA—Будет использоваться структура адресов США.
  • ZAF—Будет использоваться структура адресов ЮАР.
String
in_address_data

Таблица или класс объектов, содержащие информацию об адресе, которая будет разбита на отдельные компоненты адреса.

Информация о зоне, такая как город, квартал, подрегион и почтовый округ, не поддерживается.

Table View
in_address_fields
[in_address_fields,...]

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

Поля будут объединены в том порядке, в котором они были выбраны.

String
out_address_data

Выходной класс объектов или таблица, которые будут содержать разделенные данные адреса.

Dataset
in_exceptions
(Дополнительный)

Таблица, которая содержит исключения обработки адреса.

Таблица может быть поддержана в любом поддерживаемом формате.

Table View

Пример кода

SplitAddressIntoComponents, пример 1 (окно Python)

Разбить таблицу с одной строкой адреса в одном поле на отдельные компоненты.

import arcpy

atlanta_addresses = r"C:\AtlantaAddresses.csv"
arcpy.geocoding.SplitAddressIntoComponents("USA", atlanta_addresses, "Address", 
                                           r"C:\MySplitAddresses.csv", 
                                           "ExceptionsFile.csv")

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

  • Basic: Да
  • Standard: Да
  • Advanced: Да

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