Method: resolveMapsUrls

将 Google 地图网址列表解析为 Google 地图上的特定地理空间实体（例如地点）。

HTTP 请求

POST https://mapstools.googleapis.com/v1alpha:resolveMapsUrls

网址采用 gRPC 转码语法。

请求正文

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

JSON 表示法 
{
  "urls": [
    string
  ]
}
字段
urls[]

string

必需。要解析的 Google 地图网址。每个网址都应是有效的 Google 地图网址，例如 https://maps.app.goo.gl/...、https://www.google.com/maps/place/... 或 https://maps.google.com/...。目前，仅支持指向单个地点的网址。您最多可以指定 20 个网址。

响应正文

针对 v1alpha.resolveMapsUrls 的响应消息。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "entities": [
    {
      object (Entity)
    }
  ],
  "failedRequests": {
    integer: {
      object (Status)
    },
    ...
  }
}
字段
entities[]

object (Entity)

仅限输出。Google 地图网址中已解析实体的列表。保证与请求 urls 指数一一对应。索引 i 处的空消息（未设置 entity）表示相应网址的解析失败。如果解析失败，请检查 failedRequests 字段中的错误状态。
failedRequests

map (key: integer, value: object (Status))

仅限输出。用于传达 Google 地图网址的部分失败情况的映射。键是 urls 字段中失败请求的索引。该值是错误状态，详细说明了解析失败的原因。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

授权范围

需要以下 OAuth 范围之一：

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