主定位器角色

构建定位器的第一步是定义用于构建定位器的数据类型。 可以通过选择适合您数据的定位器角色来完成上述操作。 定位器角色可定义正在使用的数据类型（宗地、街道中心线、邮政编码、感兴趣点 [POI] 等），并提供构建定位器时使用的相应字段。 创建后，定位器中包含用于地理编码的参考数据快照，同时还包含索引和局部编址知识，这有助于在地理编码过程中返回最佳匹配项。

当选择构建定位器时基于的主定位器角色时，应考虑多个方面，包括参考数据中的几何类型和要进行地理编码的数据格式。 “点地址”定位器角色通常用于在单个位置处对地址进行建模。 您可以使用 POI 角色查找通过名称或编码识别的要素。

下表显示了 ArcGIS Pro 随附的每个主定位器角色的一些基本特征。 您可使用这些角色并附加某些区域信息（如 320 Madison St., 53606 或 329 Holiday Court, La Jolla, CA 92122）以对地址进行地理编码。 定位器角色将进一步扩展为包含备用名称表，可在该表中基于主要要素的备用名称对地址进行地理编码。

点地址

“点地址”角色的基本特征

典型参考数据集几何	典型参考数据集表示方法	地址搜索参数	示例	受支持的类别	应用程序	受支持的 ArcGIS Pro 和 Enterprise 版本
点或面 为获取最佳反向地理编码结果建议使用面	每个要素表示一个地址。 每个要素都表示一个含有可选子地址元素的地址。	单个字段中的所有地址元素	71 Cherry Ln. W1700 Rock Rd. 38-76 Carson Rd. 15 Lakeshore Dr. Apt. 24A Laurel Cottage, 26 Pinhoe Rd.	点地址、子地址	查找宗地、建筑物或地址点 查找公寓单元、联排别墅、复式别墅或购物广场内的商店	2.3；10.6.1；在 Enterprise 10.7 之前的版本中，不一定支持所有定位器功能。 2.8；10.8.1；支持子地址作为要素类型以进行反向地理编码。

“点地址”定位器角色可用于为包含建筑物名称或门牌号以及街道名称的常见地址创建定位器。 地址可以同时包含建筑物名称和门牌号。 此定位器角色使用包含面或点几何的要素类作为主要参考数据。 主要参考数据中的每个要素对应一个地址。 例如，可使用包含建筑物覆盖区或宗地质心（宗地面的中心点）的要素类作为“点地址”定位器的主要参考数据。 要搜索的各个地址必须存在于主要参考数据中。 如下所示，“点地址”定位器角色需要参考数据中的每个要素对应一个地址值，例如宗地或建筑物。

注：

将面几何用于主要参考数据时，将返回最佳反向地理编码结果。

“点地址”角色还支持使用门牌号范围进行建模的主要参考数据。 与多个地址关联的单一位置（例如，宗地）在门牌号“自”和“至”字段中具有一系列的门牌号值。 如果有些要素具有门牌号范围，您必须使用范围对所有要素进行建模。 如果门牌号值存储在门牌号“自”或“至”字段中，则没有门牌号范围的要素将包含在定位器中。 该原理类似于引用数据的两个字段中的值相同。 门牌号范围也支持奇偶校验。

注：

构建点地址定位器时，如果已映射门牌号和门牌号自和至字段，将忽略门牌号字段中的值并使用门牌号“自”和“至”字段中的值构建定位器。

此外，“点地址”角色还支持复式别墅和分割地块可能具有的、存储于表示为门牌号或完整门牌号的单个字段中的门牌号扩展，例如 2B Wingate Rd. 或 20 1/2 Rocky Knoll Dr.。其中 20 Rocky Knoll Dr. 是为原始建筑物分配的地址，20 1/2 是在地块分割后分配给邻近建筑物的地址。 B 或 1/2 等后缀通常用作门牌号后缀。 28R 17 Oak St 中的 28R 等前缀可用作门牌号前缀，但这种情况不太常见。 串连所有门牌号组成部分（门牌号前缀、门牌号、门牌号后缀）合并成单个字段，然后在构建定位器时用作门牌号字段。 当搜索包含字母数字门牌号的地址时，必须输入完整的门牌号，如 28R 17 Oak St 中的 28R，才能返回该地址的建议。

