Геокодирование и геопоиск

Локаторы позволяют находить адреса и места, которые показаны на карте, вставлять их как остановки маршрута и загружать в качестве входных данных пространственного анализа. Локаторы ArcGIS Online включают геопоиск и геокодирование следующим образом:

  • Геопоиск (или поиск местоположений) – поиск адреса или точки интереса и приближение к этому местоположению. Результат может отобразиться на карте, но он нигде не хранится для последующего использования. Геопоиск доступен любому пользователю с доступом к Map Viewer, Map Viewer Classic или общедоступному приложению, которое включает поиск местоположений на карте. Он не требует подписки организации и не потребляет кредиты (но имеется ограничение в 1 миллион геопоисков в месяц).
  • Геокодирование – конвертация адреса или места в координаты x,y и добавление полученного результата к имеющейся в базе данных записи. Картографирование происходит не всегда, но размещение результатов на карте может являться частью рабочего процесса. Пакетное геокодирование и обратное геокодирование относятся к этой категории. Учётная запись организации с правами геокодирования премиум-ресурсов необходима для доступа кArcGIS World Geocoding Service и любым его представлениям при выполнении пакетного геокодирования.

    Примечание:

    Некоторые свойства представления локатора не поддерживаются для обратного геокодирования.

По умолчанию ArcGIS Online использует ArcGIS World Geocoding Service для поиска адресов, городов, достопримечательностей, организаций и почтовых индексов в более чем 100 государствах мира. Также, ArcGIS World Geocoding Service используется для поиска координат x,y для местоположения с помощью широты и долготы, а также систем координатной привязки, таких как Military Grid Reference System (MGRS) и United States National Grid (USNG).

Если ваша организация хочет оптимизировать поиск адресов и мест, участники с правами для создания ресурсов могут создать новое представление ArcGIS World Geocoding Service для поиска только по определенным типам местоположений в пределах области интереса. Например, вы можете создать представление локатора для ограничения поиска в пределах страны или области, или для возврата только тех результатов, которые соответствуют определённой категории, например, адреса или аэропорты. После того, как вы создали представление локатора, участник с ролью администратора по умолчанию может настроить организацию, чтобы она использовала представление локатора, по которому пользователи осуществляют геопоиск.

Примечание:

Использование ArcGIS World Geocoding Service или представлений этого локатора для пакетного геокодирования (включая публикацию файлов CSV или Microsoft Excel в качестве размещённых векторных слоёв) расходует кредиты. При использовании локаторов для геопоиска кредиты не потребляются.

Учётная запись организации с правами геокодирования премиум-ресурсов необходима для использования представлений локатора при выполнении пакетного геокодирования.

Кроме того, если организации необходимо геокодировать адреса на основе своих собственных данных, администраторы могут настроить собственные локаторы работающие на сайте ArcGIS Server для геопоиска, геокодирования или и того и другого. Например, нефтяная компания может добавить локаторы для поиска своих скважин, или городская администрация добавляет локатор для поиска пожарных гидрантов.

Если вы добавите дополнительные локаторы или представления локаторов, участники увидят в поле геопоиска стрелку для выбора подходящего локатора.

Типы и категории местоположений

В этом разделе описываются типы местоположений, а также их категории и подкатегории, доступные при настройке представления локатора.

Адреса, индексы и населенные пункты

Когда вы выбираете Адреса, индексы и населенные пункты в качестве типа местоположений для поиска, вы можете настроить результаты поиска более тонко, выбрав категории и подкатегории для поиска. Для Адреса, индексы и населенные пункты доступны следующие категории:

  • Адрес - при выборе этой категории все подкатегории адресов, указанные в следующей таблице, выбираются автоматически. Эта категория ограничивает результаты поиска только местами, которые могут быть определены в категорию адресов при фильтрации результатов на точки интереса, почтовые индексы, страны или штаты. Для получения более точных результатов поиска, выберите любую комбинацию подкатегорий адресов, соответствующую вашим требованиям.
  • Почтовый - при выборе этой категории результаты поиска ограничиваются любыми типами почтовых индексов, включая форматы с 5 знаками и более. Чтобы ограничить результаты поиска совпадениями с данной точностью, выберите категорию Почтовые и категорию верхнего уровня Адрес.
  • Населенный пункт - при выборе этой категории все подкатегории населенных пунктов, указанные в следующей таблице, выбираются автоматически. Эта категория позволяет ограничить результаты поиска административными подразделениями (или границами), такими как города, провинции или страны, убрав результаты по адресам, точкам интереса и почтовым индексам. Для получения более точных результатов поиска, выберите любую комбинацию подкатегорий населенных пунктов, соответствующую вашим требованиям.

