Z tego dokumentu dowiesz się, jak za pomocą interfejsu Air Quality API tworzyć zaawansowane wyszukiwanie miejsc. Pokażemy, w jaki sposób jakość powietrza może być ważnym sygnałem dla użytkowników od samego początku do końca ścieżki i jak dane Air Quality API mogą być wykorzystywane w dotychczasowych rozwiązaniach.
Przypadki użycia i wartość dodana
Sygnały interfejsu Air Quality API mogą pasować do różnych funkcji wyszukiwania, np. podczas wyszukiwania lokalizacji do odwiedzenia. Zalety interfejsu Air Quality API:
- Czas rzeczywisty * i dane historyczne – aktualne, dokładne dane, które przedstawiają bieżący stan, a także dane z przeszłości z okresu 30 dni, z podziałem na godziny. (* godzinowe podsumowanie jakości powietrza na zewnątrz).
- Dane globalne i lokalne – obejmują całe obszary w ponad 100 krajach i wysoce zlokalizowane (do 500 m) danych interfejsu Air Quality API. Dane te pozwalają użytkownikom porównywać dane i podejmować decyzje dotyczące odpowiedniego miejsca.
Jakość powietrza może się znacznie różnić nawet w pobliżu lokalizacji
Przykładowy przewodnik
Wyświetlaj dane o jakości powietrza na wczesnym etapie korzystania z usługi
Dane z interfejsu Air Quality API można wyświetlać na 2 główne sposoby:
Aktualne warunki / godzinowo: pobierz poszczególne wartości do wyświetlenia dla każdej lokalizacji.
(przejdź do sekcji: Wyświetlanie danych dotyczących pinezek lokalizacji za pomocą interfejsu Air Quality API)Kafelki Mapa termiczna: nakładka ta jest nakładana na mapę w postaci kolorowej warstwy, która przedstawia aktualną jakość powietrza na zewnątrz. Dostępne są indeksy warstw zależne od kraju.
(przejdź do sekcji: Warstwa mapy termicznej Display Air Quality API na mapie)
Wyświetlaj dane interfejsu Air Quality API na pinezkach lokalizacji
- Wybierz indeks lokalizacji: uniwersalny AQI lub lokalny AQI (dostępnych do 70 różnych indeksów jakości powietrza (AQI)). Indeks jakości powietrza (AQI) to skala, według której dany kraj, na przykład amerykańska EPA, kategoryzuje różne poziomy jakości powietrza na podstawie różnych metod obliczania, źródeł danych i wyznaczonych celów.
- Zacznij wizualizować główną wartość interfejsu Air Quality API i kod kolorów bezpośrednio w interfejsie wyszukiwania miejsc.
Ekran domyślny może zawierać tylko kod koloru.
Wyświetlaj więcej informacji o interfejsie Air Quality API przy wyborze kodu PIN:
- Znaczenie uniwersalnego i lokalnego AQI.
- Poziomy zanieczyszczeń, czyli miary cząstek i gazów w powietrzu: dominujące zanieczyszczenia, stężenie, źródła i efekty.
- Zalecenia dotyczące zdrowia, czyli zalecane działania w związku z obecną jakością powietrza.
- Możesz dostosować domyślnie wyświetlany poziom informacji do swoich potrzeb. Pamiętaj, że punkty danych dla danej lokalizacji są często przydatne w porównaniu z innymi lokalizacjami.
Przykład wyświetlania sekcji Jakość powietrza
{
"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": …
}
}
- Możesz też przesyłać zapytania o dane dotyczące jakości powietrza tylko w przypadku interakcji z daną lokalizacją.
- Możesz użyć indeksu Air Quality API, aby filtrować miejsca w pobliżu, np. jeśli szukasz parków w swojej okolicy, zobaczysz tylko parki z dobrą jakością powietrza.
Odpowiedź dotycząca jakości powietrza
...
"color":{
"red": 0.9490196,
"green": 0.98039216,
"blue": 0.019607844
}
...
Przekonwertuj na 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)
Wyświetl warstwę mapy termicznej interfejsu Air Quality API na mapie
Kolorowe kafelki z mapą termiczną są świetnym sposobem:
- aby uzyskać ogólne informacje.
- aby szybko pokazać niuanse w danym obszarze.
Użyj interfejsu Map JavaScript API z klasą ImateMapType, aby wyświetlić poszczególne kafelki potrzebne, aby objąć cały widoczny obszar mapy Google. Kafelki mapy termicznej będą odświeżane, gdy użytkownik zaangażuje się w interakcję z mapą, przesuwając ją, powiększając lub zmieniając lokalizację.
Pamiętaj, że dozwolona wartość poziomu powiększenia to 16.
Warstwa kafelka mapy termicznej interfejsu Air Quality API może zniknąć podczas wyszukiwania hiperlokalnego.
Typy map termicznych możesz wybrać z ograniczonej liczby indeksów jakości powietrza:
Określ skalę kolorów, aby użytkownicy mogli zrozumieć wartość i jej ranking kolorów:
- skala gradientowa UAQI (0–100):
Słaby / Świetny
Fragment kodu CSS palety kolorów:
.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 */
);
}
- jednolite kolory obrazujące kluczowy punkt w skali UAQI (0–100):
Słabej / Świetnej
Liczba zapytań i powiązane z nimi koszty
- Map JavaScript API: 1 mapa podczas wczytywania interfejsu.
- Air Quality API:
- 1 zapytanie dla każdego miejsca (wszystkie na wczytaniu mapy lub tylko po wybraniu przez użytkownika).
- Warstwa mapy termicznej: każdy obraz ma wymiary 256 x 256 pikseli. Aby pokryć standardową mapę wyświetlaną na urządzeniu mobilnym lub w internecie, potrzeba 12–14 kafelków. Każdy pobrany kafelek jest liczony jako 1 jednostka SKU.
- Interfejs API wyszukiwania w pobliżu (nowy): 1 zapytanie na 20 wyświetlonych miejsc. Różnice w rozliczeniach w zależności od danych miejsc, które są częścią odpowiedzi na zapytanie.
Podsumowanie
Wykazaliśmy, że interfejs Air Quality API może być ważnym punktem danych, który pomaga użytkownikom podejmować decyzje o miejscu do odwiedzenia. Dlatego dane o jakości powietrza powinny być widoczne w wyszukiwarce jak najszybciej, z uwzględnieniem ilości informacji wyświetlanych jednocześnie oraz sposobu, w jaki są one widoczne.
Następne działania
Sugerujemy dalszą lekturę:
- Ułatwianie odkrywania miejsc w pobliżu dzięki nowemu interfejsowi API wyszukiwania w pobliżu
- Wyświetlanie danych w czasie rzeczywistym dzięki stylowi opartemu na danych
Współtwórcy
Google przechowuje ten artykuł. Następujący współtwórcy napisali go pierwotnie.
Główny autor:
Thomas Anglaret | Inżynier ds. rozwiązań