地理编码和地理搜索

您可通过定位器查找可在地图中显示的地址和地点、作为路径的停靠点插入以及作为空间分析的输入进行加载。 ArcGIS Online 定位器包括如下地理搜索和地理编码:

  • 地理搜索(也称为位置搜索)- 定位地址或感兴趣点,并将地图缩放至该位置。 可在地图上显示结果,但结果无法以任何形式存储以供将来使用。 地理搜索适用于访问 Map ViewerMap Viewer 经典版或包含地图位置搜索的公共应用程序的任何人。 地理搜索无需组织帐户或消耗配额(但仅限于每月 100 万次地理搜索)。
  • 地理编码 - 将地址或地点转换为 x,y 坐标并将结果追加至数据库的现有记录。 其中并不总是涉及制图,但将结果放置在地图上可能是工作流的一部分。 批量地理编码和反向地理编码均属于此类别。 必须拥有具有高级内容地理编码权限的组织帐户才能访问 ArcGIS World Geocoding Service 及其所有视图以进行批量地理编码。

    注:

    反向地理编码不支持某些定位器视图属性。

默认情况下,ArcGIS Online 使用 ArcGIS World Geocoding Service全球 100 多个国家/地区中查找地址、城市、地标、企业名称以及邮政编码。 此外,可以通过 ArcGIS World Geocoding Service 使用经度和纬度以及坐标参考系(例如美国军事格网参考系 (MGRS) 和美国国家电网 (USNG) 坐标系)来查找 x,y 坐标的位置。

如果您的组织想要优化地址和感兴趣地点的搜索结果,则具有创建内容权限的成员可以创建一个新的 ArcGIS World Geocoding Service 视图,这样就可以仅搜索感兴趣区域内特定类型的位置。 例如,您可以创建一个定位器视图,从而将搜索结果限制到特定的国家或地区,或仅返回与特定类别(例如街道地址或机场)匹配的结果。 创建定位器视图后,默认管理员角色的成员可以配置组织,这样在成员执行地理搜索时,组织会使用您的定位器视图。

注:

使用 ArcGIS World Geocoding Service 或此定位器的视图进行批量地理编码(包括发布 CSV 或 Microsoft Excel 文件作为托管要素图层)会消耗配额。 使用定位器进行地理搜索不会消耗配额。

必须拥有具有高级内容地理编码权限的组织帐户才能使用定位器视图进行批量地理编码。

此外,如果您的组织需要根据自身数据对地址或地点进行地理编码,则管理员可以将组织配置为使用其在 ArcGIS Server 站点上运行的自己的定位器进行地理编码和/或地理搜索。 例如,石油组织可以添加定位器以搜索油井,或者城市可以添加定位器以查找消火栓。

如果您添加其他定位器或定位器视图,成员将在地理搜索框中看到一个箭头,然后即可选择要使用的定位器或视图。

创建定位器视图

您可以创建新的 ArcGIS World Geocoding Service 视图,以仅搜索感兴趣区域内的特定位置类型 例如,您可能希望定位器视图将搜索结果限制到特定区域,或者您可能希望在成员对地址执行批量地理编码时,强制使用特定级别的精度。

