你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Search - Get Geocoding Batch

服务:: Maps

API 版本:: 2025-01-01

用于在单个请求中向地理编码 API 发送一批查询。

Get Geocoding Batch API 是一个 HTTP POST 请求，在单个请求中向 Geocoding API 发送多达 100 100 个查询的批处理。

提交同步批处理请求

建议对轻型批处理请求使用同步 API。当服务收到请求时，它会在计算批处理项后立即做出响应，并且以后将无法检索结果。如果请求花费的时间超过 60 秒，同步 API 将返回超时错误（408 响应）。批项数限制为此 API 100 个。

POST https://atlas.microsoft.com/geocode:batch?api-version=2023-06-01

批处理请求的 POST 正文

若要发送 地理编码 查询，将使用 POST 请求，其中请求正文将包含 batchItems 格式的 json 数组，Content-Type 标头将设置为 application/json。下面是包含 2 个 地理编码 查询的示例请求正文：

{
  "batchItems": [
    {
      "addressLine": "One, Microsoft Way, Redmond, WA 98052",
      "top": 2
    },
    {
      "addressLine": "Pike Pl",
      "adminDistrict": "WA",
      "locality": "Seattle",
      "top": 3
    }
  ]
}

geocoding batchItem 对象可以接受任何受支持的 地理编码URI 参数。

批处理应至少包含 1 个查询。

批处理响应模型

批处理响应包含一个 summary 组件，该组件指示作为原始批处理请求的一部分的 totalRequests，successfulRequests 即已成功执行的查询。批处理响应还包括一个 batchItems 数组，其中包含批处理请求中每个查询的响应。 batchItems 将包含结果，其顺序与在批处理请求中发送原始查询的顺序完全相同。每个项都是以下类型之一：

GeocodingResponse - 如果查询成功完成。
Error - 如果查询失败。在这种情况下，响应将包含 code 和 message。

POST https://atlas.microsoft.com/geocode:batch?api-version=2025-01-01

URI 参数

名称	在	必需	类型	说明
api-version	query	True	string	Azure Maps API 的版本号。

请求头

名称	必需	类型	说明
x-ms-client-id		string	指定哪个帐户与 Azure AD 安全模型结合使用。它表示 Azure Maps 帐户的唯一 ID，可以从 Azure Maps 管理平面帐户 API 检索。有关在 Azure Maps 中使用 Microsoft Entra ID 安全性的详细信息，请参阅在 Azure Maps 中管理身份验证。
Accept-Language		string	应返回搜索结果的语言。有关详细信息，请参阅支持的语言。

名称

必需

类型

说明

x-ms-client-id

string

指定哪个帐户与 Azure AD 安全模型结合使用。它表示 Azure Maps 帐户的唯一 ID，可以从 Azure Maps 管理平面帐户 API 检索。有关在 Azure Maps 中使用 Microsoft Entra ID 安全性的详细信息，请参阅在 Azure Maps 中管理身份验证。

Accept-Language

string

应返回搜索结果的语言。

有关详细信息，请参阅支持的语言。

请求正文

名称	类型	说明
batchItems	GeocodingBatchRequestItem[]	要处理的查询列表。

响应

名称	类型	说明
200 OK	GeocodingBatchResponse	好的
Other Status Codes	ErrorResponse	发生意外错误。

安全性

AADToken

这些 Microsoft Entra OAuth 2.0 流。与 Azure 基于角色的访问配对时，控制它可用于控制对 Azure Maps REST API 的访问。 Azure 基于角色的访问控制用于指定对一个或多个 Azure Maps 资源帐户或子资源的访问。任何用户、组或服务主体都可以通过内置角色或由一个或多个对 Azure Maps REST API 的权限组成的自定义角色授予访问权限。

若要实现方案，建议查看身份验证概念。总之，此安全定义提供了一种解决方案，用于通过能够针对特定 API 和范围进行访问控制的对象对应用程序建模。

注释

此安全定义要求使用 x-ms-client-id 标头来指示应用程序请求访问的 Azure Maps 资源。这可以从地图管理 API获取。
Authorization URL 特定于 Azure 公有云实例。主权云具有唯一的授权 URL，Microsoft Entra ID 配置。
Azure 基于角色的访问控制是通过 Azure 门户、PowerShell、CLI、Azure SDK 或 REST API 从 Azure 管理平面配置的。
使用 Azure Maps Web SDK 允许为多个用例设置基于应用程序的配置。
有关Microsoft标识平台的详细信息，请参阅 Microsoft标识平台概述。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