КатегорияПодкатегорияОписание

Адрес

Адрес точки

Адрес точки – адрес, основанный на точках, которые обозначают местоположение дома или здания. Адреса точек соответствуют крышам домов, или, точнее, местонахождению адреса. Обычно это наиболее точный уровень пространственного сопоставления. Базовые данные содержат точки адресов с соответствующими номерами домов, названиями улиц, административным делением и, дополнительно, почтовым индексом, например 380 New York St, Redlands, CA, 92373.

Представление локатора, настроенное на данную подкатегорию, ограничивает результаты этими точными адресами, что позволит избежать приблизительного сопоставления, если вам требуется высокая точность.

Улица

Улица и номер дома отличается от точечного адреса тем, что номер дома и название улицы интерполируются из диапазона номеров. Базовые данные содержат центральные улицы линий с диапазонами номеров домов, а также административное деление и, дополнительно, почтовый индекс, например, 647 Haight St, San Francisco, CA 94117.

Представление локатора с данной подкатегорией ограничивает результаты интерполированными. Если вы хотите ограничить результаты данным уровнем точности, выберите эту подкатегорию вместе с категорией Точечный адрес.

Пересечение

Пересечением является уличный адрес, состоящий из пересечения улиц, названием города и, дополнительно, почтовым индексом, например, Redlands Blvd & New York St, Redlands, CA, 92373.

Представление локатора с данной подкатегорией ограничивает результаты перекрёстками, а не полными адресами, которые находятся только на одной улице.

Название улицы

Название улицы похоже на уличный адрес, но без указания номера дома. Они содержат центральные улицы линий с связанными названиями (без диапазонов номеров), а также административное деление и, дополнительно, почтовый индекс, например, W Olive Ave, Redlands, CA, 92373.

Представление локатора с данной подкатегорией ограничивает результаты только названиями улиц. Если вы хотите ограничить результаты данным уровнем точности, выберите эту подкатегорию вместе с подкатегориями Точечный адрес и Уличный адрес.

Субадрес

Субадрес - это поднабор точечного адреса, который представляет дополнительное расположение дома или здания, например, квартиру, этаж, или отдельное здание внутри комплекса зданий, например, 3836 Emerald Ave, Suite C, La Verne, CA, 91750.

Представление локатора с данной подкатегорией ограничивает результаты точками субадресов, включающими номер дома, название улицы и элементы субадреса, вместе с административным делением и дополнительными почтовыми индексами, исключая другие варианты совпадений адресов.

Почтовый

Без подкатегорий

Представление локатора, настроенное с категорией Почтовый возвращает все типы совпадений почтовых индексов, включая 5-значные (например, 92373) и другие форматы. Чтобы ограничить результаты поиска совпадениями с данной точностью, выберите категорию Почтовый и категорию верхнего уровня Адрес.

Населенный пункт

Окрестность

Район - это подразделение города, меньше, чем округ, но больше, чем сектор.

Город

Локатор, настроенный для этой подкатегории, ограничивает результаты только городами, например, городом Венеция в Италии.

Субрегион

Субрегион - это поднабор из штата или провинции, такой как округ в США, например, Округ Адамс в штате Висконсин.

Регион

Регион - это подраздел страны, чаще всего штат или провинция, например, провинция Онтарио в Канаде.

Страна

Страна является наибольшей единицей административного деления, также известной, как нация, например, Япония.

Сектор

Сектор - административная единица, крупнее чем квартал, но меньше, чем район, представляет собой подразделение района или округа, или группу кварталов.

Блок

Квартал - минимальная административная единица, представляющая собой подразделение сектора или района, или группу строений с одним названием.

Район

Округ - административная единица, меньше, чем город, но больше, чем район, например, муниципальный округ.

Городская агломерация

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

Территория

Территория - это обширная административная единица, меньше, чем страна, и больше, чем штат или провинция, например, территория Юкон в Канаде.

Зона

Зона - это категория, представляющая неофициальную административную область, которая не принадлежит стране, например, спорная область или объединение других административных зон, например, Центральная Америка.

Координаты

