Neste documento, você vai aprender como usar a API Air Quality para criar experiências ricas 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 local para visitar. A API Air Quality oferece:
- Dados históricos e em * tempo real: dados novos e precisos que representam o estado atual e dados anteriores em uma janela de 30 dias com resolução de uma hora. (* um resumo de uma hora da qualidade do ar externo)
- Dados globais e locais: cobrindo áreas inteiras em mais de 100 países, mas altamente localizadas (até 500 metros). 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 sobre a 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 para exibição em cada local.
(acesse a seção: Exibir dados da API Air Quality em alfinetes de local)Blocos de mapa de calor: sobreponha uma camada colorida que represente as condições atuais da qualidade do ar externo no 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 em um mapa
Mostrar dados da API Air Quality em alfinetes de local
- Escolha o índice do local: IQA universal ou um IQA local (até 70 Índices de qualidade do ar (IQA) diferentes estão disponíveis. Um índice de qualidade do ar (IQAr) é a escala em que 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 da API Air Quality e o código de cores diretamente na experiência de pesquisa de local.
A exibição padrão pode incluir apenas o código de cor.
Mostre mais informações da API Air Quality na seleção de alfinetes:
- Significado de IQA universal / IQA 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: 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. Lembre-se de que os pontos de dados de um local geralmente são úteis em comparação com outros.
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": …
}
}
- 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ó serão mostrados parques com boa qualidade do ar.
Resposta sobre a 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 do mapa de calor da API Air Quality
Os blocos coloridos do mapa de calor são uma ótima maneira de:
- para fornecer uma visão geral de uma grande área.
- 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 visualização do mapa do Google. Os blocos do mapa de calor são atualizados à medida que o usuário interage com o mapa, movendo, ampliando ou mudando a localização.
O valor permitido do nível de zoom é de até 16.
A camada de Bloco de mapa de calor da API Air Quality pode desaparecer na pesquisa hiperlocal.
É possível 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 da cor:
- Escala de gradiente UAQI (0 a 100):
Ruim / excelente
Exemplo 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 da 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 (todas 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. 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 exibidos. Faturamento diferente de acordo com os dados do 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 onde visitar. Portanto, os dados de qualidade do ar precisam ficar visíveis o mais cedo possível na experiência de pesquisa, com cuidado quanto à quantidade de informações exibidas de uma vez e como elas são mostradas.
Próximas ações
Leitura adicional sugerida:
- Melhorar a descoberta local com a API Nearby Search (nova)
- Conferir seus dados em tempo real com o estilo baseado em dados
Colaboradores
O Google mantém este artigo. Os colaboradores a seguir escreveram o post originalmente.
Autor principal:
Thomas Anglaret | Engenheiro de soluções