全球化天气开发指南

全球20万+城市实况天气


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

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

请求方式及URL:

线路名称 提交方式 请求URL
洛杉矶 GET https://v0.tianqiapi.com

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

https://v0.tianqiapi.com/?version=today&unit=m&language=zh&query=洛杉矶&appid=43656176&appsecret=I42og6Lm

请求参数说明:

参数名 必选 类型 说明 备注(示例)
appid string 用户appid 注册开发账号
appsecret string 用户appsecret
version string 接口版本标识 固定值: today 每个接口的version值都不一样
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
unit string 温度单位 摄氏度m,华氏度f

备注

全球天气测试账号:appid=43656176&appsecret=I42og6Lm

响应参数说明

参数名 类型 说明 备注
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: 极强

响应JSON

{
    "errcode":0,
    "errmsg":"SUCCESS",
    "updateTime":"2022-01-15T19:48:51-0800",
    "updateTimeFormat":"2022-01-15 19:48:51",
    "timeZone":"America/Los_Angeles",
    "city":"洛杉矶",
    "country":"美国",
    "latitude":"34.054",
    "longitude":"-118.244",
    "day":{
        "icon":"26",
        "feelsLike":"16",
        "temperature":"16",
        "temperatureMaxSince7am":"20",
        "phrase":"多云",
        "phrase_img":"qing",
        "altimeter":"1020.66",
        "barometerTrend":"升温",
        "humidity":"49",
        "dewPoint":"6",
        "visibility":"16.09",
        "windSpeed":"5",
        "windDirCompass":"西北",
        "windDirDegrees":"310",
        "uvIndex":"0",
        "uvDescription":"低",
        "sunrise":"06:58",
        "sunset":"17:07",
        "moonrise":"15:09",
        "moonset":"05:22",
        "moonIcon":"WXG",
        "moonPhrase":"盈凸月",
        "narrative":"早些时候阵雨。 最低 13ºC。"
    }
}