Condições atuais

O endpoint currentConditions fornece informações atuais sobre a qualidade do ar por hora. É possível controlar quais AQIs e informações relevantes são retornadas, como o nível de concentração de poluentes e as recomendações de saúde.

É possível solicitar a qualidade do ar atual por hora usando o endpoint currentConditions enviando uma solicitação POST HTTP para:

https://airquality.googleapis.com/v1/currentConditions:lookup?key=YOUR_API_KEY

Inclua as opções de solicitação no corpo da solicitação JSON. O corpo da solicitação contém o local para o qual você quer receber as condições atuais da qualidade do ar e várias opções para controlar quais informações de qualidade do ar incluir na resposta.

O APIs Explorer permite fazer solicitações em tempo real para que você se familiarize com a API e as opções dela:

Faça um teste

Exemplo de solicitação básica

Corpo da solicitação básico

O código a seguir mostra como criar um corpo de solicitação básico para uma solicitação currentConditions. Neste exemplo, você define apenas o local.

curl -X POST -d '{
  "location": {
    "latitude": 37.419734,
    "longitude": -122.0827784
  }
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/currentConditions:lookup?key=YOUR_API_KEY'

Resposta de solicitação básica

A chamada acima gera a seguinte resposta JSON. Para mais detalhes sobre os dados de resposta, consulte Dados de resposta.

{
  "dateTime": "2023-10-26T18:00:00Z",
  "regionCode": "us",
  "indexes": [
    {
      "code": "uaqi",
      "displayName": "Universal AQI",
      "aqi": 52,
      "aqiDisplay": "52",
      "color": {
        "red": 0.9490196,
        "green": 0.98039216,
        "blue": 0.019607844
      },
      "category": "Moderate air quality",
      "dominantPollutant": "no2"
    }
  ]
}

Exemplo de solicitação com vários parâmetros

Solicitação de vários parâmetros

O código abaixo mostra como criar um corpo de solicitação para uma solicitação currentConditions. Neste exemplo, além do local, várias outras computações e o idioma da resposta são especificados.

curl -X POST -d '{
  "universalAqi": true,
  "location": {
    "latitude": 37.419734,
    "longitude": -122.0827784
  },
  "extraComputations": [
    "HEALTH_RECOMMENDATIONS",
    "DOMINANT_POLLUTANT_CONCENTRATION",
    "POLLUTANT_CONCENTRATION",
    "LOCAL_AQI",
    "POLLUTANT_ADDITIONAL_INFO"
  ],
  "languageCode": "en"
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/currentConditions:lookup?key=YOUR_API_KEY'

Resposta com vários parâmetros

A chamada acima gera a seguinte resposta JSON. Para mais detalhes sobre os dados de resposta, consulte Dados de resposta.

{
    "dateTime": "2023-06-15T10:00:00Z",
    "regionCode": "us",
    "indexes": [
        {
            "code": "uaqi",
            "displayName": "Universal AQI",
            "aqi": 89,
            "aqiDisplay": "89",
            "color": {
                "red": 48,
                "green": 175,
                "blue": 55,
                "alpha": 255
            },
            "category": "Excellent air quality",
            "dominantPollutant": "o3"
        },
        {
            "code": "usa_epa",
            "displayName": "AQI (US)",
            "aqi": 41,
            "aqiDisplay": "41",
            "color": {
                "green": 228,
                "alpha": 255
            },
            "category": "Good air quality",
            "dominantPollutant": "pm25"
        }
    ],
    "pollutants": [
        {
            "code": "co",
            "displayName": "CO",
            "fullName": "Carbon monoxide",
            "concentration": {
                "value": 334.24,
                "units": "PARTS_PER_BILLION"
            },
            "additionalInfo": {
                "sources": "Typically originates from incomplete combustion...",
                "effects": "When inhaled, carbon monoxide can prevent the blood from..."
            }
        },
        {
            "code": "no2",
            "displayName": "NO2",
            "fullName": "Nitrogen dioxide",
            "concentration": {
                "value": 13.12,
                "units": "PARTS_PER_BILLION"
            },
            "additionalInfo": {
                "sources": "Main sources are fuel burning processes, such as...",
                "effects": "Exposure may cause increased bronchial reactivity..."
            }
        },
        {
            "code": "o3",
            "displayName": "O3",
            "fullName": "Ozone",
            "concentration": {
                "value": 13.88,
                "units": "PARTS_PER_BILLION"
            },
            "additionalInfo": {
                "sources": "Ozone is created in a chemical reaction between atmospheric oxygen...",
                "effects": "Ozone can irritate the airways and cause coughing, a burning..."
            }
        },
        {
            "code": "pm10",
            "displayName": "PM10",
            "fullName": "Inhalable particulate matter (<10µm)",
            "concentration": {
                "value": 5.07,
                "units": "MICROGRAMS_PER_CUBIC_METER"
            },
            "additionalInfo": {
                "sources": "Main sources are combustion processes (e.g. indoor heating, wildfires)...",
                "effects": "Inhalable particles can penetrate into the lungs. Short term exposure..."
            }
        },
        {
            "code": "pm25",
            "displayName": "PM2.5",
            "fullName": "Fine particulate matter (<2.5µm)",
            "concentration": {
                "value": 2.83,
                "units": "MICROGRAMS_PER_CUBIC_METER"
            },
            "additionalInfo": {
                "sources": "Main sources are combustion processes (e.g. power plants, indoor heating...",
                "effects": "Fine particles can penetrate into the lungs and bloodstream. Short term..."
            }
        },
        {
            "code": "so2",
            "displayName": "SO2",
            "fullName": "Sulfur dioxide",
            "concentration": {
                "value": 0.02,
                "units": "PARTS_PER_BILLION"
            },
            "additionalInfo": {
                "sources": "Main sources are burning processes of sulfur-containing fuel in industry...",
                "effects": "Exposure causes irritation of the respiratory tract, coughing and generates..."
            }
        }
    ],
    "healthRecommendations": {
        "generalPopulation": "With this level of air quality, you have no limitations. Enjoy the outdoors!",
        "elderly": "If you start to feel respiratory discomfort such as coughing or breathing difficulties...",
        "lungDiseasePopulation": "...",
        "heartDiseasePopulation": "...",
        "athletes": "...",
        "pregnantWomen": "...",
        "children": "..."
    }
}