要使用要素类作为“点地址”定位器的参考数据，其必须具有包含门牌号或建筑物名称以及街道名称信息的字段，ObjectID 字段和 Shape 字段，同时还应具有一个可选地址 JoinID 字段，您可以将该字段分配至地址连接 ID 定位器角色字段以链接到备用门牌号或备用门牌号范围的备用名称表。 例如，您可以使用它对西里尔语的门牌号进行英语音译建模。 此外，您还可以指定包含以下信息的字段：街道的前缀方向、前缀类型、街道类型、后缀方向、邮政编码、邮政编码扩展码（例如美国为 ZIP+4）或区域（行政区域，如城市、街区等）。 如果要在多角色定位器中结合使用点地址角色和宗地定位器角色，您还必须在参考数据中包含一个可选宗地 JoinID 字段。 要将地址点链接到宗地，则将宗地 JoinID 字段分配到宗地连接 ID 定位器角色字段。 要素类还必须包含一个 ID 字段，该字段可将具有相同位置的重复要素连接起来，以移除定位器中的重复几何。 此过程可以减少定位器的大小，并从地理编码结果中移除过多的相关候选项。 必须根据定位器角色将此 ID 字段映射到要素 ID 字段，例如 POINT_ADDRESS_ID。 此外，如果重复的要素具有与之关联的备选街道名称，则要素类必须包含指示器字段，用于指示用于主要街道名称的要素。 此指示器字段必须从定位器角色（例如 PRIMARY_STREET_NAME 或 PrimaryStreetFlag）映射到主要街道名称指示器字段。 需要映射要素 ID 字段和主要街道名称指示器字段，首选街道名称属性才能按预期工作。

注：

当使用点地址角色构建定位器时，必须映射建筑物名称、门牌号、门牌号自和门牌号至，或者建筑物名称和门牌号。

子地址

“点地址”定位器角色包含对相应地址的支持，这些地址包含子地址信息，例如公寓单元、联排别墅、复式别墅或购物广场内的商店的标识符。 许多住宅和商业建筑物以及机场、停车场、码头和船坞以及校园等特殊建筑物和设施中都有子地址。

点或面主要参考数据中的每个要素对应一个包含子地址信息的地址。 您可以使用包含建筑物覆盖区或地址点作为参考数据的要素类。 要搜索的各个地址必须存在于参考数据中。 确切位置无法从街道上的任何类型的地址范围进行外插或内插，除非门牌号值在参考数据中使用门牌号范围进行建模，如“点地址角色”部分所述。 如下所示，“子地址”需要参考数据中的每个要素对应一个地址值，例如建筑物或地址点。

注：

要使用支持子地址的定位器搜索基址 36 Orchard Ct，对于主要参考数据中的基址，必须存在要素。

子地址还支持使用单元编号范围进行建模的主要参考数据。 与多个单元关联的单个位置（例如，购物广场中的建筑物）在“自”和“至”字段中具有一系列的单元编号值。 如果有些要素具有单元编号范围，则所有要素都应使用范围进行建模。 如果单元值存储在单元“自”或“至”字段中，没有单元号范围的要素将包含在定位器中。 该原理类似于引用数据的两个字段中的值相同。

注：

构建支持子地址的点地址定位器时，如果已映射单元和单元“自”和“至”字段，则将忽略单元字段中的值并使用单元“自”和“至”字段中的值构建定位器。

除了基本地址属性之外，为支持子地址的“点地址”定位器提供主要参考数据的要素类还会包含与建筑物类型、建筑物单元名称、级别类型、级别名称、单元类型和单元名称相对应的各个字段。

注：

定位器角色支持 3 对子地址元素：单元和单元类型、级别和级别类型以及建筑物单元和建筑物单元类型。 您可选择在定位器中同时使用这两对子地址元素，也可只使用一对。 可使用适用的字段（例如 Apt F、Building A 或 Floor 1）映射这几对元素。 了解有关主要参考数据中的地址元素的详细信息。

要在搜索包含子地址信息的地址时获得最佳结果，指示符（#、Apt、Suite、Bldg、Floor）必须位于子地址单元之前；否则，地址将与返回最高得分的数据记录相匹配。 当搜索包含子单元的地址时，必须输入完整的子地址元素（如 35 Orchard Ct, Unit 101 中的 Unit 101），才能返回子地址位置的匹配项。 如果某个地址处存在多个子地址，则系统将提供多个选项来返回子地址信息或者子地址候选项作为定位器属性对话框中的建议。 默认子地址建议行为是键入地址和完整的子地址名称。

• 输入基址后，要返回某个地址处的子地址单元摘要，必须启用显示带有基址建议的子地址摘要设置。 对于主要参考数据中的基址，如果不存在要素，则摘要将不会显示为建议。

  

• 必须启用建议设置键入部分单元时建议，以便在输入含或不含指示符的部分子地址名称后，返回有效的子地址建议候选项。

  

• 输入基址后，要返回子地址的列表，请启用建议设置键入基址时建议。 对于主要参考数据中的基址，如果不存在要素，则子地址建议列表将不会显示。

  

Parcel

“宗地”角色的基本特征

典型参考数据集几何	典型参考数据集表示方法	地址搜索参数	示例	受支持的类别	应用程序	受支持的 ArcGIS Pro 和 Enterprise 版本
点或面 为获取最佳反向地理编码结果建议使用面	每个要素表示一个宗地。 每个要素由宗地 ID（数字、APN 等）或地址标识。	单个字段中的所有地址元素	1760820300 1760820300、935 Feather Ln. 935 Feather Ln.	Parcel	查找宗地或地址点	2.5；10.8

