开发指南

新用户可测试2000次 比某度更精准、及时,请进入气象台网站对比数据

全国实况天气数据列表接口 收费在线测试此接口(需要登录)


该接口一次性返回全国行政区级所有城市的实况气象数据, 并附带坐标, 方便绘制天气地图。
返回字段为:城市名称、城市编号、经纬度、天气情况、图标、实时温度、高温、低温、风力、风向、湿度、能见度、气压、空气质量、PM2.5

请求方式及url:

  • 请求方式:GET

  • 接口地址:(请将线路地址设置为服务端可动态修改的)

  • 线路1(推荐)https://v0.yiketianqi.com/api
  • 线路2:https://v1.yiketianqi.com/api
  • 线路3:https://v2.yiketianqi.com/api

请求示例

https://v0.yiketianqi.com/api/cityall?appid=&appsecret=

请求参数说明:

参数名 必选 类型 说明 备注(示例)
appid string 用户appid 注册开发账号
appsecret string 用户appsecret
callback string jsonp参数 如: jQuery.Callbacks
vue string 跨域参数 如果您使用的是react、vue、angular请填写值: 1

备注

该接口每日可访问500次, 注意缓存。

响应字段说明

参数名 类型 说明 备注
cityid String 城市ID
city String 城市名称
lng String 经度
lat String 纬度
wea String 天气情况
wea_img String 天气对应图标 固定9种类型(您也可以根据wea字段自己处理):
xue、lei、shachen、wu、bingbao、yun、yu、yin、qing
tem String 实时温度
tem1 String 高温
tem2 String 低温
win String 风向
speed String 风力等级
sd String 湿度
njd String 能见度
qy String 气压
air String 空气质量
pm String PM2.5

响应JSON

[
    {
        "cityid":"101010100",
        "city":"北京",
        "lat":"39.904989",
        "lng":"116.405285",
        "wea":"阴",
        "wea_img":"yin",
        "tem":"7",
        "tem1":"20",
        "tem2":"3",
        "win":"北风",
        "speed":"1级",
        "meter":"小于12km/h",
        "sd":"35%",
        "njd":"12.8km",
        "qy":"996",
        "air":"94",
        "pm":"94"
    },
    {
        "cityid":"101011600",
        "city":"东城",
        "lat":"39.917544",
        "lng":"116.418757",
        "wea":"阴",
        "wea_img":"yin",
        "tem":"9",
        "tem1":"20",
        "tem2":"4",
        "win":"东风",
        "speed":"1级",
        "meter":"小于12km/h",
        "sd":"33%",
        "njd":"9.7km",
        "qy":"996",
        "air":"",
        "pm":""
    },
    {
        "cityid":"101020100",
        "city":"上海",
        "lat":"31.231706",
        "lng":"121.472644",
        "wea":"晴",
        "wea_img":"qing",
        "tem":"14",
        "tem1":"23",
        "tem2":"11",
        "win":"静风",
        "speed":"0级",
        "meter":"",
        "sd":"45%",
        "njd":"24.9km",
        "qy":"1015",
        "air":"49",
        "pm":"49"
    },
    {
        "cityid":"101020400",
        "city":"黄浦",
        "lat":"31.222771",
        "lng":"121.490317",
        "wea":"晴",
        "wea_img":"qing",
        "tem":"14",
        "tem1":"23",
        "tem2":"11",
        "win":"静风",
        "speed":"0级",
        "meter":"",
        "sd":"45%",
        "njd":"24.9km",
        "qy":"1015",
        "air":"",
        "pm":""
    },
    {
        "cityid":"101030100",
        "city":"天津",
        "lat":"39.125596",
        "lng":"117.190182",
        "wea":"多云",
        "wea_img":"yun",
        "tem":"14",
        "tem1":"22",
        "tem2":"9",
        "win":"南风",
        "speed":"1级",
        "meter":"小于12km/h",
        "sd":"18%",
        "njd":"16.5km",
        "qy":"1001",
        "air":"87",
        "pm":"87"
    },
    {
        "cityid":"101030800",
        "city":"和平",
        "lat":"39.118327",
        "lng":"117.195907",
        "wea":"多云",
        "wea_img":"yun",
        "tem":"14",
        "tem1":"22",
        "tem2":"9",
        "win":"南风",
        "speed":"1级",
        "meter":"小于12km/h",
        "sd":"18%",
        "njd":"16.5km",
        "qy":"1001",
        "air":"",
        "pm":""
    }
    #共7450行数据, 已省略
]