这是在通过 Azure 门户、PowerShell、CLI、Azure SDK 或 REST API 通过 Azure 管理平面创建 Azure Maps 资源时预配的共享密钥。

使用此密钥，任何应用程序都有权访问所有 REST API。换句话说，这些密钥当前可视为为其颁发的帐户的主密钥。

对于公开的应用程序，我们建议使用可安全地存储此密钥的 Azure Maps REST API 的服务器到服务器访问。

类型: apiKey
在: header

SAS Token

这是一个共享访问签名令牌，它通过 Azure 门户、PowerShell、CLI、Azure SDK 或 REST API 通过 Azure 管理平面在 azure Maps 资源上的列表 SAS 操作创建。

使用此令牌，任何应用程序都有权使用 Azure 基于角色的访问控制进行访问，并精细控制特定令牌的过期、速率和区域。换句话说，SAS 令牌可用于允许应用程序以比共享密钥更安全的方式控制访问。

对于公开的应用程序，建议在映射帐户资源上配置允许的源的特定列表，以限制呈现滥用并定期续订 SAS 令牌。

类型: apiKey
在: header

示例

A Geocoding Batch API call containing 2 Geocoding queries

示例请求

HTTP

POST https://atlas.microsoft.com/geocode:batch?api-version=2025-01-01

{
  "batchItems": [
    {
      "addressLine": "15127 NE 24th Street, Redmond, WA 98052",
      "top": 2,
      "optionalId": "4C3681A6C8AA4AC3441412763A2A25C81444DC8B"
    },
    {
      "query": "Pike Pl",
      "locality": "Seattle",
      "top": 3
    }
  ]
}

示例响应

状态代码:: 200

{
  "summary": {
    "successfulRequests": 1,
    "totalRequests": 2
  },
  "batchItems": [
    {
      "optionalId": "4C3681A6C8AA4AC3441412763A2A25C81444DC8B",
      "type": "FeatureCollection",
      "features": [
        {
          "type": "Feature",
          "properties": {
            "type": "Address",
            "confidence": "High",
            "matchCodes": [
              "Good"
            ],
            "address": {
              "locality": "Redmond",
              "adminDistricts": [
                {
                  "shortName": "WA"
                },
                {
                  "shortName": "King County"
                }
              ],
              "countryRegion": {
                "ISO": "US",
                "name": "United States"
              },
              "postalCode": "98052",
              "formattedAddress": "15127 NE 24th St, Redmond, WA 98052",
              "streetName": "NE 24th St",
              "streetNumber": "15127",
              "addressLine": "15127 NE 24th St"
            },
            "geocodePoints": [
              {
                "geometry": {
                  "type": "Point",
                  "coordinates": [
                    -122.138669,
                    47.630359
                  ]
                },
                "calculationMethod": "Rooftop",
                "usageTypes": [
                  "Display",
                  "Route"
                ]
              },
              {
                "geometry": {
                  "type": "Point",
                  "coordinates": [
                    -122.1387383,
                    47.630563
                  ]
                },
                "calculationMethod": "Rooftop",
                "usageTypes": [
                  "Route"
                ]
              }
            ]
          },
          "geometry": {
            "type": "Point",
            "coordinates": [
              -122.138669,
              47.630359
            ]
          },
          "bbox": [
            -122.14631082421619,
            47.62649628242932,
            -122.1310271757838,
            47.634221717570675
          ]
        }
      ]
    },
    {
      "error": {
        "code": "Conflicting Parameters",
        "message": "When 'query' is present, only the following parameters are valid: 'bbox, location, view, top'. 'locality' was passed"
      }
    }
  ]
}

定义