“宗地”定位器角色可用于为包含宗地编号的地址以及包含街道编号和街道名称的常见地址创建定位器。 该定位器角色类似于“点地址”角色，但不支持搜索包含子地址信息的地址。 而是支持子地址，工作原理类似于对 POI 角色子地址的支持。 此定位器角色使用包含面或点几何的要素类作为主要参考数据。 主要参考数据中的每个要素对应一个宗地。 例如，可使用包含宗地面或宗地质心（宗地面的中心点）的要素类作为“宗地”定位器的主要参考数据。 要搜索的每个宗地或地址必须存在于主要参考数据中。 如下所示，“宗地”定位器角色要求参考数据中的每个要素对应一个宗地或地址值，例如宗地或宗地质心。

要使用要素类作为“宗地”定位器的参考数据，其必须具有以下字段：一个包含宗地编号或门牌号的字段、一个包含街道名称信息的字段、ObjectID 字段和 Shape 字段，以及一个可选宗地 JoinID 字段（可以分配到宗地连接 ID 定位器角色字段以链接到多角色定位器中的点地址角色）。 此外，您还可以指定包含以下信息的字段：街道的前缀方向、前缀类型、街道类型、后缀方向、邮政编码、邮政编码扩展码（例如美国为 ZIP+4）或区域（行政区域，如城市、街区等）。 要素类还必须包含一个 ID 字段，该字段可将具有相同位置的重复要素连接起来，以移除定位器中的重复几何。 此过程可以减少定位器的大小，并从地理编码结果中移除过多的相关候选项。 必须根据定位器角色将此 ID 字段映射到要素 ID 字段，例如 PARCEL_ID。 此外，如果重复的要素具有与之关联的备选街道名称，则要素类必须包含指示器字段，用于指示用于主要街道名称的要素。 此指示器字段必须从定位器角色（例如 PRIMARY_STREET_NAME 或 PrimaryStreetFlag）映射到主要街道名称指示器字段。 需要映射要素 ID 字段和主要街道名称指示器字段，首选街道名称属性才能按预期工作。

注：

将面几何用于主要参考数据时，将返回最佳反向地理编码结果。

“宗地”角色还支持使用门牌号范围进行建模的主要参考数据。 与多个地址关联的单一位置（例如，宗地）在门牌号“自”和“至”字段中具有一系列的门牌号值。 如果有些要素具有门牌号范围，您必须使用范围对所有要素进行建模。 如果门牌号值存储在门牌号“自”或“至”字段中，则没有门牌号范围的要素将包含在定位器中。 该原理类似于引用数据的两个字段中的值相同。 门牌号范围也支持奇偶校验。

注：

构建定位器时，如果已映射门牌号和门牌号自和至字段，将忽略门牌号字段中的值并使用门牌号“自”和“至”字段中的值构建定位器。

可以使用此定位器角色进行地理编码的地址表必须包含宗地编号或宗地地址和一个行政区，例如邻域、城市或邮政编码。 使用此定位器角色创建的定位器支持以下搜索场景：

• 构建定位器时，只将宗地编号分配给宗地名称定位器角色字段，以根据确切的宗地编号进行搜索。

  

• 在构建定位器时已分配宗地编号和地址字段，以根据宗地地址进行搜索。 当以这种方式构建定位器时，您也可以只搜索宗地编号。

  

• 在构建定位器时已分配宗地编号和地址字段，以根据宗地编号和宗地地址进行搜索。 当以这种方式构建定位器时，您也可以只搜索宗地编号。

  

Street Address

“街道地址”角色的基本特征

典型参考数据集几何	典型参考数据集表示方法	地址搜索参数	示例	受支持的类别	应用程序	受支持的 ArcGIS Pro 和 Enterprise 版本
线	每个要素都具有街道段两侧的地址范围。 所有要素都具有街道名称和可选区域名称。	单个字段中的所有地址元素 单个字段中不含门牌号的地址元素	320 Madison St. N2W1700 County Rd. 105-30 Union St. 5th St. NE & Cherry St. NE Raspberry Lane, San Antonio, TX	街道地址、街道路口、街道名称	查找位于街道特定侧或街道交叉路口的房屋 按街道名称查找要素	2.3；10.6.1；在 Enterprise 10.7 之前的版本中，不一定支持所有定位器功能。

“街道地址”定位器角色可用于创建支持搜索包含门牌号、街道交叉路口和仅包含街道名称的常见地址的定位器。 这种定位器角色的优势之一是允许您提供包含街段两侧信息的门牌号值的范围。 使用这种样式，定位器不仅可确定街段沿线的位置，还可确定地址位于街段的哪一侧。

此定位器角色将使用包含线几何的要素类。 主要参考数据中的每个要素表示一个具有双地址范围的街段，范围中的地址均为该街段沿线地址，街段的每一侧对应一个地址范围。

