Informacja o jakości powietrza w miejscach korzystających z interfejsu Air Quality API

Z tego dokumentu dowiesz się, jak używać interfejsu Air Quality API do tworzenia zaawansowanych funkcji wyszukiwania miejsc. Pokażemy, jak jakość powietrza może być sygnałem wartości dla użytkowników od samego początku aż do końca ścieżki, oraz jak dane z interfejsu Air Quality API można zintegrować z dotychczasowymi rozwiązaniami.

Przykłady zastosowań i wartość dodana

Sygnały z interfejsu Air Quality API mogą być wykorzystywane w różnych sytuacjach, np. gdy użytkownicy szukają miejsca do odwiedzenia. Interfejs Air Quality API oferuje:

  • Dane w czasie rzeczywistym * i dane historyczne – aktualne i dokładne dane, które odzwierciedlają bieżący stan, a także dane z ostatnich 30 dni w rozdzielczości godzinowej. (* godzinowy obraz jakości powietrza na zewnątrz)
  • Dane globalne i lokalne – interfejs Air Quality API obejmuje całe obszary w ponad 100 krajach, a zarazem jest wysoce zlokalizowany (do 500 m). Udostępnia on użytkownikom kluczowe sygnały, które umożliwiają porównywanie danych i podejmowanie decyzji dotyczących najbardziej odpowiedniego miejsca.

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 początku

Dane z interfejsu Air Quality API można wyświetlać na 2 główne sposoby:

Wyświetlanie danych z interfejsu Air Quality API na pinezkach lokalizacji

  • Wybierz indeks dla swojej lokalizacji: uniwersalny indeks AQI lub lokalny indeks AQI (dostępnych jest do 70 różnych indeksów jakości powietrza (AQI)). Indeks jakości powietrza (AQI) to skala, za pomocą której dany kraj, np. Amerykańska Agencja Ochrony Środowiska, kategoryzuje różne poziomy jakości powietrza na podstawie różnych metod obliczeniowych, źródeł danych i określonych celów.
  • Zacznij wizualizować główną wartość interfejsu Air Quality API i kod koloru bezpośrednio w wyszukiwarce miejsc.

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


Wyświetlanie większej ilości informacji o interfejsie Air Quality API po wybraniu pinezki:

  • Znaczenie uniwersalnego i lokalnego indeksu AQI.
  • Poziomy zanieczyszczeń, czyli pomiar cząsteczek i gazów w powietrzu: dominująca substancja zanieczyszczająca, stężenie, źródła i skutki.
  • Zalecenia dotyczące zdrowia, czyli zalecane działania w zależności od aktualnej jakości powietrza.
  • Możesz dostosować domyślny poziom wyświetlanych informacji 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 w przypadku interakcji z lokalizacją.

  • Możesz użyć indeksu interfejsu Air Quality API, aby filtrować miejsca w pobliżu, np. jeśli szukasz parków w swojej okolicy, wyświetlą się tylko te, w których jakość powietrza jest dobra.

Odpowiedź dotycząca jakości powietrza

...
"color":{
  "red": 0.9490196,
  "green": 0.98039216,
  "blue": 0.019607844
}
...
 Konwertuj 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 warstwy mapy termicznej interfejsu Air Quality API na mapie

Kolorowe kafelki mapy termicznej to świetny sposób na:

  • aby zapewnić przegląd dużego obszaru.
  • aby szybko pokazać niuanse w tym obszarze.

Użyj interfejsu Maps JavaScript API z ImateMapType, aby wyświetlić poszczególne kafelki potrzebne do pokrycia całego obszaru widocznego na mapie Google. Kafelki mapy termicznej będą się odświeżać, gdy użytkownik będzie wchodzić w interakcję z mapą, przesuwając ją, powiększając lub zmieniając lokalizację.

Pamiętaj, że dozwolone wartości poziomu powiększenia to maksymalnie 16.
 Warstwa kafelków mapy cieplnej interfejsu Air Quality API może zniknąć podczas wyszukiwania w bardzo małym obszarze.

Możesz wybrać rodzaje map cieplnych w ramach ograniczonego zestawu wskaźnikó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 odcieniach indygo i perskim.
  • PM25_INDIGO_PERSIAN – indeks PM2,5 w palecie indygo-perski.
  • GBR_DEFRA - Daily Air Quality Index (UK) color palette.
  • DEU_UBA – paleta kolorów niemieckiego lokalnego indeksu jakości powietrza.
  • CAN_EC – paleta kolorów kanadyjskiego indeksu jakości powietrza i jego 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.

    • Upewnij się, że użytkownicy znają skalę kolorów, aby mogli zrozumieć wartość i jej pozycję w rankingu kolorów:

    • skala gradientu UAQI (0–100): zła / 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): zła / doskonała

    Liczba zapytań i powiązane koszty

    • Maps JavaScript API: 1 mapa podczas wczytywania.
    • Air Quality API:
      • 1 zapytanie o każde miejsce (wszystkie po wczytaniu mapy lub tylko po wyborze przez użytkownika).
      • Warstwa kafelków mapy cieplnej: każdy obraz kafelka ma wymiary 256 x 256 pikseli. Aby pokryć standardową mapę wyświetlaną na urządzeniu mobilnym lub w internecie, potrzebujesz 12–14 kafelków. Każdy pobrany kafelek jest liczony jako 1 jednostka SKU.
    • Interfejs Nearby Search (New) API: 1 zapytanie na każde 20 wyświetlonych miejsc. Różne rozliczenia w zależności od danych o miejscu, które są częścią odpowiedzi na zapytanie.

    Podsumowanie

    Pokazaliśmy, że interfejs Air Quality API może być ważnym źródłem danych, które pomogą użytkownikom w podjęciu decyzji o tym, gdzie się wybrać. Dlatego dane o jakości powietrza powinny być widoczne jak najwcześniej w wynikach wyszukiwania. Należy jednak uważać na ilość informacji wyświetlanych jednocześnie i sposób ich prezentacji.

    Następne działania

    Sugerowane dodatkowe materiały:

    Współtwórcy

    Google jest autorem tego artykułu. Autorzy oryginalnego tekstu:
    Główny autor:

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