Neste documento, você vai aprender como usar a API Air Quality para criar experiências de pesquisa de lugares avançadas. 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 adequar a várias experiências de pesquisa, como quando os usuários estão procurando 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 snapshot horário da qualidade do ar externo)
- Dados globais e locais : cobrindo áreas inteiras em mais de 100 países, mas 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 muito diferente, mesmo em locais próximos
Exemplo de tutorial
Mostrar dados de qualidade do ar no início da experiência
Há duas maneiras principais de mostrar os dados da API Air Quality:
Condições atuais / horárias: receba valores individuais para mostrar em cada local.
(acesse a seção: Mostrar dados da API Air Quality em marcadores de local)Blocos de mapa de calor: sobreponha uma camada colorida que representa as condições atuais da qualidade do ar externo no mapa. Os índices de camadas específicas de países estão disponíveis.
(acesse a seção: Mostrar a camada de mapa de calor da API Air Quality em um mapa)
Mostrar dados da API Air Quality em marcadores de local
- Escolha o índice de local: IQA universal ou local (até 70 índices de qualidade do ar (IQA) diferentes estão disponíveis). Um índice de qualidade do ar (IQA) é a escala pela qual um determinado país, por exemplo, a EPA dos EUA, categoriza 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 valor principal 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 cores.
Mostrar mais informações da API Air Quality na seleção de marcadores:
- 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.
- Você pode ajustar o nível de informações mostradas por padrão para atender às suas necessidades. Os pontos de dados de um local costumam ser úteis em comparação com outros locais.
Exemplo de exibição da seção de 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 os 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 região, só vai mostrar parques com boa qualidade do ar.
Resposta de qualidade do ar
... "color":{ "red": 0.9490196, "green": 0.98039216, "blue": 0.019607844 } ...
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 fornecer uma visão geral de uma área grande.
- de mostrar rapidamente nuances nessa á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 à medida que o usuário interagir com o mapa, deslocando, ajustando o zoom ou mudando de local.
Os valores de nível de zoom permitidos são até 16.
A camada de blocos 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:
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: 1 mapa no carregamento da experiência.
- API Air Quality:
- 1 consulta por lugar (tudo no carregamento de mapa ou apenas na seleção do usuário).
- Camada de blocos do 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, são necessários 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 que os usuários decidam sobre um lugar para visitar. Portanto, os dados de qualidade do ar precisam estar visíveis o mais cedo possível na experiência de pesquisa, com atenção à quantidade de informações mostradas de uma só vez e como elas são exibidas.
Próximas ações
Leituras sugeridas:
- Melhorar a descoberta local com a API Nearby Search (nova)
- Ver seus dados em tempo real com o estilo baseado em dados
Colaboradores
O Google mantém este artigo. Os colaboradores a seguir escreveram o artigo originalmente.
Autor principal:
Thomas Anglaret | Engenheiro de soluções