Method: currentConditions.lookup

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

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. La latitud y longitud desde las que la API busca datos sobre las condiciones actuales de la calidad del aire.

extraComputations[]

enum (ExtraComputation)

Opcional. Funciones adicionales que se pueden habilitar de manera opcional Especificar cálculos adicionales hará que se devuelvan los elementos y campos relevantes en la respuesta.

uaqiColorPalette

enum (ColorPalette)

Opcional. Determina la paleta de colores que se usa para los datos proporcionados por el "Índice universal de calidad del aire". (UAQI). Esta paleta de colores es relevante solo para el UAQI; otros ICA tienen una paleta de colores predeterminada que no se puede controlar.

customLocalAqis[]

object (CustomLocalAqi)

Opcional. Expresa un "país/región a ICA". relación. Vincula un país o una región con un ICA deseado para que los datos de la calidad del aire necesarios para ese país o región se muestren de acuerdo con el ICA elegido. Este parámetro se puede utilizar para especificar un ICA no predeterminado en un país determinado; por ejemplo, para obtener el índice de la EPA de EE.UU. para Canadá en lugar del índice predeterminado para este país.

universalAqi

boolean

Opcional. Si se configura como verdadero, el ICA universal se incluirá en los "í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 dependen del 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 RFC3339 UTC “Zulú” con una 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 alpha-2 del país o la región correspondiente a la ubicación proporcionada en la solicitud. Este campo puede omitirse en la respuesta si la ubicación proporcionada en la solicitud se encuentra en un territorio en disputa.

indexes[]

object (AirQualityIndex)

En función de los parámetros de solicitud, esta lista incluirá (hasta) dos índices de calidad del aire:

  • ICA universal. Se mostrará si el valor booleano universalAqi se establece 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 especifiquen 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 en relación 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.

Alcances 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.