多地区实时空气质量 - 咕咕数据 API 文档

已覆盖国家和地区的实时空气质量、污染物浓度与健康建议
接口详情官网地址: https://www.gugudata.com/api/details/airquality

请求方法: GET
接口路径: /Weather/AirQuality
调试地址: https://api.gugudata.com/Weather/AirQuality/demo
OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json

请求参数:

appkey (string, 必填): 付费后获取的 APPKEY。

location (string, 可选，推荐): 城市名称、LocationID 或“经度,纬度”；与 city 同时传递时优先生效。

city (string, 可选，兼容): 旧版城市参数；未传 location 时使用。

lang (string, 可选): 返回语言，支持 zh、en，默认 zh。

返回内容:

AQIStandard 表示本条结果采用的 AQI 标准代码，例如 cn-mee 或 us-epa。

Pollutants 返回与所选 AQI 标准一致的主要污染物浓度、单位及分项指数。

RetrievedAt 表示数据获取时间；DataStatus 为 fresh 或 stale。

数据服务短暂不可用时可返回最近成功数据并标记 stale；无可用缓存时返回业务状态 901。

业务状态码:

100 正常返回。

501 参数错误或位置无法解析。

502 请求频率受限。

503 接口授权已过期。

504 APPKEY 错误。

505 调用次数已用完。

900 服务内部错误。

901 空气质量数据源暂时不可用。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
  "DataStatus": {
    "RequestParameter": "location=北京&lang=zh",
    "StatusCode": 100,
    "StatusDescription": "请求成功。",
    "ResponseDateTime": "2026-08-09 19:22:59.286",
    "DataTotalCount": 1
  },
  "Data": [
    {
      "Province": "北京市",
      "City": "北京",
      "LocationId": "101010100",
      "Latitude": "39.905",
      "Longitude": "116.4053",
      "Country": "中国",
      "AQI": "49",
      "AQIDisplay": "49",
      "AQILevel": "1",
      "Quality": "优",
      "AQIColor": {
        "Red": 0,
        "Green": 228,
        "Blue": 0,
        "Alpha": 1
      },
      "PM25": "17",
      "PrimaryPollutant": "",
      "PrimaryPollutantCode": "",
      "PrimaryPollutantName": "",
      "PrimaryPollutantFullName": "",
      "HealthEffect": "空气质量令人满意，基本无空气污染。",
      "GeneralPopulationAdvice": "各类人群可正常活动。",
      "SensitivePopulationAdvice": "各类人群可正常活动。",
      "Pollutants": [
        {
          "Code": "pm2p5",
          "Name": "PM 2.5",
          "FullName": "颗粒物（粒径小于等于2.5µm）",
          "Concentration": "17",
          "Unit": "μg/m³",
          "AQI": "24",
          "AQIDisplay": "24"
        },
        {
          "Code": "pm10",
          "Name": "PM 10",
          "FullName": "颗粒物（粒径小于等于10µm）",
          "Concentration": "44",
          "Unit": "μg/m³",
          "AQI": "44",
          "AQIDisplay": "44"
        },
        {
          "Code": "no2",
          "Name": "NO2",
          "FullName": "二氧化氮",
          "Concentration": "11",
          "Unit": "μg/m³",
          "AQI": "6",
          "AQIDisplay": "6"
        },
        {
          "Code": "o3",
          "Name": "O3",
          "FullName": "臭氧",
          "Concentration": "155",
          "Unit": "μg/m³",
          "AQI": "49",
          "AQIDisplay": "49"
        },
        {
          "Code": "so2",
          "Name": "SO2",
          "FullName": "二氧化硫",
          "Concentration": "4",
          "Unit": "μg/m³",
          "AQI": "2",
          "AQIDisplay": "2"
        },
        {
          "Code": "co",
          "Name": "CO",
          "FullName": "一氧化碳",
          "Concentration": "0.5",
          "Unit": "mg/m³",
          "AQI": "5",
          "AQIDisplay": "5"
        }
      ],
      "Stations": [
        {
          "Id": "P58655",
          "Name": "万寿西宫"
        },
        {
          "Id": "P59067",
          "Name": "天坛"
        },
        {
          "Id": "P58911",
          "Name": "海淀区万柳"
        },
        {
          "Id": "P52102",
          "Name": "东四"
        },
        {
          "Id": "P5257",
          "Name": "官园"
        },
        {
          "Id": "P57961",
          "Name": "奥体中心"
        },
        {
          "Id": "P56750",
          "Name": "农展馆"
        }
      ],
      "RetrievedAt": "2026-08-09T11:20:50Z",
      "DataStatus": "fresh",
      "AQIStandard": "cn-mee"
    }
  ]
}