如何使用Weather Underground的API获取国内城市的天气状况

天南地北客

使用ESP8266+Arduino开发板制作一个微型气象站，是一件非常酷的事情。在本论坛里面也已经有很多帖子在讨论如何制作。在这些帖子中，无一例外，都是使用Weather Underground提供的API来获取天气，该网站提供的功能非常强大，几乎可以包含全球所有城市的天气情况。如果您还不会制作气象站，那么可以参考以下几个帖子：

●   Arduino Tian开发板：一个功能强大的天气预报中心：https://www.yiboard.com/thread-716-1-1.html

●   使用ESP8266制作一个微型气象站：https://www.yiboard.com/thread-701-1-1.html

●   非常酷的ESP8266 WiFi OLED微型气象站套件：https://www.yiboard.com/thread-756-1-1.html

最近有一些网友给我发消息，说他们无法使用Weather Underground的API来获取国内城市的天气状况，我在这里整理以下解决方法，供大家参考。

首先，在Weather Underground网址注册成功后，就会获得一个免费的API密钥。通过在您的浏览器中按照下列格式输入URL，就会形成一个到Wunderground的API：

1. http://api.wunderground.com/api/YOUR_API_KEY/conditions/q/THE_DESIRED_STATE/THE_DESIRED_CITY.json

复制代码

例如，要获得加利福尼亚旧金山的天气：

●    http://api.wunderground.com/api/ ... /San_Francisco.json

或者是悉尼的天气

●    http://api.wunderground.com/api/Your_Key/geolookup/conditions/forecast/q/Australia/Sydney.json

我们来看一下返回的响应内容。如果正确的话，就会返回一个带有current_observation标识的字段：

1. {
   
2.   "response": {
   
3.   "version":"0.1",
   
4.   "termsofService":"http://www.wunderground.com/weather/api/d/terms.html",
   
5.   "features": {
   
6.   "conditions": 1
   
7.   }
   
8.         }
   
9.   ,        "current_observation": {
   
10.                 "image": {
    
11.                 "url":"http://icons.wxug.com/graphics/wu2/logo_130x80.png",
    
12.                 "title":"Weather Underground",
    
13.                 "link":"http://www.wunderground.com"
    
14.                 },
    
15.                 "display_location": {
    
16.                 "full":"Sydney, Australia",
    
17.                 "city":"Sydney",
    
18.                 "state":"NSW",
    
19.                 "state_name":"Australia",
    
20.                 "country":"AU",
    
21.                 "country_iso3166":"AU",
    
22.                 "zip":"00000",
    
23.                 "magic":"16",
    
24.                 "wmo":"94768",
    
25.                 "latitude":"-33.86999893",
    
26.                 "longitude":"151.21000671",
    
27.                 "elevation":"3.0"
    
28.                 },
    
29.                 "observation_location": {
    
30.                 "full":"Sydney, NEW SOUTH WALES",
    
31.                 "city":"Sydney",
    
32.                 "state":"NEW SOUTH WALES",
    
33.                 "country":"AU",
    
34.                 "country_iso3166":"AU",
    
35.                 "latitude":"-33.88",
    
36.                 "longitude":"151.22",
    
37.                 "elevation":"79 ft"
    
38.                 },
    
39.                 "estimated": {
    
40.                 },
    
41.                 "station_id":"INEWSOUT349",
    
42.                 "observation_time":"Last Updated on May 5, 11:38 AM AEST",
    
43.                 "observation_time_rfc822":"Sat, 05 May 2018 11:38:24 +1000",
    
44.                 "observation_epoch":"1525484304",
    
45.                 "local_time_rfc822":"Sat, 05 May 2018 11:38:50 +1000",
    
46.                 "local_epoch":"1525484330",
    
47.                 "local_tz_short":"AEST",
    
48.                 "local_tz_long":"Australia/Sydney",
    
49.                 "local_tz_offset":"+1000",
    
50.                 "weather":"Clear",
    
51.                 "temperature_string":"68.4 F (20.2 C)",
    
52.                 "temp_f":68.4,
    
53.                 "temp_c":20.2,
    
54.                 "relative_humidity":"39%",
    
55.                 "wind_string":"From the East at 1.8 MPH Gusting to 2.5 MPH",
    
56.                 "wind_dir":"East",
    
57.                 "wind_degrees":98,
    
58.                 "wind_mph":1.8,
    
59.                 "wind_gust_mph":"2.5",
    
60.                 "wind_kph":2.9,
    
61.                 "wind_gust_kph":"4.0",
    
62.                 "pressure_mb":"1027",
    
63.                 "pressure_in":"30.33",
    
64.                 "pressure_trend":"0",
    
65.                 "dewpoint_string":"42 F (6 C)",
    
66.                 "dewpoint_f":42,
    
67.                 "dewpoint_c":6,
    
68.                 "heat_index_string":"NA",
    
69.                 "heat_index_f":"NA",
    
70.                 "heat_index_c":"NA",
    
71.                 "windchill_string":"NA",
    
72.                 "windchill_f":"NA",
    
73.                 "windchill_c":"NA",
    
74.                 "feelslike_string":"68.4 F (20.2 C)",
    
75.                 "feelslike_f":"68.4",
    
76.                 "feelslike_c":"20.2",
    
77.                 "visibility_mi":"N/A",
    
78.                 "visibility_km":"N/A",
    
79.                 "solarradiation":"470",
    
80.                 "UV":"-1","precip_1hr_string":"0.00 in ( 0 mm)",
    
81.                 "precip_1hr_in":"0.00",
    
82.                 "precip_1hr_metric":" 0",
    
83.                 "precip_today_string":"0.00 in (0 mm)",
    
84.                 "precip_today_in":"0.00",
    
85.                 "precip_today_metric":"0",
    
86.                 "icon":"clear",
    
87.                 "icon_url":"http://icons.wxug.com/i/c/k/clear.gif",
    
88.                 "forecast_url":"http://www.wunderground.com/global/stations/94768.html",
    
89.                 "history_url":"http://www.wunderground.com/weatherstation/WXDailyHistory.asp?ID=INEWSOUT349",
    
90.                 "ob_url":"http://www.wunderground.com/cgi-bin/findweather/getForecast?query=-33.876339,151.216187",
    
91.                 "nowcast":""
    
92.         }
    
93. }

