全球城市实况天气 (免费测试)

该接口支持全球20万+城市,地图上有的几乎都可以返回天气数据,支持20余种语言。
预报今天天气情况。
包含基本天气信息、湿度、能见度、气压、降雨概率、日出日落、月初月落、空气质量指数等,可按地名、IP、LBS坐标查询。

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

请求次数限制仅限于单个APPID每日请求次数不超规定范围,并不会限制使用的项目数量、App、设备及IP等。

请求方式:

GET

接口地址:(请将线路地址设置在服务端, 为动态可修改的, 请勿在C端直连接口, 防止遇到网络问题导致程序异常。)

测试线路1(付费后会配置专属线路):http://m7200.tianqiapis.com

请求示例:

http://m7200.tianqiapis.com/?version=today&unit=m&language=zh&query=洛杉矶&appid=&appsecret=

请求参数:

参数名 必选 类型 说明 备注(示例)
appid string 用户appid 注册开发账号
appsecret string 用户appsecret
version string 接口版本标识 today 全球实况天气 (返回内容更少,速度更快)
day 全球实况+48小时+15日天气
query string 城市名称 如: 北京、东京、New York
支持坐标查询如:query=36.68,116.99
ip string IP地址 查询IP所在城市天气
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

备注:

全球天气测试账号(定期更换,测试后请购买):appid=apptest66&appsecret=abc123456

响应参数说明:

参数名 类型 说明 备注
updateTime String UTC时间
updateTimeFormat String 更新时间
timeZone String 所在时区
city String 城市名称
country String 国家名称
longitude String 经度
latitude String 纬度
day String 今日天气情况 含每小时详细预报等
 ┗ icon String 天气现象代码 查看Icon汇总表
 ┗ 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 紫外线等级描述 0~2:
3~5: 中等
6~7:
8~9: 很强
>10: 极强
 ┗ sunrise String 日出时间 06:28
 ┗ sunset String 日落时间 19:14
 ┗ moonrise String 月出时间 22:14
 ┗ moonset String 月落时间 11:40
 ┗ moonIcon String 月相icon
 ┗ moonPhrase String 月相 如:Waning Gibbous
 ┗ narrative String 天气情况描述 如:Partly cloudy. Highs 25 to 27C and lows 17 to 19C.
 ┗ aqi String 空气质量指数
 ┗ ┗ AIR String 空气质量指数 amount: 今日空气质量, index: 等级描述, pp: 主要污染物
 ┗ ┗ CO String 一氧化碳 amount: 浓度µg/m3, index: 数值, category: 等级描述
 ┗ ┗ NO2 String 二氧化氮 amount: 浓度µg/m3, index: 数值, category: 等级描述
 ┗ ┗ O3 String 臭氧 amount: 浓度µg/m3, index: 数值, category: 等级描述
 ┗ ┗ PM10 String 10微米以下细颗粒物 amount: 浓度µg/m3, index: 数值, category: 等级描述
 ┗ ┗ PM2.5 String 2.5微米以下细颗粒物 amount: 浓度µg/m3, index: 数值, category: 等级描述
 ┗ ┗ SO2 String 二氧化硫 amount: 浓度µg/m3, index: 数值, category: 等级描述

响应JSON:

{
    "errcode":0,
    "errmsg":"SUCCESS",
    "updateTime":"2023-09-04T06:43:24-0700",
    "updateTimeFormat":"2023-09-04 06:43:24",
    "timeZone":"America\/Los_Angeles",
    "city":"Los Angeles",
    "country":"United States",
    "latitude":"34.054",
    "longitude":"-118.243",
    "day":{
        "icon":"30",
        "feelsLike":"18",
        "temperature":"18",
        "temperatureMaxSince7am":"26",
        "phrase":"Partly Cloudy",
        "phrase_img":"yun",
        "altimeter":"1013.55",
        "barometerTrend":"Rising",
        "humidity":"84",
        "dewPoint":"15",
        "visibility":"16.09",
        "windSpeed":"2",
        "windDirCompass":"E",
        "windDirDegrees":"100",
        "uvIndex":"0",
        "uvDescription":"Low",
        "sunrise":"06:28",
        "sunset":"19:14",
        "moonrise":"22:14",
        "moonset":"11:40",
        "moonIcon":"WNG",
        "moonPhrase":"Waning Gibbous",
        "narrative":"Partly cloudy. Highs 25 to 27C and lows 17 to 19C.",
        "aqi":{
            "AIR":{
                "amount":"55",
                "index":"Moderate",
                "pp":"PM2.5"
            },
            "CO":{
                "amount":"290",
                "index":"2",
                "category":"Good"
            },
            "NO2":{
                "amount":"26.38",
                "index":"13",
                "category":"Good"
            },
            "O3":{
                "amount":"4.34",
                "index":"10",
                "category":"Good"
            },
            "PM10":{
                "amount":"21.27",
                "index":"19",
                "category":"Good"
            },
            "PM2.5":{
                "amount":"13.68",
                "index":"55",
                "category":"Moderate"
            },
            "SO2":{
                "amount":"10.99",
                "index":"6",
                "category":"Good"
            }
        }
    }
}