要使用要素类作为“街道地址”定位器角色的主要参考数据，其必须具有 4 个字段：一个包含街道两侧的“自”地址和“至”地址信息和街道名称信息的字段、一个 ObjectID 字段、一个 Shape 字段以及一个可选 JoinID 字段（包含可分配到街道连接 ID 定位器角色字段以链接到参考数据中的备用名称表的 ID）。 此外，您还可以指定包含街道的前缀方向、前缀类型、街道类型、后缀方向或区域的字段。 要素类还必须包含一个 ID 字段，该字段可将具有相同位置的重复要素连接起来，以移除定位器中的重复几何。 此过程可以减少定位器的大小，并从地理编码结果中移除过多的相关候选项。 必须根据定位器角色将此 ID 字段映射到要素 ID 字段，例如 STREET_SEGMENT_ID。 此外，如果重复的要素具有与之关联的备选街道名称，则要素类必须包含指示器字段，用于指示用于主要街道名称的要素。 此指示器字段必须从定位器角色（例如 PRIMARY_STREET_NAME 或 PrimaryStreetFlag）映射到主要街道名称指示器字段。 需要映射要素 ID 字段和主要街道名称指示器字段，首选街道名称属性才能按预期工作。

此定位器角色支持标准街区范围，带格网区域的字母数字地址或门牌号中包含交叉路段信息的带连字符地址。 此定位器角色还支持街道交叉路口。 您也可以使用多个可选字段，例如，参考要素类中的 ZIPL 和 ZIPR（街道两侧的邮政编码）字段、左侧和右侧城市字段以及州或省名称缩写字段。

可针对使用此定位器角色创建的定位器进行地理编码的地址表除了包含街道的前缀说明、前缀类型、街道类型或后缀说明（如果存在）之外，还必须包含指定了街道号和街道名称的地址字段。 此字段中还可包含交叉点描述（例如，Eureka Blvd. & Vine St.）。 也可以通过使用“街道地址”角色创建的定位器来搜索街道名称，地址表中的地址字段除了包含街道的前缀方向、前缀类型、街道类型或后缀方向（如果存在）之外，还必须包括街道名称。 在匹配具有相同街道名称的地址时，在单独的字段中必须包含至少一个行政区（如城市或邮政编码），以提高地理编码质量。

带连字符的范围

街道地址定位器角色支持带连字符的门牌号范围，通常如下表示门牌号：连字符之前的数字是交叉路段的编号，连字符之后的数字是街道沿线的实际门牌号（例如，76-20 34th Ave）。 例如，位置 Queens, New York 就是使用这种类型的地址样式。 第一个数字表示北向或西向交叉街道。 第二个数字表示建筑物在街区中所处的位置。

在线要素的起点地址和终点地址字段中，门牌号可以为带连字符的数字或简单的门牌号。 例如，如下表所示，地址范围 95-1000 – 95-1018 and 95-1001 – 95-1019 必须包含一个用于分隔交叉路段和实际门牌号的连字符。 此定位器角色仅支持连字符右侧的门牌号范围，因此根据下表，Mahea St 的左侧范围不能为 95-1000 - 95-1018，右侧范围不能为 95-1001 - 96-1019，预期返回地址 96-1013 Mahea St 的匹配项。

街道名称

“街道地址”定位器角色包括对街道名称的支持。 仅基于街道名称搜索的地址（例如 Orchard Court, Lansing MI）将返回 StreetName 匹配项。 如果搜索到的地址包含门牌号，则仅当没有其他可用选项时，才返回 StreetName 匹配项。 当参考数据中没有与街段关联的门牌号时，就会发生这种情况。 要创建仅支持 StreetName 匹配项的定位器，参考数据必须针对所有记录将门牌号范围字段设置为 NULL 或空字符串，或具有包含 NULL 或空字符串的单个字段，该字段已映射到定位器角色中的每个“自”和“至”门牌号范围字段。 找到某个地址后，匹配位置会置于街段的中间位置。

街区

街道地址定位器角色支持搜索代表一个或多个城市街区的一组门牌号。 为此搜索类型返回的 Addr_type 值为 StreetMidBlock。 该要素的位置是路段的近似中点，其中包括街区号或街区范围所代表的门牌号。 StreetMidBlock 匹配比 StreetName 匹配更精确，但是不如 StreetAddress 匹配精确。 您可以使用语法 <编号或范围> block | block of <街道名称> 来搜索单个街区或一个街区范围，例如 100 block of New York St, Redlands, CA 或 200-500 block Taylor St, San Francisco。 有关搜索街区的其他详细信息，请参阅 REST API Web 帮助。

POI

POI 角色的基本特征

典型参考数据集几何	典型参考数据集表示方法	地址搜索参数	示例	受支持的类别	应用程序	受支持的 ArcGIS Pro 和 Enterprise 版本
点或面 为获取最佳反向地理编码结果建议使用面	每个要素表示一个特定地理地名或地标。 通过文本字符串、名称或编码识别各要素（编码可以包含数字，但必须由文本字符串表示）。	单个字段中的所有地名元素	Leeds Castle, England Sapporo, Japan Cafe Cabrillo N1N115	感兴趣点	在全球范围内的某个区域中查找地理地名或地标 查找通过名称或编码识别的要素	2.3；10.6.1；在 Enterprise 10.7 之前的版本中，不一定支持所有定位器功能。