复制代码

这对于大多数城市来说是可以实现的。那么国内的城市怎么获取呢？以楼主所在的城市为例，将上述API的城市修改为中国石家庄。于是API网址变成如下：

1. http://api.wunderground.com/api/0def10027afaebb7/conditions/q/China/Shijiazhuang.json

复制代码

让我们来看一下返回的内容：

1. 
   
2. {
   
3.   "response": {
   
4.   "version":"0.1",
   
5.   "termsofService":"http://www.wunderground.com/weather/api/d/terms.html",
   
6.   "features": {
   
7.   "conditions": 1
   
8.   }
   
9.                 , "results": [
   
10.                 {
    
11.                 "name": "Shijiazhuang",
    
12.                 "city": "Shijiazhuang",
    
13.                 "state": "13",
    
14.                 "country": "CI",
    
15.                 "country_iso3166":"CN",
    
16.                 "country_name":"China",
    
17.                 "zmw": "00000.137.53698",
    
18.                 "l": "/q/zmw:00000.137.53698"
    
19.                 }
    
20.                 ,
    
21.                 {
    
22.                 "name": "Shijiazhuang",
    
23.                 "city": "Shijiazhuang",
    
24.                 "state": "14",
    
25.                 "country": "CI",
    
26.                 "country_iso3166":"CN",
    
27.                 "country_name":"China",
    
28.                 "zmw": "00000.481.WZBYC",
    
29.                 "l": "/q/zmw:00000.481.WZBYC"
    
30.                 }
    
31.                 ,
    
32.                 {
    
33.                 "name": "Shijiazhuang",
    
34.                 "city": "Shijiazhuang",
    
35.                 "state": "32",
    
36.                 "country": "CI",
    
37.                 "country_iso3166":"CN",
    
38.                 "country_name":"China",
    
39.                 "zmw": "00000.414.58144",
    
40.                 "l": "/q/zmw:00000.414.58144"
    
41.                 }
    
42.                 ,
    
43.                 {
    
44.                 "name": "Shijiazhuang",
    
45.                 "city": "Shijiazhuang",
    
46.                 "state": "33",
    
47.                 "country": "CI",
    
48.                 "country_iso3166":"CN",
    
49.                 "country_name":"China",
    
50.                 "zmw": "00000.311.58660",
    
51.                 "l": "/q/zmw:00000.311.58660"
    
52.                 }
    
53.                 ,
    
54.                 {
    
55.                 "name": "Shijiazhuang",
    
56.                 "city": "Shijiazhuang",
    
57.                 "state": "36",
    
58.                 "country": "CI",
    
59.                 "country_iso3166":"CN",
    
60.                 "country_name":"China",
    
61.                 "zmw": "00000.450.58527",
    
62.                 "l": "/q/zmw:00000.450.58527"
    
63.                 }
    
64.                 ,
    
65.                 {
    
66.                 "name": "Shijiazhuang",
    
67.                 "city": "Shijiazhuang",
    
68.                 "state": "41",
    
69.                 "country": "CI",
    
70.                 "country_iso3166":"CN",
    
71.                 "country_name":"China",
    
72.                 "zmw": "00000.420.57181",
    
73.                 "l": "/q/zmw:00000.420.57181"
    
74.                 }
    
75.                 ,
    
76.                 {
    
77.                 "name": "Shijiazhuang",
    
78.                 "city": "Shijiazhuang",
    
79.                 "state": "42",
    
80.                 "country": "CI",
    
81.                 "country_iso3166":"CN",
    
82.                 "country_name":"China",
    
83.                 "zmw": "00000.251.58402",
    
84.                 "l": "/q/zmw:00000.251.58402"
    
85.                 }
    
86.                 ,
    
87.                 {
    
88.                 "name": "Shijiazhuang",
    
89.                 "city": "Shijiazhuang",
    
90.                 "state": "62",
    
91.                 "country": "CI",
    
92.                 "country_iso3166":"CN",
    
93.                 "country_name":"China",
    
94.                 "zmw": "00000.335.52996",
    
95.                 "l": "/q/zmw:00000.335.52996"
    
96.                 }
    
97.                 ,
    
98.                 {
    
99.                 "name": "Shijiazhuang",
    
100.                 "city": "Shijiazhuang",
     
101.                 "state": "64",
     
102.                 "country": "CI",
     
103.                 "country_iso3166":"CN",
     
104.                 "country_name":"China",
     
105.                 "zmw": "00000.405.53810",
     
106.                 "l": "/q/zmw:00000.405.53810"
     
107.                 }
     
108.                 ]
     
109.         }
     
110. }

