该接口支持全球10万+城市,地图上有的都可以返回天气数据,支持中英文。
预报今天和未来15日天气情况, 非常详细。
包含基本天气信息、湿度、能见度、气压、日出日落、月初月落、每日小时预报、白天天气、夜间天气、天气概况描述等,可按地名、IP、坐标查询。
请求方式及url:
请求方式:GET
接口地址:https://v0.tianqiapi.com
请求示例
https://v0.tianqiapi.com/?version=day&unit=m&language=zh&query=香港&appid=&appsecret=
请求参数说明:
参数名 | 必选 | 类型 | 说明 | 备注(示例) |
---|---|---|---|---|
appid | 是 | string | 用户appid | 注册开发账号 |
appsecret | 是 | string | 用户appsecret | |
version | 是 | string | 接口版本标识 | 固定值: day 每个接口的version值都不一样
|
query | 是 | string | 城市名称 | 如: 北京、东京、New York 支持坐标查询如:query=36.68,116.99 |
ip | 是 | string | IP地址 | 如: 169.114.222.119 |
language | 否 | string | 语言 | 默认中文,英文: en |
unit | 否 | string | 温度单位 | 摄氏度m ,华氏度f |
备注
暂无
响应参数说明
参数名 | 类型 | 说明 | 备注 |
---|---|---|---|
updateTime | String | UTC时间 | |
updateTimeFormat | String | 更新时间 | |
timeZone | String | 所在时区 | |
city | String | 城市名称 | |
country | String | 国家名称 | |
longitude | String | 经度 | |
latitude | String | 纬度 | |
day | String | 今日天气情况 | 含每小时详细预报等 |
┗ icon | String | 天气现象代码 | |
┗ feelsLike | String | 体感温度 | 单位为c摄氏度或f华氏度 |
┗ temperature | String | 温度 | 单位为c摄氏度或f华氏度 |
┗ temperatureMaxSince7am | String | 最高温度 | 单位为c摄氏度或f华氏度 |
┗ phrase | String | 天气情况 | 例如:小阵雨 |
┗ altimeter | String | 气压 | m百帕 f英寸 |
┗ barometerTrend | String | 气压趋势 | 例如:升温 |
┗ humidity | String | 相对湿度 | 0~100,单位为百分比 |
┗ dewPoint | String | 露点温度 | |
┗ visibility | String | 能见度 | 单位为km公里或mi英里 |
┗ windSpeed | String | 风速 | 单位为km/h公里每小时或mph英里每小时 |
┗ windDirCompass | String | 风向标 | 例如:东南偏东 |
┗ windDirDegrees | String | 风向角度 | 范围0~360,0为正北,90为正东,180为正南,270为正西 |
┗ uvIndex | String | 紫外线等级 | |
┗ uvDescription | String | 紫外线等级描述 | |
┗ hours | String | 小时天气 | |
┗ time | String | 预报时间 | 例如:10:15 |
┗ wea | String | 预报时间 | 例如:雷阵雨 |
┗ tem | String | 温度 | |
┗ rain | String | 降雨概率 | |
┗ humidity | String | 湿度 | |
┗ wind | String | 风向风速 | 例如:东南 5 公里 /小时 |
┗ icon | String | 天气现象代码 | |
┗ month | String | 1-15日预报 | |
┗ date | String | 日期 | 例如:2020-02-14 |
┗ dateOfWeek | String | 星期 | 例如:2020-02-14 |
┗ sunrise | String | 日出时间 | |
┗ sunset | String | 日落时间 | |
┗ moonrise | String | 月出时间 | |
┗ moonset | String | 月落时间 | |
┗ moonIcon | String | 图标 | |
┗ moonIcon | String | 描述 | |
┗ day / night | String | 白天天气 / 夜间天气 | |
┗ phrase | String | 天气情况 | |
┗ narrative | String | 天气情况叙述 | 例如:大部晴朗。 最高 16ºC。 东北 风 15 到 25 每 km / h 。 |
┗ precipPct | String | 降雨概率 | |
┗ precipType | String | 降雨标识 | |
┗ temperature | String | 温度 | |
┗ uvIndex | String | 紫外线等级 | |
┗ uvDescription | String | 紫外线等级描述 | |
┗ cloudPct | String | 多云概率 | |
┗ windDirCompass | String | 风向 | |
┗ windDirDegrees | String | 风向角度 | |
┗ windSpeed | String | 风速 | |
┗ humidity | String | 湿度 |
响应JSON
{ "errcode":0, "errmsg":"SUCCESS", "updateTime":"2020-02-14T09:48:03+0800", "updateTimeFormat":"2020-02-14 09:48:03", "timeZone":"Asia/Hong_Kong", "city":"香港", "country":"中华人民共和国", "latitude":"22.278", "longitude":"114.159", "day":{ "icon":"11", "feelsLike":"21", "temperature":"21", "temperatureMaxSince7am":"21", "phrase":"小阵雨", "altimeter":"1015.24", "barometerTrend":"升温", "humidity":"96", "dewPoint":"20", "visibility":"8.05", "windSpeed":"5", "windDirCompass":"东南偏东", "windDirDegrees":"120", "uvIndex":"3", "uvDescription":"中等", "hours":[ { "time":"10:00", "wea":"雷阵雨", "tem":"20", "rain":"55", "humidity":"97", "wind":"东南 5 公里 /小时 ", "icon":"38" }, { "time":"11:00", "wea":"局部多云", "tem":"21", "rain":"15", "humidity":"94", "wind":"东南 6 公里 /小时 ", "icon":"30" }, { "time":"12:00", "wea":"局部多云", "tem":"21", "rain":"10", "humidity":"92", "wind":"东南偏南 5 公里 /小时 ", "icon":"30" }, { "time":"13:00", "wea":"大部分地区多云", "tem":"21", "rain":"0", "humidity":"92", "wind":"东南偏南 6 公里 /小时 ", "icon":"28" }, { "time":"14:00", "wea":"大部分地区多云", "tem":"22", "rain":"0", "humidity":"87", "wind":"南 14 公里 /小时 ", "icon":"28" }, { "time":"15:00", "wea":"大部分地区多云", "tem":"22", "rain":"15", "humidity":"88", "wind":"南 14 公里 /小时 ", "icon":"28" }, { "time":"16:00", "wea":"大部分地区多云", "tem":"22", "rain":"25", "humidity":"89", "wind":"东南偏南 14 公里 /小时 ", "icon":"28" }, { "time":"17:00", "wea":"雷阵雨", "tem":"22", "rain":"40", "humidity":"90", "wind":"东南偏南 14 公里 /小时 ", "icon":"38" }, { "time":"18:00", "wea":"雷阵雨", "tem":"21", "rain":"45", "humidity":"92", "wind":"东南 13 公里 /小时 ", "icon":"38" }, { "time":"19:00", "wea":"短时阵雨", "tem":"21", "rain":"30", "humidity":"90", "wind":"东南 12 公里 /小时 ", "icon":"11" }, { "time":"20:00", "wea":"阵雨", "tem":"21", "rain":"45", "humidity":"90", "wind":"东南 11 公里 /小时 ", "icon":"11" }, { "time":"21:00", "wea":"雷阵雨", "tem":"21", "rain":"50", "humidity":"90", "wind":"东南偏东 11 公里 /小时 ", "icon":"47" }, { "time":"22:00", "wea":"雷阵雨", "tem":"21", "rain":"50", "humidity":"89", "wind":"东南偏东 12 公里 /小时 ", "icon":"47" }, { "time":"23:00", "wea":"雷阵雨", "tem":"21", "rain":"45", "humidity":"89", "wind":"东南 12 公里 /小时 ", "icon":"47" }, { "time":"00:00", "wea":"雷阵雨", "tem":"21", "rain":"55", "humidity":"90", "wind":"东南 11 公里 /小时 ", "icon":"47" }, { "time":"01:00", "wea":"雷阵雨", "tem":"21", "rain":"55", "humidity":"89", "wind":"东南 11 公里 /小时 ", "icon":"47" } ] }, "month":[ { "date":"2020-02-14", "dateOfWeek":"星期五", "sunrise":"06:56", "sunset":"18:19", "moonrise":"23:36", "moonset":"10:38", "moonIcon":"WNG", "moonPhrase":"亏凸月", "day":{ "phrase":"雷阵雨", "narrative":"零散雷暴。 最高 22ºC。 东南偏南 风 10 到 15 每 km / h 。 降雨几率 60%。", "precipPct":"60", "precipType":"rain", "temperature":"22", "uvIndex":"7", "uvDescription":"强", "icon":"38", "cloudPct":"61", "windDirCompass":"东南偏南", "windDirDegrees":"157", "windSpeed":"14", "humidity":"92" }, "night":{ "phrase":"雷雨", "narrative":"雷暴。 最低 20ºC。 东南 风 10 到 15 每 km / h 。 降雨几率 80%。", "precipPct":"80", "precipType":"rain", "temperature":"20", "uvIndex":"0", "uvDescription":"低", "icon":"4", "cloudPct":"81", "windDirCompass":"东南", "windDirDegrees":"133", "windSpeed":"12", "humidity":"91" } }, { "date":"2020-02-15", "dateOfWeek":"星期六", "sunrise":"06:55", "sunset":"18:19", "moonrise":"", "moonset":"11:21", "moonIcon":"WNG", "moonPhrase":"亏凸月", "day":{ "phrase":"雷雨", "narrative":"雷暴。 最高 23ºC。 东南偏南 风 10 到 15 每 km / h 。 降雨几率 60%。", "precipPct":"60", "precipType":"rain", "temperature":"23", "uvIndex":"7", "uvDescription":"强", "icon":"4", "cloudPct":"79", "windDirCompass":"东南偏南", "windDirDegrees":"167", "windSpeed":"16", "humidity":"90" }, "night":{ "phrase":"雨", "narrative":"中雨。 最低 11ºC。 西北偏北 风 25 到 40 每 km / h 。 降雨几率 80%。 降雨量约 6 mm。", "precipPct":"80", "precipType":"rain", "temperature":"11", "uvIndex":"0", "uvDescription":"低", "icon":"12", "cloudPct":"85", "windDirCompass":"西北偏北", "windDirDegrees":"329", "windSpeed":"31", "humidity":"86" } }, { "date":"2020-02-16", "dateOfWeek":"星期天", "sunrise":"06:54", "sunset":"18:20", "moonrise":"00:36", "moonset":"12:05", "moonIcon":"LQ", "moonPhrase":"下弦月", "day":{ "phrase":"局部多云", "narrative":"少云。 最高 15ºC。 北 风 25 到 40 每 km / h 。", "precipPct":"20", "precipType":"rain", "temperature":"15", "uvIndex":"7", "uvDescription":"强", "icon":"30", "cloudPct":"68", "windDirCompass":"北", "windDirDegrees":"355", "windSpeed":"31", "humidity":"68" }, "night":{ "phrase":"局部多云", "narrative":"少云。 最低 10ºC。 北 风 15 到 30 每 km / h 。", "precipPct":"20", "precipType":"rain", "temperature":"10", "uvIndex":"0", "uvDescription":"低", "icon":"29", "cloudPct":"49", "windDirCompass":"北", "windDirDegrees":"5", "windSpeed":"25", "humidity":"58" } }, { "date":"2020-02-17", "dateOfWeek":"星期一", "sunrise":"06:54", "sunset":"18:20", "moonrise":"01:36", "moonset":"12:51", "moonIcon":"WNC", "moonPhrase":"残月", "day":{ "phrase":"晴朗", "narrative":"大部晴朗。 最高 17ºC。 北 风 15 到 30 每 km / h 。", "precipPct":"0", "precipType":"rain", "temperature":"17", "uvIndex":"8", "uvDescription":"很强", "icon":"32", "cloudPct":"11", "windDirCompass":"北", "windDirDegrees":"8", "windSpeed":"26", "humidity":"44" }, "night":{ "phrase":"晴朗无云", "narrative":"大部晴朗。 最低 11ºC。 东北偏北 风 15 到 30 每 km / h 。", "precipPct":"0", "precipType":"rain", "temperature":"11", "uvIndex":"0", "uvDescription":"低", "icon":"31", "cloudPct":"1", "windDirCompass":"东北偏北", "windDirDegrees":"14", "windSpeed":"22", "humidity":"47" } }, { "date":"2020-02-18", "dateOfWeek":"星期二", "sunrise":"06:53", "sunset":"18:21", "moonrise":"02:35", "moonset":"13:41", "moonIcon":"WNC", "moonPhrase":"残月", "day":{ "phrase":"晴朗", "narrative":"大部晴朗。 最高 16ºC。 东北 风 15 到 25 每 km / h 。", "precipPct":"0", "precipType":"rain", "temperature":"16", "uvIndex":"8", "uvDescription":"很强", "icon":"32", "cloudPct":"2", "windDirCompass":"东北", "windDirDegrees":"40", "windSpeed":"20", "humidity":"49" }, "night":{ "phrase":"大部晴朗", "narrative":"大部晴朗。 最低 13ºC。 东北偏东 风 15 到 30 每 km / h 。", "precipPct":"0", "precipType":"rain", "temperature":"13", "uvIndex":"0", "uvDescription":"低", "icon":"33", "cloudPct":"16", "windDirCompass":"东北偏东", "windDirDegrees":"68", "windSpeed":"23", "humidity":"63" } }, { "date":"2020-02-19", "dateOfWeek":"星期三", "sunrise":"06:52", "sunset":"18:21", "moonrise":"03:32", "moonset":"14:33", "moonIcon":"WNC", "moonPhrase":"残月", "day":{ "phrase":"局部多云", "narrative":"少云。 最高 17ºC。 东北偏东 风 15 到 30 每 km / h 。", "precipPct":"0", "precipType":"rain", "temperature":"17", "uvIndex":"8", "uvDescription":"很强", "icon":"30", "cloudPct":"20", "windDirCompass":"东北偏东", "windDirDegrees":"61", "windSpeed":"23", "humidity":"62" }, "night":{ "phrase":"晴朗无云", "narrative":"大部晴朗。 最低 15ºC。 东北偏东 风 15 到 25 每 km / h 。", "precipPct":"10", "precipType":"rain", "temperature":"15", "uvIndex":"0", "uvDescription":"低", "icon":"31", "cloudPct":"15", "windDirCompass":"东北偏东", "windDirDegrees":"68", "windSpeed":"17", "humidity":"70" } }, { "date":"2020-02-20", "dateOfWeek":"星期四", "sunrise":"06:52", "sunset":"18:22", "moonrise":"04:25", "moonset":"15:27", "moonIcon":"WNC", "moonPhrase":"残月", "day":{ "phrase":"大部地区晴朗", "narrative":"大部晴朗。 最高 19ºC。 东北偏东 风 15 到 30 每 km / h 。", "precipPct":"0", "precipType":"rain", "temperature":"19", "uvIndex":"9", "uvDescription":"很强", "icon":"34", "cloudPct":"20", "windDirCompass":"东北偏东", "windDirDegrees":"68", "windSpeed":"23", "humidity":"67" }, "night":{ "phrase":"局部多云", "narrative":"少云。 最低 16ºC。 东北偏东 风 15 到 30 每 km / h 。", "precipPct":"10", "precipType":"rain", "temperature":"16", "uvIndex":"0", "uvDescription":"低", "icon":"29", "cloudPct":"38", "windDirCompass":"东北偏东", "windDirDegrees":"73", "windSpeed":"24", "humidity":"74" } }, { "date":"2020-02-21", "dateOfWeek":"星期五", "sunrise":"06:51", "sunset":"18:22", "moonrise":"05:14", "moonset":"16:21", "moonIcon":"WNC", "moonPhrase":"残月", "day":{ "phrase":"局部多云", "narrative":"少云。 最高 20ºC。 东北偏东 风 15 到 30 每 km / h 。", "precipPct":"10", "precipType":"rain", "temperature":"20", "uvIndex":"9", "uvDescription":"很强", "icon":"30", "cloudPct":"36", "windDirCompass":"东北偏东", "windDirDegrees":"61", "windSpeed":"24", "humidity":"69" }, "night":{ "phrase":"局部多云", "narrative":"少云。 最低 17ºC。 东北偏东 风 10 到 15 每 km / h 。", "precipPct":"10", "precipType":"rain", "temperature":"17", "uvIndex":"0", "uvDescription":"低", "icon":"29", "cloudPct":"29", "windDirCompass":"东北偏东", "windDirDegrees":"66", "windSpeed":"15", "humidity":"77" } }, { "date":"2020-02-22", "dateOfWeek":"星期六", "sunrise":"06:50", "sunset":"18:23", "moonrise":"05:59", "moonset":"17:15", "moonIcon":"WNC", "moonPhrase":"残月", "day":{ "phrase":"晴朗", "narrative":"大部晴朗。 最高 21ºC。 东北偏东 风 10 到 15 每 km / h 。", "precipPct":"10", "precipType":"rain", "temperature":"21", "uvIndex":"9", "uvDescription":"很强", "icon":"32", "cloudPct":"12", "windDirCompass":"东北偏东", "windDirDegrees":"63", "windSpeed":"16", "humidity":"71" }, "night":{ "phrase":"晴朗无云", "narrative":"大部晴朗。 最低 18ºC。 东北偏东 风 10 到 15 每 km / h 。", "precipPct":"10", "precipType":"rain", "temperature":"18", "uvIndex":"0", "uvDescription":"低", "icon":"31", "cloudPct":"10", "windDirCompass":"东北偏东", "windDirDegrees":"70", "windSpeed":"15", "humidity":"79" } }, { "date":"2020-02-23", "dateOfWeek":"星期天", "sunrise":"06:49", "sunset":"18:23", "moonrise":"06:40", "moonset":"18:07", "moonIcon":"N", "moonPhrase":"新月", "day":{ "phrase":"大部地区晴朗", "narrative":"大部晴朗。 最高 21ºC。 东北偏东 风 15 到 25 每 km / h 。", "precipPct":"10", "precipType":"rain", "temperature":"21", "uvIndex":"9", "uvDescription":"很强", "icon":"34", "cloudPct":"19", "windDirCompass":"东北偏东", "windDirDegrees":"69", "windSpeed":"20", "humidity":"73" }, "night":{ "phrase":"局部多云", "narrative":"少云。 最低 18ºC。 东 风 15 到 25 每 km / h 。", "precipPct":"10", "precipType":"rain", "temperature":"18", "uvIndex":"0", "uvDescription":"低", "icon":"29", "cloudPct":"36", "windDirCompass":"东", "windDirDegrees":"81", "windSpeed":"19", "humidity":"79" } }, { "date":"2020-02-24", "dateOfWeek":"星期一", "sunrise":"06:49", "sunset":"18:24", "moonrise":"07:18", "moonset":"18:59", "moonIcon":"N", "moonPhrase":"新月", "day":{ "phrase":"局部多云", "narrative":"少云。 最高 22ºC。 东北偏东 风 15 到 30 每 km / h 。", "precipPct":"10", "precipType":"rain", "temperature":"22", "uvIndex":"9", "uvDescription":"很强", "icon":"30", "cloudPct":"44", "windDirCompass":"东北偏东", "windDirDegrees":"78", "windSpeed":"21", "humidity":"75" }, "night":{ "phrase":"局部多云", "narrative":"少云。 最低 19ºC。 东 风 15 到 25 每 km / h 。", "precipPct":"10", "precipType":"rain", "temperature":"19", "uvIndex":"0", "uvDescription":"低", "icon":"29", "cloudPct":"47", "windDirCompass":"东", "windDirDegrees":"85", "windSpeed":"17", "humidity":"82" } }, { "date":"2020-02-25", "dateOfWeek":"星期二", "sunrise":"06:48", "sunset":"18:24", "moonrise":"07:53", "moonset":"19:49", "moonIcon":"WXC", "moonPhrase":"娥眉月", "day":{ "phrase":"局部多云", "narrative":"少云。 最高 22ºC。 东 风 15 到 25 每 km / h 。", "precipPct":"10", "precipType":"rain", "temperature":"22", "uvIndex":"8", "uvDescription":"很强", "icon":"30", "cloudPct":"56", "windDirCompass":"东", "windDirDegrees":"85", "windSpeed":"17", "humidity":"79" }, "night":{ "phrase":"局部多云", "narrative":"少云。 最低 20ºC。 东 风 10 到 15 每 km / h 。", "precipPct":"20", "precipType":"rain", "temperature":"20", "uvIndex":"0", "uvDescription":"低", "icon":"29", "cloudPct":"53", "windDirCompass":"东", "windDirDegrees":"92", "windSpeed":"12", "humidity":"86" } }, { "date":"2020-02-26", "dateOfWeek":"星期三", "sunrise":"06:47", "sunset":"18:25", "moonrise":"08:26", "moonset":"20:37", "moonIcon":"WXC", "moonPhrase":"娥眉月", "day":{ "phrase":"局部多云", "narrative":"少云。 最高 23ºC。 东南偏东 风 10 到 15 每 km / h 。", "precipPct":"20", "precipType":"rain", "temperature":"23", "uvIndex":"9", "uvDescription":"很强", "icon":"30", "cloudPct":"37", "windDirCompass":"东南偏东", "windDirDegrees":"107", "windSpeed":"12", "humidity":"82" }, "night":{ "phrase":"局部多云", "narrative":"少云。 最低 20ºC。 东南偏东 风,风向多变。", "precipPct":"10", "precipType":"rain", "temperature":"20", "uvIndex":"0", "uvDescription":"低", "icon":"29", "cloudPct":"34", "windDirCompass":"东南偏东", "windDirDegrees":"108", "windSpeed":"9", "humidity":"87" } }, { "date":"2020-02-27", "dateOfWeek":"星期四", "sunrise":"06:46", "sunset":"18:25", "moonrise":"08:59", "moonset":"21:26", "moonIcon":"WXC", "moonPhrase":"娥眉月", "day":{ "phrase":"局部多云", "narrative":"少云。 最高 23ºC。 东南偏东 风 10 到 15 每 km / h 。", "precipPct":"20", "precipType":"rain", "temperature":"23", "uvIndex":"9", "uvDescription":"很强", "icon":"30", "cloudPct":"41", "windDirCompass":"东南偏东", "windDirDegrees":"103", "windSpeed":"14", "humidity":"82" }, "night":{ "phrase":"局部多云", "narrative":"少云。 最低 20ºC。 东 风 10 到 15 每 km / h 。", "precipPct":"20", "precipType":"rain", "temperature":"20", "uvIndex":"0", "uvDescription":"低", "icon":"29", "cloudPct":"54", "windDirCompass":"东", "windDirDegrees":"95", "windSpeed":"14", "humidity":"86" } }, { "date":"2020-02-28", "dateOfWeek":"星期五", "sunrise":"06:45", "sunset":"18:26", "moonrise":"09:32", "moonset":"22:15", "moonIcon":"WXC", "moonPhrase":"娥眉月", "day":{ "phrase":"局部多云", "narrative":"少云。 最高 23ºC。 东 风 15 到 25 每 km / h 。", "precipPct":"20", "precipType":"rain", "temperature":"23", "uvIndex":"9", "uvDescription":"很强", "icon":"30", "cloudPct":"55", "windDirCompass":"东", "windDirDegrees":"81", "windSpeed":"18", "humidity":"79" }, "night":{ "phrase":"局部多云", "narrative":"少云。 最低 19ºC。 东 风 10 到 15 每 km / h 。", "precipPct":"10", "precipType":"rain", "temperature":"19", "uvIndex":"0", "uvDescription":"低", "icon":"29", "cloudPct":"47", "windDirCompass":"东", "windDirDegrees":"84", "windSpeed":"16", "humidity":"81" } } ] }