详细的天气API

天气API基于发送到Vaisala服务器的HTTP查询。
位置由LAT/LON坐标标识。答复是JSON,XML或界定的ASCII原始数据,这是独立的。

客户必须通过中央代理服务器从最终用户/设备中继查询。

Vaisala将仅针对指定的代理服务器IP地址开放访问查询接口。
该服务还假定查询的随机分布,即不允许使用天气API进行批处理模式查询,以查询繁忙的循环中大量位置。

任何批次模式查询都应包括查询(1 qps)之间的1 s延迟
超过10个QPS批次查询帐户可以在没有预先通知的情况下进行限制。

提供的天气数据

现在的情况

当前条件:最近报告数据的最接近相关天气观测站的数据

如果在给定坐标的100公里内没有最近的观察结果,则不会报告当前情况。
Vaisala提供了免费的GIF/PNG图像,用于可视化天气代码。

车站报告的当前状况参数

  • 观察站名称 - 例如“伦敦希思罗”
  • 距离 - 距离观测站距离所选位置的距离,例如“ 8 km ne”
  • 观察时间 - 观察时间是在当地时间进行的
  • 摄氏或华氏度的温度
  • 摄氏或华氏度的感觉般的温度
  • 图形符号代码 - 例如“ D420”
  • M/s,结,km/h或英里/h的风速
  • 风向(N,NE,E,...)
  • HPA的压力,例如“ 1012”
  • 百分比的相对湿度,例如“ 87”
  • 可见性,例如10公里的“ 10000”

详细的简短预测

详细的简短预测:包含几个时间步长的日内详细信息

  • 有一个小时,3小时,6小时的间隔
  • Vaisala提供了免费的GIF/PNG图像,用于可视化天气代码
  • 建议预测长度长达两天

每日概述预测

每日概述预测:包含一天的摘要数据

  • 建议预测长度长达7天
  • Vaisala提供了免费的GIF/PNG图像,用于可视化天气代码
  • 天气参数限制为:
    • 图形符号代码
    • 摄氏或华氏度的最小温度

选项

天气API可以配置具有额外的for fore GeoLocation功能。启用地理位置功能可以在天气数据的答复中添加其他名称属性,以便除了天气数据外,还可以为最终用户提供有意义的位置名称。

如何显示归因?

所有使用任何天气API,天气地图API或其他Vaisala原始数据供稿包的产品都必须通过以下短语之一显示对天气信息附近Vaisala的归因,或者是适当的翻译:“由Vaisala供电”,“天气数据”由Vaisala提供,“天气数据来源:Vaisala”。如果可能,文本“ Vaisala”应由此处可用的图形图像之一代替。有关详细说明,请参见文档Vaisala徽标和归因要求。

查询示例

笔记:回复解析必须能够应对将来可能出现在API中的新天气参数,即划界ASCII中的新JSON键,XML标签或新列。

每日概述查询

API查询两天的预测

https:// host/data?lon = 24.97&lat = 60.32&ftimes = 48/24H&tz =欧洲/helsinki&format&format = json/[your-api-key]

API响应

{“ loc”:[{“ obs”:{“ station”:“ helsinki kumpula”,“ dist”:“ 2 km s”,“ dt”:“ 2020-10-22 09:20:20:20:00”,“ T“:“ 9”,“ TF”:“ 7”,“ S”:“ D410”,“ WN”:“ SE”,“ WS”:“ 5”,“ P”:“ 998.5”,“ RH”:“ 97”,“ v”:“ 6610”},“ fc”:[{“ dt”:“ 2020-10-22”,“ S”:“ D430”,“ TX”:“ 11”,“ TN”:“ 8”,“ pr”:“ 14.83”,“ WSX”:“ 6”},{“ dt”:“ 2020-10-23”,“ S”:“ D220”,“ TX”:“ 11”,“ tn”:“ 1”,“ pr”:“ 5.91”,“ WSX”:“ 6”}]}]}}}

简短的预测查询

API查询两个小时的预测

https:// host/data?lon = 24.97&lat = 60.32&ftimes = 2/1H&tz =欧洲/helsinki&format&format = json/[your-api-key]

API响应

