在 ArcGIS Pro 中使用 StreetMap Premium 定位器进行地理编码

定位器的构建方式与 ArcGIS World Geocoding Service 中使用的定位器类似。 GCS_WGS_1984 是适用于所有 StreetMap Premium 定位器的坐标系。

定位器包含在地理坐标系 (GCS) 移动地图包中每个 StreetMap Premium 版本以及 My Esri 上单独的“定位器更新”版本中。 登录到您的 My Esri 账户可查看定位器的下载文件。 对于 GCS 移动地图包,找到您获得许可的地理位置(例如北卡罗来纳州),然后下载并在 ArcGIS Pro 中解压 North_Carolina.mmpk(在插入选项卡上单击导入地图)后,即可使用定位器。 定位器文件解压到默认位置 C:\Users\<UserName>\Documents\ArcGIS\Packages\North_Carolina_<unique#>\locator\USA\v101 文件夹。

定位器更新下载文件均为 7z 格式,且数据可能横跨多个文件(因此必须下载所有文件才能正确解压缩文件)。 如果您的计算机上尚未安装 7-Zip,则必须从 www.7-zip.org 安装此免费软件。 从 My Esri 下载所有文件并在计算机上解压之后,可以浏览至文件的解压位置并在 ArcGIS Pro 中添加定位器。

只要您被授权了适当地区的 StreetMap Premium 扩展模块(例如 StreetMap Premium 北美),就可以将定位器用于在 ArcGIS Pro 中进行地理编码。

注:

如果您没有适当的 StreetMap Premium 扩展模块,则会在目录窗格的工程 > 定位器下的国家/地区定位器名称旁边显示红色感叹号 (注意事项),并且该国家/地区定位器名称在定位窗格的选项按钮 选项 下的提供商设置中不可用。 有关获取 StreetMap Premium 扩展模块的信息,请参阅启用 StreetMap Premium 扩展模块

用于地理编码的定位器

StreetMap Premium 包含一组定位器,其具有以下优势:

  • 定位器文件大小较小且高效,所需的系统资源(如 RAM)更少。
    注:

    要创建更小的定位器文件夹大小,使用裁剪定位器地理处理工具将 StreetMap Premium 定位器裁剪到感兴趣区。

  • 地址匹配逻辑,可以处理格式不正确的地址和拼写错误。
  • 可以对感兴趣点(例如白宫、金门大桥或麦当劳)进行地理搜索和批量地理编码。
  • 每个定位器包含所有匹配类型(例如,PointAddress、StreetAddress、POI、Postal、Admin 等)的数据。
  • 能够针对批量地理编码结果选择路径位置(街道中心线或街道上的入口点)或地址位置(宗地或屋顶质心)。
  • 能够通过特定的地理编码匹配类型(例如地址类型、邮政编码、感兴趣点和坐标)来过滤批量地理编码结果。
  • 增强了对街道交叉路口地理编码的支持,不仅可识别物理交叉路口,还可以识别逻辑交叉路口,例如地下通道、天桥、死巷和环状交叉路。
  • 增强了对位于现有街道地址门牌号范围外的匹配门牌号的支持。
  • 一个区域定位器文件中包含多个国家/地区,因此可以在一个或多个国家/地区中运行批量地理编码。
  • 可以使用向定位器添加面字段地理处理工具将面图层的自定义输出字段添加到定位器中。 相反,可以使用从定位器中删除面字段地理处理工具删除自定义输出字段。
  • 在将定位器作为服务发布时,可以在反向地理编码中实现对返回的结果类型(例如感兴趣点、邮政编码等)的控制。
  • 当定位器作为地理编码服务发布并托管在 ArcGIS Enterprise 门户上时,可以使用对文件进行地理编码地理处理工具将大型本地地址或感兴趣点表转换为要素类或转换为 .csv.xls 表。
注:

建议您始终将这些定位器与最新版本的 ArcGIS ProArcGIS Enterprise 一起使用,并建议您从 ArcGIS StreetMap Premium 网站上查看和安装相应的修补程序。 为确保定位器或地理编码服务的正常运行,需要为 ArcGIS EnterpriseArcGIS Pro 安装 StreetMap Premium 扩展模块。 要使用这些定位器创建地理编码服务,可以从 ArcGIS Pro 将其发布到门户,或从 ArcGIS Pro 将其直接发布到服务器;无需安装 Portal for ArcGIS。 对于任一选项,必须为 ArcGIS EnterpriseArcGIS Pro 安装 StreetMap Premium 扩展模块。 如果您购买 StreetMap Premium Enterprise 许可,您将自动收到客户服务的两个扩展模块。 要从 ArcGIS Pro 直接发布到您的服务器,请使用以下方法:

  1. 首先,创建与服务器的连接。 有关如何创建服务器连接的信息,请参阅连接到 GIS Server。 在添加 ArcGIS Server 连接对话框中,添加服务器 URL、用户名和密码,然后选中保存登录下的 Windows 凭据管理器复选框。 如果连接成功,则服务器连接将在目录窗格的服务器下显示。
  2. 目录窗格中的服务器下,右键单击服务器连接,然后先后单击发布地理编码服务。 在发布地理编码服务对话框中,输入服务详细信息并完成发布定位器。

