Method: currentConditions.lookup

El extremo Condiciones actuales proporciona información por hora sobre la calidad del aire en más de 100 países, con una resolución de hasta 500 x 500 metros. Incluye más de 70 índices locales y categorías y un índice de calidad del aire a nivel mundial.

Solicitud HTTP

POST https://airquality.googleapis.com/v1/currentConditions:lookup

La URL usa la sintaxis de la transcodificación gRPC.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "location": {
    object (LatLng)
  },
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "uaqiColorPalette": enum (ColorPalette),
  "customLocalAqis": [
    {
      object (CustomLocalAqi)
    }
  ],
  "universalAqi": boolean,
  "languageCode": string
}
Campos
location

object (LatLng)

Obligatorio. Corresponde a la longitud y la latitud desde las que la API busca datos sobre las condiciones actuales de calidad del aire.
extraComputations[]

enum (ExtraComputation)

Opcional. Funciones adicionales que se pueden habilitar de manera opcional Si especificas cálculos adicionales, obtendrás los elementos y campos relevantes que se mostrarán en la respuesta.
uaqiColorPalette

enum (ColorPalette)

Opcional. Determina la paleta de colores que se utiliza para los datos proporcionados por el "Índice Universal de Calidad del Aire" (UAQI). Esta paleta de colores es relevante solo para el UAQI; otros AQI tienen una paleta de colores predeterminada que no se puede controlar.
customLocalAqis[]

object (CustomLocalAqi)

Opcional. Expresa una relación de “país o región con el AQI”. Vincula un país o una región con un ICA deseado para que se muestren los datos de calidad del aire obligatorios para ese país o región según el ICA seleccionado. Este parámetro se puede usar para especificar un ICA no predeterminado para un país determinado, por ejemplo, para obtener el índice de la EPA de EE.UU. para Canadá en lugar del índice predeterminado para Canadá.
universalAqi

boolean

Opcional. Si la estableces como verdadera, el ICA universal se incluirá en el campo "Índices" de la respuesta. El valor predeterminado es verdadero.
languageCode

string

Opcional. Permite que el cliente elija el idioma de la respuesta. Si no se pueden proporcionar datos para ese idioma, la API usa la coincidencia más cercana. Los valores permitidos se basan en el estándar IETF. El valor predeterminado es en.

Cuerpo de la respuesta

Si el proceso es satisfactorio, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON 
{
  "dateTime": string,
  "regionCode": string,
  "indexes": [
    {
      object (AirQualityIndex)
    }
  ],
  "pollutants": [
    {
      object (Pollutant)
    }
  ],
  "healthRecommendations": {
    object (HealthRecommendations)
  }
}
Campos
dateTime

string (Timestamp format)

Una marca de tiempo redondeada hacia abajo en formato RFC3339 UTC “Zulú”, con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Por ejemplo: “2014-10-02T15:00:00Z”.
regionCode

string

El código ISO_3166-1 alfa-2 del país o la región que corresponde a la ubicación proporcionada en la solicitud. Este campo podría omitirse de la respuesta si la ubicación proporcionada en la solicitud se encuentra en un territorio en disputa.
indexes[]

object (AirQualityIndex)

Según los parámetros de la solicitud, esta lista incluirá (hasta) dos índices de calidad del aire:

  • ICA universal. Se mostrará si el valor booleano universalAqi está configurado como verdadero.
  • ICA local. Se mostrará si se especifica el cálculo adicional LOCAL_AQI.
pollutants[]

object (Pollutant)

Una lista de contaminantes que afectan la ubicación especificada en la solicitud. Nota: Este campo se mostrará solo para las solicitudes que especificaron uno o más de los siguientes cálculos adicionales: POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION.
healthRecommendations

object (HealthRecommendations)

Consejos de salud y acciones recomendadas relacionadas con las condiciones de calidad del aire informadas. Las recomendaciones se adaptan de manera diferente para las poblaciones en riesgo, los grupos con mayor sensibilidad a los contaminantes y la población general.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta la Descripción general de OAuth 2.0.