| Подпись | Описание | Тип данных |
Входной класс объектов или слой | Класс точечных объектов или слой, из которого будут возвращены сопоставленные места или адреса на основе местоположения точек объектов. | Feature Layer |
Входной локатор адресов | Локатор, который будет использоваться для обратного геокодирования входного класса объектов или слоя. | Address Locator |
Выходной класс объектов | Выходной класс объектов. Примечание:Сохранение результатов в формате шейп-файлов не поддерживается в связи с ограничениями шейп-файлов. | Feature Class |
Тип выходных адресных данных (Дополнительный) |
Прежние версии:Этот параметр является устаревшим и поддерживается только для обратной совместимости. По умолчанию используются типы объектов, поддерживаемые локатором. | String |
Расстояние поиска (Дополнительный) |
Прежние версии:Этот параметр является устаревшим и поддерживается только для обратной совместимости. По умолчанию, оптимизированные иерархические значения расстояния будут использоваться на основании ролей, поддерживаемых локатором, и не могут быть перезаписаны. | Linear Unit |
Тип объекта (Дополнительный) | Задает возможные типы возвращаемых сопоставлений. Можно задать как одно, так и несколько значений. Если задано одно значение, допуск поиска для типа входного объекта – 500 метров. Если включено несколько значений, будут применены расстояния поиска, указанные в таблице иерархии типов объектов. Дополнительные сведения об этом параметре для обратного геокодирования см. в разделе Типы объектов. Этот параметр не поддерживается всеми видами локаторов.
| String |
Предпочитаемый тип местоположения (Дополнительный) | Задает предпочитаемую выходную геометрию, которая будет возвращена для соответствий PointAddress. Если предпочитаемое местоположение не существует в данных, будет возвращено расположение Местоположение адреса по умолчанию. См. веб-справку к ArcGIS REST API для получения подробной информации о параметре locationType для geocodeAddresses.
| String |
Краткая информация
Создает адреса из точечных местоположений класса пространственных объектов. В процессе обратного геокодирования выполняется поиск ближайшего адреса, места или перекрестка для местоположения точки на основе оптимизированных значений расстояний для локаторов, созданных с помощью инструмента Создать локатор.
Для выполнения операций геокодирования с помощью ArcGIS World Geocoding Service необходима учетная запись организации ArcGIS, при этом расходуются кредиты. Учетная запись организации должна иметь достаточное количество кредитов для выполнения всего запроса на геокодирование.
Примечание:
В верхней части инструмента доступна оценка кредитов, если активным является портал ArcGIS Online, а входным локатором адресов - ArcGIS World Geocoding Service.
Использование
Входной класс объектов должен содержать точечные фигуры с правильными координатами x, y. Для точек с пустыми координатами результаты возвращены не будут.
Выходной класс объектов будет содержать такое же количество записей, что и входной класс объектов. Дополнительные поля, содержащие полученные адреса или места, добавляются к классу пространственных объектов. Имена полей включают префикс REV_. Если соответствующее место или адрес невозможно найти, поля будут содержать значения NULL.
Если пространственная привязка входного класса объектов и локатора разная, то локатор будет преобразовывать координаты на лету и пытаться найти сопоставление. Выходной класс объектов будет сохранен в той же пространственной привязке, что и входной класс объектов. Чтобы изменить пространственную привязку выходного класса объектов, задайте параметр среды Выходная система координат.
Если для точки во входном классе объектов не удалось сопоставить место или адрес, это значит, что в локаторе нет объектов, которые можно связать с входной точкой. Ниже приведены наиболее распространенные причины для несопоставленных точек:
- Точка содержит нулевые координаты.
- Координаты точки неправильные, и их невозможно преобразовать в пространственную привязку, используемую локатором.
- Локатор не содержит в данной области базовых объектов, которые могут быть связаны с этой точкой.
- Был указан тип объекта, для которого нет хороших совпадений в пределах приемлемого расстояния. Более подробно см. раздел Условия сопоставления типов объектов.
Для обратного геокодирования класса объектов с помощью 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 метров. Если включено несколько значений, будут применены расстояния поиска, указанные в таблице иерархии типов объектов. Дополнительные сведения об этом параметре для обратного геокодирования см. в разделе Типы объектов. Этот параметр не поддерживается всеми видами локаторов.
| String |
location_type (Дополнительный) | Задает предпочитаемую выходную геометрию, которая будет возвращена для соответствий PointAddress. Если предпочтительное местоположение не существует в данных, будет возвращено расположение ADDRESS_LOCATION по умолчанию. См. веб-справку к ArcGIS REST API для получения подробной информации о параметре locationType для geocodeAddresses.
| 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: Да