Наверх

Назначить улицы точкам (Геокодирование)

В этом разделе

  1. Краткая информация
  2. Иллюстрация
  3. Использование
  4. Параметры
  5. Параметры среды
  6. Информация о лицензиях

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

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

Этот инструмент можно использовать для привязки адресов точек к данным улиц. Связь устанавливается путем сравнения названий объектов точек и улиц, а также расстояния между ними. Лучший кандидат имеет наибольшее сходство между именами, но также ожидается, что он расположен рядом. Как только связь установлена, для адреса точки можно создать ID улицы, сторону улицы и новую точку рядом с улицей. Дополнительные атрибуты также могут быть перенесены с улицы на адрес точки. Варианты использования этого инструмента включают добавление атрибутов улиц к адресам точек или альтернативному направлению; создание точек, расположенных рядом с одноименной улицей, которые затем можно использовать в качестве местоположения маршрута; или для создания диаграмм fishbone (рыбья кость), иллюстрирующих взаимосвязь между адресами точек и связанным с ними объектом улицы.

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

Иллюстрация

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

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

  • Этот инструмент будет принимать в качестве входных данных классы объектов простых точек и линий.

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

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

  • Этот инструмент работает лучше всего, когда входные классы точечных и линейных объектов хранятся в базе геоданных, и выходные данные сохраняются в базе геоданных.

  • Для значений параметров Сопоставление полей точек и Сопоставление полей улиц используйте инструмент Разбить адрес на компоненты для обоих наборов данных, и используйте выходные данные этого инструмента для значений параметров Входные точечные объекты и Объекты улиц в инструменте Назначить улицы точкам, чтобы получить оптимальные варианты распределения улиц.

  • Для полного оптимизированного совпадения убедитесь, что для значений параметров Сопоставление полей точек и Сопоставление полей улиц сопоставлены поля города, штата, кода страны и кода языка. Для частичного оптимизированного совпадения убедитесь, что сопоставлены поля кода страны и кода языка, или укажите страну в параметре Страна или регион, а язык - в параметре Код языка.

  • Для повышения качества убедитесь, что для значений параметров Сопоставление полей точек и Сопоставление полей улиц во входных классах пространственных объектов точек и улиц заданы поля Номер дома и Название улицы.

  • Для облегчения рабочих процессов построения маршрутов в выходных данных предусмотрен индикатор стороны улицы, на которой расположена точка. Использование этого индикатора при построении локатора позволит отображать результаты на нужной стороне улицы.

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

  • По умолчанию выходные объекты будут содержать следующие поля:

    • Street_ObjectID— Идентификатор объекта сегмента улицы из значения параметра Объекты улиц, связанного с входными точками.
      Примечание:

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

    • InputPoint_X— Координата x значения параметра Входные точечные объекты в пространственной привязке класса точечных объектов.
    • InputPoint_Y— Координата y значения параметра Входные точечные объекты в пространственной привязке класса точечных объектов.
    • Street_X— Координата x местоположения входной точки на связанной улице для значения параметра Объекты улиц в пространственной привязке класса точечных объектов.
    • Street_Y— Координата y местоположения входной точки на связанной улице для значения параметра Объекты улиц в пространственной привязке класса точечных объектов.
    • Street_Side— Сторона улицы, где находится входная точка относительно направления оцифровки объекта. Это значение не является относительным к направлению движения по улице. Это значение не является относительным к направлению движения по улице.
      • L — точка привязана к левой стороне улицы.
      • R — точка привязана к правой стороне улицы.
      • NULL — точка не привязана к улице.
    • Street_MatchReason— указывает, как значения параметра Входные точечные объекты были связаны или сопоставлены со значениями параметра Объекты улиц после запуска инструмента. У этого атрибута может быть одно из следующих значений:
      • Match_FullStAddr_AddNum — все компоненты адреса были использованы для сопоставления точки с улицей, а номер дома находился в пределах диапазона номеров домов на связанной улице.
      • Match_FullStAddr — все компоненты адреса были использованы для сопоставления точки с улицей.
      • Match_Enhanced_AddNum - все компоненты адреса и номер дома были использованы для сопоставления точки с улицей.
      • Match_StName_AddNum — для привязки точки к улице использовался только компонент названия улицы, а номер дома находился в пределах диапазона номеров домов связанной улицы.
      • Match_StName — для привязки точки к улице использовался только компонент названия улицы.
      • Match_Distance_AddNum — для привязки точки к улице использовалось расстояние, поскольку компоненты названия улицы между точками и улицами не совпадали, но номер дома находился в пределах диапазона номеров домов связанной улицы.
      • Match_Distance — для привязки точки к улице использовалось расстояние, поскольку компоненты названия улицы между точками и улицами не совпадали.
      • Unmatched — точка не была сопоставлена с улицей на основе компонентов расстояния или адреса.
        Примечание:

        Если точка не сопоставлена с улицей, выходные поля по умолчанию и выбранные поля улиц будут иметь атрибуты NULL, но поля InputPoint_X и InputPoint_Y будут заполнены координатами выходного класса точечных объектов.

    • Street_Distance - расстояние в метрах от входной точки до ближайшего местоположения на связанной улице.

  • Просмотрите результаты по значению параметра Выходные точки, если значение для поля Street_MatchReason равно Match_Distance_AddNum, Match_Distance или Unmatched. Визуализация на карте того, как точки связаны с улицей, облегчает просмотр результатов.

  • Этот инструмент поддерживает параллельную обработку. Если параметр среды Коэффициент параллельной обработки не задан (по умолчанию), параллельная обработка масштабируется в зависимости от размера таблицы и количества логических ядер. Для наборов данных, содержащих менее 50 строк, будет использоваться только один процесс.

