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

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

定位器包含在每个 StreetMap Premium 版本以及 My Esri 上单独的“定位器更新”版本中。 登录到您的 My Esri 帐户可查看定位器的下载文件。 所有下载文件均为 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 等）的数据。
• 能够针对批量地理编码结果选择路径位置（街道中心线或街道上的入口点）或地址位置（宗地或屋顶质心）。
• 能够通过特定的地理编码匹配类型（例如地址类型、邮政编码、感兴趣点和坐标）来过滤批量地理编码结果。
• 增强了对街道交叉路口地理编码的支持，不仅可识别物理交叉路口，还可以识别逻辑交叉路口，例如地下通道、天桥、死巷和环状交叉路。
• 增强了对位于现有街道地址门牌号范围外的匹配门牌号的支持。
• 一个区域定位器文件中包含多个国家/地区，因此可以在一个或多个国家/地区中运行批量地理编码。
• 可以使用向定位器添加面字段工具将面图层的自定义输出字段添加到定位器中。 相反，可以使用从定位器中删除面字段工具删除自定义输出字段。
• 在将定位器作为服务发布时，可以在反向地理编码中实现对返回的结果类型（例如感兴趣点、邮政编码等）的控制。
• 当定位器作为地理编码服务发布并托管在 Enterprise 门户上时，可以使用对文件进行地理编码地理处理工具将大型本地地址或感兴趣点表转换为要素类或转换为 .csv 或 .xls 表。

注：

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

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

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

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

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

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

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

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

有关地理编码覆盖区域、每个国家/地区的质量级别和类别过滤的详细信息，请参阅 ArcGIS Developer 网站上的 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 参数支持 Street Midblock 值。 当请求中传递 category 参数值为 Street Midblock 或 Address 时，它允许在地理编码响应中包括 Addr_type 值为 StreetMidblock 的位置。
  • StreetName - 具有相关街道名称的街道中心线（无编号地址范围）。
  • Locality - 诸如镇、市和社区等行政区；通常是最小的行政区。
  • PostalLoc - 结合了行政边界的邮政编码点。
  • PostalExt - 扩展的邮政编码点，例如 USPS ZIP+4。
  • Postal - 邮政编码点。
  • POI - 感兴趣点，例如居民区、企业名称、地标和地理名称。
  • LatLong - 用于搜索输入的 x,y 坐标对。
  • XY-XY - 基于输入的第一坐标为经度而第二坐标为纬度这一假设的匹配。
  • YX-YX - 基于输入的第一坐标为纬度而第二坐标为经度这一假设的匹配。
  • MGRS - 军事格网参考系位置。
• Match_addr - 在本地国家地址方案中设置格式的完全匹配地址。 这是基于国家地址标准的正确地址格式。
• Status
  • M - 匹配。 返回的地址与请求匹配，并且是得分最高的候选项。
  • T - 连接。 返回的地址与请求匹配，但得分与一个或多个其他候选项相同。
  • U - 不匹配。 没有地址与请求匹配。
• Score - 1 至 100 的数字用于表示地理编码请求中的输入令牌与候选记录中的地址组成部分的匹配程度。 得分为 100 表示完美匹配，分数越低表示匹配精度越低。 得分为 0 表示不匹配；没有地址与请求匹配。
• Side - 对于 SubAddress、PointAddress 和 StreetAddress 匹配，此字段表示相对于要素数字化（而非沿街道的行驶方向），地址位于街道的哪一侧（左或右）。
• DisplayX/DisplayY - 对于 SubAddress 和 PointAddress 匹配，这些字段存储和每个地址相关联的宗地质心或屋顶质心的十进制度坐标，同时地理编码点要素默认位于属性主入口附近的街段。

  注：

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

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

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

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