获取当前位置实时天气
根据用户的经纬度地址,查询当前所属经纬度的天气情况
测试地址:
{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
