Обратное геокодирование (Reverse Geocode) (Геокодирование)
Резюме
Создает адреса из точечных местоположений класса пространственных объектов. В процессе обратного геокодирования осуществляется поиск ближайшего адреса или пересечения для точечного местоположения на заданном расстоянии поиска.
Использование
-
Входной класс объектов должен содержать точечные фигуры с правильными координатами XY. Адреса для точек с пустыми координатами не возвращаются.
Выходной класс объектов будет содержать такое же количество записей, что и входной класс объектов. Дополнительные поля, содержащие полученные адреса, добавляются к классу пространственных объектов. Имена полей имеют префикс REV_. Если адрес не будет найден, то эти поля не будут показывать никаких значений.
-
Если пространственная привязка (spatial reference) входного класса объектов будет отличаться от привязки локатора адресов, то локатор незамедлительно преобразует координаты. Выходной класс объектов будет сохранен в той же пространственной привязке, что и входной класс объектов. Изменить пространственную привязку для выходного класса пространственных объектов можно, задав другую выходную систему координат в параметрах среды инструмента.
-
Если адрес для точки во входном классе объектов найти не удалось, это значит, что в локаторе адресов нет объектов, которые могут быть связаны с входной точкой. Вот наиболее распространенные причины несопоставления точек:
- Расстояние поиска слишком мало, и точка не может найти еще более близлежащие объекты.
- Точка имеет нулевые координаты.
- Некорректные координаты точки не могут быть преобразованы в пространственную привязку, используемую локатором адресов.
- Локатор адресов не содержит в данной области базовых объектов, которые могут быть связаны с этой точкой.
Можно увеличить расстояние (радиус) поиска, чтобы увеличить вероятность найти ближайший адрес, либо применить другой локатор адресов, в котором содержится больше объектов, или который покрывает большую площадь для сопоставления входных точек.
Синтаксис
| Параметр | Объяснение | Тип данных |
in_features |
Класс или слой точечных объектов, от которых адреса отображаются в зависимости от местоположения точечного объекта. | Feature Class |
in_address_locator |
Локатор адресов, используемый для обратного геокодирования входного класса объектов. | Address Locator |
out_feature_class |
Выходной класс объектов | Feature Class |
address_type (дополнительно) |
Указывает, как отображать адреса точечных объектов — как уличные адреса или как адреса пересечений в случае, если локатором адресов поддерживается сопоставление пересечений.
| String |
search_distance (дополнительно) |
Расстояние, применяемое для поиска ближайшего адреса или пересечения для точечного местоположения. | Linear unit |
Пример кода
Следующий скрипт окна Python демонстрирует, как применять функцию ReverseGeocode в быстром режиме.
# Import system modules
import arcpy
from arcpy import env
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")