Skip to main content

地理编码结果中包含的内容

地理编码结果包括定位器的输出字段，以及原始输入地址字段。

对位置表进行地理编码后，输出点图层将包含地址表中地址字段的副本。 对表进行地理编码后，定位器返回的输出字段会包含新前缀，并且表中的原始字段将保留。

以下是针对不同的地理处理工具将返回的前缀：

注:

传递地址字段的目的之一是进行重新匹配。 新地址字段集以 IN_ 作为前缀，表中的原始字段则以 USER_ 作为前缀，因此十分容易区分。 如果在重新匹配过程中修改地址，则新地址将保存在以 IN_ 作为前缀的字段中，而不是覆盖以 USER_ 作为前缀的原始字段。

输出字段选项

如果您将输出字段参数指定为非默认值 (All)，则仅会返回字段子集。

  • 全部 - 返回定位器属性对话框输出字段部分中批量输出字段列表中已启用的所有字段。 All 是默认选项。

  • 仅位置 - 返回 Shape 字段以及输入地址表中的原始字段名称。

  • 最小化 - 返回输入地址表中的原始字段名称，以及描述位置及其与定位器信息匹配程度的以下字段：

    • Shape

    • Status

    • Score

    • Match_type

    • Match_addr

    • Addr_type

  • 最小化和用户字段 - 返回输入地址表中的原始字段名称、最小输出的字段以及用户定义的输出字段。

如果创建定位器时在创建定位器工具中定义了自定义输出字段，则地理编码结果中将默认包含自定义输出字段，除非在定位器属性对话框上的输出字段页面上将字段关闭。

注:

输出字段参数适用于对表进行地理编码的所有地理处理工具：

其他输出字段

地理编码结果中的以下其他输出字段取决于所使用的地理编码服务或定位器：

重要信息：

