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

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

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

    Примечание:

    Обратное геокодирование не поддерживается для видов 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 для геопоиска, геокодирования или и того и другого. Например, нефтяная компания может добавить локаторы для поиска своих скважин, или городская администрация добавляет локатор для поиска пожарных гидрантов.

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

Создание представления локатора

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

Чтобы создать и настроить представление локатора, выполните одно из следующего:

  1. Убедитесь, что вы вошли в организацию и имеете соответствующие права для создания ресурсов.
  2. На вкладке Мои ресурсы на странице содержания щелкните Создать и выберите Локатор (представление).
  3. Введите название, теги и краткое описание локатора, выберите папку для сохранения его элемента.
  4. Щелкните OK, чтобы создать элемент представления локатора.

    Откроется страница элемента только что созданного представления локатора, на вкладке Настройки.

  5. Вверху вкладки настройки щелкните Настройки локатора (представления).
  6. В ниспадающем меню выберите тип местоположения, который вы хотите искать:
    • Все типы – выберите эту опцию, если вам не нужны ограничения по типам возвращаемых поиском местоположений.
    • Адреса, почтовые индексы и населённые пункты – выберите эту опцию, чтобы ограничить результаты улицами, городами, штатами или почтовыми индексами.
    • Координаты – выберите эту опцию, чтобы ограничить результаты только MGRS или указанным форматом для широты, долготы.
    • Точки интереса – выберите эту опцию, чтобы ограничить результаты названиями мест или достопримечательностей.
  7. Если в предыдущем шаге вы выбрали любую категорию, кроме Все типы, дополнительно настройте фильтр местоположений как необходимо, отметив те категории, по которым будет выполняться поиск. Например:
    • Если вы выбрали Адреса, индексы и населённые пункты и хотите получать от ArcGIS World Geocoding Service только соответствия по названиям улиц или выше, отметьте Адрес точки и Адрес улицы.
    • Если вы выбрали Координаты и хотите выбрать в качестве допустимого формата координат широту и долготу, отметьте пункт Широта, долгота.
    • Если вы выбрали Точки интереса и хотите получать от ArcGIS World Geocoding Service только аэропорты, отметьте Аэропорт.
  8. Выберите, где вы хотите осуществлять поиск:
    • По всему миру - выберите эту опцию для глобального поиска.
    • В выбранных странах/регионах—выберите эту опцию для поиска мест в определенных странах. Найдите или пролистайте список стран и выберите все необходимые страны по одной.
      Примечание:

      Если ваши данные содержат значение страны, результаты поиска будут включать любые страны, напрямую заданные в данных. Однако, если страны напрямую не определены в данных, результаты будут ограничены до страны или нескольких стран, определённых в настройках вида локатора

    • В пределах указанной области - выберите эту опцию, чтобы задать экстент области поиска. Щёлкните Задать область и определите экстент. По завершении щёлкните OK.
  9. Если для искомого типа местоположений выбрать Адреса, индексы и населённые пункты или Места интереса, выберите одну из следующих опций, чтобы указать предпочтения для отображения местоположений:
    • Одна сторона улицы (местоположение на маршруте)
    • Центроид крыши или участка (местоположение адреса)
    Примечание:

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

  10. Задайте параметры возвращения названий городов следующим образом:
    • Как задано для страны - оставьте эту опцию включенной, чтобы возвращать названия городов по умолчанию, как задано для страны. Например, города США по умолчанию возвращаются с почтовым названием.
    • Почтовое название города - выберите эту опцию, чтобы возвращать первичное почтовое название, даже если оно отличается от названия города, введенного в поиске. Почтовое название города - это первичное название, присвоенное почтовому индексу адреса. Например, индексу 45420 в Огайо присвоено первичное название Дейтон. Адресам в городе Кеттеринг присвоен тот же индекс, это означает, что при поиске адресов в Кеттеринге, они будут возвращаться как адреса в Дейтоне. Если выбрана эта опция и участник организации ищет адрес 2109 E Dorothy Ln, Kettering, OH, 45420, будет возвращено 2109 E Dorothy Ln, Dayton, Ohio, 45420, даже если адрес находится в пределах границ Кеттеринга.
    • Локальное название города - выберите эту опцию, чтобы возвращать локальное название города, даже если оно отличается от названия города, введенного в поиске. Локальное название города - это название города, в котором находится адрес, оно может отличаться от почтового названия города. Например, при выборе этой опции, поиск 2109 E Dorothy Ln, Dayton, OH, 45420 - адреса в Кеттеринге - вернет 2109 E. Dorothy Ln, Kettering, Ohio, 45420, даже если в поиске присутствует слово Дейтон и почтовый индекс соответствует названию Дейтон.
    • Сопоставленное название города - выберите эту опцию, чтобы возвращать сопоставленные названия, когда введенное в поиск название соответствует одному из локальных или почтовых названий.
    Примечание:

    Не все адреса имеют присвоенные почтовое и локальное названия. Если предпочитаемый запрашиваемый город отсутствует в данных, возвращается другое значение города, на основе формата адреса по умолчанию.

  11. Задайте параметры возвращения названий улиц следующим образом:
    • Как задано для страны - оставьте эту опцию включенной, чтобы возвращать названия улиц по умолчанию. Название улицы по умолчанию - это сопоставленное название улицы.
    • Сопоставленное название улицы - выберите эту опцию, чтобы возвращать сопоставленные названия улиц, когда введенное в поиск название соответствует одному из поддерживаемых имен, сопоставленным адресу.
    • Первичное название улицы - выберите эту опцию, чтобы возвращать первичное название, даже если оно отличается от альтернативного названия улицы, введенного в поиске. Первичное название улицы - это первичное название, присвоенное улице. Например, при выборе этой опции, поиск CA-138, Pearblossom, CA вернет сопоставление Pearblossom Hwy, Pearblossom, California, 93553.
  12. Щёлкните Сохранить, чтобы сохранить настройки представления локатора.
  13. Поделитесь вашим видом локатора с коллегами внутри организации или публично.

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

    Примечание:

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

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

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

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

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

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

  • Адрес - при выборе этой категории все подкатегории адресов, указанные в следующей таблице, выбираются автоматически. Эта категория ограничивает результаты поиска только местами, которые могут быть определены в категорию адресов при фильтрации результатов на точки интереса, почтовые индексы, страны или штаты. Для получения более точных результатов поиска, выберите любую комбинацию подкатегорий адресов, соответствующую вашим требованиям.
  • Почтовый - при выборе этой категории результаты поиска ограничиваются любыми типами почтовых индексов, включая форматы с 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 или другие клиенты 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 или другие клиенты ArcGIS Online получают к ним доступ. Например, если ваша организация публикует общедоступные приложения, только те пользователи, которые имеют доступ к внутренним локаторам, смогут находить места с помощью этих приложений. Элементы защищенного сервиса ArcGIS Online в данный момент не поддерживаются в ArcGIS Desktop. Для выполнения пакетного геокодирования, локатор должен быть размещён за пределами брандмауэра, чтобы ArcGIS Online мог получить доступ к операции geocodeAddresses локатора для пакетного геокодирования.

