Что включается в результаты геокодирования

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

После того как таблица местоположений геокодирована, выходной точечный слой будет содержать копию полей адресов из таблицы. Поля адреса переносятся в том числе для сопоставления. Имена этого набора полей адреса имеют префикс IN_, а исходные поля вашей таблицы – префикс USER_, так что их очень легко дифференцировать. Когда при повторном сопоставлении адрес изменяется, то новый адрес сохраняется в полях IN_, чтобы не перезаписывать исходные поля USER_.

Примечание:
  • Если вы указываете Только местоположение, Минимальные или Минимальные и пользовательские поля для параметра Выходные поля в любом инструменте геообработки, который геокодирует таблицу (Геокодировать адреса, Геокодировать файл или Геокодировать местоположения из таблицы), то возвращается только поднабор из этих полей.
  • Только местоположение Shape возвращает только поле плюс исходные имена полей из таблицы входных адресов.
  • Минимальные - возвращаются следующие поля, описывающие местоположение и то, насколько хорошо оно соответствует информации в локаторе в результатах геокодирования: Shape, Status, Score, Match_type, Match_addr и Addr_type. Исходные имена полей из таблицы входных адресов сохраняются.
  • Минимальные и пользовательские поля возвращают исходные имена полей из таблицы входных адресов, минимальные поля плюс определяемые пользователем выходные поля.
  • Если настраиваемые выходные поля были определены в инструменте Создать локатор при создании локатора, настраиваемые выходные поля включаются в результат геокодирования по умолчанию, если они не отключены на странице Выходные поля в диалоговом окне Свойств локатора.

Следующие дополнительные выходные поля в результатах геокодирования зависят от используемого сервиса локатора или локатора:

