中国和世界天气    支持HTTPS   

  • 数据编号:
    51
  • 接口状态:
    正常
  • 数据类型:
    便民类
  • 连接App数:
    3720
  • 描述:

    向开发者提供的准确、稳定、丰富的天气数据云服务。覆盖全国2567个市县地区、2100多个热门旅游景点以及全球5万个国际城市的数据;内容包括获取全国(国际)7-10天天气预报、每小时天气、实况天气、全国灾害预警、PM2.5空气质量、生活建议指数。阿凡达数据使用的是气象局官方授权的气象数据,保证了数据的优质与稳定性。

接口地址:http://api.avatardata.cn/WeatherWord/City
返回格式:JSON/XML
请求方式:GET/POST
请求示例: http://api.avatardata.cn/WeatherWord/City?key=[您申请的APPKEY]&city=shanghai
接口备注:在请求参数中,city城市名称可以用cityid或cityip代替。国内城市的查询建议使用cityid
请求参数:
  名称 类型 必填 说明
  key String 应用APPKEY
  city String 城市名(国内支持城市中文名和拼音,国外城市支持英文名)/CityId/CityIp
  dtype String 返回结果格式:可选JSON/XML,默认为JSON
  format Boolean 当返回结果格式为JSON时,是否对其进行格式化,为了节省流量默认为false,测试时您可以传入true来熟悉返回内容
  名称 类型 说明
  请参考JSON返回示例 - -
JSON返回示例:

{

  "result": {

    "alarms": [//灾害预警,若所在城市无预警则不显示该字段,仅限国内城市

      {

        "level": "黄色",  //预警等级

        "stat": "预警中",  //预警状态

        "title": "北京市怀柔区气象台发布暴雨黄色预警",  //预警信息标题

        "txt": "目前怀柔北部山区局地降雨量已达35毫米,预计未来1至2小时降雨仍将持续,局地累计雨量将达到50到70毫米,山区请注意防范地质灾害。",  //预警信息详情

        "type": "暴雨 "  //预警天气类型

      }

    ],

    "aqi": {//空气质量,仅限国内城市

      "city": {

        "aqi": "54",//空气质量指数

        "co": "1",//一氧化碳1小时平均值(ug/m³)

        "no2": "32",//二氧化氮1小时平均值(ug/m³)

        "o3": "56",//臭氧1小时平均值(ug/m³)

        "pm10": "49",//PM10 1小时平均值(ug/m³)

        "pm25": "37",//PM2.5 1小时平均值(ug/m³)

        "qlty": "良",//空气质量等级

        "so2": "16"//二氧化硫1小时平均值(ug/m³)

      }

    },

    "basic": {//基本信息

      "city": "上海",//城市名称

      "cnty": "中国",//国家

      "id": "CN101020100",//城市ID

      "lat": "31.213000",//城市维度

      "lon": "121.445000",//城市经度

      "update": {//更新时间

        "loc": "2016-01-12 14:05",//当地时间

        "utc": "2016-01-12 06:05"//UTC时间

      }

    },

    "daily_forecast": [//天气预报,国内7天,国际10天

      {

        "date": "2016-01-12",//预报日期

        "hum": "64",//相对湿度(%)

        "pcpn": "0.3", //降水量(mm)

        "pop": "91", //降水概率

        "pres": "1028", //气压

        "vis": "10",//能见度(km)

        "astro": { //天文数值  

          "sr": "06:53",//日出时间

          "ss": "17:10"//日落时间

        },

        "cond": { //天气状况

          "code_d": "104",//白天天气状况代码

          "code_n": "101",//夜间天气状况代码

          "txt_d": "阴",//白天天气状况描述

          "txt_n": "多云"//夜间天气状况描述

        },

        "tmp": {//温度

          "max": "6",//最高温度

          "min": "1"//最低温度

        },

        "wind": {//风力风向

          "deg": "356", //风向(360度)

          "dir": "北风",//风向

          "sc": "微风",//风力

          "spd": "6"//风速(kmph)

        }

      },

      {

        "date": "2016-01-13",

        "hum": "40",

        "pcpn": "0.0",

        "pop": "0",

        "pres": "1027",

        "vis": "10",

        "astro": {

          "sr": "06:53",

          "ss": "17:11"

        },

        "cond": {

          "code_d": "101",

          "code_n": "101",

          "txt_d": "多云",

          "txt_n": "多云"

        },

        "tmp": {

          "max": "6",

          "min": "1"

        },

        "wind": {

          "deg": "322",

          "dir": "北风",

          "sc": "微风",

          "spd": "10"

        }

      },

      {

        "date": "2016-01-14",

        "hum": "37",

        "pcpn": "0.0",

        "pop": "0",

        "pres": "1024",

        "vis": "10",

        "astro": {

          "sr": "06:53",

          "ss": "17:12"

        },

        "cond": {

          "code_d": "101",

          "code_n": "101",

          "txt_d": "多云",

          "txt_n": "多云"

        },

        "tmp": {

          "max": "9",

          "min": "2"

        },

        "wind": {

          "deg": "281",

          "dir": "西风",

          "sc": "微风",

          "spd": "10"

        }

      },

      {

        "date": "2016-01-15",

        "hum": "27",

        "pcpn": "0.0",

        "pop": "0",

        "pres": "1021",

        "vis": "10",

        "astro": {

          "sr": "06:53",

          "ss": "17:13"

        },

        "cond": {

          "code_d": "104",

          "code_n": "101",

          "txt_d": "阴",

          "txt_n": "多云"

        },

        "tmp": {

          "max": "10",

          "min": "5"

        },

        "wind": {

          "deg": "319",

          "dir": "西风",

          "sc": "微风",

          "spd": "7"

        }

      },

      {

        "date": "2016-01-16",

        "hum": "34",

        "pcpn": "0.0",

        "pop": "0",

        "pres": "1021",

        "vis": "10",

        "astro": {

          "sr": "06:53",

          "ss": "17:14"

        },

        "cond": {

          "code_d": "101",

          "code_n": "104",

          "txt_d": "多云",

          "txt_n": "阴"

        },

        "tmp": {

          "max": "10",

          "min": "3"

        },

        "wind": {

          "deg": "80",

          "dir": "东北风",

          "sc": "微风",

          "spd": "8"

        }

      },

      {

        "date": "2016-01-17",

        "hum": "48",

        "pcpn": "0.1",

        "pop": "27",

        "pres": "1022",

        "vis": "10",

        "astro": {

          "sr": "06:53",

          "ss": "17:15"

        },

        "cond": {

          "code_d": "305",

          "code_n": "305",

          "txt_d": "小雨",

          "txt_n": "小雨"

        },

        "tmp": {

          "max": "7",

          "min": "2"

        },

        "wind": {

          "deg": "33",

          "dir": "北风",

          "sc": "3-4",

          "spd": "16"

        }

      },

      {

        "date": "2016-01-18",

        "hum": "52",

        "pcpn": "0.0",

        "pop": "12",

        "pres": "1029",

        "vis": "10",

        "astro": {

          "sr": "06:52",

          "ss": "17:16"

        },

        "cond": {

          "code_d": "104",

          "code_n": "305",

          "txt_d": "阴",

          "txt_n": "小雨"

        },

        "tmp": {

          "max": "5",

          "min": "2"

        },

        "wind": {

          "deg": "355",

          "dir": "西北风",

          "sc": "微风",

          "spd": "10"

        }

      },

      {

        "date": "2016-01-19",

        "hum": "32",

        "pcpn": "0.0",

        "pop": "0",

        "pres": "1031",

        "vis": "10",

        "astro": {

          "sr": "06:53",

          "ss": "17:17"

        },

        "cond": {

          "code_d": "100",

          "code_n": "103",

          "txt_d": "晴",

          "txt_n": "晴间多云"

        },

        "tmp": {

          "max": "7",

          "min": "2"

        },

        "wind": {

          "deg": "9",

          "dir": "北风",

          "sc": "3-4",

          "spd": "19"

        }

      },

      {

        "date": "2016-01-20",

        "hum": "55",

        "pcpn": "0.5",

        "pop": "25",

        "pres": "1032",

        "vis": "10",

        "astro": {

          "sr": "06:52",

          "ss": "17:18"

        },

        "cond": {

          "code_d": "103",

          "code_n": "309",

          "txt_d": "晴间多云",

          "txt_n": "毛毛雨/细雨"

        },

        "tmp": {

          "max": "9",

          "min": "6"

        },

        "wind": {

          "deg": "79",

          "dir": "东风",

          "sc": "3-4",

          "spd": "19"

        }

      },

      {

        "date": "2016-01-21",

        "hum": "91",

        "pcpn": "23.4",

        "pop": "28",

        "pres": "1028",

        "vis": "7",

        "astro": {

          "sr": "06:52",

          "ss": "17:19"

        },

        "cond": {

          "code_d": "306",

          "code_n": "306",

          "txt_d": "中雨",

          "txt_n": "中雨"

        },

        "tmp": {

          "max": "8",

          "min": "7"

        },

        "wind": {

          "deg": "71",

          "dir": "东北风",

          "sc": "3-4",

          "spd": "19"

        }

      }

    ],

    "hourly_forecast": [//当天每小时天气预报

      {

        "date": "2016-01-12 13:00",//时间

        "hum": "64",//相对湿度(%)

        "pop": "0",//降水概率

        "pres": "1028",//气压

        "tmp": "7",//温度

        "wind": {//风力风向

          "deg": "239",//风向(360度)

          "dir": "西南风",//风向

          "sc": "3-4",//风力

          "spd": "21"//风速(kmph)

        }

      },

      {

        "date": "2016-01-12 14:00",

        "hum": "64",

        "pop": "0",

        "pres": "1028",

        "tmp": "7",

        "wind": {

          "deg": "356",

          "dir": "北风",

          "sc": "3-4",

          "spd": "20"

        }

      },

      {

        "date": "2016-01-12 15:00",

        "hum": "65",

        "pop": "0",

        "pres": "1028",

        "tmp": "7",

        "wind": {

          "deg": "356",

          "dir": "北风",

          "sc": "3-4",

          "spd": "20"

        }

      },

      {

        "date": "2016-01-12 16:00",

        "hum": "67",

        "pop": "0",

        "pres": "1028",

        "tmp": "7",

        "wind": {

          "deg": "357",

          "dir": "北风",

          "sc": "3-4",

          "spd": "19"

        }

      },

      {

        "date": "2016-01-12 17:00",

        "hum": "68",

        "pop": "0",

        "pres": "1028",

        "tmp": "7",

        "wind": {

          "deg": "357",

          "dir": "北风",

          "sc": "3-4",

          "spd": "19"

        }

      },

      {

        "date": "2016-01-12 18:00",

        "hum": "70",

        "pop": "0",

        "pres": "1028",

        "tmp": "6",

        "wind": {

          "deg": "356",

          "dir": "北风",

          "sc": "3-4",

          "spd": "18"

        }

      },

      {

        "date": "2016-01-12 19:00",

        "hum": "71",

        "pop": "0",

        "pres": "1029",

        "tmp": "6",

        "wind": {

          "deg": "356",

          "dir": "北风",

          "sc": "微风",

          "spd": "16"

        }

      },

      {

        "date": "2016-01-12 20:00",

        "hum": "72",

        "pop": "0",

        "pres": "1029",

        "tmp": "5",

        "wind": {

          "deg": "355",

          "dir": "北风",

          "sc": "微风",

          "spd": "15"

        }

      },

      {

        "date": "2016-01-12 21:00",

        "hum": "71",

        "pop": "0",

        "pres": "1029",

        "tmp": "5",

        "wind": {

          "deg": "351",

          "dir": "北风",

          "sc": "微风",

          "spd": "14"

        }

      },

      {

        "date": "2016-01-12 22:00",

        "hum": "71",

        "pop": "0",

        "pres": "1029",

        "tmp": "5",

        "wind": {

          "deg": "347",

          "dir": "西北风",

          "sc": "微风",

          "spd": "13"

        }

      },

      {

        "date": "2016-01-12 23:00",

        "hum": "70",

        "pop": "0",

        "pres": "1029",

        "tmp": "5",

        "wind": {

          "deg": "343",

          "dir": "西北风",

          "sc": "微风",

          "spd": "12"

        }

      },

      {

        "date": "2016-01-13 00:00",

        "hum": "70",

        "pop": "0",

        "pres": "1029",

        "tmp": "4",

        "wind": {

          "deg": "341",

          "dir": "西北风",

          "sc": "微风",

          "spd": "13"

        }

      },

      {

        "date": "2016-01-13 01:00",

        "hum": "71",

        "pop": "0",

        "pres": "1029",

        "tmp": "3",

        "wind": {

          "deg": "340",

          "dir": "西北风",

          "sc": "微风",

          "spd": "13"

        }

      },

      {

        "date": "2016-01-13 02:00",

        "hum": "71",

        "pop": "0",

        "pres": "1029",

        "tmp": "2",

        "wind": {

          "deg": "338",

          "dir": "西北风",

          "sc": "微风",

          "spd": "14"

        }

      },

      {

        "date": "2016-01-13 03:00",

        "hum": "71",

        "pop": "0",

        "pres": "1028",

        "tmp": "2",

        "wind": {

          "deg": "338",

          "dir": "西北风",

          "sc": "微风",

          "spd": "14"

        }

      },

      {

        "date": "2016-01-13 04:00",

        "hum": "71",

        "pop": "0",

        "pres": "1028",

        "tmp": "2",

        "wind": {

          "deg": "337",

          "dir": "西北风",

          "sc": "微风",

          "spd": "15"

        }

      },

      {

        "date": "2016-01-13 05:00",

        "hum": "71",

        "pop": "0",

        "pres": "1028",

        "tmp": "1",

        "wind": {

          "deg": "337",

          "dir": "西北风",

          "sc": "微风",

          "spd": "15"

        }

      },

      {

        "date": "2016-01-13 06:00",

        "hum": "65",

        "pop": "0",

        "pres": "1028",

        "tmp": "1",

        "wind": {

          "deg": "335",

          "dir": "西北风",

          "sc": "微风",

          "spd": "16"

        }

      },

      {

        "date": "2016-01-13 07:00",

        "hum": "59",

        "pop": "0",

        "pres": "1029",

        "tmp": "2",

        "wind": {

          "deg": "332",

          "dir": "西北风",

          "sc": "微风",

          "spd": "16"

        }

      },

      {

        "date": "2016-01-13 08:00",

        "hum": "53",

        "pop": "0",

        "pres": "1029",

        "tmp": "2",

        "wind": {

          "deg": "330",

          "dir": "西北风",

          "sc": "微风",

          "spd": "16"

        }

      },

      {

        "date": "2016-01-13 09:00",

        "hum": "49",

        "pop": "0",

        "pres": "1029",

        "tmp": "3",

        "wind": {

          "deg": "330",

          "dir": "西北风",

          "sc": "3-4",

          "spd": "17"

        }

      },

      {

        "date": "2016-01-13 10:00",

        "hum": "44",

        "pop": "0",

        "pres": "1029",

        "tmp": "4",

        "wind": {

          "deg": "329",

          "dir": "西北风",

          "sc": "3-4",

          "spd": "17"

        }

      },

      {

        "date": "2016-01-13 11:00",

        "hum": "39",

        "pop": "0",

        "pres": "1030",

        "tmp": "5",

        "wind": {

          "deg": "329",

          "dir": "西北风",

          "sc": "3-4",

          "spd": "18"

        }

      },

      {

        "date": "2016-01-13 12:00",

        "hum": "39",

        "pop": "0",

        "pres": "1029",

        "tmp": "5",

        "wind": {

          "deg": "326",

          "dir": "西北风",

          "sc": "3-4",

          "spd": "18"

        }

      },

      {

        "date": "2016-01-13 13:00",

        "hum": "40",

        "pop": "0",

        "pres": "1028",

        "tmp": "6",

        "wind": {

          "deg": "324",

          "dir": "西北风",

          "sc": "3-4",

          "spd": "17"

        }

      },

      {

        "date": "2016-01-13 14:00",

        "hum": "40",

        "pop": "0",

        "pres": "1027",

        "tmp": "7",

        "wind": {

          "deg": "322",

          "dir": "西北风",

          "sc": "3-4",

          "spd": "17"

        }

      }

    ],

    "now": {//实况天气

      "cond": {//天气状况

        "code": "104",//天气状况代码

        "txt": "阴"/天气状况描述

      },

      "fl": "0",//体感温度

      "hum": "69",//相对湿度(%)

      "pcpn": "0",//降水量(mm)

      "pres": "1028",//气压

      "tmp": "4",//温度

      "vis": "10",//能见度(km)

      "wind": {//风力风向

        "deg": "330",//风向(360度)

        "dir": "西北风",//风向

        "sc": "3-4",//风力

        "spd": "16"//风速(kmph)

      }

    },

    "suggestion": {//生活指数,仅限国内城市

      "comf": {//舒适度指数

        "brf": "较舒适",//简介

        "txt": "白天天气阴沉,会感到有点儿凉,但大部分人完全可以接受。"//详细描述

      },

      "cw": {//洗车指数

        "brf": "较适宜",

        "txt": "较适宜洗车,未来一天无雨,风力较小,擦洗一新的汽车至少能保持一天。"

      },

      "drsg": {//穿衣指数

        "brf": "较冷",

        "txt": "建议着厚外套加毛衣等服装。年老体弱者宜着大衣、呢外套加羊毛衫。"

      },

      "flu": { //感冒指数

        "brf": "极易发",

        "txt": "将有一次强降温过程,天气寒冷,极易发生感冒,请特别注意增加衣服保暖防寒。"

      },

      "sport": { //运动指数

        "brf": "较不宜",

        "txt": "阴天,且天气寒冷,推荐您在室内进行低强度运动;若坚持户外运动,请选择合适的运动并注意保暖。"

      },

      "trav": {//旅游指数

        "brf": "适宜",

        "txt": "天气较好,气温稍低,会感觉稍微有点凉,不过也是个好天气哦。适宜旅游,可不要错过机会呦!"

      },

      "uv": {//紫外线指数

        "brf": "最弱",

        "txt": "属弱紫外线辐射天气,无需特别防护。若长期在户外,建议涂擦SPF在8-12之间的防晒护肤品。"

      }

    }

  },

  "error_code": 0,

  "reason": "Succes"

}