有关在 ArcGIS Enterprise 中发布和使用定位器的详细信息,请参阅 ArcGIS Pro 帮助中的共享定位器在地图上查找地点简介主题。 要将地理编码服务限制为组织中的特定用户使用,请在您的 ArcGIS Enterprise 门户中创建群组。 然后,发布地理编码服务,并仅与该组共享服务。 邀请指定用户加入该组。

如果您注意到 ArcGIS Pro 中批量地理编码的结果对于较大的定位器(如 USA 或 North America 定位器)产生的结果不一致,请在文本编辑器(如 Notepad++)中将定位器的 .loc 文件中的 WarmUp 属性从 WarmUp = False 更改为 WarmUp = True。 使用从这些较大的定位器创建的地理编码服务时,定位器的 WarmUp 属性 True 默认在 ArcGIS Server 中,而不是在 ArcGIS Pro 中。

有关在 ArcGIS Enterprise优化对从定位器发布的服务进行地理编码时的性能的详细信息,请参阅 ArcGIS StreetMap Premium 帮助。

定位器支持以下地理编码匹配类型和类别过滤,但并非所有国家/地区都包含每个级别的数据:地址(子地址、点地址、街道地址、距离标记、街道交叉路口和街道名称)、邮政编码、居民区(区块、扇区、街区、区、城市、都会区、亚区、区域、地区、国家和地域)、感兴趣点和坐标。

例如,如果您希望仅对一个或两个匹配类型(例如 PointAddress、StreetAddress 等)进行地理编码,则可以将类别与定位器一起使用。 为此,您可以在 ArcGIS Pro定位器属性对话框中,右键单击目录窗格中的定位器,然后单击定位器属性。 单击左侧的地理编码选项,单击匹配选项,然后向下滚动至支持的类别部分,您可以在其中仅选择要启用的类别。 如果使用 ArcGIS Pro 中的地理编码地址工具进行批量地理编码,则无需更改定位器属性中的类别,因为指定类别的选项已经是工具对话框的一部分。

如果使用类别仅返回 SubAddress、PointAddress 和 StreetAddress 匹配,则应调整最低匹配得分设置,您也可以在定位器属性中的地理编码选项 > 匹配选项下执行此操作。 建议使用值 94,这将最大化您的匹配率,而不会引入不可接受的误报匹配数量。 如果您发现限制过于严格(过高)并排除了过多的匹配项,或者如果限制不够严格(过低)并且允许过多误报,则可以对此进行调整。 例如,如果您的输入地址简洁且格式正确,则可以使用更高的最低匹配得分值。 相反,如果由于缺少地址组成部分或额外的信息而导致输入地址的质量较低,则下限值可能会导致更多匹配项。 无论您指定了多少类别,在决定最适合您需求的最低匹配得分值时,建议查看您自己的输入地址数据和地理编码匹配结果。

有关地理编码覆盖区域、每个国家/地区的质量级别和类别过滤的详细信息,请参阅 Esri 开发者网站上的 ArcGIS REST API 地理编码数据覆盖区域

地址的输入映射字段是跨全球定位器的标准化字段,其具体包括以下内容:地址、邮政、社区、城市、亚区和区域字段;然而一些国家并不使用以下全部四个行政地点字段作为输入:

  • 社区 - 比城市小
  • 城市 - 城市或等同于城市的区域
  • 亚区 - 通常比城市大但比地区小
  • 地区 - 州/省或等同于州/省的区域

使用 ArcGIS Pro 进行地理编码时,您可以浏览这些定位器中的任何定位器。 有关使用这些定位器查找地址或地理编码表的帮助,请参阅教程:查找地址

无论是在 ArcGIS Pro 中直接使用定位器,还是将其作为地理编码服务发布,都可以使用其建议功能。 发布定位器之后,您即可在您自己的应用程序中使用建议 REST API。

定位器属性

其他定位器属性包括对以下各项的支持:

  • 自定义交叉点连接符(仅限单国家/地区定位器),例如 &@|and
  • 首选城市名称
  • 首选街道名称