名称	说明
Address	结果的地址
AdminDistricts	地址所在国家或地区的细分名称。此元素通常被视为第一个顺序管理细分，但在某些情况下，它还包含国家/地区、依赖项或区域的第二、第三或第四个顺序细分。
CalculationMethodEnum	用于计算地理编码点的方法。
ConfidenceEnum	地理编码位置结果匹配的置信度级别。将此值与匹配代码一起使用，以确定有关匹配的更完整信息。地理编码位置的置信度基于许多因素，包括地理编码位置和用户位置（如果指定）的相对重要性。
CountryRegion
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应
FeatureCollectionEnum	FeatureCollection 对象的类型必须是 FeatureCollection。
FeaturesItem
FeatureTypeEnum	特征的类型必须是功能。
GeocodePoints	一组地理编码点，这些点的计算方式及其建议的使用方式不同。
GeocodingBatchRequestBody	要处理的地址地理编码查询/请求的列表。该列表最多可以包含 100 个查询，并且必须至少包含 1 个查询。
GeocodingBatchRequestItem	Batch Query 对象
GeocodingBatchResponse	此对象是从成功的 Geocoding Batch 服务调用返回的。
GeocodingBatchResponseItem
GeoJsonPoint	有效的 `GeoJSON Point` 几何图形类型。有关详细信息，请参阅 RFC 7946。
Intersection	结果的地址。
MatchCodesEnum	一个或多个匹配代码值，表示响应中每个位置的地理编码级别。例如，具有匹配代码的地理编码位置 `Good` 和 `Ambiguous` 意味着为位置信息找到了多个地理编码位置，并且地理编码服务没有搜索向上层次结构来查找匹配项。同样，具有匹配代码的地理编码位置 `Ambiguous` 和 `UpHierarchy` 意味着找不到与提供的所有位置信息匹配的地理编码位置，因此地理编码服务必须搜索层次结构并在该级别找到多个匹配项。 `Ambiguous` 和 `UpHierarchy` 结果的一个示例是提供完整的地址信息，但地理编码服务找不到街道地址的匹配项，而是返回多个 RoadBlock 值的信息。可能的值为： `Good`：该位置只有一个匹配项或所有返回的匹配项被视为强匹配项。例如，纽约的查询返回多个 Good 匹配项。 `Ambiguous`：位置是一组可能的匹配项之一。例如，在查询街道地址 128 Main St.时，响应可能会返回 128 北主街和 128 南主街的两个位置，因为没有足够的信息来确定要选择的选项。 `UpHierarchy`：位置表示向上移动的地理层次结构。如果未找到位置请求的匹配项，则会发生这种情况，因此会返回不太精确的结果。例如，如果找不到所请求地址的匹配项，则可能会返回具有 RoadBlock 实体类型的 `UpHierarchy` 匹配代码。
Properties
Summary	批处理请求摘要
UsageTypeEnum	最适合地理编码点。每个地理编码点都定义为 `Route` 点、`Display` 点或两者。如果要创建指向位置的路由，请使用 `Route` 点。如果在地图上显示位置，请使用 `Display` 点。例如，如果位置是公园，`Route` 点可以指定公园的入口，可以使用汽车进入，而 `Display` 点可能是指定公园中心点。

Address

Object

结果的地址

名称	类型	说明
addressLine	string	包含街道名称和号码的 AddressLine
adminDistricts	AdminDistricts[]	地址所在国家或地区的细分名称。此元素通常被视为第一个顺序管理细分，但在某些情况下，它还包含国家/地区、依赖项或区域的第二、第三或第四个顺序细分。
countryRegion	CountryRegion
formattedAddress	string	Formatted Address 属性
intersection	Intersection	结果的地址。
locality	string	locality 属性
neighborhood	string	neighborhood 属性
postalCode	string	邮政编码属性
streetName	string	formattedAddress 中的街道名称
streetNumber	string	街道上的号码（如果可用），来自 formattedAddress

AdminDistricts

Object

地址所在国家或地区的细分名称。此元素通常被视为第一个顺序管理细分，但在某些情况下，它还包含国家/地区、依赖项或区域的第二、第三或第四个顺序细分。

名称	类型	说明
name	string	相应 adminDistrict 字段的名称，对于 adminDistrict[0]，这可能是州的完整名称，例如华盛顿，对于 adminDistrict[1]，这可能是该县的全名
shortName	string	相应 adminDistrict 字段的短名称，对于 adminDistrict[0]，这可能是州名称的短名称，例如 WA，对于 adminDistrict[1]，这可能是县的短名称

CalculationMethodEnum

枚举

用于计算地理编码点的方法。

值	说明
Interpolation	使用插值将地理编码点与道路上的点进行匹配。
InterpolationOffset	地理编码点使用插值与道路上的点进行匹配，并使用额外的偏移量将点移动到街道一侧。
Parcel	地理编码点已与宗地中心匹配。
Rooftop	地理编码点与建筑物的屋顶匹配。

ConfidenceEnum

枚举

地理编码位置结果匹配的置信度级别。将此值与匹配代码一起使用，以确定有关匹配的更完整信息。

