城市天气数据
京东万象 官方文档
获取城市天气相关数据,包括常用指数,空气状态和污染物,月亮相关信息
基本说明:
接口地址:https://way.jd.com/he/freeweather
返回格式:json
请求方式:get/post
请求示例:https://way.jd.com/he/freeweather?city=beijing&appkey=APPKEY
请求参数说明:
名称 类型 必填 说明
appkey string 必填 该平台的appkey 扫码关注公众号
city string 必填 可通过城市中英文名称、ID和IP地址进行,例如city=北京,city=beijing,city=CN101010100,city= 60.194.130.1
返回参数说明:
名称 类型 说明
HeWeather5 string 和风标识
suggestion string 生活指数
drsg string 穿衣指数
txt string 数据详情
brf string 生活指数简介
uv string 紫外线指数
comf string 舒适度指数
flu string 感冒指数
sport string 运动指数
trav string 旅游指数
cw string 洗车指数
status string 状态码
hourly_forecast string 每小时预报
tmp string 温度
pop string 降水概率
pres string 大气压
wind string 风力情况
deg string 风向(360度)
sc string 风力等级
spd string 风速
dir string 风向
hum string 相对湿度
date string 日期
cond string 天气状况
code string 天气状况代码
now string 实况天气
fl string 感冒指数
pcpn string 降水量
vis string 能见度
aqi string AQI
city string 城市名
pm25 string PM2.5
pm10 string PM10
co string CO
so2 string SO2
no2 string NO2
qlty string 空气质量
o3 string O3
basic string 基本信息
id string 城市ID
cnty string 国家
lat string 纬度
update string 更新时间
loc string 当地时间
utc string UTC时间
lon string 经度
daily_forecast string 天气预报
txt_d string 白天天气状况描述
txt_n string 夜间天气状况描述
code_d string 白天天气状况代码
code_n string 夜间天气状况代码
astro string 天文指数
ms string 月落时间
ss string 日落时间
sr string 日出时间
mr string 月升时间
max string 最高温度
min string 最低温度
JSON返回示例:
{
	"code": "10000",
	"charge": false,
	"msg": "查询成功",
	"result": {
		"HeWeather5": [{
			"aqi": {
				"city": {
					"aqi": "40",
					"qlty": "优",
					"pm25": "28",
					"pm10": "19",
					"no2": "31",
					"so2": "5",
					"co": "0.8",
					"o3": "42"
				}
			},
			"basic": {
				"city": "上海",
				"cnty": "我们",
				"id": "CN101020100",
				"lat": "31.23170662",
				"lon": "121.47264099",
				"update": {
					"loc": "2020-11-27 10:17",
					"utc": "2020-11-27 02:17"
				}
			},
			"daily_forecast": [{
				"astro": {
					"mr": "15:11",
					"ms": "03:25",
					"sr": "06:32",
					"ss": "16:51"
				},
				"cloud": "55",
				"cond": {
					"code_d": "305",
					"code_n": "101",
					"txt_d": "小雨",
					"txt_n": "多云"
				},
				"date": "2020-11-27",
				"hum": "56",
				"pcpn": "1.0",
				"pop": "55",
				"pres": "1032",
				"tmp": {
					"max": "14",
					"min": "9"
				},
				"uv": "1",
				"vis": "24",
				"wind": {
					"deg": "0",
					"dir": "北风",
					"sc": "3-4",
					"spd": "19"
				}
			}, {
				"astro": {
					"mr": "15:41",
					"ms": "04:19",
					"sr": "06:33",
					"ss": "16:51"
				},
				"cloud": "4",
				"cond": {
					"code_d": "104",
					"code_n": "101",
					"txt_d": "阴",
					"txt_n": "多云"
				},
				"date": "2020-11-28",
				"hum": "67",
				"pcpn": "0.0",
				"pop": "4",
				"pres": "1030",
				"tmp": {
					"max": "12",
					"min": "7"
				},
				"uv": "1",
				"vis": "25",
				"wind": {
					"deg": "0",
					"dir": "北风",
					"sc": "3-4",
					"spd": "16"
				}
			}, {
				"astro": {
					"mr": "16:13",
					"ms": "05:14",
					"sr": "06:34",
					"ss": "16:51"
				},
				"cloud": "2",
				"cond": {
					"code_d": "101",
					"code_n": "100",
					"txt_d": "多云",
					"txt_n": "晴"
				},
				"date": "2020-11-29",
				"hum": "60",
				"pcpn": "0.0",
				"pop": "2",
				"pres": "1032",
				"tmp": {
					"max": "12",
					"min": "8"
				},
				"uv": "3",
				"vis": "25",
				"wind": {
					"deg": "45",
					"dir": "东北风",
					"sc": "3-4",
					"spd": "15"
				}
			}, {
				"astro": {
					"mr": "16:50",
					"ms": "06:10",
					"sr": "06:35",
					"ss": "16:51"
				},
				"cloud": "1",
				"cond": {
					"code_d": "101",
					"code_n": "101",
					"txt_d": "多云",
					"txt_n": "多云"
				},
				"date": "2020-11-30",
				"hum": "62",
				"pcpn": "0.0",
				"pop": "1",
				"pres": "1031",
				"tmp": {
					"max": "15",
					"min": "10"
				},
				"uv": "3",
				"vis": "25",
				"wind": {
					"deg": "45",
					"dir": "东北风",
					"sc": "3-4",
					"spd": "16"
				}
			}, {
				"astro": {
					"mr": "17:31",
					"ms": "07:07",
					"sr": "06:36",
					"ss": "16:51"
				},
				"cloud": "8",
				"cond": {
					"code_d": "104",
					"code_n": "101",
					"txt_d": "阴",
					"txt_n": "多云"
				},
				"date": "2020-12-01",
				"hum": "64",
				"pcpn": "0.0",
				"pop": "8",
				"pres": "1026",
				"tmp": {
					"max": "15",
					"min": "11"
				},
				"uv": "3",
				"vis": "24",
				"wind": {
					"deg": "45",
					"dir": "东北风",
					"sc": "1-2",
					"spd": "6"
				}
			}, {
				"astro": {
					"mr": "18:18",
					"ms": "08:03",
					"sr": "06:37",
					"ss": "16:51"
				},
				"cloud": "25",
				"cond": {
					"code_d": "104",
					"code_n": "101",
					"txt_d": "阴",
					"txt_n": "多云"
				},
				"date": "2020-12-02",
				"hum": "59",
				"pcpn": "0.0",
				"pop": "25",
				"pres": "1027",
				"tmp": {
					"max": "15",
					"min": "10"
				},
				"uv": "1",
				"vis": "25",
				"wind": {
					"deg": "45",
					"dir": "东北风",
					"sc": "3-4",
					"spd": "16"
				}
			}, {
				"astro": {
					"mr": "19:11",
					"ms": "08:58",
					"sr": "06:37",
					"ss": "16:51"
				},
				"cloud": "24",
				"cond": {
					"code_d": "104",
					"code_n": "104",
					"txt_d": "阴",
					"txt_n": "阴"
				},
				"date": "2020-12-03",
				"hum": "73",
				"pcpn": "0.0",
				"pop": "24",
				"pres": "1030",
				"tmp": {
					"max": "13",
					"min": "8"
				},
				"uv": "2",
				"vis": "24",
				"wind": {
					"deg": "0",
					"dir": "北风",
					"sc": "3-4",
					"spd": "16"
				}
			}],
			"hourly_forecast": [{
				"cond": {
					"code": "101",
					"txt": "多云"
				},
				"date": "2020-11-27 13:00",
				"hum": "65",
				"pop": "14",
				"pres": "1032",
				"tmp": "13",
				"wind": {
					"deg": "339",
					"dir": "西北风",
					"sc": "3-4",
					"spd": "20"
				}
			}, {
				"cond": {
					"code": "101",
					"txt": "多云"
				},
				"date": "2020-11-27 16:00",
				"hum": "64",
				"pop": "10",
				"pres": "1031",
				"tmp": "12",
				"wind": {
					"deg": "4",
					"dir": "北风",
					"sc": "4-5",
					"spd": "25"
				}
			}, {
				"cond": {
					"code": "101",
					"txt": "多云"
				},
				"date": "2020-11-27 19:00",
				"hum": "60",
				"pop": "0",
				"pres": "1032",
				"tmp": "11",
				"wind": {
					"deg": "6",
					"dir": "北风",
					"sc": "3-4",
					"spd": "20"
				}
			}, {
				"cond": {
					"code": "101",
					"txt": "多云"
				},
				"date": "2020-11-27 22:00",
				"hum": "54",
				"pop": "0",
				"pres": "1033",
				"tmp": "11",
				"wind": {
					"deg": "7",
					"dir": "北风",
					"sc": "3-4",
					"spd": "18"
				}
			}, {
				"cond": {
					"code": "101",
					"txt": "多云"
				},
				"date": "2020-11-28 01:00",
				"hum": "54",
				"pop": "0",
				"pres": "1033",
				"tmp": "10",
				"wind": {
					"deg": "9",
					"dir": "北风",
					"sc": "3-4",
					"spd": "18"
				}
			}, {
				"cond": {
					"code": "101",
					"txt": "多云"
				},
				"date": "2020-11-28 04:00",
				"hum": "53",
				"pop": "0",
				"pres": "1032",
				"tmp": "9",
				"wind": {
					"deg": "5",
					"dir": "北风",
					"sc": "3-4",
					"spd": "16"
				}
			}, {
				"cond": {
					"code": "101",
					"txt": "多云"
				},
				"date": "2020-11-28 07:00",
				"hum": "55",
				"pop": "0",
				"pres": "1031",
				"tmp": "10",
				"wind": {
					"deg": "7",
					"dir": "北风",
					"sc": "3-4",
					"spd": "16"
				}
			}, {
				"cond": {
					"code": "101",
					"txt": "多云"
				},
				"date": "2020-11-28 10:00",
				"hum": "48",
				"pop": "0",
				"pres": "1031",
				"tmp": "11",
				"wind": {
					"deg": "9",
					"dir": "北风",
					"sc": "3-4",
					"spd": "16"
				}
			}],
			"now": {
				"cond": {
					"code": "305",
					"txt": "小雨"
				},
				"dew": "11",
				"fl": "11",
				"hum": "97",
				"pcpn": "0.2",
				"pres": "1027",
				"tmp": "11",
				"vis": "5",
				"wind": {
					"deg": "0",
					"dir": "北风",
					"sc": "0",
					"spd": "0"
				}
			},
			"status": "ok",
			"suggestion": {
				"air": {
					"brf": "良",
					"txt": "气象条件有利于空气污染物稀释、扩散和清除,可在室外正常活动。"
				},
				"comf": {
					"brf": "较舒适",
					"txt": "白天有少量雨,风力较强,这种天气条件下,人们会感到有些凉意,但大部分人完全可以接受。"
				},
				"cw": {
					"brf": "不宜",
					"txt": "不宜洗车,未来24小时内有雨,如果在此期间洗车,雨水和路上的泥水可能会再次弄脏您的爱车。"
				},
				"drsg": {
					"brf": "较冷",
					"txt": "建议着厚外套加毛衣等服装。年老体弱者宜着大衣、呢外套加羊毛衫。"
				},
				"flu": {
					"brf": "易发",
					"txt": "天冷风大且空气湿度大,易发生感冒,请注意适当增加衣服,加强自我防护避免感冒。"
				},
				"sport": {
					"brf": "较不宜",
					"txt": "有降水,且风力较强,推荐您在室内进行各种健身休闲运动;若坚持户外运动,请注意防风保暖。"
				},
				"trav": {
					"brf": "适宜",
					"txt": "有降水,虽然风稍大,但温度适宜,适宜旅游,可不要错过机会呦!"
				},
				"uv": {
					"brf": "最弱",
					"txt": "属弱紫外线辐射天气,无需特别防护。若长期在户外,建议涂擦SPF在8-12之间的防晒护肤品。"
				}
			}
		}]
	}
}
服务级错误码参照
错误码 说明
10000 查询成功
10001 错误的请求appkey
11010 商家接口调用异常,请稍后再试
11030 商家接口返回格式有误
10003 不存在相应的数据信息
10004 URL上appkey参数不能为空
10010 接口需要付费,请充值
10020 万象系统繁忙,请稍后再试
10030 调用万象网关失败, 请与万象联系
10040 超过每天限量,请明天继续
10050 用户已被禁用
10060 提供方设置调用权限,请联系提供方
10070 该数据只允许企业用户调用
10090 文件大小超限,请上传小于1M的文件
完整教学代码示例
<?php
/**
 * Created by PhpStorm.
 * User: FZS
 * Time: 2020/12/01 22:26
 */
class freeApi
{
    private $apiUrl;

    public function __construct()
    {
        $this->apiUrl = 'https://way.jd.com/he/freeweather?city=beijing&appkey=APPKEY';
    }

    /**
     * 获取结果
     * @return array
     */
    public function getResult()
    {
        return file_get_contents($this->apiUrl);
    }
}
package main

import (
	"fmt"
	"io/ioutil"
	"log"
	"net/http"
)

const (
	APIURL   = "https://way.jd.com/he/freeweather?city=beijing&appkey=APPKEY"
)

func main() {
	queryUrl := fmt.Sprintf("%s",APIURL)
	resp, err := http.Get(queryUrl)
	if err != nil {
		log.Println(err)
		return
	}

	defer resp.Body.Close()

	body, err := ioutil.ReadAll(resp.Body)

	if err != nil {
		fmt.Println(err)
		return
	}

	fmt.Println(string(body))
}