Параметры

ДиалогPython

ПодписьОписаниеТип данных
Входные точечные объекты

Входной класс точечных объектов или слой.

Feature Layer
Сопоставление полей точек

Сопоставление полей компонента адреса улицы точечных объектов, используемых для сравнения полного названия улицы с полным названием улицы в значении параметра Объекты улиц для вычисления сегмента улицы, с которым связана точка.

Чтобы выбрать компоненты адреса из значения параметра Входные точечные объекты, которые будут использоваться для привязки точки к улице, выполните следующее:

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

Доступны следующие поля компонента адреса:

  • Префикс направления улицы — направление, которое предшествует названию улицы, например, буква W в названии W. Redlands Blvd.
  • Префикс типа улицы — тип улицы, который предшествует названию улицы, например, Avenue в названии Avenue B.
  • Название улицы — название улицы, например, Cherry в названии Cherry Rd.
  • Тип улицы — тип улицы, следующий за названием улицы, например, St. в New York St.
  • Направление улицы — направление, которое следует за названием улицы, например, NW в Bridge St. NW.
  • Полное название улицы — полное название улицы в адресе, например, S. Orange St.
  • Город - город, связанный с адресом, например Redlands in 380 New York St, Redlands, Ca.
  • Штат - штат, связанный с адресом, например Ca in 380 New York St, Redlands, Ca.
  • Код страны - код страны, состоящий из трех символов, например CAN для Канады.
  • Код языка - код языка, состоящий из трех символов, обозначающий язык адреса, например ENG для английского языка.
Value Table
Объекты улиц

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

Feature Layer
Сопоставление полей для улиц

Сопоставление полей компонента адреса улицы, города, штата, кода страны и кода языка из объектов улицы, которые будут использоваться для сравнения полного названия улицы с полным названием улицы в значении параметра Input Входные точечные объекты для расчета сегмента улицы, с которым связана точка.

Чтобы выбрать компоненты адреса из значения параметра Объекты улиц, которые будут использоваться для привязки точки к улице, выполните следующее:

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

