天气地图API

天气地图API提供全球天气预报,雷达和卫星数据作为与常用地图服务(例如开放式街道地图或Google Map)兼容的地图图块。所有必需的和可选参数分别为路径和查询参数。要获得图像,必须首先使用有效的凭据请求访问令牌。然后可以使用访问令牌来获取功能响应,其中包含有关如何获取图像的信息。

可以将访问令牌作为查询参数或授权标题提供给API调用。

授权后

授权端点用于获取API访问的代币。令牌是一次性的,仅应用于一次会话。用户和密码必须保持秘密,并且必须从受信任的来源执行此请求。授权响应中给出了几秒钟内的令牌寿命。

参数

必需的

姓名

例子

描述

用户

应用程序密钥用户名

密码

应用程序密码

例子

URL
授权/令牌
回复
{ "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOlwvXC9mbnc2LmZvcmVjYS5jb21cL2F1dGhvcml6ZVwvdG9rZW4iLCJpYXQiOjE1MjYzMDAzODAsImV4cCI6MTUyNjMwMzk4MCwibmJmIjoxNTI2MzAwMzgwLCJqdGkiOiJxSXl3WVlQNjc1NkczejBEIiwic3ViIjoibFFHa1Y4Z2pIeGUyZU1ibndUUUs4NktqVTY3RXJlS2htenY1IiwicHJ2IjoiYWY3YTAzOThkZGNiNWE3YTUzN2Q3YzdkMjU2NWEyZjgxZGM4ZTQxNCJ9.V8xg6L9yrY9__VH-jdrL_CqXisEpgcfdUa0NoxlGz0k", "expires_in": 86400, "token_type": "bearer" }

GetCapabilities

功能端点用于获取层元数据。该元数据用于执行图像查询。功能响应提供了图层信息,例如描述,时间和空间扩展以及可用的配色方案。图像是可以呈现为PNG或SVG等图像格式的图层。

当前的时间元素中的数据属性是最近可用时间的索引。图像产品可能具有其他可以选择指定的配色方案。

参数

必需的

姓名

例子

描述

令牌

授权端点提供的访问令牌。

例子

URL
API/V1/功能
回复
{“图像”:[{“ title”:“单元格沉淀”,“描述”:“具有更复杂的对流可视化降水”,“格式”:[“ image/png”],“ colorschemes”:[default'', "csdata-blue" ], "extent": { "minLat": -79.1709976196289, "maxLat": 79.1709976196289, "minLon": -180, "maxLon": 180, "maxZoom": 11, "minZoom": 3},“ times”:{“更新”:“ 2017-01-01T00:00:00:00 Z”,“可用”:[“ 2017-09-09-01T03:00:00:00 Z”“],“ current”:1},“ id”:1},{“ title”:“风符号”,“描述”:“传统风符号”,“格式”:[“ Image/svg+xml”],“ colorChemes”:[“默认”,“ data -pt”],“范围”:{“ minlat”:-79.1709976196289,“ maxlat”:79.1709976196289,“ Minlon”“:11,“ minzoom”:3},“ times”:{“更新”:“ 2017-01-01T00:00:00:00 Z”,“可用”:[2017-09-09-18T06:00:00:00:00:00:2017-09-18T07:00:00z“],“当前”:0},“ ID”:2}]}

GetTile

图块端点用于获得给定层和配色方案的天气图图块。

参数

必需的

姓名

例子

描述

ID

层ID。

X

74

x索引的索引。

y

34

Y索引的索引。

z

7

请求的瓷砖的缩放级别。

时间

UTC时间戳值以获取以ISO 8601格式检索的数据。必须出现在可用的时间列表中。

令牌

授权端点提供的访问令牌。

可选的

姓名

例子

描述

Colorscheme

默认

层配色方案。必须出现在功能端点返回的配色方案列表中。

例子

H5 class =“ editor-h5”>URL
api/v1/image/tile/{z}/{x}/{y}/{time}/{id}
回复

Gettile响应

Getlegend

图例端点用于获得配色方案的图像图像。

参数

必需的

姓名

例子

描述

Colorscheme

配色方案ID。必须出现在功能端点返回的配色方案列表中。

ID

层ID。

令牌

授权端点提供的访问令牌。

例子

URL
API/V1/Legend/{Colorscheme}/{ID}
回复

GetLegend响应

getusage

用法端点用于获取请求统计信息。端点可用于监视API使用情况。

响应包含代表每种产品总命中的元素,并将其合并为每日总数。

参数

必需的

姓名

例子

描述

令牌

授权端点提供的访问令牌。

可选的

姓名

例子

描述

开始日期

以ISO格式提取统计信息的日期。

结束日期

统计信息以ISO格式获取的结束日期。

例子

URL
API/V1/用法
回复
[{“ product”:“信息请求”,“ date”:“ 2019-01-08”,“ hits”:3},{“ product”:“ layer 2”,“ date”:“ 2019-01-08“,“ hits”:37},{“ product”:“ layer 4”,“ date”:“ 2019-01-08”,“ hits”:85},{“ product”:“ figend'Ligend'Effault for Layer'2“,“ date”:“ 2019-01-08”,“ hits”:1},{“ product”:“ figend'default'for Layer 4“”,“ date”:“ 2019-01-08”,“”,“hits“:1},{“ product”:“统计请求”,“ date”:“ 2019-01-08”,“ hits”:2}]

天气地图API

天气地图API提供天气预报和观察值,作为全球地图叠加层。降水雷达图像,大气天气预测和卫星图像通常显示为地图覆盖。Vaisala通过其天气地图API提供地图覆盖图像。叠加层主要是与最常见的地图服务兼容的瓷砖,例如Google Map和OpenStreetMap。背景地图也可用。