Когда вы выбираете Координаты в качестве типа местоположений для поиска, вы можете настроить результаты поиска более тонко, выбрав категории для поиска. Они описаны в приведенной ниже таблице.

КатегорияОписание

Долгота, широта

Эта категория представляет собой географические (x,y) координаты. X является долготой (координатами восток-запад), а Y - широтой (координатами север-юг). Координаты вводятся и возвращаются в виде x,y.

Широта, Долгота

Эта категория представляет собой географические (x,y) координаты. X является долготой (координатами восток-запад), а Y - широтой (координатами север-юг). Координаты вводятся и возвращаются в виде y,x.

MGRS

Категория координат Military Grid Reference System (MGRS).

USNG

Система координат United States National Grid (USNG).

Места интереса

Когда вы выбираете Точки интереса в качестве типа местоположений для поиска, вы можете настроить результаты поиска более тонко, выбрав категории для поиска. Они описаны в приведенной ниже таблице.

КатегорияОписание

Образование

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

Еда

В этой категории представлены все типы ресторанов.

Магазины и сервис

В этой категории собраны все типы магазинов и предприятий обслуживания.

Аэропорт

К этой категории относятся аэропорты, обозначенные либо по названиям, либо по кодам аэропортов.

Требования к настройке собственных локаторов

ArcGIS Online поддерживает локаторы, запускаемые на ArcGIS Server 10.0 и более поздних версиях, как локаторы для геопоиска. При использовании для геопоиска, локаторы могут быть внутренними и внешними. Внутренние локаторы работают только для геопоиска, когда Map Viewer Classic или другие клиенты ArcGIS Online получают к ним доступ. Например, если ваша организация публикует общедоступные приложения, только те пользователи, которые имеют доступ к внутренним локаторам, смогут находить места с помощью этих приложений.

ArcGIS Online поддерживает локаторы, работающие на ArcGIS Server 10.1 и более новых версий, как геокодеры для пакетного геокодирования. В отличие от геопоиска, для пакетного геокодирования необходимы внешние локаторы, размещённые вне вашего брандмауэра. Это необходимо, поскольку ArcGIS Online должен иметь доступ к операции geocodeAddresses в локаторе для пакетного геокодирования. Если внешний локатор является защищенным, сначала необходимо создать элемент защищенного сервиса в ArcGIS Online, в котором будут храниться учетные данные, необходимые для доступа к локатору. Затем можно настроить URL-адрес сервиса, предоставляемого элементом защищенного сервиса в качестве локатора.

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

ArcGIS Online поддерживает локаторы с одним полем из ArcGIS Server 10.0 и более новых версий. Локаторы из ArcGIS Server 10.0 и внутренние локаторы могут использоваться для геопоиска, но не для пакетного геокодирования. Для пакетного геокодирования необходимы внешние локаторы из ArcGIS Server 10.1 или более новых версий. Внутренние локаторы работают только для геопоиска, когда Map Viewer, Map Viewer Classic или другие клиенты ArcGIS Online получают к ним доступ. Например, если ваша организация публикует общедоступные приложения, только те пользователи, которые имеют доступ к внутренним локаторам, смогут находить места с помощью этих приложений. Элементы защищенного сервиса ArcGIS Online в данный момент не поддерживаются в ArcGIS Desktop. Для выполнения пакетного геокодирования, локатор должен быть размещён за пределами брандмауэра, чтобы ArcGIS Online мог получить доступ к операции geocodeAddresses локатора для пакетного геокодирования.

Обогатить слой информацией об адресе

При публикации размещенного векторного слоя из файла CSV, у вас есть возможность включить информацию из процесса геокодирования, как часть вашего размещенного векторного слоя. Эта информация генерируется локатором и хранится в полях в размещенном векторном слое.

По умолчанию только информация о местоположении (координаты x, y) включена в размещенный векторный слой. Есть две опции для включения дополнительной информации в размещенный векторный слой:

  • Присоединить четыре поля, которые показывают, насколько хорошо сопоставлен адрес - включаются поля status, score, match_addr и addr_type со значениями. Эти поля и значения описаны в следующей таблице.
  • Присоединить 50 полей для полной информации о местоположении - включаются все поля, перечисленные в следующей таблице.