要创建并配置定位器视图,请执行以下操作:

  1. 验证您是否登录到组织以及是否具备创建内容的权限
  2. 在内容页面中的我的内容选项卡中,单击新建项目,然后单击定位器(视图)
  3. 输入标题,或者选择文件夹来保存定位器项目,并为定位器指定标签和摘要。
  4. 单击保存以创建定位器视图项目。

    您创建的定位器视图的项目页面将跳转至设置选项卡。

  5. 设置选项卡顶部,单击定位器(视图)设置
  6. 在下拉菜单中,选择您想要查找的位置类型
    • 所有类型 - 如果您不希望对返回的位置类型设置任何限制,请选择此选项。
    • 地址、邮政编码和居民区 - 选择此选项可将结果限制为街道、城市、州或邮政编码。
    • 坐标 - 选择此选项可将结果限制为 MGRS 或(纬度,经度)的特定格式。
    • 感兴趣地点 - 选择此选项可将结果限制为地点或地标的名称。
  7. 如果您在上一步中选择了除所有类型以外的类别,请根据需要进一步优化位置过滤器,方法是选中要搜索的类别的复选框。 例如:
    • 如果您选择地址、邮政编码和居民区,并且只需要 ArcGIS World Geocoding Service 返回与街道地址或更佳的匹配项,请选中点地址街道地址复选框。
    • 如果选择坐标,并希望将(纬度,经度)设为可接受的坐标格式,请选中(纬度,经度)复选框。
    • 如果您选择了感兴趣地点,并且只需要 ArcGIS World Geocoding Service 返回与机场的匹配项,请选中机场复选框。
  8. 请指定您希望搜索位置的范围,具体如下:
    • 世界上的任何地方 - 选择此选项可以搜索全球的任一位置。
    • 在所选国家/地区内 - 选择此选项可搜索特定国家/地区内的位置。 搜索或浏览您需要的国家,然后一次选择一个国家,直到您选中所有您需要的国家为止。
      注:

      如果您的数据包含国家/地区值,则搜索结果将包括数据中明确定义的任何国家/地区。 但是,如果数据中未明确定义国家/地区,则结果将仅限于使用此定位器视图设置定义的国家/地区。

    • 在指定区域内 - 选择此选项可定义搜索位置的区域范围。 单击设置区域,然后定义范围。 完成后单击确定
  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 匹配标注,即使搜索字符串中包含 Dayton 且输入的邮政编码的邮政城市值为 Dayton。
    • 匹配城市名称 - 如果选择此选项,当搜索中输入的城市名称与本地城市名称或邮政城市名称的任意值相匹配时,将返回匹配的城市名称值。
    注:

    并非所有地址都分配有邮政城市和本地城市值。 如果数据中不存在所请求的首选城市,则将根据默认地址格式返回其他城市值。

  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)和其他邮政编码格式的邮政编码。 为了限制结果使其至少达到这种匹配精度,请选择邮政和顶层的地址类别。

居民区

邻域

社区是城市的组成部分,比市区小比细分区域大。

City

用此子类别配置的定位器将结果仅限于城市,例如,意大利的威尼斯市。

亚区

亚区是州或省的一个子集,例如美国的一个县 - 威斯康星州的亚当斯县

区域

区域是一个国家的组成部分,通常是一个州或省;例如加拿大的安大略省。

国家/地区

国家是最高行政区域(亦被称为国)- 例如日本

细分区域

细分区域是比街区大,比社区小的行政区域,代表社区或区域的细分,或者街区的集合。

街区

街区是一个国家最小的行政区域,代表细分区域或社区的一部分,或一个已命名的城市街区。

行政区

行政区是比城市小但比社区大的行政区域 - 例如城区。

都会区

都会区(大都市)区域是由大城市和周边较小城市组成的城市群,如大东京地区

区域

地区是较大的行政区划,比国家小但比州或省大 - 例如加拿大的育空地区。

区域

地带代表不属于某个国家的非官方行政区域类别,如争议地区或其他行政区组合 - 例如中美洲

坐标

当您选择坐标作为您要查找的位置类型时,您可以通过选择要搜索的类别进一步优化定位器视图的搜索结果。 下表对相关内容进行了描述。

类别描述

经度、纬度

此类别表示地理 (x,y) 坐标。 X 指经度(东西坐标),y 表示纬度(南北坐标)。 将以 x,y 格式输入和返回坐标。

Latitude、Longitude

此类别表示地理 (x,y) 坐标。 X 指经度(东西坐标),y 表示纬度(南北坐标)。 将以 y,x 格式输入和返回坐标。

MGRS

此类别表示军事网格参考系统 (MGRS) 坐标。

USNG

