Atenção à qualidade do ar nos lugares com a API Air Quality

Neste documento, você vai aprender como usar a API Air Quality para criar experiências avançadas de pesquisa de lugares. Vamos mostrar como a qualidade do ar pode ser um indicador de valor para os usuários desde o início até o fim do funil e como os dados da API Air Quality podem ser incorporados às experiências atuais.

Casos de uso e valor agregado

Os indicadores da API Air Quality podem se encaixar em várias experiências de pesquisa, como quando os usuários procuram um lugar para visitar. A API Air Quality oferece:

  • Dados históricos e em tempo real: dados atualizados e precisos que representam o estado atual e dados anteriores em uma janela de 30 dias com resolução horária. (* um instantâneo horário da qualidade do ar externo)
  • Dados globais e locais: cobrem áreas inteiras em mais de 100 países, mas são altamente localizados (até 500 m). Os dados da API Air Quality fornecem indicadores importantes para que os usuários comparem e tomem decisões sobre o lugar mais adequado.

A qualidade do ar pode ser drasticamente diferente, mesmo em locais próximos

Tutorial de exemplo

Mostrar dados sobre a qualidade do ar no início da experiência

Há duas maneiras principais de mostrar os dados da API Air Quality:

Mostrar dados da API Air Quality em ícones de locais

  • Escolha seu índice de local: IQA universal ou IQA local (até 70 índices de qualidade do ar (IQA) diferentes estão disponíveis). Um índice de qualidade do ar (IQA) é a escala usada por um determinado país, por exemplo, a EPA dos EUA, para categorizar diferentes níveis de qualidade do ar com base em diferentes métodos de cálculo, fontes de dados e finalidades designadas.
  • Comece a visualizar o principal valor e o código de cores da API Air Quality diretamente na experiência de pesquisa de lugares.

A exibição padrão pode incluir apenas o código de cor.


Mostrar mais informações da API Air Quality ao selecionar um marcador:

  • Significado do IQA universal / local.
  • Níveis de poluentes, que são uma medida de partículas e gases no ar: poluente dominante, concentração, fontes e efeitos.
  • Recomendações de saúde, que são ações recomendadas para as condições atuais de qualidade do ar.
  • É possível ajustar o nível de informações exibidas por padrão para atender às suas necessidades. Os pontos de dados de um local costumam ser úteis em comparação com outros.

Exemplo de exibição da seção de qualidade do ar

Resposta sobre a qualidade do ar

{
    "dateTime": "2023-08-09T10:00:00Z",
    "regionCode": "fr",
    "indexes": [
       {
            "code": "uaqi",
            "displayName": "Universal AQI",
            "aqi": 76,
            "aqiDisplay": "76",
            "color": {
                "red": 0.4117647,
                "green": 0.77254903,
                "blue": 0.20392157
            },
            "category": "Good air quality",
            "dominantPollutant": "pm10"
        },
       …
    ],
    "pollutants": [
       {
            "code": "co",
            "displayName": "CO",
            "fullName": "Carbon monoxide",
            "concentration": {
                "value": 95.18,
                "units": "PARTS_PER_BILLION"
            }...
        },
       …
    ],
    "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, consider red ...",
        "lungDiseasePopulation": …
    }
}
  • Como alternativa, você pode consultar dados de qualidade do ar apenas na interação com um local.

  • Você pode usar o índice da API Air Quality para filtrar lugares próximos. Por exemplo, se você estiver procurando parques na sua área, só vai mostrar aqueles com boa qualidade do ar.

Resposta sobre a qualidade do ar

...
"color":{
  "red": 0.9490196,
  "green": 0.98039216,
  "blue": 0.019607844
}
...
 Converter para RGB 
  var red = parseInt(colorResponse.red*255)|| 1;
  var green = parseInt(colorResponse.green*255)|| 1;
  var blue = parseInt(colorResponse.blue*255)|| 1; 
  // --> output rgb(241,250,5)

Mostrar a camada de mapa de calor da API Air Quality em um mapa

Os blocos coloridos do mapa de calor são uma ótima maneira de:

  • para fornecer uma visão geral de uma área grande.
  • para mostrar rapidamente as nuances dessa área.

Use a API Maps JavaScript com o ImateMapType para mostrar os blocos individuais necessários para cobrir toda a janela de visualização do seu mapa do Google. Os blocos do mapa de calor serão atualizados conforme o usuário interage com o mapa, deslocando, ajustando o zoom ou mudando de local.

O valor permitido do nível de zoom é até 16.
A camada de bloco do mapa de calor da API Air Quality pode desaparecer na pesquisa hiperlocal.

Você pode selecionar Tipos de mapa de calor em um conjunto limitado de índices de qualidade do ar:

  • UAQI_RED_GREEN: paleta vermelho-verde do Índice Universal de Qualidade do Ar.
  • UAQI_INDIGO_PERSIAN - Paleta de cores índigo-persa do Índice Universal de Qualidade do Ar.
  • PM25_INDIGO_PERSIAN: paleta de cores índigo-persa do índice PM2,5.
  • GBR_DEFRA: paleta de cores do Índice Diário de Qualidade do Ar (Reino Unido).
  • DEU_UBA: paleta de cores do índice local de qualidade do ar da Alemanha.
  • CAN_EC: paleta de cores do Índice de Saúde referente à Qualidade do Ar do Canadá.
  • FRA_ATMO: paleta de cores do índice de qualidade do ar da França.
  • US_AQI: paleta de cores do Índice de Qualidade do Ar dos EUA.

    • Indique a escala de cores para que os usuários entendam o valor e a classificação de cores:

    • escala de gradiente UAQI (0 a 100): Ruim / Excelente

    Snippet de código CSS da paleta de cores: 

    .gradient-scale { 
background: linear-gradient(to right, 
    rgb(99, 20, 161) 0%, /* purple */
    rgb(149, 0, 25) 20%, /* red */
    rgb(248, 47, 21) 40%, /* orange */
    rgb(255, 248, 35) 60%, /* yellow */
    rgb(34,163,120) 80%, /* steelblue */
    rgb(255,255,255) 100% /* white */
   );
}

    • cores sólidas para representar o ponto principal na escala UAQI (0 a 100): Ruim / Excelente

    Contagem de consultas e custo associado

    • API Maps JavaScript: um mapa no carregamento da experiência.
    • API Air Quality:
      • 1 consulta por lugar (todos no carregamento do mapa ou apenas na seleção do usuário).
      • Camada de blocos de mapa de calor: cada imagem de bloco tem 256 x 256 pixels, e para cobrir um mapa padrão apresentado em um dispositivo móvel ou na Web, você precisa de 12 a 14 blocos. Cada bloco extraído é contado como uma unidade de SKU.
    • API Nearby Search (nova): 1 consulta a cada 20 lugares mostrados. Faturamento diferente de acordo com os dados de lugar que fazem parte da resposta da consulta.

    Conclusão

    Mostramos que a API Air Quality pode ser um ponto de dados importante para os usuários decidirem um lugar para visitar. Portanto, os dados de qualidade do ar precisam ser visíveis o mais cedo possível na experiência de pesquisa, com atenção à quantidade de informações exibidas de uma só vez e como elas são disponibilizadas.

    Próximas ações

    Leituras recomendadas:

    Colaboradores

    O Google mantém este artigo. Os colaboradores a seguir escreveram o texto original.
    Autor principal:

    Thomas Anglaret | Engenheiro de soluções