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 do início ao 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 sinais da API Air Quality podem se encaixar em várias experiências de pesquisa, como quando os usuários estão procurando um local para visitar. A API Air Quality oferece:
- Tempo real * e dados históricos: dados novos e precisos que representam o estado atual, bem como dados retroativos dentro de uma janela de 30 dias em uma resolução por hora. (* um instantâneo da qualidade do ar externo por hora)
- Dados globais e locais: abrangendo áreas inteiras em mais de 100 países, mas altamente localizados (até 500 metros), os dados da API Air Quality dão indicadores importantes para os usuários compararem e tomarem decisões sobre o local mais apropriado.
A qualidade do ar pode variar drasticamente 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 / por hora: receba valores individuais a serem exibidos em cada local.
(acesse a seção: Dados da API Display Air Quality sobre alfinetes de localização)Blocos de mapa de calor: sobreponha uma camada colorida que representa as condições atuais da qualidade do ar externo em cima do mapa. Os índices de camadas específicas de um país estão disponíveis.
(acesse a seção: camada do mapa de calor da API Air Quality Display em um mapa)
Exibir dados da API Air Quality em alfinetes de localização
- Escolha seu índice de localização: IQA universal ou IQA local (há até 70 Índices de qualidade do ar (IQA) diferentes 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.
- Confira o valor e o código de cores principais da API Air Quality da experiência de pesquisa de lugar.
a exibição padrão pode incluir apenas o código de cores.
Mostre mais informações da API Air Quality na seleção de pin:
- Significado do IQA universal / IQA local.
- Níveis de poluentes, que são uma medida das 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 exibidas por padrão para atender às suas necessidades. Lembre-se de que os pontos de dados de um local geralmente são úteis em comparação com outros locais.
Exemplo de exibição da seção "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": …
}
}
- Você também pode consultar dados de qualidade do ar somente quando interage com um local.
- Você pode usar o índice da API Air Quality para filtrar lugares por perto. Por exemplo, se estiver procurando parques na sua área, serão exibidos apenas os parques 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 do mapa de calor da API Air Quality em um mapa
Blocos coloridos no mapa de calor são uma ótima maneira:
- para fornecer uma visão geral de área ampla.
- para mostrar rapidamente as nuances da área.
Use a API Maps JavaScript com o ImateMapType para exibir os blocos individuais necessários para cobrir toda a janela de visualização do mapa do Google. Os blocos do mapa de calor são atualizados conforme o usuário interage com o mapa, movimentando, aplicando zoom ou alterando a localização.
Lembre-se de que 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:
Indique a escala de cores para que os usuários entendam o valor e a classificação de cores dele:
- UAQI da escala de gradiente (0-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:
- Uma consulta para cada lugar (tudo no carregamento do mapa ou apenas na seleção do usuário).
- Camada de bloco 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, você precisa de 12 a 14 blocos. Cada bloco extraído é contado como 1 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 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, considerando a quantidade de informações exibidas de uma vez e como elas ficam visíveis.
Próximas ações
Leitura adicional sugerida:
- Melhorar a descoberta local com a nova API Nearby Search
- Conferir seus dados em tempo real com o estilo baseado em dados
Colaboradores
O Google mantém este artigo. Ela foi escrita pelos colaboradores a seguir.
Autor principal:
Thomas Anglaret | Engenheiro de soluções