地理编码位置的置信度基于许多因素，包括地理编码位置和用户位置（如果指定）的相对重要性。

值说明

High

值	说明
High	如果置信度设置为 `High`，则找到了一个或多个强匹配项。多个置信度匹配按 `High` 重要性排名排序（如果适用）。例如，地标具有重要性，但地址不重要。如果请求包含位置或视图，则排名可能会相应更改。例如，对“Paris”的位置查询会可靠地 `High` 返回“Paris， France”和“Paris， TX”。由于重要性，“法国巴黎”始终排在第一位，除非用户位置表明用户位于或非常靠近德克萨斯州巴黎，或者地图视图表明用户正在该区域进行搜索。
Medium	在某些情况下，返回的匹配项可能与请求中提供的信息不在同一级别。例如，请求可以指定地址信息，而地理编码服务可能只能匹配邮政编码。在这种情况下，如果地理编码服务具有邮政编码与数据匹配的置信度，则置信度设置为， `Medium` 匹配代码设置为， `UpHierarchy` 以指定它无法匹配所有信息，并且必须向上搜索层次结构。如果查询中的位置信息不明确，并且没有其他信息来对位置进行排名（例如用户位置或位置的相对重要性），则置信度设置为 `Medium`。例如，对“148th Ave， Bellevue”的位置查询可能会可靠地 `Medium` 返回“148th Ave SE”和“148th Ave NE”。如果查询中的位置信息未提供足够的信息来对特定位置进行地理编码，则可能会返回不太精确的位置值，并将置信度设置为 `Medium`。例如，如果提供了地址，但未找到门牌号的匹配项，则可能会返回具有路障实体类型的地理编码结果。
Low

如果置信度设置为 High，则找到了一个或多个强匹配项。多个置信度匹配按 High 重要性排名排序（如果适用）。例如，地标具有重要性，但地址不重要。

如果请求包含位置或视图，则排名可能会相应更改。例如，对“Paris”的位置查询会可靠地 High 返回“Paris， France”和“Paris， TX”。由于重要性，“法国巴黎”始终排在第一位，除非用户位置表明用户位于或非常靠近德克萨斯州巴黎，或者地图视图表明用户正在该区域进行搜索。

Medium

在某些情况下，返回的匹配项可能与请求中提供的信息不在同一级别。例如，请求可以指定地址信息，而地理编码服务可能只能匹配邮政编码。在这种情况下，如果地理编码服务具有邮政编码与数据匹配的置信度，则置信度设置为， Medium 匹配代码设置为， UpHierarchy 以指定它无法匹配所有信息，并且必须向上搜索层次结构。

如果查询中的位置信息不明确，并且没有其他信息来对位置进行排名（例如用户位置或位置的相对重要性），则置信度设置为 Medium。例如，对“148th Ave， Bellevue”的位置查询可能会可靠地 Medium 返回“148th Ave SE”和“148th Ave NE”。

如果查询中的位置信息未提供足够的信息来对特定位置进行地理编码，则可能会返回不太精确的位置值，并将置信度设置为 Medium。例如，如果提供了地址，但未找到门牌号的匹配项，则可能会返回具有路障实体类型的地理编码结果。

Low

CountryRegion

Object

名称	类型	说明
ISO	string	国家/地区的 ISO
name	string	国家/地区的名称

ErrorAdditionalInfo

Object

资源管理错误附加信息。

名称	类型	说明
info	object	其他信息。
type	string	其他信息类型。

ErrorDetail

Object

