Обратное геокодирование (Инструменты Геокодирование)

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

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

Для выполнения операций геокодирования с помощью ArcGIS World Geocoding Service требуется учетная запись организации ArcGIS и необходимы кредиты. Учетная запись организации должна иметь достаточное количество кредитов для выполнения всего запроса на геокодирование.

Примечание:

В верхней части инструмента доступна оценка кредитов, если активный портал — это ArcGIS Online, а входной локатор — это ArcGIS World Geocoding Service.

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

Входной класс объектов должен содержать точечные объекты с правильными координатами x, y. Для точек с пустыми координатами результаты возвращены не будут.
Выходной класс объектов будет содержать такое же количество записей, что и входной класс объектов. Дополнительные поля, содержащие полученные адреса или места, добавляются к классу пространственных объектов. Имена полей включают префикс REV_. Если соответствующее место или адрес невозможно найти, поля будут содержать значения NULL.
Если пространственная привязка входного класса объектов и локатора разная, то локатор будет преобразовывать координаты на лету и пытаться найти сопоставление. Выходной класс объектов будет сохранен в той же пространственной привязке, что и входной класс объектов. Чтобы изменить пространственную привязку выходного класса объектов, задайте параметр среды Выходная система координат.
Если для точки во входном классе объектов не удалось сопоставить место или адрес, это значит, что в локаторе нет объектов, которые можно связать с входной точкой. Ниже приведены наиболее распространенные причины для несопоставленных точек:
- Точка содержит пустые координаты.
- Координаты точки неправильные, и их невозможно преобразовать в пространственную привязку, используемую локатором.
- Локатор не содержит в данной области базовых объектов, которые могут быть связаны с этой точкой.
- Был указан тип объекта, для которого нет хороших совпадений в пределах приемлемого расстояния. Более подробно см. раздел Условия сопоставления типов объектов.
Когда в свойствах локатора задается обратное расстояние, оно переопределяет оптимизированные иерархические значения расстояний, используемые на основе ролей, поддерживаемых локатором.
Требуется подписка ArcGIS Online for organizations для обратного геокодирования входного класса объектов с использованием ArcGIS World Geocoding Service.
При использовании входного локатора, построенного с использованием данных с z-значениями, инструмент вернет выходные данные, которые не поддерживают z-значения. Этот инструмент поддерживает только выходные 2D-данные.