Помните, что размер размещённого векторного слоя увеличится из-за этих дополнительных полей и значений. Насколько увеличится размер слоя зависит от количества записей во входном файле и от того, какую опцию вы выбрали. В следующей таблице описаны поля, которые можно добавить к размещенному слою объектов, опубликованному из файла .csv:

ПолеОписаниеПоддерживаемые типы запросов

spatialReference

Выходная пространственная привязка совпадает с координатами местоположения, заданными свойствами wkid и latestWkid. Входной параметр outSR определяет пространственную привязку.

findAddressCandidates

geocodeAddresses

reverseGeocode

address

Полностью совпавший адрес возвращается для запросов геокодирования findAddressCandidates и geocodeAddresses.

Пример: 380 New York St, Redlands, California, 92373

findAddressCandidates

geocodeAddresses

address (reverseGeocode only)

Полный адрес местоположения, включая номер дома и название улицы.

Пример: 380 New York St

Примечание:
Это отличается от поля address, которое возвращается в ответах для запросов findAddressCandidates и geocodeAddresses. Возвращается только для reverseGeocode. Это аналогично выходному полю StAddr для findAddressCandidates и geocodeAddresses.

reverseGeocode

location

Координаты точки выходных данных совпадают с местоположением, заданным свойствами x и y. Пространственная привязка координат x и y определяется выходным полем spatialReference. Посмотрите описания параметра locationType, чтобы получить более подробную информацию о том, как поле выходного местоположения связано с выходными атрибутами X и Y.

findAddressCandidates

geocodeAddresses

reverseGeocode

ResultID

Возвращается только для запросов geocodeAddresses. Каждая запись в результате пакетного геокодирования включает значение ResultID, которое равно значению OBJECTID соответствующей входной записи адреса. Его можно использовать для присоединения выходных полей к атрибутам исходной таблицы адресов.

geocodeAddresses

Loc_name

Имя локатора, используемого для возврата частично сопоставленных результатов.

Примечание:

Поле Loc_name используется внутри программного обеспечения ArcGIS и не предназначено для использования приложениями клиентами.

findAddressCandidates

geocodeAddresses

Status

Показывает вид результатов запросов геокодироваия: сопоставлено, связано или не сопоставлено.

Список возможных значений следующий:

  • M - Сопоставлен. Возвращаемый адрес сопоставлен с запросом, и есть кандидат с высоким рейтингом.
  • T - Связан. Возвращаемый адрес сопоставлен с запросом, но одинаковый рейтинг у нескольких кандидатов.
  • U - Не сопоставлен. Нет адресов, сопоставленных с запросом.

findAddressCandidates

geocodeAddresses

Score

Число в диапазоне от 1 до 100, определяющее, насколько входные токены запроса геокодирования соответствуют записи адреса кандидата. Счет (score), равный 100, означает полной совпадение. Чем он ниже - тем меньше точность совпадения.

findAddressCandidates

geocodeAddresses

Match_addr

Полный адрес возвращается для запросов геокодирования. Формат базируется на стандартах адресов для страны, в которой находится адрес.

findAddressCandidates

geocodeAddresses

reverseGeocode

LongLabel

Более длинная версия Match_addr, содержащая больше административных данных.

findAddressCandidates

geocodeAddresses

reverseGeocode

ShortLabel

Укороченная версия значения Match_addr.

findAddressCandidates

geocodeAddresses

reverseGeocode

Addr_type

Уровень совпадения для запроса геокодирования. Поддерживаемые уровни сопоставления различаются в разных странах.