Выберите поля из класса объектов улиц в ниспадающем списке Поле данных, которые соответствуют компоненту адреса улицы, указанному в столбце Имя поля. Доступны следующие поля компонента адреса:

  • Префикс направления улицы — направление, которое предшествует названию улицы, например, буква W в названии W. Redlands Blvd.
  • Префикс типа улицы — тип улицы, который предшествует названию улицы, например, Avenue в названии Avenue B.
  • Название улицы — название улицы, например, Cherry в названии Cherry Rd.
  • Тип улицы — тип улицы, следующий за названием улицы, например, St. в New York St.
  • Направление улицы — направление, которое следует за названием улицы, например, NW в Bridge St. NW.
  • Полное название улицы — полное название улицы в адресе, например, S. Orange St.
  • Номер дома слева от — значение, представляющее начальное число в диапазоне номеров домов по левой стороне улицы.
  • Номер дома слева до — значение, представляющее конечное число в диапазоне номеров домов по левой стороне улицы.
  • Номер дома справа от — значение, представляющее начальное число в диапазоне номеров домов по правой стороне улицы.
  • Номер дома справа до — значение, представляющее конечное число в диапазоне номеров домов по правой стороне улицы.
  • Город слева - значение, обозначающее город, связанный с адресом на левой стороне улицы.
  • Город справа - значение, обозначающее город, связанный с адресом на правой стороне улицы.
  • Штат слева - значение, обозначающее штат, связанный с адресом на левой стороне улицы.
  • Штат справа - значение, обозначающее штат, связанный с адресом на правой стороне улицы.
  • Код страны - значение, представляющее собой код для страны, состоящий из трех символов, например CAN для Канады.
  • Код языка - значение, представляющее собой код языка адреса, состоящий из трех символов, например ENG для английского языка.
Value Table
Выходные точки

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

Feature Class
Поля улиц
(Дополнительный)

Поля из значения параметра Объекты улиц, которые будут назначены значению параметра Выходные точки. Выберите поля из входных объектов улиц, которые содержат атрибуты для назначения связанным точечным объектам, например поле, содержащее значение ID улицы. Выбранные поля будут добавлены к значению параметра Выходные точки.

Field
Расстояние
(Дополнительный)

Расстояние, которое будет использоваться для поиска объекта улицы, ближайшего к точечному объекту. Чем выше ограничение по расстоянию, тем больше времени потребуется для выполнения инструмента, но качество совпадений улучшается. По умолчанию задано значение 100 метров.

Double
Выходная геометрия
(Дополнительный)

Определяет геометрию, которая будет включена в выходной класс точечных объектов.

  • Входная точечная геометрия—Геометрия для исходного входного класса точечных объектов будет включена в выходной класс точечных объектов.
  • Геометрия точки улицы—Геометрия для местоположения на улице связанной точки будет включена в выходной класс точечных объектов.
String
Страна или регион
(Дополнительный)

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

По умолчанию соответствует региональным настройкам операционной системы. Можно задать с помощью опции <Как определено в данных> и подставив значение из параметров Входные точечные объекты и Объекты улиц в параметры Сопоставление полей точек и Сопоставление полей для улиц, либо применить ко всему набору данных, указав вариант страны.

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

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

По умолчанию соответствует региональным настройкам операционной системы. Можно задать с помощью опции <Как определено в данных> и подставив значение из параметров Входные точечные объекты и Объекты улиц в параметры Сопоставление полей точек и Сопоставление полей для улиц, либо применить ко всему набору данных, указав вариант языка.

  • <Как определено в данных>—Будет использоваться значение кода языка из трех символов, заданное в базовых данных для каждого объекта.
  • Баскский—Баскский
  • Каталонский—Каталонский
  • Чешский—Чешский
  • Нидерландский—Нидерландский
  • Английский—Английский
  • Эстонский—Эстонский
  • Французский—Французский
  • Немецкий—Немецкий
  • Галисийский—Галисийский
  • Иврит—Иврит
  • Итальянский—Итальянский
  • Японский—Японский
  • Корейский—Корейский
  • Латвийский—Латвийский
  • Литовский—Литовский
  • Норвежский—Норвежский
  • Испанский—Испанский
  • Шведский—Шведский
String

arcpy.geocoding.AssignStreetsToPoints(in_point_features, point_field_mapping, in_street_features, street_field_mapping, out_points, {street_fields}, {distance}, {output_geometry}, {country_code}, {language_code})
ИмяОписаниеТип данных
in_point_features

Входной класс точечных объектов или слой.

Feature Layer
point_field_mapping
[point_field_mapping,...]

Сопоставление полей компонента адреса улицы точечных объектов, используемых для сравнения полного названия улицы с полным названием улицы в значении параметра in_street_features для вычисления сегмента улицы, с которым связана точка.

