Method: mapTypes.mapTiles.lookupMapTile

返回指定地点的天气地图。

HTTP 请求

GET https://weather.googleapis.com/v1/mapTypes/{mapType}/mapTiles/{zoom}/{x}/{y}

网址采用 gRPC 转码语法。

路径参数

参数
mapType

enum (MapType)

必需。天气地图的类型。定义地图将以图形方式表示的天气事件。

允许的值:- US_PRECIPITATION_CURRENT - 美国降水量当前地图。- EU_PRECIPITATION_CURRENT - 欧盟降水量当前地图。

zoom

integer

必需。地图的缩放级别。定义地图内容在地图视图中的显示大小。

缩放级别 0 表示整个世界都显示在单个图块中。缩放级别为 1 时,整个世界使用 4 个图块渲染。缩放级别 2 是整个世界,由 16 个图块组成。缩放级别 16 是整个世界,包含 65,536 个图块。

允许的值:0-16

x

integer

必需。定义所请求图块中的东西向点。

必须是非负数。

y

integer

必需。定义所请求图块中的南北点。

必须是非负数。

请求正文

请求正文必须为空。

响应正文

表示任意 HTTP 正文的消息。它应仅用于无法表示为 JSON 的负载格式,例如原始二进制文件或 HTML 网页。

此消息可同时用于请求和响应中的流式传输和非流式传输 API 方法。

它可以用作顶级请求字段,如果想要将网址或 HTTP 模板中的参数提取到请求字段中,并且还希望访问原始 HTTP 正文,这会很方便。

示例:

message GetResourceRequest {
  // A unique request id.
  string request_id = 1;

  // The raw HTTP body is bound to this field.
  google.api.HttpBody http_body = 2;

}

service ResourceService {
  rpc GetResource(GetResourceRequest)
    returns (google.api.HttpBody);
  rpc UpdateResource(google.api.HttpBody)
    returns (google.protobuf.Empty);

}

流式传输方法示例:

service CaldavService {
  rpc GetCalendar(stream google.api.HttpBody)
    returns (stream google.api.HttpBody);
  rpc UpdateCalendar(stream google.api.HttpBody)
    returns (stream google.api.HttpBody);

}

使用此类型仅会更改请求和响应正文的处理方式,所有其他功能将继续保持不变。

如果成功,则响应为通用 HTTP 响应,其格式由方法定义。

JSON 表示法
{
  "contentType": string,
  "data": string,
  "extensions": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
字段
contentType

string

指定正文内容类型的 HTTP Content-Type 标头值。

data

string (bytes format)

作为原始二进制文件的 HTTP 请求/响应正文。

base64 编码的字符串。

extensions[]

object

应用专用响应元数据。必须在流式传输 API 的第一个响应中设置。

此对象可以包含任意类型的字段。附加字段 "@type" 包含用于标示相应类型的 URI。示例:{ "id": 1234, "@type": "types.example.com/standard/id" }。

授权范围

需要以下 OAuth 范围:

  • https://www.googleapis.com/auth/cloud-platform

MapType

天气地图的类型。定义地图将以图形方式表示的天气事件。未来可能会添加其他值。

枚举
MAP_TYPE_UNSPECIFIED 默认值。如果作为参数传递,则忽略该值。
US_PRECIPITATION_CURRENT 表示美国当前降水量地图。
EU_PRECIPITATION_CURRENT 表示欧盟降水量当前地图。