获取当前位置实时天气
根据用户的经纬度地址,查询当前所属经纬度的天气情况
测试地址:
{url}/dev-api/customer/util/weather
生产地址:
{url}/api/customer/util/weather
是否白名单:是
具体请求
header:
body:
请求参数说明
参数名 | 类型 | 是否必填 | 说明 | 示例 |
---|---|---|---|---|
location | String | 是 | 纬度+英文逗号+经度 | 36.71265155,119.16837791 |
响应参数
成功响应示例
{
"msg": "操作成功",
"code": 200,
"data": {
"province": "山东",
"city": "奎文区",
"adcode": "370705",
"windpower": "≤3",
"icon": "https://oss.icuapi.com/docs/openapi-website/20220310/1646883391805.png",
"weather": "晴",
"temperature": "7",
"humidity": "91",
"reporttime": "2022-03-11 00:01:34",
"winddirection": "东南"
}
}
失败响应示例
响应参数说明
参数名 | 说明 | 备注 |
---|---|---|
code | 返回码 | 为200表示成功,非200表示调用失败,其他错误码请见返回码说明 |
msg | 返回码的文本描述内容 | |
data | 返回数据 | |
province | 省份名 | |
city | 城市名 | |
adcode | 区域编码 | |
icon | 天气图标 | |
weather | 天气预报 | 详见天气现象列表 |
temperature | 实时气温,单位:摄氏度 | |
windDirection | 风向,风向编码对应描述 | |
windPower | 风力,风力编码对应风力级别,单位:级 | |
humidity | 空气湿度(百分比) | |
reportTime | 数据发布的时间 |
天气现象表
下表列举了天气功能中所能返回的天气现象:
天气现象表 | ||
---|---|---|
晴 少云 晴间多云 多云 阴 有风 平静 微风 和风 清风 强风/劲风 疾风 大风 烈风 风暴 狂爆风 飓风 热带风暴 霾 中度霾 重度霾 严重霾 |
阵雨 雷阵雨 雷阵雨并伴有冰雹 小雨 中雨 大雨 暴雨 大暴雨 特大暴雨 强阵雨 强雷阵雨 极端降雨 毛毛雨/细雨 雨 小雨-中雨 中雨-大雨 大雨-暴雨 暴雨-大暴雨 大暴雨-特大暴雨 雨雪天气 雨夹雪 阵雨夹雪 冻雨 |
雪 阵雪 小雪 中雪 大雪 暴雪 小雪-中雪 中雪-大雪 大雪-暴雪 浮尘 扬沙 沙尘暴 强沙尘暴 龙卷风 雾 浓雾 强浓雾 轻雾 大雾 特强浓雾 热 冷 未知 |
风力表
进行天气查询时返回的风力如下表所示:
风力表 | ||||
---|---|---|---|---|
≤3 | 4 | 5 | 6 | 7 |
8 | 9 | 10 | 11 | 12 |
风向表
进行天气查询时返回的风向如下表所示:
风向表 | ||||
---|---|---|---|---|
无风向 | 东北 | 东 | 东南 | 南 |
西南 | 西 | 西北 | 北 | 旋转不定 |
注意事项:
该接口为限制接口: 调用量上限(次/日):3000000 并发量上限(次/秒)1000