全球20万+城市实况天气

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

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

请求参数

Query 参数

appid

string

必需

注册开发者账号

示例值:

123456

appsecret

string

必需

用户appsecret

示例值:

123456

version

string

必需

接口版本标识,固定值: today 每个接口的version值都不一样

示例值:

today

query

string

必需

如: 北京、东京、New York
支持坐标查询如：query=36.68,116.99

示例值:

北京

string

必需

查询IP所在城市天气

示例值:

IP地址

language

string

可选

默认中文
英文: en 日文: jp
德语: de 法语: fr
韩语: kr 俄语: ru
葡萄牙: pt 西班牙: es
萨特阿拉伯: sa 意大利: it

示例值:

unit

string

可选

温度单位，摄氏度m，华氏度f

示例值:

返回响应

🟢200成功

application/json

Body

cityid

string

必需

city

string

必需

cityEn

string

必需

country

string

必需

countryEn

string

必需

update_time

string

必需

data

array [object {8}]

必需

date

string

必需

wea

string

必需

wea_img

string

必需

tem1

string

必需

tem2

string

必需

win

array[string]

必需

win_speed

string

必需

hours

array [object {6}]

必需

errcode

integer

必需

errmsg

string

必需

updateTime

string

必需

updateTimeFormat

string

必需

timeZone

string

必需

latitude

string

必需

longitude

string

必需

day

object

必需

icon

string

必需

feelsLike

string

必需

temperature

string

必需

temperatureMaxSince7am

string

必需

phrase

string

必需

phrase_img

string

必需

altimeter

string

必需

barometerTrend

string

必需

humidity

string

必需

dewPoint

string

必需

visibility

string

必需

windSpeed

string

必需

windDirCompass

string

必需

windDirDegrees

string

必需

uvIndex

string

必需

uvDescription

string

必需

sunrise

string

必需

sunset

string

必需

moonrise

string

必需

moonset

string

必需

moonIcon

string

必需

moonPhrase

string

必需

narrative

string

必需

示例

{
    "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。"
    }
}

全球20万+城市实况天气

请求参数

示例代码

返回响应