POI（感兴趣点）定位器角色可用于为包含地表、地点或建筑物名称的数据创建定位器。 借助此角色，还可以为包含用于识别位置的字母数字字符串（例如，N1N115）的地址数据创建定位器。 可使用通过此角色创建的定位器查找如山脉、桥梁、河流、城市等要素。 使用此角色创建的定位器也可以用于查找蜂窝塔、人口普查区域以及要素类中表示的几乎所有唯一要素。 借助此定位器角色，您还可以为每个要素分配类别和子类别，这些要素可用于在进行地理编码时限制结果，或者仅用于在对要素进行地理编码后，提供有关要素的附加信息。

提示：

如果只有参考数据中的要素（如水表或人口普查区块组）的唯一简称或标识符，则可以使用创建要素定位器工具构建定位器。

此定位器角色使用包含点几何或面几何的要素类作为主要参考数据。 除 ObjectID 字段和 Shape 字段之外，用作此定位器的参考数据的要素类必须具有表示名称和地理区域的属性（如城市、州、国家）才能区别要素的位置，或者具有包含该要素的唯一名称或值的特定字段。 也可以包括 POI 物理地址的地址元素，并将它们分配到各自的字段中。 要使用类别和子类别，主要参考数据必须包含一个或两个用于对要素进行分类的字段。 或者，您可以选择包含一个包含 ID 的连接字段。您可以使用此 ID 链接到参考数据中的备用地名或备用类别的备用名称表。 在构建定位器时，将连接字段分配到主表和备用名称表中的地点连接 ID 定位器角色字段。 要素类还必须包含一个 ID 字段，该字段可将具有相同位置的重复要素连接起来，以移除定位器中的重复几何。 此过程可以减少定位器的大小，并从地理编码结果中移除过多的相关候选项。 必须根据定位器角色将此 ID 字段映射到要素 ID 字段，例如 PLACE_NAME_ID。 此外，如果重复的要素具有与之关联的备选街道名称，则要素类必须包含指示器字段，用于指示用于主要街道名称的要素。 此指示器字段必须从定位器角色（例如 PRIMARY_STREET_NAME 或 PrimaryStreetFlag）映射到主要街道名称指示器字段。 需要映射要素 ID 字段和主要街道名称指示器字段，首选街道名称属性才能按预期工作。

注：

• 将面几何用于主要参考数据时，将返回最佳反向地理编码结果。
• POI 定位器角色取代了对地名别名表的需求，但是它需要地名的点或面要素类以及属性表中的关联地址。

提示：

如果您拥有的要素表示多个要素类中不同类型的地点或位置（例如公共汽车站、地铁站、公园和学校），则建议您在单独的要素类中为每个要素分配一个类别，并将每个要素类合并为单个要素类，因为对于每个角色，您只能使用一个主要参考数据集。 您可以使用单个定位器搜索不同的位置类型。

可使用此定位器角色进行地理编码的地址表还必须包含地名和地理区域，或者可用于识别位置的唯一名称或值。 地理区域信息用于缩小搜索范围，因为经常可在同一国家的多个州中找到相同的地名（如 Rochester）。 如要对 POI 和地址进行地理编码，则需在 address 字段中包括地名并在 address2 字段中包括地址。 也可以使用以 POI 角色创建的定位器，按名称、类别，或者名称或类别与一部分地址的组合来搜索地点。 例如，键入 Starbucks, Orange St, Redlands 或 gas station, Boulder, CO。使用此定位器角色创建的定位器支持以下搜索格式：

• 按名称搜索地点（如 Disneyland、Starbucks 或 Niagara Falls），或是按类别搜索（如游乐园、瀑布或咖啡店）。

  

• 使用带有可选连接器（in 或 at）的一个或多个区域（邻域、城市、地区、邮政编码），按名称或类别搜索地点。

  

• 使用部分地址（如街道名称）按名称或类别搜索地点。

  

• 使用地址以及一个或多个区域（邻域、城市、地区、邮政编码）按名称或类别搜索地点。

  

子地址

POI 定位器角色支持相关点，这些点包含医疗室内的套间或购物广场内的商店的标识符等子地址信息。 许多商业建筑物以及机场、停车场、码头和船坞以及校园等特殊建筑物和设施中都有子地址。

点或面主要参考数据中的每个要素对应单个相关点，该点包含 POI 物理地址的地址和子地址元素，按相应的字段进行分隔。 子地址是 POI 的属性，只能将一个子地址链接到单个 POI 要素，但是不能表示为点地址角色支持的独立要素。

POI 角色支持使用子地址属性的单元编号范围建模的主要参考数据。 与多个单元关联的单个位置（例如，购物广场中的建筑物）在“自”和“至”字段中具有一系列的单元编号值。 如果有些要素具有单元编号范围，则所有要素都应使用范围进行建模。 如果单元值存储在单元“自”或“至”字段中，没有单元号范围的要素将包含在定位器中。 该原理类似于引用数据的两个字段中的值相同。

注：

构建支持子地址的 POI 定位器时，如果已映射单元和单元“自”和“至”字段，则将忽略单元字段中的值并使用单元“自”和“至”字段中的值构建定位器。

