| Подпись | Описание | Тип данных |
Входные точечные объекты | Входной класс точечных объектов или слой. | Feature Layer |
Сопоставление полей точек | Сопоставление полей компонента адреса улицы точечных объектов, используемых для сравнения полного названия улицы с полным названием улицы в значении параметра Объекты улиц для вычисления сегмента улицы, с которым связана точка. Чтобы выбрать компоненты адреса из значения параметра Входные точечные объекты, которые будут использоваться для привязки точки к улице, выполните следующее:
Доступны следующие поля компонента адреса:
| Value Table |
Объекты улиц | Входной класс объектов улиц или слой, атрибуты которого будут присвоены значению параметра Входные точечные объекты. | Feature Layer |
Сопоставление полей для улиц | Сопоставление полей компонента адреса улицы из объектов улиц, используемых для сравнения полного названия улицы с полным названием улицы в значении параметра Входные точечные объекты для вычисления сегмента улицы, с которым связана точка. Чтобы выбрать компоненты адреса из значения параметра Объекты улиц, которые будут использоваться для привязки точки к улице, выполните следующее:
Выберите поля из класса объектов улиц в ниспадающем списке Поле данных, которые соответствуют компоненту адреса улицы, указанному в столбце Имя поля. Доступны следующие поля компонента адреса:
| Value Table |
Выходные точки | Выходной класс точечных объектов, содержащий поля улиц, назначенные точке. | Feature Class |
Поля улиц (Дополнительный) | Поля из значения параметра Объекты улиц, которые будут назначены значению параметра Выходные точки. Выберите поля из входных объектов улиц, которые содержат атрибуты для назначения связанным точечным объектам, например поле, содержащее значение ID улицы. Выбранные поля будут добавлены к значению параметра Выходные точки. | Field |
Расстояние (Дополнительный) | Расстояние, которое будет использоваться для поиска объекта улицы, ближайшего к точечному объекту. Чем выше ограничение по расстоянию, тем больше времени потребуется для выполнения инструмента, но качество совпадений улучшается. Значение по умолчанию составляет 70 метров. | Double |
Выходная геометрия (Дополнительный) | Определяет геометрию, которая будет включена в выходной класс точечных объектов.
| String |
Краткая информация
Использует адресную информацию, такую как названия улиц и расстояние, для поиска наилучшего объекта-кандидата для точки. Информация об адресе имеет приоритет перед расстоянием.
Этот инструмент можно использовать для привязки адресов точек к данным улиц. Связь устанавливается путем сравнения названий объектов точек и улиц, а также расстояния между ними. Лучший кандидат имеет наибольшее сходство между именами, но также ожидается, что он расположен рядом. Как только связь установлена, для адреса точки можно создать 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_ObjectID— Идентификатор объекта сегмента улицы из значения параметра Объекты улиц, связанного с входными точками.
Просмотрите результаты по значению параметра Выходные точки, если значение для поля Street_MatchReason равно Match_Distance_AddNum, Match_Distance или Unmatched. Визуализация на карте того, как точки связаны с улицей, облегчает просмотр результатов.
Этот инструмент поддерживает параллельную обработку. Если параметр среды Коэффициент параллельной обработки не задан (по умолчанию), параллельная обработка масштабируется в зависимости от размера таблицы и количества логических ядер. Для наборов данных, содержащих менее 50 строк, будет использоваться только один процесс.
Параметры
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, используя доступные компоненты адреса следующим образом:
| Value Table |
in_street_features | Входной класс объектов улиц или слой, атрибуты которого будут присвоены значению параметра in_point_features. | Feature Layer |
street_field_mapping [street_field_mapping,...] | Сопоставление полей компонента адреса улицы с объектами улицы, которые будут использоваться для сравнения полного названия улицы с полным названием улицы в значении параметра in_point_features для вычисления сегмента улицы, с которым связана точка. Укажите названия полей компонента уличного адреса и имена полей данных из значения параметра in_street_features, используя доступные компоненты адреса следующим образом:
| Value Table |
out_points | Выходной класс точечных объектов, содержащий поля улиц, назначенные точке. | Feature Class |
street_fields [street_fields,...] (Дополнительный) | Поля из значения параметра in_street_features, которые будут назначены значению параметра out_points. Укажите поля из входных объектов улиц, которые содержат атрибуты для назначения связанным точечным объектам, например, поле, содержащее значение ID улицы. Поля будут добавлены к значению параметра out_points. | Field |
distance (Дополнительный) | Расстояние, которое будет использоваться для поиска объекта улицы, ближайшего к точечному объекту. Чем выше ограничение по расстоянию, тем больше времени потребуется для выполнения инструмента, но качество совпадений улучшается. Значение по умолчанию составляет 70 метров. | Double |
output_geometry (Дополнительный) | Определяет геометрию, которая будет включена в выходной класс точечных объектов.
| String |
Пример кода
Следующий скрипт 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"
)