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

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

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

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

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

Иллюстрация

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

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

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

• Этот инструмент может помочь назначить 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 строк, будет использоваться только один процесс.

Параметры

Диалог

Подпись	Описание	Тип данных
Входные точечные объекты	Входной класс точечных объектов или слой.	Feature Layer
Сопоставление полей точек	Сопоставление полей компонента адреса улицы точечных объектов, которые будут использоваться для сравнения полного названия улицы с полным названием улицы в значении параметра Объекты улиц для вычисления сегмента улицы, с которым связана точка. Чтобы выбрать компоненты адреса из значения параметра Входные точечные объекты, которые будут использоваться для привязки точки к улице, выполните следующее: Выберите компонент адреса из ниспадающего списка в столбце Имя поля. В столбце Поле данных выберите из ниспадающего списка поле класса точечных объектов, содержащее соответствующий компонент адреса. Доступны следующие поля компонента адреса: Префикс направления улицы—направление, которое указывается перед названием улицы, например W в W. Redlands Blvd Префикс типа улицы—тип улицы, стоящий перед названием улицы, например Avenue в Avenue B Название улицы—название улицы, например Cherry в Cherry Rd Тип улицы—тип улицы, стоящий после названия улицы, например, St. в New York St. Направление улицы—направление, которое следует за названием улицы, например, NW в Bridge St. NW. Полное название улицы—полное название улицы в адресе, например, S. Orange St. Город—город, связанный с адресом, например, Redlands по адресу 380 New York St., Redlands, Ca. Штат—штат, связанный с адресом, например, CA (Калифорния), ул. Нью-Йорк, 380., Redlands, Ca. Код страны—трехсимвольный код страны, например, CAN для Канады. Код языка—трехсимвольный код языка, представляющий язык этого адреса, например ENG для английского.	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. Номер дома слева от—значение, представляющее начальное число в диапазоне номеров домов по левой стороне улицы. Номер дома слева до—значение, представляющее конечное число в диапазоне номеров домов по левой стороне улицы. Номер дома справа от—значение, представляющее начальное число в диапазоне номеров домов по правой стороне улицы. Номер дома справа до—значение, представляющее конечное число в диапазоне номеров домов по правой стороне улицы. Город слева—значение, представляющее город, связанный с адресом на левой стороне улицы. Город справа—значение, представляющее город, связанный с адресом на правой стороне улицы. Штат слева—значение, представляющее штат, связанный с адресом на левой стороне улицы. Штат справа—значение, представляющее штат, связанный с адресом на правой стороне улицы. Код страны—значение, представляющее трехсимвольный код страны, например, CAN для Канады. Код языка—значение, представляющее трехсимвольный код языка адреса, например, ENG для английского языка.	Value Table
Выходные точки	Выходной класс точечных объектов, содержащий поля улиц, назначенные точке.	Feature Class
Поле(я) улиц (Дополнительный)	Поля из значения параметра Объекты улиц, которые будут назначены значению параметра Выходные точки. Выберите поля из входных объектов улиц, которые содержат атрибуты для назначения связанным точечным объектам, например поле, содержащее значение ID улицы. Выбранные поля будут добавлены к значению параметра Выходные точки.	Field
Расстояние (Дополнительный)	Расстояние, которое будет использоваться для поиска объекта улицы, ближайшего к точечному объекту. Чем выше ограничение по расстоянию, тем больше времени потребуется для выполнения инструмента, но качество совпадений улучшается. По умолчанию задано значение 100 метров.	Double
Выходная геометрия (Дополнительный)	Определяет геометрию, которая будет включена в выходной класс точечных объектов. Входная точечная геометрия—Геометрия для исходного входного класса точечных объектов будет включена в выходной класс точечных объектов. Геометрия точки улицы—Геометрия для местоположения связанной точки на улице будет включена в выходной класс точечных объектов.	String
Страна или регион (Дополнительный)	Определяет, где к входным данным будет применена логика, зависящая от конкретной страны, для присвоения атрибутов сегмента улицы точечным объектам. По умолчанию соответствует региональным настройкам операционной системы. Можно задать с помощью опции <Как определено в данных> и сопоставления значения из параметров Входные точечные объекты и Объекты улиц в параметрах Сопоставление полей точек и Сопоставление полей улиц, или она может быть применена ко всему набору данных путем указания опции страны. <Как определено в данных>—Будет использоваться значение трехзначного кода языка, заданное в базовых данных для каждого объекта. Американское Самоа—Американское Самоа Австралия—Австралия Австрия—Австрия Бельгия—Бельгия Канада—Канада Швейцария—Швейцария Колумбия—Колумбия Чехия—Чехия Германия—Германия Дания—Дания Испания—Испания Эстония—Эстония Финляндия—Финляндия Франция—Франция Великобритания—Великобритания Гуам—Гуам India—India Израиль—Израиль Италия—Италия Japan—Japan Южная Корея—Южная Корея Литва—Литва Латвия—Латвия Северные Марианские острова—Северные Марианские острова Нидерланды—Нидерланды Норвегия—Норвегия Новая Зеландия—Новая Зеландия Пуэрто-Рико—Пуэрто-Рико Швеция—Швеция Американские Виргинские острова—Американские Виргинские острова США—США Внешние малые острова США—Внешние малые острова США Южная Африка—Южная Африка	String
Код языка (Дополнительный)	Определяет, где к входным данным будет применена логика, зависящая от языка, для присвоения атрибутов сегмента улицы точечным объектам. По умолчанию соответствует региональным настройкам операционной системы. Можно задать с помощью опции <Как определено в данных> и сопоставления значения из параметров Входные точечные объекты и Объекты улиц в параметрах Сопоставление полей точек и Сопоставление полей улиц, или она может быть применена ко всему набору данных путем указания языковой опции. <Как определено в данных>—Будет использоваться значение трехзначного кода языка, заданное в базовых данных для каждого объекта. Баскский—Баскский Каталонский—Каталонский Чешский—Чешский Датский—Датский Нидерландский—Нидерландский Английский—Английский Эстонский—Эстонский Финский—Финский Французский—Французский Немецкий—Немецкий Галисийский—Галисийский Иврит—Иврит Итальянский—Итальянский Японский—Японский Корейский—Корейский Латвийский—Латвийский Литовский—Литовский Норвежский—Норвежский Испанский—Испанский Шведский—Шведский	String

Python

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, ул. Нью-Йорк, 380., Redlands, Ca. STATE—штат, связанный с адресом, например, CA (Калифорния), ул. Нью-Йорк, 380., 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—Швейцария COL—Колумбия CZE—Чехия DEU—Германия DNK—Дания ESP—Испания EST—Эстония FIN—Финляндия FRA—Франция GBR—Великобритания GUM—Гуам IND—India ISR—Израиль ITA—Италия JPN—Japan KOR—Южная Корея LTU—Литва LVA—Латвия MNP—Северные Марианские острова NLD—Нидерланды NOR—Норвегия NZL—Новая Зеландия 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—Чешский DAN—Датский DUT—Нидерландский ENG—Английский EST—Эстонский FIN—Финский 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: Да