{“ loc”:[{“ obs”:{“ station”:“ helsinki-vantaa”,“ dist”:“ 1 km nw”,“ dt”:“ 2020-10-22 09:49:00”,“t“:“ 9”,“ TF”:“ 6”,“ S”:“ D430”,“ WN”:“ SE”,“ WS”:“ 5”,“ P”:“ 998.2”,“ RH”:“ 98”,“ v”:“ 3879”},“ fc”:[{“ dt”:“ 2020-10-22 10:00”,“ s”:“ d430”,“ t”:“ t”:“ 8”“”,“ tf”:“ 5”,“ WS”:“ 5”,“ WN”:“ S”,“ PP”:“ 99”,“ PR”:“ 2.06”},{“ dt”:“ 2020-10-22 11:00“,“ S”:“ D430”,“ T”:“ 8”,“ TF”:“ 6”,“ WS”:“ 5”,“ WN”:“ S”,“ PP“:“ 99”,“ pr”:“ 2.45”}]}]}}

在一次通话中要求几个预测间隔

可以在一个API呼叫中要求每小时和每日预测。以下请求

http:// host/data?lon = 24.97&lat = 60.22&ftimes = 24/1H,120/24H&格式= json/[your_api_key]&tempunit = c&windunit = ms

在接下来的24小时内的每小时预测以及接下来5天的每日预测。作为响应,这些预测间隔是在单独的JSON键(FC1,FC2,...)下发现的。

API查询搜索位置

API查询搜索位置

https:// host/search?q = new%20york&format = json/[your-api-key]

API响应

{“ searchResults”:{“ query”:“纽约”,“ loc”:[{“ id”:“ 105128581”“名称”:“纽约市”,“纽约”,“乡村”:“美国”,“ TZ”:“美国\/new_york”,“ lon”:“  -  74.005973816”,“ lat”:“ 40.714267731”},{“ id”:“ 105128616”,“ 105128616”,“名称”:“ new York Mills”:“ New York Mills”,“乡村”:“”:“”:“”:“”:“”美国”,“ tz”:“美国\/new_york”,“ lon”:“  -  75.291275024”,“ lat”:“ 43.105346680”},{“ id”:“ 105039192”“,“乡村”:“美国”,“ tz”:“美国\/north_dakota \/中心”,“ lon”:“  -  95.3761444409”,“ lat”:“ 46.518016815”}}}}}}}}

从结果列表中选择位置,然后使用其“ ID”请求天气数据以进行位置:

http:// host/data?l = 105128581&ftimes = 48/24H&格式= json/[your_api_key]&tempunit = c&windunit = ms&tz =

响应解释

准备处理缺失的当前状况(观察)信息,因为缺少仪器或仪器故障可能会影响数据。任何参数值都可能丢失/空,甚至整个obs键(在json中),标签(in xml)或obsh/obs cow(在文本中)可能会丢失,请尝试lon = 0&lat = 0,以获取示例。如果缺少数据,建议简单地调整布局,以便显示空白。诸如“无数据”之类的文本通常被最终用户解释为服务故障,情况并非如此。

预测参数/行将始终存在,因此缺少的值处理不需要像当前条件一样坚固。只有在存在真正的技术问题的情况下,才能缺少预测。

所需的查询参数

  • LON-小数度的位置的经度
  • LAT-小数度的位置的纬度

或者

  • ID -Vaisala位置ID
  • 格式 - 回复格式,为每个客户提供专用格式名称,“ JSON/StandardFeed”和“ XML/StandardFeed”作为上述示例。可以创建自定义格式。

可选查询参数

  • alt-海拔高度以上的海拔米,例如2148米的“ 2148”。默认情况下,高度是根据给定坐标的数值天气预测(NWP)模型值估算的,这可能会导致山区的错误。提供实际高度将使天气API预测引擎能够在高度变化较大的位置进行更好的温度预测。在层面上,利益可以忽略不计。
  • tempunit-摄氏或华氏的“ c”或“ f”,默认为摄氏
  • Windunit-要么“ MS”,“ KTS”,“ KMH”或“ MPH”,用于m/s,结,km/h或Miles/h,默认为m/s
  • TZ-响应时间戳的POSIX格式化时区字符串,例如“ UTC”或“欧洲/赫尔辛基”。如果没有给出,则时区是从坐标近似的,这可能会导致时区边界附近的错误。
  • ftimes-(仅标准/高级软件包)在每日概述模式下以小时为单位,每小时24小时的间隔开关的长度/逐步间隔。例如。“ 72/24H”在接下来的三天中返回每日概述,“ 48/3H”将在接下来的两天内返回三小时的预测,而“ 12/1h”返回接下来的12小时的每小时预测。建议的间隔为:1、3、6、24。最大预测长度为10天。可选的第一个预测时间可以在ftimes参数中给出,有关详细信息(*),请参见下文。

