实时天气和预报
实况天气 #
全国4000+个市县区和海外15万个城市实时天气数据，包括实时温度、体感温度、风力风向、相对湿度、大气压强、降水量、能见度、露点温度、云量等数据。
| 接口代码 | 接口说明 | 数据类 |
|---|---|---|
| getWeatherNow | 实况天气数据 | WeatherNowBean |
接口参数说明 #
location
需要查询地区的LocationID或以逗号分隔的经度/纬度坐标（十进制），LocationID可通过GeoAPI服务获取。例如： location=101010100 或 location=116.41,39.92
lang
多语言设置，默认中文，当数据不匹配你设置的语言时，将返回英文或其本地语言结果。可选语言请参考多语言参数。
unit
度量衡单位参数选择，例如温度选摄氏度或华氏度、公里或英里。默认公制单位
示例代码 #
QWeather.getWeatherNow(Context context, String location, Lang lang, Unit unit,QWeather.OnResultWeatherNowListener listener) ;
QWeather.getWeatherNow(Context context, String location, QWeather.OnResultWeatherNowListener listener);
WeatherNowBean属性 #
| 属性 | 说明 | 示例值 |
|---|---|---|
| getCode | 接口状态 | 200 |
| getNow | NowBean 实况天气 | NowBaseBean |
| getRefer | Refer 数据来源以及数据授权 | Refer |
| getBasic | Basic 基础信息 | Basic |
Refer
| 属性 | 说明 | 示例值 |
|---|---|---|
| getSourcesList | 原始数据来源 | Weather China |
| getLicenseList | 使用许可 | commercial license |
Basic
| 属性 | 说明 | 示例值 |
|---|---|---|
| getUpdateTime | 接口更新时间 | 2017-10-25 04:34 |
| getFxLink | 所查询城市的天气预报网页 | http://hfx.link/ae45 |
NowBaseBean 实况天气
| 属性 | 说明 | 示例值 |
|---|---|---|
| getObsTime | 实况观测时间 | 2013-12-30 13:14 |
| getFeelsLike | 体感温度，默认单位：摄氏度 | 23 |
| getTemp | 温度，默认单位：摄氏度 | 21 |
| getIcon | 实况天气状况代码 | 100 |
| getText | 实况天气状况代码 | 晴 |
| getWind360 | 风向360角度 | 305 |
| getWindDir | 风向 | 西北 |
| getWindScale | 风力 | 3-4 |
| getWindSpeed | 风速，公里/小时 | 15 |
| getHumidity | 相对湿度 | 40 |
| getPrecip | 降水量 | 0 |
| getPressure | 大气压强 | 1020 |
| getVis | 能见度，默认单位：公里 | 10 |
| getCloud | 云量 | 23 |
| getDew | 实况云量 | 23 |
逐天预报 #
全球城市未来15天天气预报，包括：日出日落、月升月落、最高最低温度、天气白天和夜间状况、风力、风速、风向、相对湿度、大气压强、降水量、降水概率、露点温度、紫外线强度、能见度等。
| 接口代码 | 接口说明 | 数据类 |
|---|---|---|
| getWeather3D | 3天预报天气数据 | WeatherDailyBean |
| getWeather7D | 7天预报天气数据 | WeatherDailyBean |
| getWeather10D | 10天预报天气数据 | WeatherDailyBean |
| getWeather15D | 15天预报天气数据 | WeatherDailyBean |
接口参数说明 #
location
需要查询地区的LocationID或以逗号分隔的经度/纬度坐标（十进制），LocationID可通过GeoAPI服务获取。例如： location=101010100 或 location=116.41,39.92
lang
多语言设置，默认中文，当数据不匹配你设置的语言时，将返回英文或其本地语言结果。可选语言请参考多语言参数。
unit
度量衡单位参数选择，例如温度选摄氏度或华氏度、公里或英里。默认公制单位
示例代码 #
/**
* 获取3天预报数据
*/
QWeather.getWeather3D(Context context, String location, Lang lang, Unit unit,QWeather.OnResultWeatherDailyListener listener) ;
QWeather.getWeather3D(Context context, String location, QWeather.OnResultWeatherDailyListener listener);
/**
* 获取7天预报数据
*/
QWeather.getWeather7D(Context context, String location, Lang lang, Unit unit,QWeather.OnResultWeatherDailyListener listener) ;
QWeather.getWeather7D(Context context, String location, QWeather.OnResultWeatherDailyListener listener);
/**
* 获取10天预报数据
*/
QWeather.getWeather10D(Context context, String location, Lang lang, Unit unit,QWeather.OnResultWeatherDailyListener listener) ;
QWeather.getWeather10D(Context context, String location, QWeather.OnResultWeatherDailyListener listener);
/**
* 获取15天预报数据
*/
QWeather.getWeather15D(Context context, String location, Lang lang, Unit unit,QWeather.OnResultWeatherDailyListener listener) ;
QWeather.getWeather15D(Context context, String location, QWeather.OnResultWeatherDailyListener listener);
WeatherDailyBean属性 #
| 属性 | 说明 | 示例值 |
|---|---|---|
| getCode | 接口状态 | 200 |
| getDaily | DailyBean 逐天天气 | List<DailyBean> |
| getRefer | Refer 数据来源以及数据授权 | Refer |
| getBasic | Basic 基础信息 | Basic |
Refer
| 属性 | 说明 | 示例值 |
|---|---|---|
| getSourcesList | 原始数据来源 | Weather China |
| getLicenseList | 使用许可 | commercial license |
Basic
| 属性 | 说明 | 示例值 |
|---|---|---|
| getUpdateTime | 接口更新时间 | 2017-10-25 04:34 |
| getFxLink | 所查询城市的天气预报网页 | http://hfx.link/ae45 |
DailyBean 天气预报
| 属性 | 说明 | 示例值 |
|---|---|---|
| getFxDate | 预报日期 | 2013-12-30 |
| getSunrise | 日出时间 | 07:36 |
| getSunset | 日落时间 | 16:58 |
| getMoonRise | 月升时间 | 04:47 |
| getMoonSet | 月落时间 | 14:59 |
| getMoonPhase | 月相名称 | 满月 |
| getTempMax | 最高温度 | 4 |
| getTempMin | 最低温度 | -5 |
| getIconDay | 白天天气状况代码 | 100 |
| getIconNight | 晚间天气状况代码 | 100 |
| getTextDay | 白天天气状况描述 | 晴 |
| getTextNight | 晚间天气状况描述 | 晴 |
| getWind360Day | 白天风向360角度 | 310 |
| getWind360Night | 夜间风向360角度 | 310 |
| getWindDirDay | 白天风向 | 西北风 |
| getWindDirNight | 夜间风向 | 西北风 |
| getWindScaleDay | 白天风力 | 1-2 |
| getWindScaleNight | 夜间风力 | 1-2 |
| getWindSpeedDay | 白天风速，公里/小时 | 14 |
| getWindSpeedNight | 夜间风速，公里/小时 | 14 |
| getHumidity | 相对湿度 | 37 |
| getPrecip | 降水量 | 0 |
| getPressure | 大气压强 | 1018 |
| getCloud | 当天云量 | 23 |
| getUvIndex | 紫外线强度指数 | 3 |
| getVis | 能见度，单位：公里 | 10 |
逐小时天气预报 #
全球城市未来168小时逐小时天气预报，包括：温度、天气状况、风力、风速、风向、相对湿度、大气压强、降水概率、露点温度、云量。
| 接口代码 | 接口说明 | 数据类 |
|---|---|---|
| getWeather24H | 24小时预报天气数据 | WeatherHourlyBean |
| getWeather72H | 72小时预报天气数据 | WeatherHourlyBean |
| getWeather168H | 168小时预报天气数据 | WeatherHourlyBean |
接口参数说明 #
location
需要查询地区的LocationID或以逗号分隔的经度/纬度坐标（十进制），LocationID可通过GeoAPI服务获取。例如： location=101010100 或 location=116.41,39.92
lang
多语言设置，默认中文，当数据不匹配你设置的语言时，将返回英文或其本地语言结果。可选语言请参考多语言参数。
unit
度量衡单位参数选择，例如温度选摄氏度或华氏度、公里或英里。默认公制单位
示例代码 #
/**
* 获取24小时预报数据
*/
QWeather.getWeather24Hourly(Context context, String location, Lang lang, Unit unit,QWeather.OnResultWeatherHourlyListener listener);
QWeather.getWeather24Hourly(Context context, String location, QWeather.OnResultWeatherHourlyListener listener);
/**
* 获取72小时预报数据
*/
QWeather.getWeather72Hourly(Context context, String location, Lang lang, Unit unit,QWeather.OnResultWeatherHourlyListener listener) ;
QWeather.getWeather72Hourly(Context context, String location, QWeather.OnResultWeatherHourlyListener listener);
/**
* 获取168小时预报数据
*/
QWeather.getWeather168Hourly(Context context, String location, Lang lang, Unit unit,QWeather.OnResultWeatherHourlyListener listener) ;
QWeather.getWeather168Hourly(Context context, String location, QWeather.OnResultWeatherHourlyListener listener);
WeatherHourlyBean属性 #
| 属性 | 说明 | 示例值 |
|---|---|---|
| getCode | 接口状态 | 200 |
| getHourly | HourlyBean 逐小时天气 | List<HourlyBean> |
| getRefer | Refer 数据来源以及数据授权 | Refer |
| getBasic | Basic 基础信息 | Basic |
Refer
| 属性 | 说明 | 示例值 |
|---|---|---|
| getSourcesList | 原始数据来源 | Weather China |
| getLicenseList | 使用许可 | commercial license |
Basic
| 属性 | 说明 | 示例值 |
|---|---|---|
| getUpdateTime | 接口更新时间 | 2017-10-25 04:34 |
| getFxLink | 所查询城市的天气预报网页 | http://hfx.link/ae45 |
HourlyBean 逐小时天气
| 属性 | 说明 | 示例值 |
|---|---|---|
| getFxTime | 预报时间，格式yyyy-MM-dd HH:mm | 2013-12-30 13:00 |
| getTemp | 温度 | 2 |
| getIcon | 天气状况代码 | 101 |
| getText | 天气状况代码 | 多云 |
| getWind360 | 风向360角度 | 290 |
| getWindDir | 风向 | 西北 |
| getWindScale | 风力 | 3-4 |
| getWindSpeed | 风速，公里/小时 | 15 |
| getHumidity | 相对湿度 | 30 |
| getPrecip | 逐小时预报降水量，默认单位：毫米 | 1.2 |
| getPop | 逐小时预报降水概率，百分比数值，可能为空 | 5 |
| getPressure | 大气压强 | 1030 |
| getDew | 露点温度 | 5 |
| getCloud | 云量，百分比 | 15 |
分钟降水 #
分钟级降水提供中国地区未来2小时内每5分钟降水数据、降水类型以及未来2小时的降水概况信息。可实现精确到1公里格点的全国分钟级降雨/降雪预报，为每一分钟的降雨进行预测。
| 接口代码 | 接口说明 | 数据类 |
|---|---|---|
| getMinutely | 分钟级降雨 | MinutelyBean |
接口参数说明 #
location
需要查询地区的以英文逗号分隔的经度,纬度坐标（十进制）。例如 location=116.41,39.92
lang
多语言设置，默认中文，本数据仅支持中文和英文。可选语言请参考多语言参数。
示例代码 #
QWeather.getMinuteLy(Context context, String location,QWeather.OnResultMinutelyListener listener);
QWeather.getMinuteLy(Context context, String location, Lang lang, QWeather.OnResultMinutelyListener listener);
MinutelyBean属性 #
| 属性 | 说明 | 示例值 |
|---|---|---|
| getCode | 接口状态 | 200 |
| getSummary | 分钟降水描述 | 未来2小时无降雨 |
| getMinutelyList | 临近预报 | List<Minutely> |
| getRefer | Refer 数据来源以及数据授权 | Refer |
| getBasic | Basic 基础信息 | Basic |
Refer
| 属性 | 说明 | 示例值 |
|---|---|---|
| getSourcesList | 原始数据来源 | Weather China |
| getLicenseList | 使用许可 | commercial license |
Basic
| 属性 | 说明 | 示例值 |
|---|---|---|
| getUpdateTime | 接口更新时间 | 2017-10-25 04:34 |
| getFxLink | 所查询城市的天气预报网页 | http://hfx.link/ae45 |
Minutely 未来两小时5分钟降水量
| 属性 | 说明 | 示例值 |
|---|---|---|
| getFxTime | 时间，格式yyyy-MM-dd HH:mm | 2013-12-30 20:35 |
| getPrecip | 降水量 | 10 |
| getType | 降水类型 | rain |