Список возможных значений следующий:

  • Subaddress — поднабор значения PointAddress, который представляет собой субадрес дома или здания, например, корпус, этаж или отдельное здание в комплексе. Значения полей UnitName, UnitType, LevelName, LevelType, BldgName и BldgType помогают определять субадреса, которые могут быть связаны с тем же значением PointAddress. Базовые данные состоят из точечных объектов с номером дома, названием улицы и элементами субадреса, вместе с административным делением и, дополнительно, почтовым индексом. Пример: 3836 Emerald Ave, Suite C, La Verne, CA, 91750.
  • PointAddress - адрес улицы, основанный на точках, которые обозначают местоположение дома или здания. Обычно это наиболее точный уровень пространственного сопоставления. Базовые данные содержат точки адресов с соответствующими номерами домов, названиями улиц, административным делением и, дополнительно, почтовым индексом. Выходные значения X / Y и geometry для совпадения с PointAddress обозначают местоположение улицы данного адреса; это местоположение используется для маршрутизации. Значения DisplayX и DisplayY соответствуют крышам домов, или, точнее, местонахождению адреса. Пример: 380 New York St, Redlands, CA, 92373.
  • StreetAddress — адрес улицы отличается от значения PointAddress, так как номер дома интерполируется исходя из диапазона номеров. Базовые данные содержат центральные линии улиц с диапазонами номеров домов, административным делением и, дополнительно, почтовым индексом. Пример: 647 Haight St, San Francisco, CA, 94117.
  • StreetInt - адрес улицы состоит из перекрестка, города и, дополнительно, штата и почтового индекса Он извлекается из базовых данных StreetAddress. Пример: Redlands Blvd & New York St, Redlands, CA, 92373.
  • StreetAddressExt — интерполированный сопоставленный уличный адрес, который возвращается, когда параметр matchOutOfRange=true и входной номер дома превышает значение диапазона номеров домов в сопоставленном сегменте улицы.
  • DistanceMarker - уличный адрес, который представляет линейное расстояние вдоль улицы, обычно, в километрах или милях, от указанной исходной точки. Пример: Carr 682 KM 4, Barceloneta, 00617.
  • StreetMidBlock – оценочная средняя точка диапазона номеров домов вдоль участка улицы, который соответствует кварталу. Местоположение, возвращаемое для соответствия StreetMidBlock, более точное, чем соответствие StreetName, но менее точное, чем StreetAddress. В настоящее время это значение работает только для США. Пример: 100 Block of Grant Ave, Millville, New Jersey.
  • StreetName - то же, что и адрес, но без номера дома. Базовые данные содержат центральные улицы линий с связанными названиями (без диапазонов номеров), а также административное деление и, дополнительно, почтовый индекс. Пример: W Olive Ave, Redlands, CA, 92373.
  • Locality - имя местоположения представляет заполненное местоположение. Выходное поле Type, которое предоставляет более подробную информацию о типе населённого пункта. Возможные значения Type для совпадений Locality включает Block, Sector, Neighborhood,District, City, MetroArea, County, State or Province,Territory, Country и Zone. Пример: Bogotá, COL
  • PostalLoc - комбинация почтового индекса и названия города. Базовые данные обычно содержат комбинацию границ почтовых индексов и административных границ. Пример: 7132 Frauenkirchen.
  • PostalExt — почтовый индекс с дополнительным расширением, например, используемый почтовой службой США ZIP+4. Базовые данные – это почтовый индекс с расширениями. Пример: 90210-3841.
  • Postal – почтовый индекс. Базовые данные – это точки почтового индекса. Пример: 90210 USA.
  • POI — точки интереса. Базовые данные содержат названия предприятий, достопримечательностей и географический объекты. Пример: Starbucks.
  • LatLong - пара координат x,y. LatLong addr_type возвращается когда пара координат x,y, такая как 117.155579,32.703761, является входными данными для поиска.
  • XY — это совпадение , основанное на предположении, что первая координата является долготой, а вторая - широтой.
  • YX — возвращается как Addr_type для кандидата, при этом предполагается, что первая цифра - это широта, а вторая - долгота.
  • MGRS – местоположение в системе координат Military Grid Reference System (MGRS) типа 46VFM5319397841.
  • USNG — местоположение United States National Grid (USNG), такое как 15TXN29753883. Это значение Addr_type возвращается, только когда для параметра category задано USNG в запросе findAddressCandidates или geocodeAddresses.

findAddressCandidates

geocodeAddresses

reverseGeocode

Type

Тип объекта для ограничения результатов, возвращаемых поиском. Поле Type включает только значения для кандидатов с Addr_type = POI или Locality. Например, для кафе Starbucks Type=Coffee Shop.

findAddressCandidates

geocodeAddresses

reverseGeocode

PlaceName

Официальное название кандидата при геокодировании. Пример: Paris or Starbucks.

findAddressCandidates

geocodeAddresses

reverseGeocode

Place_addr

Полный адрес места, включая улицу, город и регион. Пример: 275 Columbus Ave, New York, New York.

findAddressCandidates

geocodeAddresses

Phone

Основной номер телефона точки интереса (POI). Пример: Knott's Berry Farm, Phone=(714)220-5200. При других типах поиска, таких как поиск адреса, перекрестка, почтового индекса, это поле пусто.

findAddressCandidates

geocodeAddresses

