全球天气预报信息 - 咕咕数据 API 文档

全球天气预报信息
接口详情官网地址: https://www.gugudata.com/api/details/weatherinfo
支持全球城市名称、LocationID 和经纬度查询，同时兼容原有地区编码调用。
请求方法: GET
接口路径: /weather/weatherinfo
调试地址: https://api.gugudata.com/weather/weatherinfo/sz
OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
请求参数:
appkey (string, 必填): 付费后获取的 APPKEY
code (string, 可选): 兼容参数，支持原地区编码或 [经度,纬度]
location (string, 可选): 推荐参数，支持城市名称、LocationID 或经度,纬度；与 code 同时传递时优先生效
days (integer, 可选): 预报天数，范围 1-7，默认 1
lang (string, 可选): 返回语言，默认 zh
code 与 location 至少传递一个
返回说明:
Data 为按日期升序排列的天气预报数组
保留原有日期、地区、天气、温度、风向风力、日出日落字段
WeatherPerHour 返回对应日期的逐小时天气预报
LifeHelperUV、LifeHelperWear、LifeHelperWashCar 返回未来 3 天生活指数
LifeHelperAir 仅在查询位置有对应数据时返回
无同语义数据的历史最高/最低温度字段继续返回 null
WeatherDataGenerateDateTime 为预报数据更新时间
业务状态码:
100: 正常返回
501: 参数错误
502: 请求频率受限
503: 订单已过期
504: APPKEY 错误
505: 调用额度不足
900: 服务内部异常
支持 HTTPS，接口调用状态见 https://www.gugudata.com/status。
请求示例代码
Shell
JavaScript
Java
Swift
PHP
Python
HTTP
Objective-C
Ruby
OCaml
Dart
返回响应
🟢200成功
application/json
Bodyapplication/json
示例
{
  "DataStatus": {
    "RequestParameter": "code=101190401&location=&days=3&lang=zh",
    "StatusCode": 100,
    "StatusDescription": "请求成功。",
    "ResponseDateTime": "2026-08-09 16:53:53.053",
    "DataTotalCount": 3
  },
  "Data": [
    {
      "Code": "101190401",
      "CodeAddress": "中国,江苏省,苏州,苏州",
      "WeatherDate": "2026-08-09",
      "WeatherRegion": {
        "Code": "101190401",
        "ReginType": 0,
        "ProvinceCode": null,
        "ProvinceName": "江苏省",
        "CityCode": null,
        "CityName": "苏州",
        "DistrictCode": null,
        "DistrictName": "苏州",
        "TownCode": null,
        "TownName": null
      },
      "WeatherInfo": "大雨转暴雨",
      "TemperatureHigh": 26,
      "TemperatureLow": 25,
      "TodayHistoryHighestTemperature": null,
      "TodayHistoryLowestTemperature": null,
      "WeatherWindCondition1": "东北风",
      "WeatherWindCondition2": "东风",
      "WeatherWindLevel": "3-4",
      "SunRiseTime": "05:20",
      "SunSetTime": "18:48",
      "WeatherPerHour": [
        {
          "WeatherTime": "17",
          "WeatherInfo": "中雨",
          "Wet": 92,
          "Temperature": "25",
          "WeatherWindCondition": "东北风",
          "WeatherWindLevel": "3-4"
        },
        {
          "WeatherTime": "18",
          "WeatherInfo": "多云",
          "Wet": 91,
          "Temperature": "26",
          "WeatherWindCondition": "东北风",
          "WeatherWindLevel": "5-6"
        },
        {
          "WeatherTime": "19",
          "WeatherInfo": "小雨",
          "Wet": 91,
          "Temperature": "26",
          "WeatherWindCondition": "东北风",
          "WeatherWindLevel": "4-5"
        },
        {
          "WeatherTime": "20",
          "WeatherInfo": "小雨",
          "Wet": 95,
          "Temperature": "26",
          "WeatherWindCondition": "东北风",
          "WeatherWindLevel": "4-5"
        },
        {
          "WeatherTime": "21",
          "WeatherInfo": "小雨",
          "Wet": 94,
          "Temperature": "26",
          "WeatherWindCondition": "东北风",
          "WeatherWindLevel": "4-5"
        },
        {
          "WeatherTime": "22",
          "WeatherInfo": "小雨",
          "Wet": 95,
          "Temperature": "26",
          "WeatherWindCondition": "东北风",
          "WeatherWindLevel": "3-4"
        },
        {
          "WeatherTime": "23",
          "WeatherInfo": "小雨",
          "Wet": 94,
          "Temperature": "25",
          "WeatherWindCondition": "东北风",
          "WeatherWindLevel": "3-4"
        }
      ],
      "LifeHelperUV": {
        "HelperName": "紫外线指数",
        "HelperStatus": "最弱",
        "HelperLevel": 1,
        "HelperContent": "属弱紫外线辐射天气，无需特别防护。若长期在户外，建议涂擦SPF在8-12之间的防晒护肤品。"
      },
      "LifeHelperWear": {
        "HelperName": "穿衣指数",
        "HelperStatus": "舒适",
        "HelperLevel": 5,
        "HelperContent": "建议着长袖T恤、衬衫加单裤等服装。年老体弱者宜着针织长袖衬衫、马甲和长裤。"
      },
      "LifeHelperWashCar": {
        "HelperName": "洗车指数",
        "HelperStatus": "不宜",
        "HelperLevel": 4,
        "HelperContent": "不宜洗车，未来24小时内有雨，如果在此期间洗车，雨水和路上的泥水可能会再次弄脏您的爱车。"
      },
      "LifeHelperAir": {
        "HelperName": "空气污染扩散条件指数",
        "HelperStatus": "良",
        "HelperLevel": 2,
        "HelperContent": "气象条件有利于空气污染物稀释、扩散和清除，可在室外正常活动。"
      },
      "WeatherDataGenerateDateTime": "2026-08-09T16:53+08:00"
    },
    {
      "Code": "101190401",
      "CodeAddress": "中国,江苏省,苏州,苏州",
      "WeatherDate": "2026-08-10",
      "WeatherRegion": {
        "Code": "101190401",
        "ReginType": 0,
        "ProvinceCode": null,
        "ProvinceName": "江苏省",
        "CityCode": null,
        "CityName": "苏州",
        "DistrictCode": null,
        "DistrictName": "苏州",
        "TownCode": null,
        "TownName": null
      },
      "WeatherInfo": "大雨转小雨",
      "TemperatureHigh": 28,
      "TemperatureLow": 27,
      "TodayHistoryHighestTemperature": null,
      "TodayHistoryLowestTemperature": null,
      "WeatherWindCondition1": "东风",
      "WeatherWindCondition2": "东风",
      "WeatherWindLevel": "4-5/3-4",
      "SunRiseTime": "05:20",
      "SunSetTime": "18:47",
      "WeatherPerHour": [
        {
          "WeatherTime": "00",
          "WeatherInfo": "小雨",
          "Wet": 93,
          "Temperature": "25",
          "WeatherWindCondition": "东北风",
          "WeatherWindLevel": "3-4"
        },
        {
          "WeatherTime": "01",
          "WeatherInfo": "小雨",
          "Wet": 93,
          "Temperature": "25",
          "WeatherWindCondition": "东北风",
          "WeatherWindLevel": "3-4"
        },
        {
          "WeatherTime": "02",
          "WeatherInfo": "小雨",
          "Wet": 94,
          "Temperature": "25",
          "WeatherWindCondition": "东风",
          "WeatherWindLevel": "3-4"
        },
        {
          "WeatherTime": "03",
          "WeatherInfo": "小雨",
          "Wet": 94,
          "Temperature": "26",
          "WeatherWindCondition": "东风",
          "WeatherWindLevel": "3-4"
        },
        {
          "WeatherTime": "04",
          "WeatherInfo": "小雨",
          "Wet": 94,
          "Temperature": "26",
          "WeatherWindCondition": "东风",
          "WeatherWindLevel": "4-5"
        },
        {
          "WeatherTime": "05",
          "WeatherInfo": "小雨",
          "Wet": 95,
          "Temperature": "26",
          "WeatherWindCondition": "东风",
          "WeatherWindLevel": "4-5"
        },
        {
          "WeatherTime": "06",
          "WeatherInfo": "小雨",
          "Wet": 95,
          "Temperature": "26",
          "WeatherWindCondition": "东风",
          "WeatherWindLevel": "4-5"
        },
        {
          "WeatherTime": "07",
          "WeatherInfo": "阴",
          "Wet": 96,
          "Temperature": "26",
          "WeatherWindCondition": "东风",
          "WeatherWindLevel": "4-5"
        },
        {
          "WeatherTime": "08",
          "WeatherInfo": "阴",
          "Wet": 95,
          "Temperature": "27",
          "WeatherWindCondition": "东风",
          "WeatherWindLevel": "4-5"
        },
        {
          "WeatherTime": "09",
          "WeatherInfo": "阴",
          "Wet": 92,
          "Temperature": "27",
          "WeatherWindCondition": "东风",
          "WeatherWindLevel": "4-5"
        },
        {
          "WeatherTime": "10",
          "WeatherInfo": "小雨",
          "Wet": 90,
          "Temperature": "27",
          "WeatherWindCondition": "东风",
          "WeatherWindLevel": "4-5"
        },
        {
          "WeatherTime": "11",
          "WeatherInfo": "小雨",
          "Wet": 87,
          "Temperature": "27",
          "WeatherWindCondition": "东风",
          "WeatherWindLevel": "5-6"
        },
        {
          "WeatherTime": "12",
          "WeatherInfo": "小雨",
          "Wet": 86,
          "Temperature": "27",
          "WeatherWindCondition": "东风",
          "WeatherWindLevel": "5-6"
        },
        {
          "WeatherTime": "13",
          "WeatherInfo": "中雨",
          "Wet": 88,
          "Temperature": "27",
          "WeatherWindCondition": "东风",
          "WeatherWindLevel": "5-6"
        },
        {
          "WeatherTime": "14",
          "WeatherInfo": "小雨",
          "Wet": 90,
          "Temperature": "27",
          "WeatherWindCondition": "东风",
          "WeatherWindLevel": "5-6"
        },
        {
          "WeatherTime": "15",
          "WeatherInfo": "小雨",
          "Wet": 90,
          "Temperature": "27",
          "WeatherWindCondition": "东风",
          "WeatherWindLevel": "5-6"
        },
        {
          "WeatherTime": "16",
          "WeatherInfo": "小雨",
          "Wet": 89,
          "Temperature": "27",
          "WeatherWindCondition": "东风",
          "WeatherWindLevel": "5-6"
        },
        {
          "WeatherTime": "17",
          "WeatherInfo": "多云",
          "Wet": 86,
          "Temperature": "27",
          "WeatherWindCondition": "东风",
          "WeatherWindLevel": "5-6"
        },
        {
          "WeatherTime": "18",
          "WeatherInfo": "多云",
          "Wet": 89,
          "Temperature": "27",
          "WeatherWindCondition": "东风",
          "WeatherWindLevel": "5-6"
        },
        {
          "WeatherTime": "19",
          "WeatherInfo": "阴",
          "Wet": 91,
          "Temperature": "27",
          "WeatherWindCondition": "东风",
          "WeatherWindLevel": "5-6"
        },
        {
          "WeatherTime": "20",
          "WeatherInfo": "阴",
          "Wet": 94,
          "Temperature": "27",
          "WeatherWindCondition": "东风",
          "WeatherWindLevel": "5-6"
        },
        {
          "WeatherTime": "21",
          "WeatherInfo": "多云",
          "Wet": 94,
          "Temperature": "27",
          "WeatherWindCondition": "东风",
          "WeatherWindLevel": "5-6"
        },
        {
          "WeatherTime": "22",
          "WeatherInfo": "多云",
          "Wet": 93,
          "Temperature": "27",
          "WeatherWindCondition": "东风",
          "WeatherWindLevel": "4-5"
        },
        {
          "WeatherTime": "23",
          "WeatherInfo": "多云",
          "Wet": 94,
          "Temperature": "27",
          "WeatherWindCondition": "东风",
          "WeatherWindLevel": "4-5"
        }
      ],
      "LifeHelperUV": {
        "HelperName": "紫外线指数",
        "HelperStatus": "弱",
        "HelperLevel": 2,
        "HelperContent": "紫外线强度较弱，建议出门前涂擦SPF在12-15之间、PA+的防晒护肤品。"
      },
      "LifeHelperWear": {
        "HelperName": "穿衣指数",
        "HelperStatus": "舒适",
        "HelperLevel": 5,
        "HelperContent": "建议着长袖T恤、衬衫加单裤等服装。年老体弱者宜着针织长袖衬衫、马甲和长裤。"
      },
      "LifeHelperWashCar": {
        "HelperName": "洗车指数",
        "HelperStatus": "不宜",
        "HelperLevel": 4,
        "HelperContent": "不宜洗车，未来24小时内有雨，如果在此期间洗车，雨水和路上的泥水可能会再次弄脏您的爱车。"
      },
      "LifeHelperAir": {
        "HelperName": "空气污染扩散条件指数",
        "HelperStatus": "优",
        "HelperLevel": 1,
        "HelperContent": "气象条件非常有利于空气污染物稀释、扩散和清除，可在室外正常活动。"
      },
      "WeatherDataGenerateDateTime": "2026-08-09T16:53+08:00"
    },
    {
      "Code": "101190401",
      "CodeAddress": "中国,江苏省,苏州,苏州",
      "WeatherDate": "2026-08-11",
      "WeatherRegion": {
        "Code": "101190401",
        "ReginType": 0,
        "ProvinceCode": null,
        "ProvinceName": "江苏省",
        "CityCode": null,
        "CityName": "苏州",
        "DistrictCode": null,
        "DistrictName": "苏州",
        "TownCode": null,
        "TownName": null
      },
      "WeatherInfo": "中雨转小雨",
      "TemperatureHigh": 29,
      "TemperatureLow": 28,
      "TodayHistoryHighestTemperature": null,
      "TodayHistoryLowestTemperature": null,
      "WeatherWindCondition1": "东南风",
      "WeatherWindCondition2": "东南风",
      "WeatherWindLevel": "1-3",
      "SunRiseTime": "05:21",
      "SunSetTime": "18:46",
      "WeatherPerHour": [
        {
          "WeatherTime": "00",
          "WeatherInfo": "小雨",
          "Wet": 96,
          "Temperature": "27",
          "WeatherWindCondition": "东风",
          "WeatherWindLevel": "4-5"
        },
        {
          "WeatherTime": "01",
          "WeatherInfo": "多云",
          "Wet": 93,
          "Temperature": "27",
          "WeatherWindCondition": "东风",
          "WeatherWindLevel": "4-5"
        },
        {
          "WeatherTime": "02",
          "WeatherInfo": "小雨",
          "Wet": 94,
          "Temperature": "27",
          "WeatherWindCondition": "东风",
          "WeatherWindLevel": "4-5"
        },
        {
          "WeatherTime": "03",
          "WeatherInfo": "小雨",
          "Wet": 94,
          "Temperature": "27",
          "WeatherWindCondition": "东南风",
          "WeatherWindLevel": "4-5"
        },
        {
          "WeatherTime": "04",
          "WeatherInfo": "小雨",
          "Wet": 93,
          "Temperature": "27",
          "WeatherWindCondition": "东南风",
          "WeatherWindLevel": "3-4"
        },
        {
          "WeatherTime": "05",
          "WeatherInfo": "多云",
          "Wet": 93,
          "Temperature": "27",
          "WeatherWindCondition": "东南风",
          "WeatherWindLevel": "3-4"
        },
        {
          "WeatherTime": "06",
          "WeatherInfo": "多云",
          "Wet": 93,
          "Temperature": "27",
          "WeatherWindCondition": "东南风",
          "WeatherWindLevel": "4-5"
        },
        {
          "WeatherTime": "07",
          "WeatherInfo": "多云",
          "Wet": 91,
          "Temperature": "27",
          "WeatherWindCondition": "东风",
          "WeatherWindLevel": "3-4"
        },
        {
          "WeatherTime": "08",
          "WeatherInfo": "多云",
          "Wet": 89,
          "Temperature": "28",
          "WeatherWindCondition": "东风",
          "WeatherWindLevel": "3-4"
        },
        {
          "WeatherTime": "09",
          "WeatherInfo": "多云",
          "Wet": 89,
          "Temperature": "28",
          "WeatherWindCondition": "东南风",
          "WeatherWindLevel": "3-4"
        },
        {
          "WeatherTime": "10",
          "WeatherInfo": "多云",
          "Wet": 89,
          "Temperature": "28",
          "WeatherWindCondition": "东南风",
          "WeatherWindLevel": "3-4"
        },
        {
          "WeatherTime": "11",
          "WeatherInfo": "多云",
          "Wet": 89,
          "Temperature": "29",
          "WeatherWindCondition": "东南风",
          "WeatherWindLevel": "3-4"
        },
        {
          "WeatherTime": "12",
          "WeatherInfo": "多云",
          "Wet": 87,
          "Temperature": "29",
          "WeatherWindCondition": "东南风",
          "WeatherWindLevel": "3-4"
        },
        {
          "WeatherTime": "13",
          "WeatherInfo": "多云",
          "Wet": 85,
          "Temperature": "29",
          "WeatherWindCondition": "东南风",
          "WeatherWindLevel": "3-4"
        },
        {
          "WeatherTime": "14",
          "WeatherInfo": "小雨",
          "Wet": 81,
          "Temperature": "29",
          "WeatherWindCondition": "东南风",
          "WeatherWindLevel": "3-4"
        },
        {
          "WeatherTime": "15",
          "WeatherInfo": "多云",
          "Wet": 83,
          "Temperature": "29",
          "WeatherWindCondition": "东南风",
          "WeatherWindLevel": "3-4"
        },
        {
          "WeatherTime": "16",
          "WeatherInfo": "多云",
          "Wet": 85,
          "Temperature": "29",
          "WeatherWindCondition": "东南风",
          "WeatherWindLevel": "3-4"
        },
        {
          "WeatherTime": "17",
          "WeatherInfo": "多云",
          "Wet": 85,
          "Temperature": "29",
          "WeatherWindCondition": "东南风",
          "WeatherWindLevel": "3-4"
        },
        {
          "WeatherTime": "18",
          "WeatherInfo": "小雨",
          "Wet": 87,
          "Temperature": "29",
          "WeatherWindCondition": "东南风",
          "WeatherWindLevel": "3-4"
        },
        {
          "WeatherTime": "19",
          "WeatherInfo": "小雨",
          "Wet": 87,
          "Temperature": "29",
          "WeatherWindCondition": "东南风",
          "WeatherWindLevel": "3-4"
        },
        {
          "WeatherTime": "20",
          "WeatherInfo": "小雨",
          "Wet": 90,
          "Temperature": "29",
          "WeatherWindCondition": "东南风",
          "WeatherWindLevel": "3-4"
        },
        {
          "WeatherTime": "21",
          "WeatherInfo": "小雨",
          "Wet": 90,
          "Temperature": "29",
          "WeatherWindCondition": "东南风",
          "WeatherWindLevel": "3-4"
        },
        {
          "WeatherTime": "22",
          "WeatherInfo": "小雨",
          "Wet": 90,
          "Temperature": "28",
          "WeatherWindCondition": "东南风",
          "WeatherWindLevel": "3-4"
        },
        {
          "WeatherTime": "23",
          "WeatherInfo": "小雨",
          "Wet": 91,
          "Temperature": "28",
          "WeatherWindCondition": "东南风",
          "WeatherWindLevel": "3-4"
        }
      ],
      "LifeHelperUV": {
        "HelperName": "紫外线指数",
        "HelperStatus": "弱",
        "HelperLevel": 2,
        "HelperContent": "紫外线强度较弱，建议出门前涂擦SPF在12-15之间、PA+的防晒护肤品。"
      },
      "LifeHelperWear": {
        "HelperName": "穿衣指数",
        "HelperStatus": "热",
        "HelperLevel": 6,
        "HelperContent": "天气热，建议着短裙、短裤、短薄外套、T恤等夏季服装。"
      },
      "LifeHelperWashCar": {
        "HelperName": "洗车指数",
        "HelperStatus": "不宜",
        "HelperLevel": 4,
        "HelperContent": "不宜洗车，未来24小时内有雨，如果在此期间洗车，雨水和路上的泥水可能会再次弄脏您的爱车。"
      },
      "LifeHelperAir": {
        "HelperName": "空气污染扩散条件指数",
        "HelperStatus": "良",
        "HelperLevel": 2,
        "HelperContent": "气象条件有利于空气污染物稀释、扩散和清除，可在室外正常活动。"
      },
      "WeatherDataGenerateDateTime": "2026-08-09T16:53+08:00"
    }
  ]
}