Краткая информация
Создает адреса из точечных местоположений класса пространственных объектов. В процессе обратного геокодирования осуществляется поиск ближайшего адреса или пересечения улиц для точечного местоположения на заданном расстоянии поиска. При использовании сервиса ArcGIS World Geocoding Service эта операция может потреблять кредиты.
Использование
Входной класс объектов должен содержать точечные фигуры с правильными координатами XY. Адреса для точек с пустыми координатами не возвращаются.
Выходной класс объектов будет содержать такое же количество записей, что и входной класс объектов. Дополнительные поля, содержащие полученные адреса, добавляются к классу пространственных объектов. Имена полей включают префикс REV_. Если адрес не будет найден, то эти поля не будут показывать никаких значений.
Если пространственная привязка входного класса объектов будет отличаться от привязки локатора адресов, то локатор незамедлительно преобразует координаты. Выходной класс объектов будет сохранен в той же пространственной привязке, что и входной класс объектов. Изменить пространственную привязку для выходного класса пространственных объектов можно, задав другую выходную систему координат в параметрах среды инструмента.
Если адрес для точки во входном классе объектов найти не удалось, это значит, что в локаторе адресов нет объектов, которые могут быть связаны с входной точкой. Вот наиболее распространенные причины появления несопоставленных точек:
- Расстояние поиска слишком мало, и точка не может найти еще более близлежащие объекты.
- Точка содержит нулевые координаты.
- Координаты точки не корректны и не могут быть преобразованы в пространственную привязку, используемую локатором адресов.
- Локатор адресов не содержит в данной области базовых объектов, которые могут быть связаны с этой точкой.
Можно увеличить расстояние (радиус) поиска, чтобы увеличить вероятность найти ближайший адрес, либо применить другой локатор адресов, в котором содержится больше объектов, или который покрывает большую площадь для сопоставления входных точек.
Для обратного геокодирования входного класса объектов с помощью ArcGIS World Geocoding Service необходима подписка на ArcGIS Online for organizations. Дополнительные сведения см. в разделе Работа с сервисом геокодирования ArcGIS Online World.
Синтаксис
ReverseGeocode_geocoding (in_features, in_address_locator, out_feature_class, {address_type}, {search_distance}, {feature_type}, {location_type})| Параметр | Объяснение | Тип данных |
in_features | Класс или слой точечных объектов, от которых адреса отображаются в зависимости от местоположения точечного объекта. | Feature Class |
in_address_locator | Локатор адресов, используемый для обратного геокодирования входного класса объектов. | Address Locator |
out_feature_class | Выходной класс объектов. | Feature Class |
address_type (Дополнительный) | Указывает, как отображать адреса точечных объектов – как уличные адреса или как адреса пересечений в случае, если локатором адресов поддерживается сопоставление пересечений.
| String |
search_distance (Дополнительный) | Расстояние, применяемое для поиска ближайшего адреса или пересечения для точечного местоположения. Некоторые локаторы используют оптимизированные значения расстояния, которые не поддерживают перекрытия в параметре Расстояние поиска. | Linear Unit |
feature_type [feature_type,...] (Дополнительный) | Возвращено ограничение возможных типов сопоставления. Можно выбрать как единичные так и множественные значения. Если выбрано единичное значение, допуск поиска для типа входного объекта – 500 метров. Если выбрано несколько значений, применяются расстояния поиска по умолчанию Этот параметр не поддерживается для всех локаторов.
| String |
location_type (Дополнительный) | Этот параметр доступен для всех локаторов, поддерживающих параметр locationType. Задает предпочитаемую выходную геометрию для соответствий PointAddress. Варианты этого параметра – сторона улицы, которую можно использовать для построения маршрутов, либо местоположение, представляющее крышу здания или центроид земельного участка. Если предпочитаемое местоположение отсутствует в данных, вместо него будет возвращено местоположение по умолчанию. Этот параметр не поддерживается для всех локаторов.
| String |
Пример кода
ReverseGeocode, пример (окно Python)
Пример скрипта окна Python для использования функции ReverseGeocode в режиме прямого запуска.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/ArcTutor/Geocoding/atlanta.gdb"
# Set local variables:
input_feature_class = "geocode_result"
address_locator = "C:/ArcTutor/Geocoding/Atlanta.loc"
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: Да