URL

URL-адрес основного веб-сайта данной точки интереса (POI). Пример: the University of Georgia, URL =http://www.uga.edu/. При других типах поиска, таких как поиск адреса, перекрестка, почтового индекса, это поле пусто.

findAddressCandidates

geocodeAddresses

Rank

Числовое значение с плавающей запятой, указывающее приоритет результата относительно других результатов с таким же именем. Например, в России и США есть города с названием Москва. Москва в России имеет большее население, чем Москва в Техасе, поэтому ее ранг выше. Поле Rank используется для сортировки неоднозначных запросов, например "Lincoln", когда нет дополнительной информации (о штате). Rank значения основаны на демографических данных или типе объекта.

findAddressCandidates

geocodeAddresses

AddBldg

Название здания. Пример: Empire State Building.

findAddressCandidates

geocodeAddresses

AddNum

Буквенно-числовое значение, представляющее часть адреса, обычно называемую номером дома или строения. Пример: в адресе 380 New York Street, AddNum = 380.

Это значение возвращается только при сопоставлении PointAddress и StreetAddress.

findAddressCandidates

geocodeAddresses

reverseGeocode

AddNumFrom

Значение, представляющее начальное число в диапазоне адресов улиц. Оно связано с направлением оцифровки объекта и не всегда является наименьшим в диапазоне. Это значение предоставляется для результатов сопоставления StreetAddress.

findAddressCandidates

geocodeAddresses

AddNumTo

Значение, представляющее конечное число в диапазоне адресов улиц. Оно связано с направлением оцифровки объекта и не всегда является наибольшим в диапазоне. Это значение предоставляется для результатов сопоставления StreetAddress.

findAddressCandidates

geocodeAddresses

AddRange

Полный диапазон номеров домов для участка улицы, на котором находится данный адрес, в формате AddNumFrom-AddNumTo. Например, значение AddRange для адреса 123 Main St. может быть 101-199.

findAddressCandidates

geocodeAddresses

Side

Сторона улицы, где находится адрес, относительно направления оцифровки объекта. Это значение не является относительным к направлению движения по улице. Возможные значения R (справа) и L (слева).

Примечание:

Side - это устаревшее поле, которое сохраняется только для поддержки приложений, ожидающие его присутствия в ответе REST. Для большинства адресов, возвращаемых службой геокодирования, это поле будет пустым. Его не следует использовать в целях анализа.

findAddressCandidates

geocodeAddresses

StPreDir

Элемент адреса, определяющий направление улицы и находящийся перед основным названием улицы. Пример: North в North Main Street.

findAddressCandidates

geocodeAddresses

StPreType

Элемент адреса, определяющий сопроводительный тип улицы. Пример: испанский термин "Avenida" в Avenida Central или французский термин "Rue"в Rue Lapin.

findAddressCandidates

geocodeAddresses

StName

Элемент адреса, определяющий основное название улицы. Пример: Main в North Main Street.

findAddressCandidates

geocodeAddresses

StType

Элемент адреса, определяющий второстепенный тип улицы. Пример: Street в Main Street.

findAddressCandidates

geocodeAddresses

StDir

Элемент адреса, определяющий направление улицы, находящийся после основного названия улицы. Пример: North в Main Street North.

findAddressCandidates

geocodeAddresses

BldgName

Название или номер подразделения здания. Пример: A в "building A".

findAddressCandidates

geocodeAddresses

BldgType

Классификация подразделения здания. Это может быть здание, ангар, башня.

findAddressCandidates

geocodeAddresses

LevelType

Классификация подразделения этажа. Это может быть этаж, уровень, отдел или крыло.

findAddressCandidates

geocodeAddresses

LevelName

Название или номер подразделения этажа. Пример: 3 в "level 3".

findAddressCandidates

geocodeAddresses

UnitType

Классификация подразделений модуля. Это может быть помещение, апартамент, квартира, офис или многокомнатный номер.

findAddressCandidates

geocodeAddresses

UnitName

Название или номер подразделения модуля. Пример: 2B в "apartment 2B".

findAddressCandidates

geocodeAddresses

SubAddr

Полное название внутренней единицы для кандидата с Addr_type=Subaddress, которое включает <subunit type> + <subunit name>. Например, если кандидат субадреса представляет собой квартиру, SubAddr = UnitType + UnitName. Пример: Apt 4B

findAddressCandidates

