Подпись | Описание | Тип данных |
Входной класс объектов или слой | Класс точечных объектов или слой, из которого будут возвращены сопоставленные места или адреса на основе местоположения точек объектов. | Feature Layer |
Входной локатор адресов | Локатор, который будет использоваться для обратного геокодирования входного класса объектов или слоя. | Address Locator |
Выходной класс объектов | Выходной класс объектов. Примечание:Сохранение результатов в формате шейп-файлов не поддерживается в связи с ограничениями шейп-файлов. | Feature Class |
Тип выходных адресных данных (Дополнительный) |
Прежние версии:Этот параметр является устаревшим и поддерживается только для обратной совместимости. По умолчанию используются типы объектов, поддерживаемые локатором. | String |
Расстояние поиска (Дополнительный) |
Прежние версии:Этот параметр является устаревшим и поддерживается только для обратной совместимости. По умолчанию, оптимизированные иерархические значения расстояния будут использоваться на основании ролей, поддерживаемых локатором, и не могут быть перезаписаны. | Linear Unit |
Тип объекта (Дополнительный) | Задает возможные типы возвращаемых сопоставлений. Можно выбрать как одно, так и несколько значений. Если выбрано единичное значение, допуск поиска для типа входного объекта – 500 метров. Если включено несколько значений, будут применены расстояния поиска, указанные в таблице иерархии типов объектов. См. в разделе Типы объектов более подробно о параметре Тип объекта для обратного геокодирования. Этот параметр не поддерживается всеми видами локаторов.
| String |
Предпочитаемый тип местоположения (Дополнительный) | Задает предпочитаемую выходную геометрию для сопоставления Точечного адреса. Варианты этого параметра - сторона улицы, которую можно использовать для построения маршрутов, либо местоположение, находящееся на крыше здания либо в центре земельного участка. Если предпочтительное местоположение не существует в данных, будет возвращено расположение по умолчанию. Для результатов геокодирования Addr_type=PointAddress атрибутивные значения x,y соответствуют координатам адреса, а значения DisplayX и DisplayY описывают координаты верхней точки крыши или центроида здания. Этот параметр не поддерживается всеми видами локаторов.
| String |
Краткая информация
Создает адреса из точечных местоположений класса пространственных объектов. В процессе обратного геокодирования выполняется поиск ближайшего адреса, места или пересечения для местоположения точки на основе оптимизированных значений расстояний для локаторов, созданных с помощью инструмента Создать локатор.
Для выполнения операций геокодирования с помощью ArcGIS World Geocoding Service необходима учетная запись организации ArcGIS, при этом расходуются кредиты. Учетная запись организации должна иметь достаточное количество кредитов для выполнения всего запроса на геокодирование.
Примечание:
В верхней части инструмента доступна оценка кредитов, если активным является портал ArcGIS Online, а входным локатором адресов - ArcGIS World Geocoding Service.
Использование
Входной класс объектов должен содержать точечные фигуры с правильными координатами x, y. Для точек с пустыми координатами результаты возвращены не будут.
Выходной класс объектов будет содержать такое же количество записей, что и входной класс объектов. Дополнительные поля, содержащие полученные адреса или места, добавляются к классу пространственных объектов. Имена полей включают префикс REV_. Если соответствующее место или адрес невозможно найти, поля будут содержать пустые значения.
Если пространственная привязка входного класса объектов и локатора разная, то локатор будет преобразовывать координаты на лету и пытаться найти сопоставление. Выходной класс объектов будет сохранен в той же пространственной привязке, что и входной класс объектов. Чтобы изменить пространственную привязку для выходного класса пространственных объектов задайте другую выходную систему координат в параметрах среды инструмента.
Если для точки во входном классе объектов не удалось сопоставить место или адрес, это значит, что в локаторе нет объектов, которые можно связать с входной точкой. Ниже приведены наиболее распространенные причины для несопоставленных точек:
- Точка содержит нулевые координаты.
- Координаты точки неправильные, и их невозможно преобразовать в пространственную привязку, используемую локатором.
- Локатор не содержит в данной области базовых объектов, которые могут быть связаны с этой точкой.
- Был указан тип объекта, для которого нет хороших совпадений в пределах приемлемого расстояния. Более подробно см. раздел Условия сопоставления типов объектов.
Для обратного геокодирования класса объектов с помощью ArcGIS World Geocoding Service необходима подписка ArcGIS Online для организаций.
При использовании входного локатора, построенного с использованием данных с z-значениями, инструмент вернет выходные данные, которые не поддерживают z-значения. Этот инструмент поддерживает только выходные 2D-данные.
Параметры
arcpy.geocoding.ReverseGeocode(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 (Дополнительный) |
Прежние версии:Этот параметр является устаревшим и поддерживается только для обратной совместимости. По умолчанию используются типы объектов, поддерживаемые локатором. | String |
search_distance (Дополнительный) |
Прежние версии:Этот параметр является устаревшим и поддерживается только для обратной совместимости. По умолчанию, оптимизированные иерархические значения расстояния будут использоваться на основании ролей, поддерживаемых локатором, и не могут быть перезаписаны. | Linear Unit |
feature_type [feature_type,...] (Дополнительный) | Задает возможные типы возвращаемых сопоставлений. Можно выбрать как одно, так и несколько значений. Если выбрано единичное значение, допуск поиска для типа входного объекта – 500 метров. Если включено несколько значений, будут применены расстояния поиска, указанные в таблице иерархии типов объектов. См. в разделе Типы объектов более подробно о параметре feature_type для обратного геокодирования. Этот параметр не поддерживается всеми видами локаторов.
| String |
location_type (Дополнительный) | Задает предпочитаемую выходную геометрию, которая будет возвращена для соответствий POINT_ADDRESS. Варианты этого параметра – ROUTING_LOCATION, сторона улицы, которую можно использовать для построения маршрутов, либо ADDRESS_LOCATION, местоположение, находящееся на крыше здания или в центре земельного участка. Если предпочтительное местоположение не существует в данных, будет возвращено расположение ROUTING_LOCATION по умолчанию. Для результатов геокодирования Addr_type=PointAddress атрибутивные значения x,y соответствуют координатам адреса, а значения DisplayX и DisplayY описывают координаты верхней точки крыши или центроида здания. См. веб-справку к REST API для получения подробной информации о параметре locationType для reverseGeocode. Этот параметр не поддерживается всеми видами локаторов.
| String |
Пример кода
Пример скрипта окна 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.loc"
result_feature_class = "customers_with_address"
arcpy.geocoding.ReverseGeocode(input_feature_class, address_locator,
result_feature_class, "ADDRESS")
Следующий скрипт Python демонстрирует использование функции ReverseGeocode в качестве автономного скрипта.
# Description:
# Reverse Geocode customer point locations using a locator created with
# the Create Locator tool.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "c:/data/Atlanta.gdb"
# Set local variables
input_features = "MyCustomers"
locator = "c:/data/Atlanta/Atlanta_StreetAddress.loc"
reverse_output = "MyCustomers_Reverse_Streets"
addr_type = "ADDRESS"
feature_type = "STREET_INTERSECTION;STREET_ADDRESS"
location_type = "ROUTING_LOCATION"
# Run ReverseGeocode
arcpy.geocoding.ReverseGeocode(input_features, locator, reverse_output,
addr_type, None, feature_type, location_type)
Этот скрипт Python демонстрирует пример использования функции ReverseGeocode с ArcGIS World Geocoding Service в автономном скрипте.
Примечание:
Если вы работаете с локаторами на своем портале, убедитесь, что выполнили вход и задали его в качестве активного в ArcGIS Pro. Для доступа к локатору, расположенному на портале, отличном от активного, можно выполнить аутентификацию через SignInToPortal.
# Description:
# Reverse Geocode customer point locations using the ArcGIS World Geocoding Service.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "c:/data/Atlanta.gdb"
# Set local variables
input_features = "MyCustomers"
locator = "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer/ArcGIS World Geocoding Service"
reverse_output = "MyCustomers_Reverse_Streets"
addr_type = "ADDRESS"
feature_type = "STREET_INTERSECTION;STREET_ADDRESS"
location_type = "ROUTING_LOCATION"
# Run ReverseGeocode
arcpy.geocoding.ReverseGeocode(input_features, locator, reverse_output,
addr_type, None, feature_type, location_type)
Параметры среды
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да