Method: resolveNames

将地点名称(或地址)列表解析为 Google 地图上的特定地理空间实体(例如地点)。

HTTP 请求

POST https://mapstools.googleapis.com/v1:resolveNames

网址采用 gRPC 转码语法。

请求正文

请求正文中包含结构如下的数据:

JSON 表示法
{
  "queries": [
    {
      object (LocationQuery)
    }
  ],
  "locationBias": {
    object (LocationBias)
  },
  "regionCode": string
}
字段
queries[]

object (LocationQuery)

必需。要解析的位置查询列表。您最多可以指定 20 个查询。

locationBias

object (LocationBias)

可选。一个可选区域,用于使解析结果偏向于该区域。如果指定,解析结果将偏向于更靠近此区域的实体。添加 locationBias 或 regionCode 通常可以缩小搜索范围,从而提供更好的结果。

如果同时指定了 locationBias 和 regionCode,则 locationBias 优先于 regionCode。

regionCode

string

可选。一个可选的地区代码,用于使解析结果偏向于特定地区。如果指定了此参数,则解析结果将偏向于位于指定区域内或附近的实体。这应该是 CLDR 地区代码。例如,“US”或“CA”。添加 locationBias 或 regionCode 通常可以缩小搜索范围,从而提供更好的结果。

如果同时指定了 locationBias 和 regionCode,则 locationBias 优先于 regionCode。

响应正文

如果成功,则响应正文包含一个 ResolveNamesResponse 实例。

授权范围

需要以下 OAuth 作用域:

  • https://www.googleapis.com/auth/maps-platform.mapstools