geocodeAddresses

StAddr

Адрес места, без города и региона. Пример: 275 Columbus Ave.

findAddressCandidates

geocodeAddresses

Block

Имя единицы административного деления уровня квартала для кандидата. Значение Block - это минимальная административная область страны. Это может быть подразделение района или пригорода, или квартал со своим названием. Обычно не используется.

findAddressCandidates

geocodeAddresses

reverseGeocode

Sector

Имя единицы административного деления уровня сектора для кандидата. Значение Sector - это составная часть района, округа или совокупность кварталов. Обычно не используется.

findAddressCandidates

geocodeAddresses

reverseGeocode

Nbrhd

Имя единицы административного деления уровня округа для кандидата. Значение Nbhrhd является подразделением города или округа.

findAddressCandidates

geocodeAddresses

Neighborhood

Имя единицы административного деления уровня округа для кандидата. Значение Neighborhood является подразделением города или округа.

Примечание:
Это аналогично выходному полю Nbhrhd для запроса findAddressCandidates и geocodeAddresses.

reverseGeocode

District

Имя единицы административного деления уровня района для кандидата. Например, подразделение города.

findAddressCandidates

geocodeAddresses

reverseGeocode

City

Имя единицы административного деления уровня города для кандидата. Значение City - это часть подрайона или района.

findAddressCandidates

geocodeAddresses

reverseGeocode

MetroArea

Название административной единицы на уровне городской агломерации для кандидата. Это городская застройка, состоящая из крупного города и окружающих его небольших городов. Значение может располагаться в нескольких субрегионах или регионах. Примером может являться Kolkata Metropolitan Area в Индии.

findAddressCandidates

geocodeAddresses

reverseGeocode

Subregion

Имя единицы административного деления уровня субрегиона для кандидата. Значение Subregion является подразделением района.

findAddressCandidates

geocodeAddresses

reverseGeocode

Region

Имя единицы административного деления уровня региона для кандидата. Это административная единица на уровне страны или территории. Как правило, это крупнейшее административное подразделение страны, если не используется уровень деления Territory.

findAddressCandidates

geocodeAddresses

reverseGeocode

RegionAbbr

Сокращенное название региона. Значение RegionAbbr для Калифорнии – это CA.

findAddressCandidates

geocodeAddresses

reverseGeocode

Territory

Имя единицы административного деления уровня территории для кандидата. Это административное подразделение страны. Обычно не используется. Например, Юго-восточный макрорегион Бразилии, состоящий из штатов Эспириту-Санту, Минас-Жерайс, Рио-де-Жанейро и Сан-Пауло.

findAddressCandidates

geocodeAddresses

reverseGeocode

Postal

Буквенно-числовой элемент адреса, определяющий основной почтовый код. Пример: V7M 2B4 в канадском почтовом индексе и 92374 в почтовом индексе США.

findAddressCandidates

geocodeAddresses

reverseGeocode

PostalExt

Буквенно-числовой элемент адреса, определяющий расширение почтового кода. Пример: 8100 в почтовом индексе США 92373-8110.

findAddressCandidates

geocodeAddresses

reverseGeocode

Country

Трехсимвольный код страны. Пример: Canada это CAN. Список поддерживаемых стран и кодов доступен на карте Geocode data coverage. Это поле возвращается операциями findAddressCandidates и geocodeAddresses.

findAddressCandidates

geocodeAddresses

CountryCode

Трехсимвольный код страны. Пример: Canada это CAN. Список поддерживаемых стран и кодов доступен на карте Geocode data coverage.

Примечание:
Это аналогично выходному полю Country для запроса findAddressCandidates и geocodeAddresses.

reverseGeocode

CntryName

Полное название страны для кандидата-адреса. Пример: "日本" (Япония). Имя может быть на том же языке, что и входной адрес, либо на языке, который указан в параметре запроса langCode. Если полное название страны на указанном языке недоступно, то вместо этого используется основной язык страны, в пределы которой попадает адрес-кандидат. Информация о том, какие языки поддерживаются по странам, доступна на карте Geocode data coverage. Это поле возвращается операциями findAddressCandidates, geocodeAddresses и reverseGeocode.

findAddressCandidates

geocodeAddresses

reverseGeocode

LangCode

Трехсимвольный код языка, представляющий язык адреса. Пример: ENG это английский.

findAddressCandidates

geocodeAddresses

Distance