Укажите названия полей компонента уличного адреса и имена полей данных из значения параметра in_point_features, используя доступные компоненты адреса следующим образом:

  • STREET_PREFIX_DIR — направление, которое указывается перед названием улицы, например W в W. Redlands Blvd
  • STREET_PREFIX_TYPE — тип улицы, стоящий перед названием улицы, например Avenue в Avenue B
  • STREET_NAME — название улицы, например Cherry в Cherry Rd
  • STREET_SUFFIX_TYPE — тип улицы, стоящий после названия улицы, например St. в New York St.
  • STREET_SUFFIX_DIR — направление, следующее за названием улицы, например, NW (северо-запад) в Bridge St. NW
  • STREET_FULL_NAME — полное название улицы в адресе, например, S. Orange St.
  • HOUSE_NUMBER — номер дома, связанный с адресом, например, 380 в адресе 380 New York St.
  • CITY - город, связанный с адресом, например, Redlands in 380 New York St, Redlands, Ca.
  • STATE - штат, связанный с адресом, например Ca in 380 New York St, Redlands, Ca.
  • COUNTRY_CODE - код страны, состоящий из трех символов, например CAN для Канады.
  • LANGUAGE_CODE - код языка, состоящий из трех символов, обозначающий язык адреса, например ENG для английского языка.

Value Table
in_street_features

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

Feature Layer
street_field_mapping
[street_field_mapping,...]

Сопоставление полей компонента адреса улицы с объектами улицы, которые будут использоваться для сравнения полного названия улицы с полным названием улицы в значении параметра in_point_features для вычисления сегмента улицы, с которым связана точка.

Укажите названия полей компонента уличного адреса и имена полей данных из значения параметра in_street_features, используя доступные компоненты адреса следующим образом:

  • STREET_PREFIX_DIR — направление, которое указывается перед названием улицы, например W в W. Redlands Blvd
  • STREET_PREFIX_TYPE — тип улицы, стоящий перед названием улицы, например Avenue в Avenue B
  • STREET_NAME — название улицы, например Cherry в Cherry Rd
  • STREET_SUFFIX_TYPE — тип улицы, стоящий после названия улицы, например St. в New York St.
  • STREET_SUFFIX_DIR — направление, следующее за названием улицы, например, NW (северо-запад) в Bridge St. NW
  • STREET_FULL_NAME — полное название улицы в адресе, например, S. Orange St.
  • HOUSE_NUMBER_FROM_LEFT — значение, представляющее начальное число в диапазоне номеров домов по левой стороне улицы.
  • HOUSE_NUMBER_TO_LEFT — значение, представляющее конечный номер в диапазоне номеров домов на левой стороне улицы.
  • HOUSE_NUMBER_FROM_RIGHT — значение, представляющее начальное число в диапазоне номеров домов по правой стороне улицы.
  • HOUSE_NUMBER_TO_RIGHT — значение, представляющее конечное число в диапазоне номеров домов по правой стороне улицы.
  • LEFT_CITY - значение, обозначающее город, связанный с адресом на левой стороне улицы.
  • RIGHT_CITY - значение, обозначающее город, связанный с адресом на правой стороне улицы.
  • LEFT_STATE - значение, обозначающее штат, связанный с адресом на левой стороне улицы.
  • RIGHT_STATE - значение, обозначающее штат, связанный с адресом на правой стороне улицы.
  • COUNTRY_CODE - значение, представляющее собой код для страны, состоящий из трех символов, например CAN для Канады.
  • LANGUAGE_CODE - значение, представляющее собой код языка адреса, состоящий из трех символов, например ENG для английского языка.
Value Table
out_points

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

Feature Class
street_fields
[street_fields,...]
(Дополнительный)

Поля из значения параметра in_street_features, которые будут назначены значению параметра out_points. Укажите поля из входных объектов улиц, которые содержат атрибуты для назначения связанным точечным объектам, например, поле, содержащее значение ID улицы. Поля будут добавлены к значению параметра out_points.

Field
distance
(Дополнительный)

Расстояние, которое будет использоваться для поиска объекта улицы, ближайшего к точечному объекту. Чем выше ограничение по расстоянию, тем больше времени потребуется для выполнения инструмента, но качество совпадений улучшается. По умолчанию задано значение 100 метров.

Double
output_geometry
(Дополнительный)