除了基本地址属性之外，为支持子地址的 POI 定位器提供主要参考数据的要素类还会包含与建筑物类型、建筑物单元名称、级别类型、级别名称、单元类型和单元名称相对应的各个字段。

注：

定位器角色支持 3 对子地址元素：单元和单元类型、级别和级别类型以及建筑物单元和建筑物单元类型。 您可选择在定位器中同时使用这两对子地址元素，也可只使用一对。 可使用适用的字段（例如 Apt F、Building A 或 Floor 1）映射这几对元素。 如果构建定位器时映射的子地址元素与相关点要素类相关联，则这些元素将在输出中返回。 了解有关主要参考数据中的地址元素的详细信息。

此定位器角色使用包含子地址信息的 POI 要素创建的定位器支持上面列出的搜索格式，但是在下面列出的搜索结果和建议中返回子地址详细信息：

• 按名称搜索地点。

  

• 按名称或类别搜索地点

  

距离标记

“距离标记”角色的基本特征

典型参考数据集几何	典型参考数据集表示方法	地址搜索参数	示例	受支持的类别	应用程序	受支持的 ArcGIS Pro 和 Enterprise 版本
点	每个要素表示以固定间隔沿道路放置的按顺序编号的标记。	单个字段中的距离标记	Mile 25 I-5 N, San Diego, CA	距离标记	查找高速公路上的距离标记符号	2.3；10.6.1；在 Enterprise 10.7 之前的版本中，不一定支持所有定位器功能。

“距离标记”定位器角色可用于为距离标记（以固定间隔沿道路放置的按顺序编号的标记）创建定位器。 此定位器角色使用包含点几何的要素类，而参考数据中的每个要素表示一个距离标记或符号。

要使用要素类作为“距离标记”定位器的参考数据，所使用的要素类必须具有以下几个字段：包含距离值、测量单位和街道名称信息的字段、一个ObjectID 字段以及一个 Shape 字段。 要素类还必须包含一个 ID 字段，该字段可将具有相同位置的重复要素连接起来，以移除定位器中的重复几何。 此过程可以减少定位器的大小，并从地理编码结果中移除过多的相关候选项。 必须根据定位器角色将此 ID 字段映射到要素 ID 字段，例如 STREET_ID。 此外，如果重复的要素具有与之关联的备选街道名称，则要素类必须包含指示器字段，用于指示用于主要街道名称的要素。 此指示器字段必须从定位器角色（例如 PRIMARY_STREET_NAME 或 PrimaryStreetFlag）映射到主要街道名称指示器字段。 需要映射要素 ID 字段和主要街道名称指示器字段，首选街道名称属性才能按预期工作。

要使用“距离标记”定位器对位置表进行地理编码，该表必须具有一个文本字段，以在单个字段中按以下格式之一包含所有地址元素：

• Kilometer 152 MEX-400
• Km 152 MEX-400
• MEX-400 Kilometer 152
• MEX-400 Km 152

注：

如果在使用此角色构建定位器时包含了距离单位，当前定位器在搜索位置时将忽略距离单位。

距离范围

“距离范围”角色的基本特征

典型参考数据集几何	典型参考数据集表示方法	地址搜索参数	示例	受支持的类别	应用程序	受支持的 ArcGIS Pro 和 Enterprise 版本
线	每个要素表示每个线段的距离标记范围。	单个字段中的距离标记范围	Carr 682 KM 4.4, Barceloneta, 00617	距离标记	查找沿高速公路的近似距离	2.3；10.6.1；在 Enterprise 10.7 之前的版本中，不一定支持所有定位器功能。

“距离范围”定位器角色可用于为具有距离标记范围的街段创建定位器。 此定位器角色使用具有线几何的要素类，并且参考数据中的每个要素表示一个街段，沿着该街段分布着一个距离标记范围。 要使用要素类作为“距离范围”定位器的参考数据，其必须具有以下字段：包含距离起点、距离终点、测量单位和街道名称信息的字段、一个 ObjectID 字段以及一个 Shape 字段。 要素类还必须包含一个 ID 字段，该字段可将具有相同位置的重复要素连接起来，以移除定位器中的重复几何。 此过程可以减少定位器的大小，并从地理编码结果中移除过多的相关候选项。 必须根据定位器角色将此 ID 字段映射到要素 ID 字段，例如 STREET_ID。 此外，如果重复的要素具有与之关联的备选街道名称，则要素类必须包含指示器字段，用于指示用于主要街道名称的要素。 此指示器字段必须从定位器角色（例如 PRIMARY_STREET_NAME 或 PrimaryStreetFlag）映射到主要街道名称指示器字段。 需要映射要素 ID 字段和主要街道名称指示器字段，首选街道名称属性才能按预期工作。

邮政地址

“邮政编码”角色的基本特征

典型参考数据集几何	典型参考数据集表示方法	地址搜索参数	示例	受支持的类别	应用程序	受支持的 ArcGIS Pro 和 Enterprise 版本
点或面 为获取最佳反向地理编码结果建议使用面	每个要素表示一个邮政编码区域或质心。	单个字段中的邮政编码	22066 B4N 1Z5	主要邮政编码	查找特定的邮政编码位置	2.3；10.6.1；在 Enterprise 10.7 之前的版本中，不一定支持所有定位器功能。

