实况天气接口/v2.2 - Revision history

XTao at 10:13, 20 May 2019

2019-05-20T10:13:36Z

Liuzhonghua: /* 示例2如下 */

2019-03-28T05:38:41Z

‎示例2如下

Mingli: /* 返回结构和说明 */

2019-02-25T11:33:37Z

‎返回结构和说明

Liuzhonghua: /* 变量说明 */

2018-12-27T08:10:17Z

‎变量说明

Liuzhonghua: /* 返回结构和说明 */

2018-12-27T08:08:10Z

‎返回结构和说明

Mingli: /* 请求样例 */

2018-12-13T07:29:53Z

‎请求样例

Mingli: Mingli moved page 实况接口/v2.2 to 实况天气接口/v2.2

2018-12-06T18:23:22Z

Mingli moved page 实况接口/v2.2 to 实况天气接口/v2.2

Liuzhonghua at 05:41, 3 December 2018

2018-12-03T05:41:09Z

Liuzhonghua at 05:40, 3 December 2018

2018-12-03T05:40:07Z

Liuzhonghua: /* 天气现象 */

2018-12-03T05:39:49Z

‎天气现象

@@ Line 30: / Line 30: @@
 unit: metric                                               # 单位制
 location: [25.1552 121.6544]                               # 经纬度
 server_time: 1443418222                                    # 服务器本次返回的utc时间戳
 tzshift: 28800                                             # 时区的偏移秒数，如东八区就是 28800 秒

@@ Line 19: / Line 19: @@
 ==== 示例2如下 ====
-<blockquote><code> <nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json?lang=en_US</nowiki> </code></blockquote><blockquote>'''语言选项 lang：'''默认为简体中文（zh_CN）、繁体中文（zh_TW）、美式英语（en_US）、英式英语（en_GB）</blockquote><blockquote>'''单位制选项 unit：'''默认为公制（metric）、科学单位体系（SI） 、英制（imperial）</blockquote><blockquote>'''时区偏移秒数 tzshift：'''默认为东八区，tzshift=28800；例如：印度东5.5区，tzshift=3600*5.5==19800，使用秒是为了支持像尼泊尔这样的差 5 小时 45 分钟的地区，它们有非整齐的偏移量</blockquote>
+<blockquote><code> <nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json?lang=en_US</nowiki> </code></blockquote><blockquote>'''语言选项 lang：'''默认为简体中文（zh_CN）、繁体中文（zh_TW）、美式英语（en_US）、英式英语（en_GB）</blockquote><blockquote>'''单位制选项 unit：'''默认为公制（metric）、科学单位体系（SI） 、英制（imperial）</blockquote><blockquote>'''时区偏移秒数 tzshift：'''默认为东八区，tzshift=28800；例如：印度东5.5区，tzshift=3600*5.5==19800，使用秒是为了支持像尼泊尔这样的差 5 小时 45 分钟的地区，它们有非整齐的偏移量；考虑了欧美夏令时。</blockquote>
 =='''返回结构和说明'''==

@@ Line 22: / Line 22: @@
 =='''返回结构和说明'''==