Физическое расстояние в метрах от кандидата до указанного положения. Выходное значение Distance вычисляется для каждого кандидата, когда входной параметр Location задан в запросе с помощью операции findAddressCandidates. Если параметр Location не передается в запрос, значение Distance равно нулю.

findAddressCandidates

X

Основная x-координата адреса, возвращаемая ArcGIS World Geocoding Service с пространственной привязкой WGS84 (WKID 4326).

findAddressCandidates

geocodeAddresses

Y

Основная x-координата адреса, возвращаемая ArcGIS World Geocoding Service с пространственной привязкой WGS84 (WKID 4326).

findAddressCandidates

geocodeAddresses

DisplayX

Отображение x-координаты адреса, возвращаемой ArcGIS World Geocoding Service с пространственной привязкой WGS84 (WKID 4326). Для всех типов сопоставлений значения X и DisplayX одинаковы. Для сопоставлений Addr_type, PointAddress и Subaddress значения могут отличаться. В общем случае, для сопоставлений PointAddress и Subaddress, DisplayX представляет собой значение x-координаты крыши здания или центроида участка для адреса, тогда как значение X представляет x-координату стороны улицы для адреса. Однако есть исключения. Некоторые источники адресов, используемые ArcGIS World Geocoding Service, предоставляют только местоположения крыш для объектов PointAddress и Subaddress. Однако, для некоторых объектов PointAddress и Subaddress доступно только местоположение на одной из сторон улицы. В таких случаях значения X и DisplayX равны.

findAddressCandidates

geocodeAddresses

DisplayY

Отображение y-координаты адреса, возвращаемой ArcGIS World Geocoding Service с пространственной привязкой WGS84 (WKID 4326). Для всех типов сопоставлений значения Y и DisplayY одинаковы. Для сопоставлений Addr_type, PointAddress и Subaddress значения могут отличаться. В общем случае, для сопоставлений PointAddress и Subaddress, DisplayY представляет собой значение y-координаты крыши здания или центроида участка для адреса, тогда как значение Y представляет собой y-координату стороны улицы для адреса. Однако есть исключения. Некоторые источники адресов, используемые ArcGIS World Geocoding Service, предоставляют только местоположения крыш для объектов PointAddress и Subaddress. Однако, для некоторых объектов PointAddress и Subaddress доступно только местоположение на одной из сторон улицы. В таких случаях значения Y и DisplayY равны.

findAddressCandidates

geocodeAddresses

Xmin

Минимальная x-координата для отображения экстента объекта, возвращаемого ArcGIS World Geocoding Service. Значения Xmin, Xmax, Ymin и Ymax можно комбинировать для задания экстента карты, используемого при отображении результата геокодирования. Координаты экстента используют пространственную привязку WGS84.

findAddressCandidates

geocodeAddresses

Xmax

Максимальная x-координата для отображения экстента объекта, возвращаемого ArcGIS World Geocoding Service. Значения Xmin, Xmax, Ymin и Ymax можно комбинировать для задания экстента карты, используемого при отображении результата геокодирования. Координаты экстента используют пространственную привязку WGS84.

findAddressCandidates

geocodeAddresses

Ymin

Минимальная y-координата для отображения экстента объекта, возвращаемого ArcGIS World Geocoding Service. Значения Xmin, Xmax, Ymin и Ymax можно комбинировать для задания экстента карты, используемого при отображении результата геокодирования. Координаты экстента используют пространственную привязку WGS84.

findAddressCandidates

geocodeAddresses

Ymax

Максимальная y-координата для отображения экстента объекта, возвращаемого ArcGIS World Geocoding Service. Значения Xmin, Xmax, Ymin и Ymax можно комбинировать для задания экстента карты, используемого при отображении результата геокодирования. Координаты экстента используют пространственную привязку WGS84.

findAddressCandidates

geocodeAddresses

ExInfo

Набор строк из входных данных, которые невозможно сопоставить ни с одной из частей адреса, и которые использовались для оценки баллов или штрафа за результат.

findAddressCandidates

geocodeAddresses

extent

Минимальный ограничивающий прямоугольник выходного объекта сопоставления задан значениями полей Xmin, Ymin, Xmax. и Ymax. Пространственная привязка координат x и y определяется выходным полем spatialReference. Это всегда возвращается по умолчанию только для запросов геокодирования findAddressCandidates.

findAddressCandidates