Jakość powietrza w miejscach

Z tego dokumentu dowiesz się, jak używać interfejsu Air Quality API do tworzenia bogatych wyników 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 Air Quality API oferuje:

  • Dane w czasie rzeczywistym * i historyczne – aktualne i dokładne dane, które odzwierciedlają bieżący stan, a także dane historyczne z okresu 30 dni w rozdzielczości godzinowej. (* 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:

Wyświetlanie danych interfejsu Air Quality API 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 dany kraj, np. amerykańska Agencja Ochrony Środowiska (EPA), kategoryzuje różne poziomy jakości powietrza na podstawie różnych metod obliczania, źródeł danych i określonych celów.
  • Zacznij wizualizować główną wartość interfejsu API Air Quality i kod koloru bezpośrednio z wyszukiwarki miejsc.

domyślne wyświetlanie może obejmować tylko kod koloru.


Wyświetlanie dodatkowych informacji z interfejsu Air Quality API po wybraniu pinezki:

  • Ogólny i lokalny indeks jakości powietrza.
  • 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 punkty danych dotyczące lokalizacji są często przydatne w porównaniu z innymi lokalizacjami.

Przykład wyświetlania sekcji jakości powietrza

Odpowiedź dotycząca jakości 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
}
...
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świetlanie na mapie warstwy mapy termicznej interfejsu Air Quality API

Kolorowe płytki mapy termicznej to świetny sposób na:

  • aby uzyskać przegląd dużego obszaru.
  • aby szybko wyświetlić niuanse w danym 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 z ciepłomapą w ograniczonym zestawie indeksów jakości powietrza:

  • UAQI_RED_GREEN – uniwersalny indeks jakości powietrza w palecie czerwono-zielonej.
  • UAQI_INDIGO_PERSIAN – uniwersalny indeks jakości powietrza w palecie indygo-persyjskiej.
  • PM25_INDIGO_PERSIAN – paleta barw indeksu PM2,5 w odmianie indygo-persyjskiej.
  • GBR_DEFRA – paleta kolorów dziennego indeksu jakości powietrza (Wielka Brytania).
  • DEU_UBA – niemiecka paleta kolorów indeksu jakości powietrza
  • CAN_EC – paleta kolorów kanadyjskiego indeksu jakości powietrza i jej wpływu na zdrowie.
  • FRA_ATMO – paleta kolorów indeksu jakości powietrza we Francji.
  • US_AQI – paleta kolorów indeksu jakości powietrza w Stanach Zjednoczonych.

    • Pamiętaj, aby wskazać użytkownikom skalę kolorów, dzięki której będą mogli zrozumieć wartość i kolor:

    • Skala UAQI (0–100): Niska / Wysoka

    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

    Pokazałyś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 tak szybko, jak to możliwe, przy zachowaniu ostrożności w zakresie ilości wyświetlanych informacji i sposobu ich wyświetlania.

    Dalsze działania

    Sugerowane materiały dodatkowe:

    Współtwórcy

    Google jest autorem tego artykułu. Pierwotnie napisali go autorzy wymienieni poniżej.
    Główny autor:

    Thomas Anglaret | Inżynier ds. rozwiązań