Определяет геометрию, которая будет включена в выходной класс точечных объектов.

  • INPUT_POINT_GEOMETRY—Геометрия для исходного входного класса точечных объектов будет включена в выходной класс точечных объектов.
  • STREET_POINT_GEOMETRY—Геометрия для местоположения на улице связанной точки будет включена в выходной класс точечных объектов.
String
country_code
(Дополнительный)

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

Можно задать с помощью опции AS_DEFINED_IN_DATA и подставив значение из параметров in_point_features и in_street_features в параметры point_field_mapping и street_field_mapping или применить ко всему набору данных, указав имя кода страны из трех символов.

  • AS_DEFINED_IN_DATA—Будет использоваться значение кода страны из трех символов, заданное в базовых данных для каждого объекта.
  • ASM—Американское Самоа
  • AUS—Австралия
  • AUT—Австрия
  • BEL—Бельгия
  • CAN—Канада
  • CHE—Швейцария
  • CZE—Чехия
  • DEU—Германия
  • ESP—Испания
  • EST—Эстония
  • FRA—Франция
  • GBR—Великобритания
  • GUM—Гуам
  • IND—Индия
  • ISR—Израиль
  • ITA—Италия
  • JPN—Japan
  • KOR—Южная Корея
  • LTU—Литва
  • LVA—Латвия
  • MNP—Северные Марианские острова
  • NLD—Нидерланды
  • NOR—Норвегия
  • PRI—Пуэрто-Рико
  • SWE—Швеция
  • VIR—Американские Виргинские острова
  • USA—США
  • UMI—Внешние малые острова США
  • ZAF—Южная Африка
String
language_code
(Дополнительный)

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

Можно задать с помощью опции AS_DEFINED_IN_DATA и подставив значение из параметров in_point_features и in_street_features в параметры point_field_mapping и street_field_mapping или применить ко всему набору данных, указав язык с помощью кода языка, состоящего из трех символов.

  • AS_DEFINED_IN_DATA—Будет использоваться значение кода языка из трех символов, заданное в базовых данных для каждого объекта.
  • BAQ—Баскский
  • CAT—Каталонский
  • CZE—Чешский
  • DUT—Нидерландский
  • ENG—Английский
  • EST—Эстонский
  • FRE—Французский
  • GER—Немецкий
  • GLG—Галисийский
  • HEB—Иврит
  • ITA—Итальянский
  • JPN—Японский
  • KOR—Корейский
  • LIT—Литовский
  • LAV—Латвийский
  • NOR—Норвежский
  • SPA—Испанский
  • SWE—Шведский
String

Пример кода

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

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

import arcpy

# Point Address Data from Tutorial Data
in_point_features = r"C:\Data\SanMarcos.gdb\Address_Points"
point_field_mapping = "STREET_FULL_NAME ADDRESS"

# Street Address Data from Tutorial Data
in_street_features = r"C:\Data\SanMarcos.gdb\Address_Lines"
street_field_mapping = "HOUSE_NUMBER_FROM_LEFT L_ADDNUM_FROM;HOUSE_NUMBER_TO_LEFT L_ADDNUM_TO;HOUSE_NUMBER_FROM_RIGHT R_ADDNUM_FROM;HOUSE_NUMBER_TO_RIGHT R_ADDNUM_TO;STREET_PREFIX_DIR STPREDIR;STREET_NAME STNAME;STREET_SUFFIX_TYPE STSUFFIX;STREET_SUFFIX_DIR STPOSTDIR"

output_data_path = r"C:\Data\SanMarcos.gdb\Street_Points"

arcpy.geocoding.AssignStreetsToPoints(
    in_point_features,
    point_field_mapping,
    in_street_features,
    street_field_mapping,
    output_data_path,
    street_fields=None,
    distance=70,
    output_geometry="STREET_POINT_GEOMETRY"
)

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

Текущая рабочая область, Коэффициент параллельной обработки

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

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

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

  • Обзор группы инструментов Подготовка данных
  • Поиск инструмента геообработки

Отзыв по этому разделу?

В этом разделе
  1. Краткая информация
  2. Иллюстрация
  3. Использование
  4. Параметры
  5. Параметры среды
  6. Информация о лицензиях