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

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

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

Этот инструмент можно использовать для привязки адресов точек к данным улиц. Связь устанавливается путем сравнения названий объектов точек и улиц, а также расстояния между ними. Лучший кандидат имеет наибольшее сходство между именами, но также ожидается, что он расположен рядом. Как только связь установлена, для адреса точки можно создать 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_StName_AddNum — для привязки точки к улице использовался только компонент названия улицы, а номер дома находился в пределах диапазона номеров домов связанной улицы.
      • Match_StName — для привязки точки к улице использовался только компонент названия улицы.
      • Match_Distance_AddNum — для привязки точки к улице использовалось расстояние, поскольку компоненты названия улицы между точками и улицами не совпадали, но номер дома находился в пределах диапазона номеров домов связанной улицы.
      • Match_Distance — для привязки точки к улице использовалось расстояние, поскольку компоненты названия улицы между точками и улицами не совпадали.
      • Unmatched — точка не была сопоставлена с улицей на основе компонентов расстояния или адреса.
        Примечание:

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

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

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

Параметры

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

arcpy.geocoding.AssignStreetsToPoints(in_point_features, point_field_mapping, in_street_features, street_field_mapping, out_points, {street_fields}, {distance}, {output_geometry})
ИмяОписаниеТип данных
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.

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 — значение, представляющее конечное число в диапазоне номеров домов по правой стороне улицы.
Value Table
out_points

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

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

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

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

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

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

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

  • INPUT_POINT_GEOMETRYГеометрия для исходного входного класса точечных объектов будет включена в выходной класс точечных объектов.
  • STREET_POINT_GEOMETRYГеометрия для местоположения на улице связанной точки будет включена в выходной класс точечных объектов.
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"
)