-<syntaxhighlight lang="javascript">
+<syntaxhighlight lang="yaml">
-{   status:ok,
+status: ok
-    api_version:v2.2,                                          // 版本号
+api_version: v2.2                                          # 版本号
-    api_status:active,                                         // 版本号状态
+api_status: active                                         # 版本号状态
-    lang:zh_CN,                                                // 语言
+lang: zh_CN                                                # 语言
-    unit:metric,                                               // 单位制
+unit: metric                                               # 单位制
-    result:{
+location: [25.1552 121.6544]                               # 经纬度
-        status:ok,                                             // 实况模块返回状态
+placename: "崁脚里"                                         # 经纬度处地址
-        temperature:28.0,                                          // 温度
+server_time: 1443418222                                    # 服务器本次返回的utc时间戳
-        pres: 100991.3,                                            // 气压
+tzshift: 28800                                             # 时区的偏移秒数，如东八区就是 28800 秒
-        humidity:0.92,                                             // 相对湿度
+result:
-        wind:{direction:25.33,                                     // 风向，单位是度。正北方向为0度，顺时针增加到360度。
+    status:  ok                                            # 实况模块返回状态
-              speed:83.3},                                         // 风速，米制下是公里每小时
+    temperature: 28.0                                      # 温度
-        precipitation:{ nearest:{status:ok,
+    pres:  100991.3                                        # 气压
-                                 distance:0.77,                    // 最近的降水带距离
+    humidity: 0.92                                         # 相对湿度
-                                 intensity:0.3125},                // 最近的降水带降水强度（单位为雷达降水强度）
+    wind:
-                        local:{status:ok,
+        direction: 25.33                                   # 风向，单位是度。正北方向为0度，顺时针增加到360度。
-                               intensity:0.2812,                   // 本地降水强度（单位为雷达降水强度）
+        speed: 83.3                                        # 风速，米制下是公里每小时
-                               datasource:radar} },                // 本地降水观测的数据源（radar，GFS）
+    precipitation:
-        cloudrate:0.51,                                            // 云量
+        nearest:
-        dswrf: 8.3,                                                // 向下短波辐射通量
+            status: ok
-        visibility: 8.3,                                            // 能见度
+            distance: 0.77                                 # 最近的降水带距离
+            intensity: 0.3125                              # 最近的降水带降水强度（单位为雷达降水强度）
-        skycon:RAIN,                                               // 主要天气现象
+        local:
-        comfort: {                                                 // 舒适度指数及其自然语言描述
+            status: ok
-            index: 7,
+            intensity: 0.2812                              # 本地降水强度（单位为雷达降水强度）
-            desc: 冷},
+            datasource: radar                              # 本地降水观测的数据源（radar，GFS）
-        ultraviolet: {                                             // 紫外线指数及其自然语言描述
+    cloudrate: 0.51                                        # 云量
-           index: 0,
+    dswrf:  8.3                                            # 向下短波辐射通量
-           desc: 无},
+    visibility:  8.3                                       # 能见度
+    skycon: RAIN                                           # 主要天气现象
-        pm25: 18,                                                  // pm25，质量浓度值
+    comfort:                                               # 舒适度指数及其自然语言描述
-        pm10: 46,                                                  // pm10，质量浓度值
+        index: 7
-        o3: 47,                                                    // 臭氧，质量浓度值
+        desc: 冷
-        no2: 14,                                                   // 二氧化氮，质量浓度值
+    ultraviolet:                                           # 紫外线指数及其自然语言描述
-        so2: 1,                                                    // 二氧化硫，质量浓度值
+       index: 0
-        co: 0.3,                                                   // 一氧化碳，质量浓度值
+       desc: 无
-        aqi: 46,                                                   // AQI（国标）
+    pm25: 18                                               # pm25，质量浓度值
-    },
+    pm10: 46                                               # pm10，质量浓度值
-    location:[25.1552,
+    o3:  47                                                # 臭氧，质量浓度值
-.6544],                                       // 经纬度
+    no2: 14                                                # 二氧化氮，质量浓度值
-    placename	"崁脚里"，                                     // 经纬度处地址
+    so2: 1                                                 # 二氧化硫，质量浓度值
-    server_time:1443418222,                                    // 服务器本次返回的utc时间戳
+    co: 0.3                                                # 一氧化碳，质量浓度值
-    tzshift:28800,                                             // 时区的偏移秒数，如东八区就是 28800 秒
+    aqi: 46                                                # AQI（国标）
 </syntaxhighlight>

@@ Line 134: / Line 134: @@
 |-
 ! PM25浓度
-| $.result.pm25 || PM25浓度(μg/m3) || 实况 || 大陆、港澳台、印度 || PM25浓度
+| $.result.pm25 || PM25浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || PM25浓度
 |-
 ! PM10浓度
-| $.result.pm10 || PM10浓度(μg/m3) || 实况 || 大陆、港澳台、印度 || PM10浓度
+| $.result.pm10 || PM10浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || PM10浓度
 |-
 ! 臭氧浓度
-| $.result.o3 || 臭氧浓度(μg/m3) || 实况 || 大陆、港澳台、印度 || 臭氧浓度
+| $.result.o3 || 臭氧浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 臭氧浓度
 |-
 ! 二氧化氮浓度
-| $.result.no2 || 二氧化氮浓度(μg/m3) || 实况 || 大陆、港澳台、印度 || 二氧化氮浓度
+| $.result.no2 || 二氧化氮浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 二氧化氮浓度
 |-
 ! 二氧化硫浓度
-| $.result.so2 || 二氧化硫浓度(μg/m3) || 实况 || 大陆、港澳台、印度 || 二氧化硫浓度
+| $.result.so2 || 二氧化硫浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 二氧化硫浓度
 |-
 ! 一氧化碳浓度
-| $.result.co || 一氧化碳浓度(mg/m3) || 实况 || 大陆、港澳台、印度 || 一氧化碳浓度
+| $.result.co || 一氧化碳浓度(mg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 一氧化碳浓度
 |-
 ! AQI
-| $.result.aqi || 国标AQI || 实况 || 大陆、港澳台、印度 || 国标AQI
+| $.result.aqi || 国标AQI || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 国标AQI
 |}
 {{天气现象}}

@@ Line 54: / Line 54: @@
             desc: 无},
-         pm25: 18,                                                  // pm25值
+         pm25: 18,                                                  // pm25，质量浓度值
-         pm10: 46,                                                  // pm10值
+         pm10: 46,                                                  // pm10，质量浓度值
-         o3: 47,                                                    // 臭氧值
+         o3: 47,                                                    // 臭氧，质量浓度值
-         no2: 14,                                                   // 二氧化氮值
+         no2: 14,                                                   // 二氧化氮，质量浓度值
-         so2: 1,                                                    // 二氧化硫值
+         so2: 1,                                                    // 二氧化硫，质量浓度值
-         co: 0.3,                                                   // 一氧化碳值
+         co: 0.3,                                                   // 一氧化碳，质量浓度值
          aqi: 46,                                                   // AQI（国标）
      },

← Older revision	Revision as of 18:23, 6 December 2018
(No difference)

@@ Line 154: / Line 154: @@
 | $.result.aqi || 国标AQI || 实况 || 大陆、港澳台、印度 || 国标AQI
 |}
 =='''生活指数'''==

@@ Line 155: / Line 155: @@
 |}
-=='''天气现象'''==
+{{天气|天气现象=}}
 =='''生活指数'''==