如果您正在使用服务进行地理编码，而该服务使用 ArcGIS Pro 中已弃用的定位器类型创建，则所看到的输出字段将与下方记录的字段不同。

  • Loc_name - 用于返回匹配结果的定位器的名称。 仅当用于匹配表的定位器是复合定位器时，此字段才可用。

    注:

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

    当复合定位器中的参与定位器在定位器属性对话框的输出字段页面上禁用 Addr_type 时，地理编码结果中的 Loc_name 字段将为空。 如果启用 Addr_type 字段，则下次使用复合定位器进行地理编码时，将使用匹配结果的定位器名称来填充 Loc_name 字段。

  • 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 - 包括街道交叉点和城市以及州和邮政编码信息（可选信息）的街道地址。 这是从 StreetAddress 参考数据中获取的，例如 Redlands Blvd. & New York St., Redlands, CA 92373。

    • StreetAddressExt - 当参数 matchOutOfRange=true 且输入的门牌号超过匹配街段的门牌号范围时返回的预估街道地址匹配。

    • POI - 感兴趣点。 参考数据包括行政区域、地名、企业、地标和地理要素，例如星巴克。

    • 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 - 具有附加扩展码的邮政编码，如美国邮政编码 +4。 参考数据是具有扩展码的邮政编码点，例如 90210-3841。

    • Postal - 邮政编码。 参考数据是邮政编码点，例如 90210 USA。

    • PostalLoc - 邮政编码和城市名称的组合。 参考数据通常是邮政边界和行政（地域）边界的联合，例如 7132 Frauenkirchen。

    • Locality - 代表居民区的地名。 Type 输出字段可提供更为详细的居民区类型相关信息。 所在地匹配的可能 Type 值包括区块、扇区、街区、区、城市、都会区、县、州或省、地区、国家以及区域，例如 Bogotá, COL。

    • 要素 - 使用创建要素定位器工具创建的定位器返回的地理编码结果。 可能的地理编码结果示例可以是要素类中表示的唯一要素，例如感兴趣点、征税宗地、人口普查区、水表、短地名、信号塔或用于识别位置的字母数字字符串（例如 N1N115）。

    • LatLong - x,y 坐标对。 当 x,y 坐标对（例如 117.155579,32.703761）为搜索输入时，将返回 LatLong addr_type。

    • XY-XY - 基于输入的第一坐标为经度而第二坐标为纬度这一假设的匹配。

    • YX—YX - 作为候选项的 Addr_type 返回，该项假定纬度是输入中的第一个数字，而经度为第二个数字。

    • MGRS - 军事格网参考系统 (MGRS) 位置，例如，46VFM5319397841。

    • USNG - 美国国家格网 (USNG) 位置，例如 15TXN29753883。 仅当定位器属性对话框中的支持的类别部分中已启用 USNG 坐标系类别，或者在 findAddressCandidates 或 geocodeAddresses 请求中已将 category 参数设置为 USNG 时，才会返回此 Addr_type 值。

  • Type - 搜索返回的结果的要素类型或交叉点类型。

    • 对于 Addr_type = POI 或 Locality 的候选项，Type 字段包含该要素的描述性值，例如对于星巴克，Type = Coffee Shop。

    • 对于 Addr_type = StreetInt 的候选项，Type 字段包含虚拟交叉点的 Virtual 值，例如 Type = Virtual。

  • PlaceName - 地理编码匹配候选项的正式名称，例如 Paris 或 Starbucks。

  • 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 - 数值文本值或数值字段中的浮点型值（具体取决于定位器），用于指示某结果相对于其他相同名称结果的重要性。 例如，在法国和德克萨斯州都有城市叫 Paris。 法国巴黎的人口多于德克萨斯州巴黎的人口，所以法国巴黎的等级更高。 数字越小，表示的要素等级越高。 等级用于对一些模糊不清的查询进行排序，例如 Lincoln，其中无可用附加信息（州）。 Rank 值基于人口或要素类型。

  • AddBldg - 建筑物的名称，例如帝国大厦。

  • AddNum - 字母数字值，用于表示地址的一部分，通常为门牌号或建筑物编号，例如，在地址 380 New York Street 中，AddNum = 380。 仅针对 PointAddress 和 StreetAddress 匹配返回此值。

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

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

  • AddRange - 地址所在街道的完整地址编号范围，格式为 AddNumFrom-AddNumTo。 例如，街道地址 123 Main St. 的 AddRange 值可能为 101-199。

  • Side - 相对于要素数字化方向，地址所在的街道一侧。 该值不是相对于沿街道出行的方向。 此属性可具有下列值中的一个：

    • L - 地址与街道的左侧匹配。

    • R - 地址与街道的右侧匹配。

    • 没有值 - 地址不匹配，或者定位器不能确定是街道的哪一侧。

  • StPreDir - 定义街道方向的地址元素，位于主街道名称前，例如，North Main Street 中的“North”。

  • StPreType - 定义街道主要类型的地址元素，例如，Avenida Central 中的西班牙语术语“Avenida”或 Rue Lapin 中的法语术语“Rue”。

  • StName - 定义街道主名称的地址元素，例如，North Main Street 中的“Main”。

  • StType - 定义街道类型的地址元素，例如，Main Street 中的“Street”。

  • StDir - 定义街道方向的地址元素，位于主街道名称后，例如，Main Street North 中的“North”。

  • Bldg Comp - 一个区域，通常为住宅区，由一系列代表多个地址的建筑组成，例如 Essel Park Subdivision。

  • BldgName - 建筑物子单位的名称或编号，例如 Building A 中的 A。

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

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

  • LevelName - 楼层子单位的名称或编号，例如 Level 3 中的 3。

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

  • UnitName - 单元子单位的名称或编号，例如，Apartment 2B 中的 2B。

  • RoomType - 房间子单元的分类，例如房间。

  • RoomName - 位于单元内的房间的名称或编号。 房间是单元的一个子组件，例如 Room 3 中的 3。

  • WingType - 翼子单位的分类，例如 wing。

  • WingName - 作为建筑物一部分的翼子单位的名称或编号。 一个翼由建筑物某一分区内的所有楼层和单元组成，例如 Wing A 中的 A。

  • SubAddr - Addr_type = Subaddress 的候选项的完整子单位值，其中包括 <子单位类型> + <子单位名称>。 例如，如果子地址候选项为公寓单元，则 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 - 某候选项的区域级别行政区域的名称。 这可以是一个国家或地区的细分区域。 如果未采用地区行政区划，则其通常为国家/地区的最大行政区域，例如州或省。

  • RegionAbbr - 区域的缩写名称。 加利福尼亚州（美国的一个州）的 RegionAbbr 值是 CA。

  • Territory - 某候选项的地区级别行政区域的名称。 例如，一个国家的细分区域。 这并不常用。 巴西的 Sudeste 大区，其中包括 Espírito Santo、Minas Gerais、Rio de Janeiro 和 São Paulo 等州。

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

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

  • Country - 国家的 3 位代码，例如 United States of America = USA。 ArcGIS World Geocoding Service 的地理编码数据覆盖范围中提供了支持的国家/地区列表。

  • CountryCode - 国家/地区的三字符代码；例如，Canada = CAN。 ArcGIS World Geocoding Service 的地理编码数据覆盖范围中提供了支持的国家/地区列表。 此字段与 Country 输出字段相同，但是仅由反向地理编码返回。

  • CntryName - 地址候选项对应的国家/地区全名；例如“日本”（日本）。 该名称可以采用与输入地址相同的语言，或者采用请求的 langCode 参数指定的语言。 如果国家/地址全名在指定语言中不可用，则使用地址候选项所在国家/地区的母语。 World Geocoding Service 的地理编码数据覆盖范围中提供了受支持语言的列表。

  • LangCode - 3 位语言代码，表示对应地址的语言，例如，ENG = English。 请参阅代码列表。

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

  • X - 定位器的空间参考中匹配地址的主 x 坐标。 X 坐标由 ArcGIS World Geocoding Service 在空间参考 WGS84 (WKID 4326) 中返回。

  • Y - 定位器的空间参考中匹配地址的主 y 坐标。 Y 坐标由 ArcGIS World Geocoding Service 在空间参考 WGS84 (WKID 4326) 中返回。

  • Z - 定位器的空间参考中匹配地址的主 z 坐标。

  • DisplayX - 定位器的空间参考中返回的地址的显示 x 坐标。 显示 x 坐标由 ArcGIS World Geocoding Service 在空间参考 WGS84 (WKID 4326) 中返回。 如 Addr_type 字段和 PointAddress 基于角色的定位器中所示，对于 PointAddress 或 Subddress 的匹配，此值表示该地址的建筑物屋顶或宗地质心的 x 坐标值。 它与主要 x 值不同，主要 x 值表示街道位置一侧的 x 坐标或地址的街道条目。 但是，也存在例外情况，因为 ArcGIS World Geocoding Service 使用的一些数据源仅提供 PointAddress 和 Subaddress 要素的屋顶位置。 在其他情况下，仅为某些 PointAddress 和 Subaddress 要素提供街道侧位置。 在这些情况下，X 和 DisplayX 值相等。 对所有其他 Addr_type 匹配和定位器，此值和 x 值相同。

  • DisplayY - 定位器的空间参考中返回的地址的显示 y 坐标。 显示 y 坐标由 ArcGIS World Geocoding Service 在空间参考 WGS84 (WKID 4326) 中返回。 如 Addr_type 字段和 PointAddress 基于角色的定位器中所示，对于 PointAddress 或 Subddress 的匹配，此值表示该地址的建筑物屋顶或宗地质心的 y 坐标值。 此值不同于 y 值，y 值派生自街道上的某个位置或地址的街道条目。 但是，也存在例外情况，因为 ArcGIS World Geocoding Service 使用的一些数据源仅提供 PointAddress 和 Subaddress 要素的屋顶位置。 在其他情况下，仅为某些 PointAddress 和 Subaddress 要素提供街道侧位置。 在这些情况下，Y 和 DisplayY 值相等。 对所有其他 Addr_type 匹配和定位器，此值和 y 值相同。

  • DisplayZ - 定位器的空间参考中返回的地址的显示 z 坐标。

  • 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 - 输入中无法与地址中的任何部分匹配的字符串集合，用于对结果进行评分或罚分。

  • StrucType - 一种用于描述结构或建筑物主要用途的标识。 该字段仅由 ArcGIS World Geocoding Service 和 ArcGIS StreetMap Premium 定位器返回。 有关 StrucType 字段的详细信息，请参阅 ArcGIS REST API Web 帮助。

  • StrucDet - 结构或建筑物更详细的用途描述。 该字段与 StrucType 字段相关。 该字段仅由 ArcGIS World Geocoding Service 和 ArcGIS StreetMap Premium 定位器返回。 有关 StrucDet 字段的详细信息，请参阅 ArcGIS REST API Web 帮助。

  • MatchID - 表示唯一地址或地点的 ID 值，例如 matchID=AQFV9QAAmeQBAJUBBAAAAAAMD05FVyBZT1JLIFNUUkVFVBUDMzgwZgNFTkc。

  • PotentialID - 具有不匹配但已分类子地址信息的地址的潜在 MatchID 值。

  • MatchNarrative - 有关定位器如何匹配地理编码结果的详细信息集合。 如果您将匹配叙述分割为字段，将按顺序返回以下内容：

    • MatchNarr_ID - 输入表与新分割匹配叙述表之间的连接字段。

    • Seq - 评估给定地址各组成部分的顺序。

    • Field - 输入部分与之匹配的地址组成部分。

    • Code - 描述输入部分匹配方式的匹配叙述代码值。 有关各代码的示例输入，请参阅匹配叙述代码描述。 多个代码可能会用于描述特定输入部分的匹配叙述。 以下是可能的代码值：

      • c - 分类。 将输入部分识别为参考数据中的地址值、别名或某种指标。

      • m - 匹配。 输入部分与参考数据中的地址值匹配。

      • i - 非精确。 输入部分与其所匹配内容的拼写不同。

      • p - 部分。 输入部分与参考数据中的某个值部分匹配。

      • s - 分割/串联。 将输入中的一个单词分割为多个单词，或将多个输入单词串连为一个单词，以实现与参考数据中某个值的匹配。

      • a - 别名。 输入部分与参考数据值的别名匹配。

      • r - 重新定位。 输入部分与参考数据中的某个值匹配，但在整个地址中的位置错误。

      • d - 不同。 将输入部分识别为特定的地址组成部分，但与该组成部分的不同参考数据值相匹配。

      • n - 附近。 输入部分与邮政编码或行政区域相匹配；该邮政编码或行政区域与地理编码地址实际所属的邮政分区或行政区域相邻。

      • e - 外插。 输入部分与参考数据中 StreetAddress 记录的门牌号范围之外相匹配。

    • Input_Field - 各地址组成部分的分类。 以下是可能的 Input_Field 值：

      • Address - 表示第一行街道地址的字符串。 该字段用于街道名称和门牌号的输入，也可以输入建筑物名称或地名。

      • Address2 - 表示第二行街道地址的字符串。 该字段可以包括街道名称/门牌号、建筑物名称、地名或子单元。

      • Address3 - 表示第三行街道地址的字符串。 该字段可以包括街道名称/门牌号、建筑物名称、地名或子单元。

      • 社区 - 地址的最小行政区划，通常是社区或较大人口聚居地的区域。 社区是城市的细分区域。

      • 市 - 地址的下一级行政区划，通常是市或自治市。 市是亚区或区域的细分区域。

      • 亚区 - 地址的下一级行政区划。 根据国家/地区不同，亚区可以代表县、州或省。

      • 区域 - 地址的最大行政区划，通常是州或省。

      • 邮政编码 - 地址的标准邮政编码，通常为 3 到 6 位字母数字编码。

      • PostalExt - 邮政编码扩展码，如美国邮政编码 +4。

    • 输入 - 正在描述的输入字符串部分。

    • 基准 - 输入部分与之匹配的定位器参考数据中的值。