“邮政编码”定位器角色可用于为邮政编码创建定位器。 此定位器角色使用包含点几何或面几何的要素类，而参考数据中的每个要素表示一个邮区或其质心。

注：

将面几何用于主要参考数据时，将返回最佳反向地理编码结果。

“邮政编码”角色定位器的参考数据必须具有用于指定要素的邮政编码的字段、一个 ObjectID 字段、一个 Shape 字段、一个连接字段（包含可用于链接到备用名称表的 ID）以及（可选）行政区域（例如城市）字段。 要素类还必须包含一个 ID 字段，该字段可将具有相同位置的重复要素连接起来，以移除定位器中的重复几何。 此过程可以减少定位器的大小，并从地理编码结果中移除过多的相关候选项。 必须根据定位器角色将此 ID 字段映射到要素 ID 字段，例如 POSTAL_ID。

如果参考数据的邮政编码中包含城市名称值，则在构建定位器时城市值将存储为邮政城市值。 在某些国家/地区（包括美国）中，在进行地理编码时默认返回邮政城市。 这会影响多角色定位器（包含点地址、宗地、街道地址或 POI 角色）返回的结果。 可通过更改定位器属性对话框中首选城市名称的默认值，更改定位器中要返回给本地城市或匹配城市的值。

可使用此定位器角色进行地理编码的地址表必须具有包含邮政编码信息的字段。

邮政编码扩展码

“邮政编码扩展码”角色的基本特征

典型参考数据集几何	典型参考数据集表示方法	地址搜索参数	示例	受支持的类别	应用程序	受支持的 ArcGIS Pro 和 Enterprise 版本
点	每个要素表示一个邮政编码扩展码质心。	五位数字邮政编码外加四位数字扩展的单个字段	96822-2323	主要邮政编码、邮政编码扩展码	查找特定的邮政编码扩展码位置	2.3；10.6.1；在 Enterprise 10.7 之前的版本中，不一定支持所有定位器功能。

“邮政编码扩展码”定位器角色可用于对具有扩展的邮政编码进行地理编码，例如美国增强型 (ZIP+4) 邮政编码。 之后，您可以使用定位器角色来创建使用点要素类作为主要参考数据的定位器。

主要参考数据源中的每个要素表示一个邮政编码扩展码点。 除了 ObjectID 和 Shape 字段之外，参考数据要素类或 shapefile 必须具有表示要素邮政编码（在美国为 5 位邮政编码）的文本字段，同时还必须具有另一个包含邮政编码扩展码（在美国为 4 位增强型 (ZIP+4) 邮政编码）的文本字段。 要素类还必须包含一个 ID 字段，该字段可将具有相同位置的重复要素连接起来，以移除定位器中的重复几何。 此过程可以减少定位器的大小，并从地理编码结果中移除过多的相关候选项。 必须根据定位器角色将此 ID 字段映射到要素 ID 字段，例如 POSTAL_EXTENSION_ID。

要使用“邮政编码扩展码”定位器对地址表进行地理编码，该地址表必须具有包含整个邮政编码和邮政编码扩展码的文本字段。 例如，在美国，此字段是增强型 (ZIP+4) 邮政编码（即 5 位邮政编码加上增强型 (ZIP+4) 邮政编码），例如 12345-6789、12345 6789 或 123456789。

邮政地点

“邮政地点”角色的基本特征

典型参考数据集几何	典型参考数据集表示方法	地址搜索参数	示例	受支持的类别	应用程序	受支持的 ArcGIS Pro 和 Enterprise 版本
点 为获取最佳反向地理编码结果建议使用面	每个要素表示邮政编码与邮政编码边界或质心中的城市的并集。	单个字段中的邮政编码和城市	7132 Frauenkirchen	主要邮政编码、邮政地点	寻找特定地点	2.3；10.6.1；在 Enterprise 10.7 之前的版本中，不一定支持所有定位器功能。

“邮政地点”定位器角色可用于为邮政编码和地点的并集创建定位器。 当邮政编码跨多个地点时，可以使用此定位器解析到更准确的位置。 对于此定位器角色，必须使用以下要素类：参考数据中的每个要素表示邮政编码和地点之间的并集。 例如，在下图中，Scripps Estates（紫色）的邻域边界位于邮政编码为 92037 （黑色）的边界范围内，此处属于拉霍亚市。 如果您已使用邮政编码数据创建“邮政编码”定位器，则搜索 92037, La Jolla 将返回一个匹配项。 但是，搜索 92037 Scripps Estates 则不会返回匹配项，因为 Scripps Estates 未关联至邮政编码参考数据中的 92037 邮政编码要素。 要查找 92037, Scripps Estates，您必须构建“邮政地点”定位器。

注：

将面几何用于主要参考数据时，将返回最佳反向地理编码结果。