Выходные поля локатора

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

По умолчанию только информация о местоположении (координаты x, y) включена в размещенный векторный слой. Если вы выбрали опцию Минимальный, размещённый векторный слой также включает поля и значения status, score, match_addr и addr_type, которые описаны в следующей таблице. Если вы выбрали опцию Все, все поля, перечисленные в следующей таблице, будут включены в размещенный векторный слой.

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

ПолеОписание

spatialReference

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

address

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

location

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

ResultID

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

Loc_name

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

Примечание:

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

Status

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

К возможным значениям относятся:

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

Score

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

Match_addr

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

LongLabel

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

ShortLabel

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

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 — это совпадение XY, основанное на предположении, что первая координата является долготой, а вторая - широтой.
  • YX — возвращается YX как Addr_type для кандидата, при этом предполагается, что первая цифра - это широта, а вторая - долгота.
  • MGRS — местоположение в системе Military Grid Reference System (MGRS), например, 46VFM5319397841.
  • USNG — местоположение United States National Grid (USNG), такое как 15TXN29753883. Это значение Addr_type возвращается, только когда для параметра category задано USNG в запросе findAddressCandidates или geocodeAddresses.

Type

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

PlaceName

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

Place_addr

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

Phone

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

URL

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

Rank

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

AddBldg

Название здания, например, Empire State Building.

AddNum

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

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

AddNumFrom

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

AddNumTo

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

AddRange

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

Side

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

StPreDir

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

StPreType

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

StName

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

StType

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

StDir

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

BldgName

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

BldgType

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

LevelType

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

LevelName

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

UnitType

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

UnitName

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

SubAddr

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

StAddr

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

Block

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

Sector

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

Nbrhd

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

District

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

City

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

MetroArea

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

Subregion

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

Region

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

RegionAbbr

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

Territory

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

Postal

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

PostalExt

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

Country

Трехсимвольный код страны, например, Canada (Канада) = CAN Список поддерживаемых стран и кодов доступен на карте Geocode coverage.

LangCode

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

Distance

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

X

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

Y

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

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 равны.

DisplayY

Отображение x-координаты адреса, возвращаемой 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 равны.

Xmin

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

Xmax

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

Ymin

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

Ymax

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

ExInfo

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

extent

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