该接口支持全球20万+城市,地图上有的几乎都可以返回天气数据,支持20余种语言。
包含基本天气信息、湿度、能见度、气压、降雨概率、日出日落、月初月落、空气质量指数、主要污染物等,可按地名、IP、经纬度坐标查询。
接口文档
请先注册账号获取appid和appsecret, 可以免费测试, 测试后需要购买接口
官网接口文档:http://tianqiapi.com/index/doc?version=world_today
请求方式:GET
请求示例 (我用的是当前测试账号, 如果报错, 可以去官网文档查看最新测试账号)
http://pitaya.tianqiapis.com/?version=today&unit=m&language=en&query=洛杉矶&appid=test&appsecret=test888
请求参数
参数名 | 必选 | 类型 | 说明 | 备注(示例) |
---|---|---|---|---|
appid | 是 | string | 用户appid | 先注册开发账号 |
appsecret | 是 | string | 用户appsecret | |
version | 是 | string | 接口标识 | 固定值: today 全球实况天气 (最多支持15日天气) |
query | 是 | string | 查询参数 | 如: 北京 、东京 、New York 也支持坐标传值如:36.68,116.99 |
language | 是 | string | 语言标识 | 默认中文,更多语言联系客服 英文: en 日文: jp 德语: de 法语: fr 韩语: kr 俄语: ru 葡萄牙: pt 西班牙: es 萨特阿拉伯: sa 意大利: it 泰语: th 越南: vi-VN 菲律宾: tl-PH 印度尼西亚: id-ID 希腊: el-GR 波兰: pl-PL 土耳其: tr 罗马尼亚: ro 巴基斯坦: ur-PK 伊朗: fa-IR |
unit | 是 | string | 温度单位 | 摄氏度m ,华氏度f |
返回JSON, 已加备注, 具体字段接口还请查看文档:
{
"errcode": 0,
"errmsg": "SUCCESS",
"updateTime": "2024-08-02T16:44:44-0700",
"updateTimeFormat": "2024-08-02 16:44:44",
"timeZone": "America\/Los_Angeles",//所在时区
"city": "Los Angeles",//城市名称
"country": "United States",//所在国家
"latitude": "34.054",
"longitude": "-118.242",
"day": {
"icon": "32",
"feelsLike": "31",//体感温度
"temperature": "30",//当前温度
"temperatureMaxSince7am": "30",//最高温度
"phrase": "Sunny",//天气情况
"phrase_img": "qing",//天气情况图标
"altimeter": "1013.88",//气压
"barometerTrend": "Falling",//气压趋势,例如:升温
"humidity": "36",//湿度
"dewPoint": "14",//
"visibility": "16.09",//能见度
"windSpeed": "14",//风速km/h
"windDirCompass": "SW",
"windDirDegrees": "230",//风向角度
"uvIndex": "3",//紫外线
"uvDescription": "Moderate",//紫外线等级描述
"sunrise": "06:05",//日出
"sunset": "19:52",//日落
"moonrise": "04:03",//月出
"moonset": "19:12",//月落
"moonIcon": "WNC",//月相
"moonPhrase": "Waning Crescent",
"narrative": "Clear. Low 19C.",//天气情况描述短语
"aqi": {
"AIR": {
"amount": "56",//空气质量
"index": "Moderate",//空气质量等级
"pp": "PM2.5"//主要污染物
},
"CO": {
"amount": "280",
"index": "3",
"category": "Good"
},
"NO2": {
"amount": "15.82",
"index": "8",
"category": "Good"
},
"O3": {
"amount": "126.35",
"index": "34",
"category": "Good"
},
"PM10": {
"amount": "13.18",
"index": "12",
"category": "Good"
},
"PM2.5": {
"amount": "13.29",
"index": "56",
"category": "Moderate"
},
"SO2": {
"amount": "3.88",
"index": "1",
"category": "Good"
}
}
}
}