返回指定地点的天气地图。
HTTP 请求
GET https://weather.googleapis.com/v1/mapTypes/{mapType}/mapTiles/{zoom}/{x}/{y}
网址采用 gRPC 转码语法。
路径参数
| 参数 | |
|---|---|
mapType |
必需。天气地图的类型。定义地图将以图形方式表示的天气事件。 允许的值:- US_PRECIPITATION_CURRENT - 美国降水量当前地图。- EU_PRECIPITATION_CURRENT - 欧盟降水量当前地图。 |
zoom |
必需。地图的缩放级别。定义地图内容在地图视图中的显示大小。 缩放级别 0 表示整个世界都显示在单个图块中。缩放级别为 1 时,整个世界使用 4 个图块渲染。缩放级别 2 是整个世界,由 16 个图块组成。缩放级别 16 是整个世界,包含 65,536 个图块。 允许的值:0-16 |
x |
必需。定义所请求图块中的东西向点。 必须是非负数。 |
y |
必需。定义所请求图块中的南北点。 必须是非负数。 |
请求正文
请求正文必须为空。
响应正文
表示任意 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 |
指定正文内容类型的 HTTP Content-Type 标头值。 |
data |
作为原始二进制文件的 HTTP 请求/响应正文。 base64 编码的字符串。 |
extensions[] |
应用专用响应元数据。必须在流式传输 API 的第一个响应中设置。 此对象可以包含任意类型的字段。附加字段 |
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/cloud-platform
MapType
天气地图的类型。定义地图将以图形方式表示的天气事件。未来可能会添加其他值。
| 枚举 | |
|---|---|
MAP_TYPE_UNSPECIFIED |
默认值。如果作为参数传递,则忽略该值。 |
US_PRECIPITATION_CURRENT |
表示美国当前降水量地图。 |
EU_PRECIPITATION_CURRENT |
表示欧盟降水量当前地图。 |