Skip To Content

Обратное геокодирование

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

Создает адреса из точечных местоположений класса пространственных объектов. В процессе обратного геокодирования осуществляется поиск ближайшего адреса или пересечения улиц для точечного местоположения на заданном расстоянии поиска. При использовании сервиса ArcGIS World Geocoding Service, эта операция может потреблять кредиты.

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

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

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

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

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

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

    Можно увеличить расстояние (радиус) поиска, чтобы увеличить вероятность найти ближайший адрес, либо применить другой локатор адресов, в котором содержится больше объектов, или который покрывает большую площадь для сопоставления входных точек.

  • Требуется подписка ArcGIS Online for organizations для обратного геокодирования входного класса объектов с использованием ArcGIS World Geocoding Service.

Синтаксис

ReverseGeocode_geocoding (in_features, in_address_locator, out_feature_class, {address_type}, search_distance, {feature_type}, {location_type})
ПараметрОбъяснениеТип данных
in_features

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

Feature Layer
in_address_locator

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

Address Locator
out_feature_class

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

Feature Class
address_type
(Дополнительный)

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

  • ADDRESSВозвращает уличные адреса или адрес в формате, определенном входным локатором адресов. Это является опцией по умолчанию.
  • INTERSECTIONВозвращает адреса пересечений. Эта опция доступна, если локатором адресов поддерживается сопоставление адресов пересечений.
String
search_distance

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

Linear Unit
feature_type
[feature_type,...]
(Дополнительный)

Возвращено ограничение возможных типов сопоставления. Можно выбрать как единичные так и множественные значения. Если выбрано единичное значение, допуск поиска для типа входного объекта – 500 метров. Если включены множественные значения, будут применены расстояния поиска, указанные в таблице иерархии типа вхоного объекта. См. веб-справку REST API для дополнительной информации о параметре featureTypes для reverseGeocode.

Этот параметр не поддерживается для всех локаторов.

  • POINT_ADDRESSАдрес улицы, основанный на точках, которые обозначают местоположение дома или здания.
  • STREET_ADDRESSАдрес улицы отличается от PointAddress так как номер дома интерполируется на основе диапазона номеров. Совпадения StreetAddress включают диапазон номеров домов для сопоставленного отрезка улицы а не интерполированное значение номера дома.
  • STREET_INTERSECTIONАдрес улицы – адрес состоит из перекрестка, города и, дополнительно, штата и почтового индекса, например, Redlands Blvd New York St, Redlands, CA, 92373. Он извлекается из базовых данных Street Address, например, Redlands Blvd & New York St, Redlands, CA, 92373.
  • LOCALITYИмя местоположения представляет заполненное местоположение.
  • POSTALПочтовый индекс. Базовые данные – это почтовый индекс, например, 90210 USA.
  • POINT_OF_INTERESTТочка интереса. Базовые данные могут состоять из имен административных районов, достопримечательностей и географических объектов, например Starbucks.
String
location_type
(Дополнительный)

Задает предпочитаемую выходную геометрию для соответствия POINT_ADDRESS. Варианты этого параметра - ROUTING_LOCATION, сторона улицы, которую можно использовать для построения маршрутов, либо ADDRESS_LOCATION, местоположение, находящееся на крыше здания или в центре земельного участка. Если предпочитаемое местоположение отсутствует в данных, вместо него будет возвращено местоположение ROUTING_LOCATION по умолчанию. Для результатов геокодирования с Addr_type=PointAddress атрибутивные значения x,y соответствуют координатам адреса, а значения DisplayX и DisplayY описывают координаты верхней точки крыши или центроида здания. См. справочную онлайн-систему REST API для получения подробной информации о параметре locationType для reverseGeocode.

Этот параметр не поддерживается для всех локаторов.

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

Пример кода

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

Пример скрипта окна Python для использования функции ReverseGeocode в режиме прямого запуска.

import arcpy
arcpy.env.workspace = "C:/data/locations.gdb"
# Set local variables:
input_feature_class = "customers"
address_locator = "e:/StreetMap/data/Street_Addresses_US"
result_feature_class = "customers_with_address"
arcpy.ReverseGeocode_geocoding(input_feature_class, address_locator, 
                               result_feature_class, "ADDRESS", "100 Meters")

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

  • ArcGIS Desktop Basic: Да
  • ArcGIS Desktop Standard: Да
  • ArcGIS Desktop Advanced: Да

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