错误详细信息。

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	ErrorDetail[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

ErrorResponse

Object

错误响应

名称	类型	说明
error	ErrorDetail	错误对象。

FeatureCollectionEnum

枚举

FeatureCollection 对象的类型必须是 FeatureCollection。

值	说明
FeatureCollection

FeaturesItem

Object

名称	类型	说明
bbox	number[] (double)	边界框。使用的投影 - EPSG：3857。有关详细信息，请参阅 RFC 7946。
geometry	GeoJsonPoint	有效的 `GeoJSON Point` 几何图形类型。有关详细信息，请参阅 RFC 7946。
id	string	返回的功能的 ID
properties	Properties
type	FeatureTypeEnum	特征的类型必须是功能。

FeatureTypeEnum

枚举

特征的类型必须是功能。

值	说明
Feature

GeocodePoints

Object

一组地理编码点，这些点的计算方式及其建议的使用方式不同。

名称	类型	说明
calculationMethod	CalculationMethodEnum	用于计算地理编码点的方法。
geometry	GeoJsonPoint	有效的 `GeoJSON Point` 几何图形类型。有关详细信息，请参阅 RFC 7946。
usageTypes	UsageTypeEnum[]	最适合地理编码点。每个地理编码点都定义为 `Route` 点、`Display` 点或两者。如果要创建指向位置的路由，请使用 `Route` 点。如果在地图上显示位置，请使用 `Display` 点。例如，如果位置是公园，`Route` 点可以指定公园的入口，可以使用汽车进入，而 `Display` 点可能是指定公园中心点。

GeocodingBatchRequestBody

Object

要处理的地址地理编码查询/请求的列表。该列表最多可以包含 100 个查询，并且必须至少包含 1 个查询。

名称	类型	说明
batchItems	GeocodingBatchRequestItem[]	要处理的查询列表。

GeocodingBatchRequestItem

Object

Batch Query 对象

名称	类型	默认值	说明
addressLine	string		相对于该区域的地址的官方街道线，由地区或邮政编码属性指定。此元素的典型用途是提供街道地址或任何官方地址。当请求中包含参数时 `query` ，不应使用此参数。
adminDistrict	string		地址的国家/地区细分部分，如 WA。当请求中包含参数时 `query` ，不应使用此参数。
adminDistrict2	string		结构化地址的县，如国王。当请求中包含参数时 `query` ，不应使用此参数。
adminDistrict3	string		结构化地址的命名区域。当请求中包含参数时 `query` ，不应使用此参数。
bbox	number[] (double)		地球上的矩形区域定义为边界框对象。矩形的两侧由经度和纬度值定义。有关详细信息，请参阅位置和区域类型。指定此参数时，计算位置查询的结果时，将考虑地理区域。示例：[lon1、lat1、lon2、lat2]
coordinates	number[] (double)		地球上指定为经度和纬度的点。指定此参数时，将考虑用户的位置，并且返回的结果可能与用户更相关。示例：[lon，lat]
countryRegion	string		地理编码结果的信号 ISO 3166-1 Alpha-2 区域/国家/地区代码指定，例如 FR./ 当请求中包含参数时 `query` ，不应使用此参数。
locality	string		地址的区域部分，如西雅图。当请求中包含参数时 `query` ，不应使用此参数。
optionalId	string		将在相应 batchItem 中显示的请求的 ID
postalCode	string		地址的邮政编码部分。当请求中包含参数时 `query` ，不应使用此参数。
query	string		一个字符串，其中包含有关位置的信息，例如地址或地标名称。
top	integer (int32) minimum: 1 maximum: 20	5	将返回的最大响应数。默认值：5，最小值：1，最大值：20。
view	string	auto	一个字符串，指定 ISO 3166-1 Alpha-2 区域/国家/地区代码。这将更改地缘政治争议的边框和标签，使其与指定的用户区域保持一致。

GeocodingBatchResponse

Object

此对象是从成功的 Geocoding Batch 服务调用返回的。

名称	类型	说明
batchItems	GeocodingBatchResponseItem[]	包含批处理结果的数组。
nextLink	string	该链接指向返回的功能的下一页。如果是最后一页，则不显示此字段。
summary	Summary	批处理请求摘要

GeocodingBatchResponseItem

Object

名称	类型	说明
error	ErrorDetail	错误详细信息。
features	FeaturesItem[]
nextLink	string	该链接指向返回的功能的下一页。如果是最后一页，则不显示此字段。
optionalId	string	batchItem 的 id，该 ID 与请求中的 ID 相同
type	FeatureCollectionEnum	FeatureCollection 对象的类型必须是 FeatureCollection。

GeoJsonPoint

Object

有效的 GeoJSON Point 几何图形类型。有关详细信息，请参阅 RFC 7946。

名称	类型	说明
bbox	number[] (double)	边界框。使用的投影 - EPSG：3857。有关详细信息，请参阅 RFC 7946。
coordinates	number[] (double)	`Position` 是包含两个或多个元素的数字数组。前两个元素经度和纬度，精确按顺序排列。海拔/海拔是可选的第三个元素。有关详细信息，请参阅 RFC 7946。
type	string: Point	指定 `GeoJSON` 类型。必须是九种有效的 GeoJSON 对象类型之一 - Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon、GeometryCollection、Feature 和 FeatureCollection。

Intersection

Object

结果的地址。

名称	类型	说明
baseStreet	string	该位置的主要街道。
displayName	string	交集的完整名称。
intersectionType	string	交集的类型。
secondaryStreet1	string	第一条相交的街道。
secondaryStreet2	string	如果有，第二条相交的街道。

MatchCodesEnum

枚举

一个或多个匹配代码值，表示响应中每个位置的地理编码级别。

例如，具有匹配代码的地理编码位置 Good 和 Ambiguous 意味着为位置信息找到了多个地理编码位置，并且地理编码服务没有搜索向上层次结构来查找匹配项。

同样，具有匹配代码的地理编码位置 Ambiguous 和 UpHierarchy 意味着找不到与提供的所有位置信息匹配的地理编码位置，因此地理编码服务必须搜索层次结构并在该级别找到多个匹配项。 Ambiguous 和 UpHierarchy 结果的一个示例是提供完整的地址信息，但地理编码服务找不到街道地址的匹配项，而是返回多个 RoadBlock 值的信息。

可能的值为：

Good：该位置只有一个匹配项或所有返回的匹配项被视为强匹配项。例如，纽约的查询返回多个 Good 匹配项。

Ambiguous：位置是一组可能的匹配项之一。例如，在查询街道地址 128 Main St.时，响应可能会返回 128 北主街和 128 南主街的两个位置，因为没有足够的信息来确定要选择的选项。

UpHierarchy：位置表示向上移动的地理层次结构。如果未找到位置请求的匹配项，则会发生这种情况，因此会返回不太精确的结果。例如，如果找不到所请求地址的匹配项，则可能会返回具有 RoadBlock 实体类型的 UpHierarchy 匹配代码。

值	说明
Good
Ambiguous
UpHierarchy

Properties

Object

名称	类型	说明
address	Address	结果的地址
confidence	ConfidenceEnum	地理编码位置结果匹配的置信度级别。将此值与匹配代码一起使用，以确定有关匹配的更完整信息。地理编码位置的置信度基于许多因素，包括地理编码位置和用户位置（如果指定）的相对重要性。
geocodePoints	GeocodePoints[]	一组地理编码点，这些点的计算方式及其建议的使用方式不同。
matchCodes	MatchCodesEnum[]	一个或多个匹配代码值，表示响应中每个位置的地理编码级别。例如，具有匹配代码的地理编码位置 `Good` 和 `Ambiguous` 意味着为位置信息找到了多个地理编码位置，并且地理编码服务没有搜索向上层次结构来查找匹配项。同样，具有匹配代码的地理编码位置 `Ambiguous` 和 `UpHierarchy` 意味着找不到与提供的所有位置信息匹配的地理编码位置，因此地理编码服务必须搜索层次结构并在该级别找到多个匹配项。 `Ambiguous` 和 `UpHierarchy` 结果的一个示例是提供完整的地址信息，但地理编码服务找不到街道地址的匹配项，而是返回多个 RoadBlock 值的信息。可能的值为： `Good`：该位置只有一个匹配项或所有返回的匹配项被视为强匹配项。例如，纽约的查询返回多个 Good 匹配项。 `Ambiguous`：位置是一组可能的匹配项之一。例如，在查询街道地址 128 Main St.时，响应可能会返回 128 北主街和 128 南主街的两个位置，因为没有足够的信息来确定要选择的选项。 `UpHierarchy`：位置表示向上移动的地理层次结构。如果未找到位置请求的匹配项，则会发生这种情况，因此会返回不太精确的结果。例如，如果找不到所请求地址的匹配项，则可能会返回具有 RoadBlock 实体类型的 `UpHierarchy` 匹配代码。
type	string	下列其中一项：地址路障 RoadIntersection 附近 PopulatedPlace Postcode1 AdminDivision1 AdminDivision2 CountryRegion

Summary

Object

批处理请求摘要

名称	类型	说明
successfulRequests	integer (int32)	批处理中成功的请求数
totalRequests	integer (int32)	批处理中的请求总数

UsageTypeEnum

枚举

最适合地理编码点。每个地理编码点都定义为 Route 点、Display 点或两者。如果要创建指向位置的路由，请使用 Route 点。如果在地图上显示位置，请使用 Display 点。例如，如果位置是公园，Route 点可以指定公园的入口，可以使用汽车进入，而 Display 点可能是指定公园中心点。

值	说明
Display
Route