“邮政地点”角色定位器的参考数据必须具有一个用于指定要素的邮政编码和城市的字段、一个 ObjectID 字段、一个 Shape 字段以及（可选）一个包含可用于链接到备用名称表的 ID 的连接字段。 要素类还必须包含一个 ID 字段，该字段可将具有相同位置的重复要素连接起来，以移除定位器中的重复几何。 此过程可以减少定位器的大小，并从地理编码结果中移除过多的相关候选项。 必须根据定位器角色将此 ID 字段映射到要素 ID 字段，例如 POSTAL_LOCALITY_ID。 要创建参考数据以用于创建具有“邮政地点”角色的定位器，使用联合工具在具有每个数据集属性的单个要素类中计算城市或地点和邮政编码边界要素类的地理并集。

行政区域

“行政区域”角色的基本特征

典型参考数据集几何	典型参考数据集表示方法	地址搜索参数	示例	受支持的类别	应用程序	受支持的 ArcGIS Pro 和 Enterprise 版本
点或面 为获取最佳反向地理编码结果建议使用面	每个要素表示一个特定的行政区域，如城市、街区、都会区、地区、区域等。	单个字段中的行政区域名称	British Columbia North Park, San Diego	区块、细分区域、街区、区、城市、都会区、子区域、区域、地区、国家、地带	查找特定的行政区域	2.3；10.6.1；在 Enterprise 10.7 之前的版本中，不一定支持所有定位器功能。

“行政区域”角色可用于对城市、社区、县、省、区、地区和州等区域进行地理编码。 您可以使用此角色创建将点要素类或面要素类用作主要参考数据的定位器。 使用多个角色构建包括地址级别和行政区域的定位器时，将使用行政区域面根据地址数据来填充缺失的行政区域属性。

注：

将面几何用于主要参考数据时，将返回最佳反向地理编码结果。

“行政区”角色定位器的参考数据必须具有指定要素的行政区名称的字段、一个 ObjectID 字段、一个 Shape 字段以及（可选）一个包含可用于链接到备用名称表的 ID 的行政区 JoinID 字段。 您可以将 ID 与主要参考数据中的多个要素关联起来，并使用其链接到备用名称表中 Join ID 字段中的唯一记录。 在备用名称表中的主要参考数据和备用名称之间必须存在多对多或多对一的关系。 如果一个主要管理要素有多个名称，则相同要素的备用管理名称的备用名称表中的 Join ID 字段必须包含相同的唯一 ID 值，如下所示。

注：

构建定位器时，不要将主要参考数据和备用名称表中的 ObjectID 映射到连接 ID 定位器角色字段。 使用 ObjectID 可能会增加定位器的大小，并降低批量地理编码性能和地理编码质量。

要移除定位器中的重复几何，要素类必须还包含一个将重复要素与相同位置连接的 ID 字段。 此过程可以减少定位器的大小，并从地理编码结果中移除过多的相关候选项。 必须根据定位器角色将此 ID 字段映射到要素 ID 字段，例如 REGION_FEATURE_ID。

其他角色属性

在创建定位器时，定位器角色列表包含其他多种用于区别各种定位器角色的属性。

连接 ID 字段

可使用表为参考数据要素类中的要素定义备用名称。 可使用备用街道名称将一个地址与一个使用多个名称之一的要素进行匹配。 例如，如果 Bridge Street 也称为 Slash Road，则使用 266 Bridge Street 和 266 Slash Road 可以找到相同的地址。

主要素类必须具有一个字段，用来包含每个记录的 ID 值。 您可以将 ID 与主要要素类中的多个要素关联起来，并使用其链接到备用名称表中 Join ID 字段中的唯一记录。 在备用名称表中的主要要素类和备用名称之间必须存在多对多或多对一的关系。 主要素类必须具有一个字段，其中包含可用于从备用名称表链接到连接 ID 的每个记录的唯一 ID 值。

注：

构建定位器时，不要将主要参考数据和备用名称表中的 ObjectID 映射到连接 ID 定位器角色字段。 使用 ObjectID 可能会增加定位器的大小，并降低批量地理编码性能和地理编码质量。

行政区域字段

每个角色均包含行政区域字段，例如城市、州和邮政编码，必须尽可能地使用这些字段，以进一步增加正确匹配的可能性。 可能存在跨越多个区域的超长街道，例如美国伊利诺伊州芝加哥的湖岸大道，它跨越整个城市并穿越了超过 5 个邮区。 如之前的示例所示，如果仅对没有邮政编码的街道地址进行地理编码，则将返回多个匹配项，而无法确定哪个匹配项是正确的。

自定义输出字段

每个定位器角色都允许将其他自定义输出字段添加到定位器。 这些字段是可选字段。 您可从参考要素类中选择任意一个或多个字段作为要包括在内的一个或多个自定义输出字段。 当您使用具有指定附加字段的定位器搜索地址时，参考数据中相应字段的信息会显示在地址候选项中，并保存到输出要素类。

常见示例包括 Block ID、特殊标识符或产权人名称。 您可以使用保存在输出要素类中的其他字段连接到其他属性表或要素类，以进行进一步的空间分析。 重新匹配地址并需要附加信息以确定匹配是否正确时，也可以使用此信息。