编辑

实时空气质量

平台: API iOS Android

实时空气质量API提供指定地点的实时空气质量数据，精度为1x1公里。

  • 基于各个国家或地区当地标准的AQI、AQI等级、颜色和首要污染物
  • 和风天气通用AQI
  • 污染物浓度值、分指数
  • 健康建议
  • 相关联的监测站信息

我们推荐阅读空气质量信息文档，以便了解指数类型、污染物、支持的国家等信息。

接口代码 接口 数据类
airCurrent 实时空气质量 AirV1CurrentResponse

参数

AirV1Parameter

请求参数包括必选和可选参数，如不填写可选参数将使用其默认值。

  • latitude(必选)所需位置的纬度。十进制，最多支持小数点后两位。例如 39.92
  • longitude(必选)所需位置的经度。十进制，最多支持小数点后两位。例如 116.41
  • lang多语言设置，请阅读多语言文档，了解我们的多语言是如何工作、如何设置以及数据是否支持多语言。

示例代码

Swift

Task {
    do {
        let parameter = AirV1Parameter(longitude: 116.41, latitude: 39.92)
        let response = try await QWeather.instance
            .airCurrent(parameter)
        print(response)
    } catch QWeatherError.errorResponse(let error) {
        print(error)
    } catch {
        print(error)
    }
}

Objective-C

AirV1Parameter *parameter = [AirV1Parameter instanceWithLongitude:116.41 latitude:39.92 lang:@(LangZH_HANS)];
[QWeatherObjc airCurrent:parameter completionHandler:^(AirV1CurrentResponse * _Nullable response, NSError * _Nullable error) {
    if (response) {
        NSLog(@"%@", response.description);
    }
    if (error) {
        NSLog(@"%@", error.localizedDescription);
    }
}];

返回数据

AirV1CurrentResponse

  • metadata.tag 数据标签
  • indexes.code 空气质量指数Code
  • indexes.name 空气质量指数的名字
  • indexes.aqi 空气质量指数的值
  • indexes.aqiDisplay 空气质量指数的值的文本显示
  • indexes.level 空气质量指数等级，可能为空
  • indexes.category 空气质量指数类别，可能为空
  • indexes.color.red 空气质量指数的颜色，RGBA中的red
  • indexes.color.green 空气质量指数的颜色，RGBA中的green
  • indexes.color.blue 空气质量指数的颜色，RGBA中的blue
  • indexes.color.alpha 空气质量指数的颜色，RGBA中的alpah
  • indexes.primaryPollutant.code 首要污染物的Code，可能为空
  • indexes.primaryPollutant.name 首要污染物的名字，可能为空
  • indexes.primaryPollutant.fullName 首要污染物的全称，可能为空
  • indexes.health.effect 空气质量对健康的影响，可能为空
  • indexes.health.advice.generalPopulation 对一般人群的健康指导意见，可能为空
  • indexes.health.advice.sensitivePopulation 对敏感人群的健康指导意见，可能为空
  • pollutants.code 污染物的Code
  • pollutants.name 污染物的名字
  • pollutants.fullName 污染物的全称
  • pollutants.concentration.value 污染物的浓度值
  • pollutants.concentration.unit 污染物的浓度值的单位
  • pollutants.subIndexes.code 污染物的分指数的Code，可能为空
  • pollutants.subIndexes.aqi 污染物的分指数的数值，可能为空
  • pollutants.subIndexes.aqiDisplay 污染物的分指数数值的显示名称
  • stations.id AQI相关联的监测站Location ID，可能为空
  • stations.name AQI相关联的监测站名称