小米天气新接口

#小米天气新接口 | 来源: 网络整理| 查看: 265

# 小米天气新接口

该接口提供5天内（暂不包括昨天）定位城市/街道的常用天气信息查询服务，支持条件查询；用户可在天气客户端取消关注定位城市/街道，此时该接口返回的数据为用户关注第一个城市的天气信息。

# 数据更新策略

该接口根据条件进行查询，分为三种case：1.本地+网络；2.取本地数据；3.取网络数据本地数据，每小时更新一次（具体更新策略参见天气后台数据更新任务）

# 接口uri及参数说明

content://weather/actualWeatherData/{dataType}/{wantOnlyCityName}

参数名参数值说明备注 dataType（必需） 1 check本地数据，如果本地数据超过一小时，更新本地数据，并返回默认逻辑，必须异步调用 dataType 2 直接取本地数据可同步调用，仍建议异步 dataType 3 直接获取网络数据必须异步调用 wantOnlyCityName（非必需） 1/0 是否只需要城市名（否则精确到区或街道名），1即是，0即否默认可不传此参数，默认值为0，即city_name字段返回尽量精确的名称

出于功耗考虑，若无特殊需求，请尽量使用第 1 种类型。因为正常情况下天气后台数据是保持了较新时效性的，此时使用3和1没有区别。

# 接口返回字段 ColIndex 字段名说明类型（type）字段值示例备注 0 publish_time 实时天气信息发布时间（time mills） string 1508143200000 可用于实时信息的时效判断 1 city_id 城市唯一标识 string 39.959_116.298 经纬度（北纬_东经） 2 city_name 城市/街道名称 string 安宁庄南路能定位到街道时优先返回街道名，否则返回城市名 3 description 天气现象（实时） string 多云 4 temperature 气温（实时） string 18℃ 5 temperature_range 气温（预报） string 8℃~18℃ 支持数组，type="string[]" 6 aqilevel AQI等级 int 90 参考见：AQI等级 7 locale 语言 string zh_CN 8 weather_type 天气类型（实时） intstring 1 type="int"时不支持数组，type="string[]"时支持数组与天气现象对应关系参考见：天气现象代码对照表 9 humidity 湿度 int 68% 单位：% 10 sunrise 日出时间 int 80760000 距0点过去的毫秒数（换算成时间时只取Hour和Minute，例如80760000换算后为06:26） 11 sunset 日落时间 int 34440000 距0点过去的毫秒数（换算成时间时只取Hour和Minute，34440000换算后为17:34） 12 wind 风向,风力 string 东南风,2级 13 day 日期偏移量 int 1 0代表昨天，1代表今天，2代表明天 14 pressure 气压 int 1016hPa 单位：hPa 15 timestamp 预报天气信息发布时间（time mills） string 1508055000000 16 tmphighs 最高温（预报） string 18 支持数组，type="string[]" 17 tmplows 最低温（预报） string 8 支持数组，type="string[]" 18 forecast_type 天气类型（预报） intstring 1 type="int"时不支持数组，type="string[]"时支持数组与天气现象对应关系参考见：天气现象代码对照表 19 weathernamesfrom 天气现象（预报） string 多云支持数组，type="string[]" 20 weathernamesto 同上 21 temperature_unit 气温单位 int 1 1代表摄氏度，0代表华氏度 22 water 暂时无用（降水概率） - 50% 暂时无用 # 示例 # 简化版天气图标使用

在日常制作中如果画26个天气图标工作量较大，所以我们可以把一个类型的图标集合为一个图标即可。

如下示例：

简化版图标对应天气现象示图：

11个天气图标附件下载：11个天气图标素材.zip (opens new window)

【本文地址】

公司简介

联系我们