Примечание:

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

  • Loc_name – имя локатора, который используется для возврата сопоставленных результатов. Это поле доступно только в том случае, если локатор, который используется для сопоставления таблицы, является составным локатором.
    Примечание:

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

  • Status – код, указывающий на то, был ли сопоставлен данный адрес. Этот атрибут может иметь следующие значения:
    • M – сопоставлен. Адрес успешно сопоставлен.
    • U – не сопоставлен. Адрес не сопоставлен.
    • T – связан. Адрес имеет более одного кандидата с одинаковым счетом соответствий, но расположенных в разных местах.
  • Score – счет соответствий кандидата, которому сопоставлялся данный адрес. Счет может быть в диапазоне от 0 до 100, где 100 говорит об идеальном соответствии кандидата.
  • Match_type – код, показывающий, каким образом был сопоставлен адрес. Вы можете группировать результаты, основываясь на данном атрибуте, для того, чтобы показать, каким образом были сопоставлены эти адреса, или использовать группирование объектов для выборки записей для повторного сопоставления.
    • A – автоматически сопоставлено или пересопоставлено.
    • M – сопоставлено вручную или сопоставление отменено вручную. При пересопоставлении геокодированного объекта это поле может иметь код M, если сопоставление выполняется или отменяется вручную.
    • PP – отбор по точке. Адрес был сопоставлен выделенной точке, выбранной пользователем во время процесса пересопоставления.
  • Match_addr – Адрес, где в действительности находится сопоставленное местоположение на основе информации сопоставленного кандидата. Например, входной адрес 123 Main St N сопоставлен кандидату с суффиксом направления NW (северо-запад) и корректно сопоставленными другими компонентами. Поле Match_addr содержит 123 Main St NW как действительный адрес, который сопоставлялся.
  • LongLabel – более длинная версия Match_addr, содержащая больше административных данных.
  • ShortLabel – укороченная версия Match_addr.
  • Addr_type – Тип адреса, который был геокодирован. Этот атрибут обозначает уровень сопоставления адреса. Вы можете изучить точность соответствия адресов и характер соответствия на основе значений. Поддерживаемые уровни сопоставления различаются в разных странах. К возможным значениям относятся:
    • Subaddress– адрес, основанный на точках, которые обозначают местоположение субадреса дома или здания. Обычно это наиболее точный уровень пространственного сопоставления. Элементы субадреса обозначающие тип единицы и ее идентификатор позволяют выделять один субадрес среди других в пределах комплекса, если в одном объекте или местоположении PointAddress содержится несколько субадресов. Базовые данные содержат точки адресов или полигоны со связанными номером дома, названием улицы и элементами субадреса, вместе с административным делением и, дополнительно, почтовым индексом, например, 3836 Emerald Ave., Suite C, La Verne, CA 91750. Обычно это точное местоположение адреса.
    • PointAddress – адрес, основанный на точках, которые обозначают местоположение дома или здания. Базовые данные содержат точки адресов с соответствующими номерами домов, названиями улиц, административным делением и, дополнительно, почтовым индексом. Выходные значения X, Y и геометрии, соответствующие PointAddress, обозначают местоположение улицы данного адреса; это местоположение используется для маршрутизации. Значения DisplayX и DisplayY соответствуют крышам домов или реальному местоположению адреса, например, 380 New York St., Redlands, CA 92373.
    • Parcel - часть земельного владения, которая считается реальным владением и может включать один или несколько домов и других строений. Участок обычно имеет адрес и идентификационный номер участка, присвоенный ем, например, 17 011100120063.
    • StreetAddress – адрес, который отличается от PointAddress, поскольку номер дома интерполируется из диапазона номеров. Базовые данные содержат центральные улицы линий с диапазонами номеров домов, а также административное деление и, дополнительно, почтовый индекс, например, 647 Haight St., San Francisco, CA 94117.
    • StreetInt – адрес состоит из перекрестка, города и, дополнительно, штата и почтового индекса, например, Redlands Blvd New York St, Redlands, CA, 92373. Он извлекается из базовых данных StreetAddress, например, Redlands Blvd & New York St., Redlands, CA 92373.
    • StreetAddressExt – интерполированный сопоставленный уличный адрес, который возвращается, когда параметр matchOutOfRange=true и входной адрес дома превышает значение диапазона номеров домов в совпадающем сегменте улицы.
    • POI – точки интереса. Базовые данные содержат административное деление, названия мест, предприятий, достопримечательностей и географический объекты, например, Starbucks.
    • DistanceMarker – уличный адрес, который представляет линейное расстояние вдоль улицы, как правило, километры или мили от выбранной исходной локации, например, Carr 682 KM 4, Barceloneta, 00617 .
    • StreetMidBlock – расчетная средняя точка диапазона номеров домов вдоль сегмента улицы, который соответствует кварталу, например 100 Block of Grant Ave, Millville, New Jersey. Местоположение, возвращаемое для соответствия StreetMidBlock, более точное, чем соответствие StreetName, но менее точное, чем StreetAddress. В настоящее время это работает только для США.
    • StreetName – то же, что и адрес, но без номера дома. Базовые данные содержат центральные улицы линий с связанными названиями (без диапазонов номеров), а также административное деление и, дополнительно, почтовый индекс, например, W Olive Ave., Redlands, CA 92373.
    • PostalExt – почтовый индекс с дополнительным расширением, например, используемый почтовой службой США ZIP+4. Базовые данные – это почтовый индекс с расширениями, например, 90210-3841.
    • Postal – почтовый индекс. Базовые данные – это почтовый индекс, например, 90210 USA.
    • PostalLoc – комбинация почтового индекса и названия города. Базовые данные обычно содержат комбинацию границ почтовых индексов и административных границ, например, 7132 Frauenkirchen.
    • Locality – название местоположения, обозначающее населенный пункт. Type – выходное поле, которое предоставляет более подробную информацию о типе населенного пункта. Возможные значения этого поля для поиска совпадений: Block, Sector, Neighborhood, District, City, MetroArea, County, State or Province, Territory, Country и Zone, например, Bogotá, COL.
    • Feature – результат геокодирования, возвращенный локатором, созданным с помощью инструмента Создать локатор объектов. Примерами потенциальных результатов геокодирования могут быть уникальные объекты, такие как достопримечательности, налоговые участки, участки переписи населения, счетчики воды, короткие названия мест, вышки сотовой связи или буквенно-цифровые строки, используемые для идентификации местоположений, такие как N1N115, представленные в классе объектов.
    • 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 возвращается только, когда включена категория USNG Система координат в разделе Поддерживаемые категории диалогового окна Свойства локатора или когда параметр 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 - числовой рейтинг (текстовое поле) или значение с плавающей запятой (числовое поле), это зависит от типа локатора, который определяет важность результата по отношению к другим результатам с таким же именем. Например, в России и США есть города с названием Москва. Москва в России имеет большее население, чем Москва в Техасе, поэтому ее ранг выше. Чем меньше значение, тем выше ранг объекта. Ранг используется для сортировки неоднозначных запросов, Lincoln, нет дополнительной информации (о штате). Значения Ранга основаны на демографических данных или типе объекта.
  • 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 – сторона улицы, где находится адрес, относительно направления оцифровки объекта. Это значение не является относительным к направлению движения по улице. У этого атрибута может быть одно из следующих значений:
    • L – адрес сопоставлен левой стороне улицы.
    • R – адрес сопоставлен правой стороне улицы.
    • Нет значения – адрес не сопоставлен, либо локатору не удалось определить сторону улицы.
  • 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 в Строение А.
  • BldgType – классификация подразделения здания. Это может быть здание, ангар, башня.
  • LevelType – классификация подразделения этажа. Это может быть этаж, уровень, отдел или крыло.
  • LevelName – название или номер подразделения этажа, например, 3 в Этаж 3.
  • UnitType – классификация помещения подразделения. Это может быть помещение, апартамент, квартира, офис или многокомнатный номер.
  • UnitName – название или номер подразделения помещения, например, 2B в Квартира 2B.
  • SubAddr – полное название внутренней единицы для кандидата с Addr_type=Subaddress, которое включает <subunit type> + <subunit name>. Например, если кандидат субадреса представляет собой квартиру, то Subaddr = UnitType + UnitName. Например, Apt 2B. Базовые данные состоят из точечных объектов с номером дома, названием улицы и элементами субадреса, вместе с административным делением и, дополнительно, почтовым индексом, например, 3836 Emerald Ave., Suite C, La Verne, CA 91750.
  • StAddr – уличный адрес места, без зоны, например, города или штата, например, 275 Columbus Ave.
  • Block – имя единицы административного деления уровня квартала для кандидата. Block - это минимальная административная область страны. Это может быть подразделение района или пригорода, или квартал со своим названием. Обычно не используется.
  • Sector – название административной единицы для сопоставления на уровне сектора. Sector– район, является подразделением пригорода, округа или квартала. Обычно не используется.
  • Nbrhd – название административной единицы для сопоставления на уровне пригорода. Nbrhd – пригород является подразделением города или округа. Little Italy — это название района в городе Сан-Диего, штат Калифорния.
  • District – название административной единицы для сопоставления на уровне округа, например, внутренний район города. Wilhelmsburg — это район в городе Гамбург в Германии.
  • City – название административной единицы для сопоставления на уровне города. City является подразделением субрегиона или региона, например, Атланта - город в округе Фултон штата Джорджия.
  • MetroArea – название административной единицы для сопоставления на уровне городской агломерации. Примером является городская территория, состоящая из крупного города и окружающих его небольших городов. Может пересекать несколько субрегионов или регионов. Примером может являться местоположение района Калькутты в Индии.
  • Subregion – название административной единицы для сопоставления на уровне внутри района. Subregion является подразделением региона, например округа в пределах штата. Например, округ Сан-Диего является субрегионом штата Калифорния.
  • Region – название административной единицы для сопоставления на уровне района. Может быть подразделением страны или другой территории. Как правило, это крупнейшее административное подразделение области, такое как штат или провинция, если не используется уровень Territory.
  • RegionAbbr – сокращенное название региона. Значение RegionAbbr для Калифорнии - CA, которая является штатом в Соединенных Штатах Америки.
  • Territory – имя единицы административного деления уровня территории для кандидата. Примером является подразделение внутри страны. Обычно не используется. Например, Юго-восточный макрорегион Бразилии, состоящий из штатов Эспириту-Санту, Минас-Жерайс, Рио-де-Жанейро и Сан-Пауло.
  • Postal – буквенно-числовой элемент адреса, определяющий основной почтовый индекс, например, V7M 2B4 в канадском почтовом индексе и 92374 в почтовом индексе США.
  • PostalExt – буквенно-числовой элемент адреса, определяющий дополнение почтового индекса, например, 8100 в почтовом индексе США 92373-8110.
  • Country – код, состоящий из трех символов, для страны, например, United States of America = USA. Список поддерживаемых стран доступен на карте Geocode data coverage для ArcGIS World Geocoding Service.
  • CountryCode — трехсимвольный код страны, например, Canada = CAN. Список поддерживаемых стран доступен на карте Geocode data coverage для ArcGIS World Geocoding Service. Это поле совпадает с выходным полем Country, но возвращается только при обратном геокодировании.
  • CntryName — Полное название страны для кандидата-адреса, например, "日本" (Япония). Имя может быть на том же языке, что и входной адрес, либо на языке, который указан в параметре запроса langCode. Если полное название страны на указанном языке недоступно, то вместо этого используется основной язык страны, в пределы которой попадает адрес-кандидат. Список поддерживаемых языков доступен в разделе Geocode data coverage в World Geocoding Service.
  • LangCode – код, состоящий из трех символов, представляющий язык адреса, например, ENG = английский. См. список кодов.
  • Distance – физическое расстояние в метрах от кандидата до указанного положения. Выходное значение Distance вычисляется для каждого кандидата, когда входной параметр Location задан в запросе при помощи операции REST findAddressCandidates. Если параметр Location не передается в запросе, значение Distance равно нулю.
  • X – первичная x-координата сопоставленного адреса в пространственной привязке локатора. Координата x в ArcGIS World Geocoding Service возвращается в пространственной привязке WGS84 (WKID 4326).
  • Y – первичная y-координата сопоставленного адреса в пространственной привязке локатора. Координата y в ArcGIS World Geocoding Service возвращается в пространственной привязке WGS84 (WKID 4326).
  • DisplayX – отображение x-координаты адреса, возвращенной с пространственной привязкой локатора. Отображаемая координата x возвращается в пространственной привязке WGS84 (WKID 4326) в ArcGIS World Geocoding Service. Для соответствия с PointAddress или Subddress, как указано в поле Addr_type и в локаторе на основе роли PointAddress, это значение представляет координату x крыши здания или центроида участка для адреса. Оно отличается от x-значения, представляющего координату x местоположения на одной из сторон улицы или на улице для адреса. Тем не менее, это исключения, так как часть источников данных, используемых ArcGIS World Geocoding Service предоставляют только местоположения крыш для объектов PointAddress и Subaddress. В остальных случаях только местоположение на одной из сторон улицы доступно для объектов PointAddress и Subaddress. Для некоторых случаев значения X и DisplayX идентичны. Для других совпадения Addr_type и локаторов это значение равно x-значению.
  • DisplayY – отображение y-координаты адреса, возвращенной с пространственной привязкой локатора. Координата отображения y возвращается в пространственной привязке WGS84 (WKID 4326) в ArcGIS World Geocoding Service. Для соответствия с PointAddress или Subddress, как указано в поле Addr_type и в локаторе на основе роли PointAddress, это значение представляет координату y крыши здания или центроида участка для адреса. Оно отличается от y-значения, полученного из местоположения вдоль улицы или записи улицы для адреса. Тем не менее, это исключения, так как часть источников данных, используемых ArcGIS World Geocoding Service предоставляют только местоположения крыш для объектов PointAddress и Subaddress. В остальных случаях только местоположение на одной из сторон улицы доступно для объектов PointAddress и Subaddress. Для некоторых случаев значения Y и DisplayY идентичны. Для других совпадения Addr_type и локаторов это значение равно y-значению.
  • Xmin – минимальная x-координата отображаемого экстента объекта, возвращаемого локатором. Значения Xmin, Xmax, Ymin и Ymax можно комбинировать для задания экстента карты, используемого при отображении результата геокодирования. Координаты экстента используют пространственную привязку локатора, но в ArcGIS World Geocoding Service используется WGS84 (WKID 4326).
  • Xmax – максимальная x-координата отображаемого экстента объекта, возвращаемого локатором. Значения Xmin, Xmax, Ymin и Ymax можно комбинировать для задания экстента карты, используемого при отображении результата геокодирования. Координаты экстента используют пространственную привязку локатора, но в ArcGIS World Geocoding Service используется WGS84 (WKID 4326).
  • Ymin – минимальная y-координата отображаемого экстента объекта, возвращаемого локатором. Значения Xmin, Xmax, Ymin и Ymax можно комбинировать для задания экстента карты, используемого при отображении результата геокодирования. Координаты экстента используют пространственную привязку локатора, но в ArcGIS World Geocoding Service используется WGS84 (WKID 4326).
  • Ymax – максимальная y-координата отображаемого экстента объекта, возвращаемого локатором. Значения Xmin, Xmax, Ymin и Ymax можно комбинировать для задания экстента карты, используемого при отображении результата геокодирования. Координаты экстента используют пространственную привязку локатора, но в ArcGIS World Geocoding Service используется WGS84 (WKID 4326).
  • ExInfo — набор строк из входных данных, которые невозможно сопоставить ни с одной из частей адреса, и которые использовались для оценки баллов или штрафа за результат.