🎉实况、15日接口新增AQI空气质量指数字段, 欢迎对接→
  • 全球7日天气
该接口支持全球20万+城市,地图上有的几乎都可以返回天气数据,支持20余种语言。
预报今天和未来7日天气基础情况,适合硬件设备请求,占用字节较少。
包含基本日期、白天天气、夜间天气、实况温度、实况PM2.5、白天高温、夜间低温等,可按地名、IP、LBS坐标查询。

接口价格:

地区权限 请求限制 使用方案 发票
地图上可查询的所有城市 每日4万次 2500/一年(最低) 10000/永久(最低) 可提供普票、电子票、专票
地图上可查询的所有城市 每日5万次 3000/一年(最低) 12500/永久(最低) 可提供普票、电子票、专票
地图上可查询的所有城市 每日10万次 4000/一年(最低) 16000/永久(最低) 可提供普票、电子票、专票
地图上可查询的所有城市 每日20万次 8000/一年(最低) 32000/永久(最低) 可提供普票、电子票、专票

请求方式及URL:

线路名称 提交方式 请求URL
洛杉矶 GET http://pitaya.tianqiapis.com

请求示例(如果浏览器没有安装jsonview插件, 请复制内容到json.cn解析,不要保留转义)

http://pitaya.tianqiapis.com/?version=day&unit=m&language=zh&query=洛杉矶&appid=test&appsecret=test888&isweek=1

请求参数说明:

参数名 必选 类型 说明 备注(示例)
appid string 用户appid 注册开发账号
appsecret string 用户appsecret
version string 接口版本标识 固定值:day
query string 城市名称 如: 北京、东京、New York
支持坐标查询如:query=36.68,116.99
ip string IP地址 如: 169.114.222.119
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
isweek Int 周标记 固定值:1

备注

全球天气测试账号:appid=test&appsecret=test888

响应参数说明

参数名 类型 说明 备注
updateTime String UTC时间
timeZone String 所在时区
city String 城市名称
country String 国家名称
list Array 数据列表 每日详细预报
 ┗ date String 预报日期
 ┗ pharse_day String 白天天气情况
 ┗ pharse_day_icon String 白天天气情况Icon 查看Icon汇总表
 ┗ pharse_night String 夜间天气情况
 ┗ pharse_night String 夜间天气情况Icon 查看Icon汇总表
 ┗ pm25 String 实况PM2.5 只有第一天会有
 ┗ tem String 实况温度 只有第一天会有
 ┗ tem_day String 白天温度
 ┗ tem_night String 夜间温度

响应JSON

{
    "updateTime":"2023-11-06T06:35:12-0800",
    "country":"美国",
    "city":"洛杉矶",
    "list":[
        {
            "date":"2023-11-06",
            "pharse_day":"局部多云",
            "pharse_day_icon":"30",
            "pharse_night":"夜间有雾",
            "pharse_night_icon":"20",
            "pm25":"50",
            "tem":"12",
            "tem_day":"24",
            "tem_night":"14"
        },
        {
            "date":"2023-11-07",
            "pharse_day":"局部多云",
            "pharse_day_icon":"30",
            "pharse_night":"大部晴朗",
            "pharse_night_icon":"33",
            "pm25":"",
            "tem":"",
            "tem_day":"21",
            "tem_night":"12"
        },
        {
            "date":"2023-11-08",
            "pharse_day":"晴朗",
            "pharse_day_icon":"32",
            "pharse_night":"晴朗无云",
            "pharse_night_icon":"31",
            "pm25":"",
            "tem":"",
            "tem_day":"23",
            "tem_night":"10"
        },
        {
            "date":"2023-11-09",
            "pharse_day":"晴朗",
            "pharse_day_icon":"32",
            "pharse_night":"局部多云",
            "pharse_night_icon":"29",
            "pm25":"",
            "tem":"",
            "tem_day":"26",
            "tem_night":"10"
        },
        {
            "date":"2023-11-10",
            "pharse_day":"局部多云",
            "pharse_day_icon":"30",
            "pharse_night":"局部多云",
            "pharse_night_icon":"29",
            "pm25":"",
            "tem":"",
            "tem_day":"25",
            "tem_night":"10"
        },
        {
            "date":"2023-11-11",
            "pharse_day":"晴朗",
            "pharse_day_icon":"32",
            "pharse_night":"晴朗无云",
            "pharse_night_icon":"31",
            "pm25":"",
            "tem":"",
            "tem_day":"26",
            "tem_night":"12"
        },
        {
            "date":"2023-11-12",
            "pharse_day":"大部地区晴朗",
            "pharse_day_icon":"34",
            "pharse_night":"局部多云",
            "pharse_night_icon":"29",
            "pm25":"",
            "tem":"",
            "tem_day":"28",
            "tem_night":"13"
        }
    ]
}