对于多国家/地区定位器(例如 Europe.loc),交叉点连接符属性无法编辑,因为每个国家/地区具有一组唯一交叉点连接符。

文件输出字段定义

以下文件输出字段定义可能会对您有所帮助:

  • Addr_type - 地址的匹配类型。 可能的值如下:
    • SubAddress - 点地址的子集,包含相关门牌号、建筑物或单元编号以及街道名称。
    • PointAddress - 具有相关门牌号和街道名称的点地址。
    • BuildingName - 具有相关建筑物名称的点地址。
    • StreetAddress - 具有地址范围的街道中心线。
    • StreetInt - 从街道地址数据中获得的街道交叉路口。
    • StreetAddressExt - 当地址的门牌号组件位于现有街道地址门牌号范围之外时的插入街道地址匹配。
    • DistanceMarker - 用于表示沿某条街道的线性距离的街道地址(通常以公里或英里为单位,且指定了原点位置)。
    • StreetMidBlock - 街道段的估计中点,包括由城市街区号或城市街区范围表示的门牌号。 StreetMidBlock 匹配返回的结果准确度高于 StreetName 匹配返回的结果,但是低于 StreetAddress 匹配的结果。 目前仅在美国可用。 对于地理编码服务,category 参数支持 StreetMidBlock 值。 当请求中传递 category 参数值为 StreetMidblockAddress 时,它允许在地理编码响应中包括 Addr_type 值为 StreetMidblock 的位置。
    • StreetBetween - 位于两个指定交叉街道之间的街道中心点。 针对 StreetBetween 匹配返回的位置比针对 StreetName 匹配返回的位置更加精确,但是不如针对 StreetAddress 匹配返回的位置精确。 Addr_type 值目前仅在美国可用。
    • StreetName - 具有相关街道名称的街道中心线(无编号地址范围)。
    • Locality - 诸如镇、市和社区等行政区;通常是最小的行政区。
    • PostalLoc - 结合了行政边界的邮政编码点。
    • PostalExt - 扩展的邮政编码点,例如 USPS ZIP+4。
    • Postal - 邮政编码点。
    • POI - 感兴趣点,例如居民区、企业名称、地标和地理名称。
    • LatLong - 用于搜索输入的 x,y 坐标对。
    • XY-XY - 基于输入的第一坐标为经度而第二坐标为纬度这一假设的匹配。
    • YX-YX - 基于输入的第一坐标为纬度而第二坐标为经度这一假设的匹配。
    • MGRS - 军事格网参考系位置。
  • Match_addr - 在本地国家地址方案中设置格式的完全匹配地址。 这是基于国家地址标准的正确地址格式。
  • Status - 用于指示地址是否匹配的代码。 该属性的值如下:
    • M - 匹配。 返回的地址与请求匹配,并且是得分最高的候选项。
    • T - 连接。 返回的地址与请求匹配,但得分与一个或多个其他候选项相同。
    • U - 不匹配。 没有地址与请求匹配。
  • 得分 - 1 至 100 之间的数字,用于表示地理编码请求中的输入令牌与候选记录中的地址组件的匹配程度。 得分为 100 表示完美匹配,分数越低表示匹配精度越低。 得分为 0 表示不匹配;没有地址与请求匹配。
  • - 对于 SubAddressPointAddressStreetAddress 匹配,此字段表示相对于要素数字化(而非沿街道的行驶方向),地址位于街道的哪一侧()。
  • DisplayX/DisplayY - 对于 SubAddressPointAddress 匹配,这些字段存储和每个地址相关联的宗地质心或屋顶质心的十进制度坐标,同时地理编码点要素默认位于属性主入口附近的街段。
    注:

    使用地理编码地址工具在 ArcGIS Pro 中进行批量地理编码时,定位器会提供将首选位置类型设置为路径位置设置(街道中心线或街道上的入口点)或地址位置设置(宗地质心或屋顶质心)的选项,可将其用于地理编码结果。 您还可以在定位器文件中对此进行管理,以便在 ArcGIS Pro 中使用定位时获得首选位置。 右键单击目录中的定位器,然后选择定位器属性。 在左侧单击地理编码选项,然后单击显示选项。 在首选位置类型下,选择路径位置地址位置

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

有关地理编码结果中的输出字段的详细信息,请参阅 ArcGIS Pro 帮助文档中的地理编码结果包含的内容

有关使用定位器发布地理编码服务时的输出字段的详细信息,请参阅 Esri 开发者网站上的 ArcGIS REST API:World Geocoding Service 文档