Z tego dokumentu dowiesz się, jak korzystać z Air Quality API, aby tworzyć bogate wyniki wyszukiwania miejsc. Pokażemy, jak jakość powietrza może być sygnałem wartości dla użytkowników od samego początku do końca ścieżki oraz jak dane z Air Quality API można osadzać w dotychczasowych usługach.
Przypadki użycia i wartość dodana
Sygnały interfejsu Air Quality API mogą być uwzględniane w różnych funkcjach wyszukiwania, np. gdy użytkownicy szukają miejsca do odwiedzenia. Interfejs API Air Quality oferuje:
- Czas rzeczywisty * i dane historyczne – aktualne, dokładne dane odzwierciedlające obecny stan, a także dane z okresu do 30 dni, z rozdzielczością godzinową. (* godzinny obraz jakości powietrza na zewnątrz)
- Dane globalne i lokalne – obejmujące całe obszary w ponad 100 krajach, a jednak bardzo skoncentrowane (do 500 m) dane z interfejsu Air Quality API dostarczają użytkownikom kluczowych informacji, które mogą wykorzystać do porównania i podjęcia decyzji o najlepszym miejscu.
Jakość powietrza może się znacznie różnić nawet w przypadku lokalizacji położonych blisko siebie.
Przykładowy przewodnik
wyświetlanie danych o jakości powietrza na wczesnym etapie korzystania z aplikacji;
Dane interfejsu Air Quality API można wyświetlać na 2 główne sposoby:
Obecne warunki / co godzinę: wyświetlane są wartości dla każdej lokalizacji.
(przejdź do sekcji: Wyświetlanie danych interfejsu Air Quality API przy pinezkach lokalizacji)Fragmenty mapy termicznej: nałożenie na mapę kolorowej warstwy reprezentującej aktualną jakość powietrza na zewnątrz. Dostępne są indeksy warstw dla poszczególnych krajów.
(przejdź do sekcji: Wyświetlanie warstwy mapy termicznej interfejsu Air Quality API na mapie)
Wyświetlanie danych interfejsu API jakości powietrza na pinezylach lokalizacji
- Wybierz indeks lokalizacji: uniwersalny indeks AQI lub lokalny indeks AQI (dostępnych jest do 70 różnych indeksom jakości powietrza (AQI)). Indeks jakości powietrza (AQI) to skala, według której określony kraj, np. Amerykańska EPA, klasyfikuje 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 API jakości powietrza i kod koloru bezpośrednio w wyszukiwarce miejsc.
domyślne wyświetlanie może obejmować tylko kod koloru.
Aby wyświetlić więcej informacji o interfejsie Air Quality API, które są związane z wyborem kodu PIN:
- Ogólny indeks AQI / znaczenie lokalnego indeksu AQI.
- Poziomy zanieczyszczeń, które są miarą cząsteczek i gazów w powietrzu: dominujące zanieczyszczenie, stężenie, źródła i skutki.
- Zalecenia dotyczące zdrowia, czyli zalecane działania w związku z obecną jakością powietrza.
- Możesz dostosować poziom wyświetlanych domyślnie informacji, aby dopasować je do swoich potrzeb. Pamiętaj, że dane o 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ż wysyłać zapytania o dane dotyczące jakości powietrza tylko po interakcji z lokalizacją.
- Możesz użyć indeksu interfejsu API jakości powietrza, aby filtrować miejsca w pobliżu. Jeśli np. szukasz parków w swojej okolicy, wyświetlą się tylko parki o dobrej jakości powietrza.
Odpowiedź dotycząca jakości powietrza
... "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)
Wyświetl na mapie warstwę mapy termicznej interfejsu Air Quality API
Kolorowe płytki mapy cieplnej to świetny sposób na:
- aby uzyskać przegląd dużego obszaru.
- aby szybko wyświetlić niuanse w tym obszarze.
Użyj interfejsu Maps JavaScript API z parametrem ImateMapType, aby wyświetlić poszczególne płytki potrzebne do pokrycia całego widoku mapy Google. Płytki mapy cieplnej są odświeżane, gdy użytkownik korzysta z mapy, przesuwając ją, powiększając lub zmieniając lokalizację.
Pamiętaj, że dozwolona wartość poziom powiększenia to maksymalnie 16.
Warstwy mapy termicznej interfejsu Air Quality API mogą zniknąć w wyszukiwaniu hiperlokalnym.
Możesz wybrać typy mapy typu mapa ciepła w ograniczonym zestawie indeksów jakości powietrza:
Pamiętaj, aby wskazać użytkownikom skalę kolorów, dzięki której będą mogli zrozumieć wartość i kolor:
- skala gradientu UAQI (0–100):
słaba / doskonała
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, które reprezentują kluczowe punkty na skali UAQI (0–100):
Niska / Wysoka
Liczba zapytań i powiązane koszty
- Maps JavaScript API: 1 mapa podczas wczytywania interfejsu.
- Air Quality API:
- 1 zapytanie na każde miejsce (wszystkie po załadowaniu mapy lub tylko po wybraniu przez użytkownika).
- Warstwa kafelków mapy ciepła: każdy obraz ma rozmiar 256 × 256 pikseli, a aby pokryć standardową mapę wyświetlaną na urządzeniu mobilnym lub w internecie, potrzebujesz 12–14 kafelków. Każdy wygenerowany kafelek jest liczony jako 1 jednostka SKU.
- Nearby Search (New) API: 1 zapytanie na każde 20 wyświetlanych miejsc. Różne metody rozliczeń w zależności od danych o miejscach, które są częścią odpowiedzi na zapytanie.
Podsumowanie
Potwierdziliśmy, że interfejs API Air Quality może być ważnym źródłem danych, na podstawie których użytkownicy mogą podejmować decyzje dotyczące miejsc do odwiedzenia. Dlatego dane o jakości powietrza powinny być widoczne w wyszukiwarce jak najwcześniej, przy zachowaniu ostrożności w zakresie ilości wyświetlanych jednocześnie informacji i sposobu ich wyświetlania.
Dalsze działania
Sugerowane materiały dodatkowe:
- Ułatwianie lokalnego wyszukiwania za pomocą interfejsu Nearby Search API (Nowy)
- Wyświetlanie danych w czasie rzeczywistym dzięki stylowi opartemu na danych
Współtwórcy
Ten artykuł jest aktualizowany przez Google. Poniżsi współtwórcy są autorami tych treści.
Główny autor:
Thomas Anglaret | Inżynier ds. rozwiązań