复制代码

从回复的内容中可以看出，并没有current_observation的字段，而是带有Result的字段。那么这表示什么意思呢。在这里，我们先引用以下官网中的描述：

Ambiguous Results

When the API location query does not produce an exact location match, a results array will be present in the JSON response.
http://api.wunderground.com/api/Your_Key/geolookup/forecast/q/Allentown.json

Each result object has an l parameter (short for link) that can be used for constructing wunderground URLs:
http://api.wunderground.com/api/Your_Key/forecast/q/zmw:31003.1.99999.json

大概意思是：

1. 不明确的结果
   
2. 
   
3. 当API位置查询未产生精确的位置匹配时，在JSON响应中将出现一个result数组。
   
4. http://api.wunderground.com/api/Your_Key/geolookup/forecast/q/Allentown.json
   
5. 
   
6. 每个result对象都有一个l参数（链接的简写），可用于构建wunderground URL：
   
7. http://api.wunderground.com/api/Your_Key/forecast/q/zmw:31003.1.99999.json

复制代码

如果没有正确获得国内城市的天气状况，是因为位置没有精确匹配，比如在石家庄的响应中，有8个result对象，我们可以使用其中的一个，重新生成链接：

1. http://api.wunderground.com/api/0def10027afaebb7/conditions/q/zmw:00000.137.53698.json

复制代码

这样就可以了。

也可以缩小城市的范围。比如石家庄正定市。于是上面的网址变成：

1. http://api.wunderground.com/api/0def10027afaebb7/conditions/q/China/Zhengding.json

复制代码