(*)使用ftimes查询参数指定第一个时间段

有两种格式:

ftimes =长度/时间段
ftimes =长度/timeStep/firstStep

格式1使用默认值来确定第一个预测的时间。在格式2中,第一步参数修改了第一个预测的时间。对于每日摘要预测(X/24H类型),它被解释为午夜之前的小时数,默认值为11。对于每小时预测,它被解释为从现在到第一个预测时间步长的最小小时数,默认值为0。 例子:

ftimes = 72/24H-默认值,下午1点,即13:00切换日期
ftimes = 72/24H/11-与默认值相同,在午夜前11小时切换日期
ftimes = 72/24H/3-在晚上9点切换日期(午夜前3小时)
ftimes = 72/24H/0-切换日期
ftimes = 72/24h/-6-显示昨天的预测到凌晨6点

ftimes = 12/1h-默认,每小时预测从现在开始十二小时
ftimes = 12/1H/0-与默认值相同,每小时预测,从现在起,首次阶段零小时
ftimes = 12/1H/6-每小时预测12个小时,从现在开始六个小时,即结束18小时

请注意,当地时间的时区计算是近似的。

响应参数

  • DT-观察/预测时间戳,对于每日概述DT仅包含日期部分。除非在查询参数中提供,否则对于天气API的预测,时区是一个近似区域,可能是不准确的近时区域边界。使用预释放ID时,时区是准确的。对于观察(观察标签),时间始终在观察站的当地时间。
  • 站 - 观察站名称 - 例如“柏林Tegelhof”
  • 距离 - 到与给定坐标的观测站的距离,以英语为例,以风向以风向。“ 8 km ne”
  • P- HPA的压力,例如“ 1012”
  • V-可见性,例如10公里的“ 10000”
  • T-空气温度(默认单元:摄氏)
  • TX -24小时最高温度(默认单元:Celsius)(每日摘要数据)
  • TN -24h最低温度(默认单元:摄氏)(每日摘要数据)
  • TF-所谓的感觉般的温度(默认单元:摄氏),这是NOAA/NWS组合的“仅面部”风冷索引和Rothfusz热量指数,它考虑了风和湿度的冷却和加热效果
  • RH-百分比的相对湿度,范围从0到100
  • PP-降水的概率为百分比,范围从0到100
  • TP-百分比的雷声概率从0到100不等
  • PR - 累积降水(默认单位:毫米)。例外:如果要求15分钟的步骤“ PR”是雨的强度(单位:毫米 /小时)。
  • WS- 10分钟的平均风速(默认单元:M/s)
  • WSX- 10分钟平均风速的每日最大(默认单元:m/s)
  • WSA-每日平均风速的平均风速(默认单元:m/s)
  • WN-风向字符串,N,NE,E,SE,S,S,SW,W,NW
  • S-符号代码(请参阅中的解释https://corporate.foreca.com/en/resources/foreca-symbols
  • C-百分比的云云范围从0到100
  • CA-白天的平均浑浊百分比,范围从0到100
  • ST-符号代码作为文本,使用lang参数控制输出语言
  • 上升 - 当地时间24h时钟表示法的日出时间
  • 设置 - 当地时间24h时钟表示法的日落时间
  • UV-基于全局臭氧预测模型的UV指数(1-2 =低,3-5 =中度,6-7 =高,8-10 =非常高,11+=极端)注意:最大5天预报可用
  • DL-几分钟内的一天长度

请注意,将来可能会使用新数据升级天气API。这意味着您的应用程序必须解析响应,以便如果参数的顺序更改或出现新参数,则不会破坏。

天气API

天气API向世界上每个坐标点提供高质量的天气预报。具有超本地预测的接口适合将天气条件集成到移动应用程序,Web应用程序或任何其他应用程序中。