此类别代表美国国家电网 (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 ViewerMap Viewer 经典版或其他 ArcGIS Online 客户端具备对内部定位器的访问权限时,才能使用内部定位器进行地理搜索。 例如,如果您的组织与公众共享应用程序,则只有对您的内部定位器具备访问权限的用户才能使用这些应用程序查找地点。 ArcGIS Online 当前不支持 ArcGIS Desktop 受保护的服务项目。 要执行批量地理编码,需要在您的防火墙外托管定位器,这样 ArcGIS Online 可以访问您的定位器上的 geocodeAddresses 操作,以执行批量地理编码。

使用地址信息丰富图层

从逗号分隔值 (CSV) 文件发布托管要素图层时,您可以选择将地理编码过程中的信息作为托管要素图层的一部分包含在内。 该信息由定位器生成,并存储在托管要素图层的字段中。

默认情况下,托管要素图层中仅包含位置信息(x,y 坐标)。 有两个选项可用于在托管要素图层中包含其他信息:

  • 追加四个字段,显示地址的匹配程度 - 包括 statusscorematch_addr 以及 addr_type 字段和值。 下表将介绍这些字段和值。
  • 追加 50 个字段以提供完整位置信息 - 包括下表中列出的所有字段。

请注意,这些附加字段和值将增加托管要素图层的大小。 图层大小增加多少取决于输入文件中的记录数以及选择的选项。

字段描述

spatialReference

wkidlatestWkid 属性指定的输出匹配位置坐标的空间参考。 outSR 输入参数用于确定空间参考。 默认情况下始终返回。

address

findAddressCandidatesgeocodeAddresses 地理编码请求返回的完整匹配地址。 默认情况下始终返回。

location

由 x 和 y 属性指定的输出匹配位置的点坐标。 x 和 y 坐标的空间参考由 spatialReference 输出字段定义。 默认情况下,始终为 findAddressCandidatesgeocodeAddresses 地理编码请求返回。 有关位置输出字段如何与 XY 输出属性相关联的详细信息,请参阅 locationType 参数的描述。

ResultID

仅为 geocodeAddresses 请求返回。 批量地理编码响应中的每个记录都包含一个 ResultID 值,该值等于相应输入地址记录的 OBJECTID 值。 它可用于将输出字段加入对原始地址表中属性的响应中。

Loc_name

用于返回特定匹配结果的定位器的名称。

注:

Loc_name 字段由 ArcGIS 软件内部使用,且不适用于客户端应用程序。

Status

指示批量地理编码请求结果为匹配、连接还是不匹配。

可能的值包括:

  • M - 匹配。 返回的地址与请求匹配,并且是得分最高的候选项。
  • T - 连接。 返回的地址与请求匹配,但得分与一个或多个其他候选项相同。
  • U - 不匹配。 没有地址与请求匹配。

Score

1-100 的数字用于表示地理编码请求中的输入令牌与候选记录中的地址组成部分的匹配程度。 得分为 100 表示完美匹配,分数越低表示匹配精度越低。 默认情况下,始终返回 Score

Match_addr

为地理编码请求返回的完整地址。 该格式基于地址所在国家/地区的地址标准。

LongLabel

包含更多管理信息的 Match_addr 的更长版本。

ShortLabel

Match_addr 的缩短版本。

Addr_type

地理编码请求的匹配级别。 支持的匹配级别在不同的国家/地区有所不同。

可能的值包括:

  • Subaddress - PointAddress 的子集,表示房屋或建筑物子地址位置,例如公寓单元、楼层或复杂建筑物内的单个建筑物。 UnitNameUnitTypeLevelNameLevelTypeBldgNameBldgType 字段值可帮助区分可能与相同 PointAddress 相关联的子地址。 参考数据由具有相关门牌号、街道名称和子地址元素的点要素以及行政区域和可选邮政编码构成;例如 3836 Emerald Ave, Suite C, La Verne, CA, 91750
  • PointAddress - 街道地址(基于代表房屋和建筑位置的点)。 通常,这是空间上最准确的匹配级别。 参考数据包含具有相关联的房屋号码和街道名称的地址点,以及行政区域和可选的邮政编码。 PointAddress 匹配的 X/Y 以及 geometry 输出值表示地址的街道条目位置;这是用于路径选择操作的位置。 DisplayXDisplayY 值表示地址的屋顶或实际位置。 示例: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 输出字段可提供更为详细的居民区类型相关信息。 Locality 匹配可能的 Type 值包括 BlockSectorNeighborhoodDistrictCityMetroAreaCountyState or ProvinceTerritoryCountryZone。 示例: Bogotá, COL
  • PostalLoc - 邮政编码和城市名称的组合。 参考数据通常是邮政边界和行政(地域)边界的联合,例如 7132 Frauenkirchen
  • PostalExt - 具有附加扩展码的邮政编码,如美国邮政编码 + 4。 参考数据是具有扩展码的邮政编码点,例如 90210-3841
  • Postal - 邮政编码。 参考数据是邮政编码点,例如 90210 USA
  • POI - 感兴趣点。 参考数据包括企业、地标和地理要素,例如 Starbucks
  • LatLong - x/y 坐标对。 如果 x/y 坐标对(例如 117.155579,32.703761)为搜索输入,则返回 LatLong addr_type
  • XY - XY 是基于输入的第一坐标为经度而第二坐标为纬度这一假设的匹配。
  • YX - YX 作为候选项的 Addr_type 返回,该项假定纬度是输入中的第一个数字,而经度为第二个数字。
  • MGRS - 军事格网参考系统 (MGRS) 位置,例如 46VFM5319397841
  • USNG - 美国国家格网 (USNG) 位置,例如 15TXN29753883。 仅当在 findAddressCandidatesgeocodeAddresses 请求中将 category 参数设置为 USNG 时,才会返回此 Addr_type 值。

Type

搜索返回的结果的要素类型。 Type 字段仅包含 Addr_type = POILocality 的候选项值。 例如,对于 StarbucksType=Coffee Shop

PlaceName

地理编码匹配候选项的正式名称,例如 ParisStarbucks

Place_addr

地点的完整街道地址,其中包括街道、城市和地区,例如 275 Columbus Ave, New York, New York

Phone

地点的主要电话号码。 对于其他搜索(例如地址、交叉点和邮政编码),此字段为空,例如对于 Knott's Berry Farm,Phone=(714)220-5200

URL

地点的主要网站的 URL。 对于其他搜索(例如地址、交叉点和邮政编码),此字段为空,例如对于乔治亚大学,URL =http://www.uga.edu/

Rank

浮点型数字值,表示某结果相对于其他同名结果的重要性。 例如,在法国和德克萨斯州都有城市叫巴黎。 法国巴黎的人口多于德克萨斯州巴黎的人口,因此法国巴黎的等级更高。Rank 可用于对一些模糊不清的查询进行排序,例如 Lincoln,其中无可用附加信息(状态)。 Rank 值基于人口或要素类型。

AddBldg

建筑物的名称,例如 Empire State Building

AddNum

字母数字值,用于表示地址的一部分,通常为门牌号或建筑物编号,例如,在 380 New York Street 这一地址中,AddNum = 380。

PointAddressStreetAddress 匹配返回该值。

AddNumFrom

表示街道地址范围起始数字的值。 该值相对于要素数字化方向且不总是范围内的最小数值。 StreetAddress 结果会返回该值。

AddNumTo

表示街道地址范围结束数字的值。 该值相对于要素数字化方向且不总是范围内的最大数值。 StreetAddress 结果会返回该值。

AddRange

地址所在街段的完整门牌号范围,格式为 AddNumFrom-AddNumTo。 例如,街道地址 123 Main St AddRange 值可能为 101-199

Side

相对于要素数字化方向,地址所在的街道一侧。 该值不是相对于沿街道出行的方向。 可能的值为 R(右侧)和 L(左侧)。

注:

Side 是一个原有字段,保留该字段仅用于支持期望该字段出现在 REST 响应中的应用程序。 对于地理编码服务返回的大多数地址,该字段为空。 不应将其用于分析目的。

StPreDir

定义街道方向的地址元素,位于主街道名称前,例如,North Main Street 中的 North

StPreType

定义街道主要类型的地址元素,例如,Avenida Central 中的西班牙语术语 AvenidaRue Lapin 中的法语术语 Rue

StName

定义街道主名称的地址元素,例如 North Main Street 中的 Main

StType

定义街道类型的地址元素,例如 Main Street 中的 "Street"

StDir

定义街道方向的地址元素,位于主街道名称后,例如,Main Street North 中的 North

BldgName

建筑物子单位的名称或编号。 例如,building A 中的 A

BldgType

建筑物子单位的分类。 例如建筑物、飞机库和塔楼。

LevelType

楼层子单位的分类。 例如楼层、层级、部门和翼。

LevelName

楼层子单位的名称或编号。 例如,level 3 中的 3

UnitType

单位子单位的分类。 例如单位、公寓、办公室、套房。

UnitName

单位子单位的名称或编号。 例如,apartment 2B 中的 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,其中包括 Espírito Santo、Minas Gerais、Rio de Janeiro 和 São Paulo 等州。

Postal

定义主邮政编码的字母数字地址元素,例如加拿大邮政编码 V7M 2B4 和美国邮政编码 92374

PostalExt

定义邮政编码扩展码的字母数字地址元素,例如美国邮政编码 92373-8110 中的 8100

Country

国家/地区的三位字符代码,例如 CAN 对应加拿大。 可在数据覆盖范围中找到受支持的国家/地区和代码列表。 该字段由 findAddressCandidatesgeocodeAddresses 返回。

CountryCode

国家/地区的三位字符代码,例如 CAN 对应加拿大。 可在数据覆盖范围中找到受支持的国家/地区和代码列表。 该字段与 Country 输出字段相同;不同之处在于它仅由 reverseGeocode 返回。

CntryName

地址候选项对应的国家/地区全名;例如 "日本"(日本)。 该名称可以采用与输入地址相同的语言,或者采用请求的 langCode 参数指定的语言。 如果国家/地址全名在指定语言中不可用,则使用地址候选项所在国家/地区的母语。 有关国家/地区支持的语言的信息,请参阅数据覆盖范围。 该字段由 findAddressCandidatesgeocodeAddressesreverseGeocode 返回。

LangCode

三位字符语言代码,表示对应地址的语言,例如,ENG 对应英语。

Distance

从候选位置到指定位置的物理距离,单位为米。 当 Location 输入参数使用 findAddressCandidates 操作在请求中传递时,将为每个候选项计算 Distance 输出值。 如果 Location 参数未在请求中传递,则 Distance 值为零。

X

空间参考 WGS84 (WKID 4326) 中的 ArcGIS World Geocoding Service 所返回地址的主 x 坐标。

Y

空间参考 WGS84 (WKID 4326) 中的 ArcGIS World Geocoding Service 所返回地址的主 y 坐标。

DisplayX

空间参考 WGS84 (WKID 4326) 中的 ArcGIS World Geocoding Service 所返回地址的显示 x 坐标。 对于大多数匹配类型,XDisplayX 的值相同。 特定于 Addr_type PointAddressSubaddress 的匹配,值可能不同。 通常,对于 PointAddressSubaddress 匹配,DisplayX 代表地址的建筑物屋顶或宗地质心的 x 坐标值,而 X 值代表地址的街道一侧位置的 x 坐标。 但有例外情况。 ArcGIS World Geocoding Service 使用的某些地址数据源仅提供 PointAddressSubaddress 要素的屋顶位置;而对于某些 PointAddressSubaddress 要素,则仅提供街道一侧位置。 在此类情况下,XDisplayX 值相等。

DisplayY

空间参考 WGS84 (WKID 4326) 中的 ArcGIS World Geocoding Service 所返回地址的显示 y 坐标。 对于大多数匹配类型,YDisplayY 的值相同。 特定于 Addr_type PointAddressSubaddress 的匹配,值可能不同。 通常,对于 PointAddressSubaddress 匹配,DisplayY 代表地址的建筑物屋顶或宗地质心的 y 坐标值,而 Y 值代表地址的街道一侧位置的 y 坐标。 但有例外情况。 ArcGIS World Geocoding Service 使用的某些地址数据源仅提供 PointAddressSubaddress 要素的屋顶位置;而对于某些 PointAddressSubaddress 要素,则仅提供街道一侧位置。 在此类情况下,YDisplayY 值相等。

Xmin

ArcGIS World Geocoding Service 返回的要素显示范围的最小 x 坐标。 XminXmaxYminYmax 值共同用于设置显示地理编码结果的地图范围。 范围坐标使用 WGS84 空间参考。

Xmax

ArcGIS World Geocoding Service 返回的要素显示范围的最大 x 坐标。 XminXmaxYminYmax 值共同用于设置显示地理编码结果的地图范围。 范围坐标使用 WGS84 空间参考。

Ymin

ArcGIS World Geocoding Service 返回的要素显示范围的最小 y 坐标。 XminXmaxYminYmax 值共同用于设置显示地理编码结果的地图范围。 范围坐标使用 WGS84 空间参考。

Ymax

ArcGIS World Geocoding Service 返回的要素显示范围的最大 y 坐标。 XminXmaxYminYmax 值共同用于设置显示地理编码结果的地图范围。 范围坐标使用 WGS84 空间参考。

ExInfo

输入中无法与地址中的任何部分匹配的字符串集合,用于对结果进行评分或罚分。

extent

由 xmin、ymin、xmax 和 ymax 属性指定的输出匹配要素的最小外接矩形。 x 和 y 坐标的空间参考由 spatialReference 输出字段定义。 默认情况下,始终仅为 findAddressCandidates 地理编码请求返回。