Подпись	Объяснение	Тип данных
Входной класс объектов или слой	Класс точечных объектов или слой, из которого будут возвращены сопоставленные места или адреса на основе местоположения точек объектов.	Feature Layer
Входной локатор адресов	Локатор, который будет использоваться для обратного геокодирования входного класса объектов или слоя.	Address Locator
Выходной класс пространственных объектов	Выходной класс объектов. Примечание: Сохранение результатов в формате шейп-файлов не поддерживается в связи с ограничениями шейп-файлов.	Feature Class
Тип выходных адресных данных (Дополнительный)	Прежние версии: Этот параметр является устаревшим и поддерживает только обратную совместимость. По умолчанию используются типы объектов, поддерживаемые локатором.	String
Расстояние поиска (Дополнительный)	Прежние версии: Этот параметр является устаревшим и поддерживает только обратную совместимость. По умолчанию, оптимизированные иерархические значения расстояния будут использоваться на основании ролей, поддерживаемых локатором, и не могут быть перезаписаны.	Linear Unit
Тип объекта (Дополнительный)	Задает возможные типы возвращаемых сопоставлений. Можно задать как одно, так и несколько значений. Если задано одно значение, допуск поиска для типа входного объекта – 500 метров. Если включены множественные значения, будут применены расстояния поиска, указанные в таблице иерархии типа объекта. Дополнительные сведения об этом параметре для обратного геокодирования см. в разделе Типы объектов. Этот параметр не поддерживается для всех локаторов. Субадрес–Сопоставление будет ограничено уличным адресом на основании точек, представляющих местоположения субадреса домов и строений. Для этой опции необходим локатор, созданный в ArcGIS Pro 2.8 или позднее и ArcGIS Enterprise 10.9 или позднее, если он опубликован как сервис. Адрес точки–Сопоставление будет ограничено уличным адресом на основании точек, представляющих местоположения домов и строений. Участок–Сопоставление будет ограничено участком земли, который считается реальным владением и может включать один или несколько домов и других строений. Эта опция обычно имеет адрес и связанный идентификационный номер участка. Этот параметр поддерживается только пользовательскими локаторами, созданными с использованием роли Parcel. Он не поддерживается локаторами ArcGIS World Geocoding Service и ArcGIS StreetMap Premium. Адрес улицы–Совпадение будет ограничено уличным адресом, отличающимся от Адреса точки, поскольку номер дома интерполируется из диапазона номеров. Совпадения адресов улицы включают диапазон номеров домов для соответствующего сегмента улицы, а не интерполированное значение номера дома. Пересечение улиц–Сопоставление будет ограничено уличным адресом, состоящим из перекрестка, города и, дополнительно, штата и почтового индекса. Он извлекается из базовых данных уличный адрес, например, Redlands Blvd & New York St, Redlands, CA, 92373. Название улицы–Совпадение будет ограничено уличным адресом, похожим на Street Address, но без номеров домов и с административным делением и почтовым индексом, например, W Olive Ave, Redlands, CA 92373. Местность–Сопоставление будет ограничено названием местоположения, обозначающее населенный пункт. Почтовый индекс–Сопоставление будет ограничено почтовым индексом. Базовые данные – это почтовый индекс, например, 90210 USA. Точка интереса–Сопоставление будет ограничено точкой интереса. Базовые данные могут состоять из имен административных районов, достопримечательностей и географических объектов, например, Starbucks. Указатель расстояния–Сопоставление будет ограничено адресом улицы, который представляет собой линейное расстояние вдоль улицы, обычно, в километрах или милях, от указанной исходной точки, например, Mile 25 I-5 N, San Diego, CA.	String
Предпочитаемый тип местоположения (Дополнительный)	Задает предпочитаемую выходную геометрию, которая будет возвращена для соответствий `PointAddress`. Если желаемое местоположение отсутствует в данных, будет возвращено местоположение адреса по умолчанию. См. веб-справку к ArcGIS REST API для получения подробной информации о параметре `locationType` для `geocodeAddresses`. Местоположение адреса–Возвращается геометрия для результатов геокодирования, которые представляют адреса таких элементов местоположений, как верхняя точка крыши, центроид участка или входная дверь. Используется по умолчанию. Местоположение маршрута–Будет возвращена геометрия результатов геокодирования, которые представляют местоположение рядом с обочиной улицы, которое может использоваться для маршрутизации транспортных средств.	String

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 метров. Если включены множественные значения, будут применены расстояния поиска, указанные в таблице иерархии типа объекта. Дополнительные сведения об этом параметре для обратного геокодирования см. в разделе Типы объектов. Этот параметр не поддерживается для всех локаторов. `SUBADDRESS`–Сопоставление будет ограничено уличным адресом на основании точек, представляющих местоположения субадреса домов и строений. Для этой опции необходим локатор, созданный в ArcGIS Pro 2.8 или позднее и ArcGIS Enterprise 10.9 или позднее, если он опубликован как сервис. `POINT_ADDRESS`–Сопоставление будет ограничено уличным адресом на основании точек, представляющих местоположения домов и строений. `PARCEL`–Сопоставление будет ограничено участком земли, который считается реальным владением и может включать один или несколько домов и других строений. Эта опция обычно имеет адрес и связанный идентификационный номер участка. Этот параметр поддерживается только пользовательскими локаторами, созданными с использованием роли Parcel. Он не поддерживается локаторами ArcGIS World Geocoding Service и ArcGIS StreetMap Premium. `STREET_ADDRESS`–Сопоставление будет ограничено уличным адресом, который отличается от `POINT_ADDRESS`, так как номер дома интерполируется на основе диапазона номеров. Сопоставления `STREET_ADDRESS` включают диапазон номеров домов для соответствующего отрезка улицы, а не интерполированное значение номера дома. `STREET_INTERSECTION`–Сопоставление будет ограничено уличным адресом, состоящим из перекрестка, города и, дополнительно, штата и почтового индекса. Он извлекается из базовых данных `STREET_ADDRESS`, например, Redlands Blvd & New York St, Redlands, CA, 92373. `STREET_NAME`–Сопоставление будет ограничено адресом, похожим похожий на `STREET_ADDRESS`, но без номеров домов, а также административным округом и, дополнительно, почтовым индексом, например, W Olive Ave, Redlands, CA 92373. `LOCALITY`–Сопоставление будет ограничено названием местоположения, обозначающее населенный пункт. `POSTAL`–Сопоставление будет ограничено почтовым индексом. Базовые данные – это почтовый индекс, например, 90210 USA. `POINT_OF_INTEREST`–Сопоставление будет ограничено точкой интереса. Базовые данные могут состоять из имен административных районов, достопримечательностей и географических объектов, например, Starbucks. `DISTANCE_MARKER`–Сопоставление будет ограничено адресом улицы, который представляет собой линейное расстояние вдоль улицы, обычно, в километрах или милях, от указанной исходной точки, например, Mile 25 I-5 N, San Diego, CA.	String
location_type (Дополнительный)	Задает предпочитаемую выходную геометрию, которая будет возвращена для соответствий `PointAddress`. Если предпочитаемое местоположение отсутствует в данных, будет возвращено местоположение `ADDRESS_LOCATION` по умолчанию. См. веб-справку к ArcGIS REST API для получения подробной информации о параметре `locationType` для `geocodeAddresses`. `ADDRESS_LOCATION`–Возвращается геометрия для результатов геокодирования, которые представляют адреса таких элементов местоположений, как верхняя точка крыши, центроид участка или входная дверь. Используется по умолчанию. `ROUTING_LOCATION`–Будет возвращена геометрия результатов геокодирования, которые представляют местоположение рядом с обочиной улицы, которое может использоваться для маршрутизации транспортных средств.	String

Пример кода

ReverseGeocode, пример 1 (окно 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.loc"
result_feature_class = "customers_with_address"

arcpy.geocoding.ReverseGeocode(input_feature_class, address_locator,
                               result_feature_class, "ADDRESS")

ReverseGeocode, пример 2 (автономный скрипт)

В следующем скрипте 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)

ReverseGeocode, пример 3 (автономный скрипт)

В следующем скрипте 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: Да

Обратное геокодирование (Инструменты Геокодирование)

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

Примечание:

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

Параметры

Примечание:

Прежние версии:

Прежние версии:

Параметры среды

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

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