Luftqualitätserkennung für Orte mithilfe der Air Quality API

In diesem Dokument erfahren Sie, wie Sie mit der Air Quality API umfassende Funktionen für die Suche nach Orten erstellen. Wir zeigen, wie die Luftqualität von Anfang bis Ende des Trichters ein wertvolles Signal für Nutzer sein kann und wie Daten der Air Quality API in bestehende Produkte eingebettet werden können.

Anwendungsfälle und Mehrwert

Die Signale der Luftqualitäts-API können in verschiedene Suchanfragen einfließen, z. B. wenn Nutzer nach einem Ort suchen, den sie besuchen möchten. Die Air Quality API bietet:

  • Echtzeitdaten * und Verlaufsdaten: Aktuelle, genaue Daten, die den aktuellen Status sowie Daten aus den letzten 30 Tagen in stündlicher Auflösung darstellen. (* Stündliche Momentaufnahme der Luftqualität im Freien)
  • Globale und lokale Daten: Die Daten der Luftqualitäts-API decken ganze Gebiete in über 100 Ländern ab, sind aber sehr lokalisiert (bis zu 500 m). Sie liefern Nutzern wichtige Signale, um den am besten geeigneten Ort zu vergleichen und zu entscheiden.

Die Luftqualität kann selbst an nahe gelegenen Standorten drastisch variieren.

Beispiel für eine Schritt-für-Schritt-Anleitung

Daten zur Luftqualität schon früh anzeigen

Es gibt zwei Möglichkeiten, die Daten der Air Quality API anzuzeigen:

Air Quality API-Daten an Standortmarkierungen anzeigen

  • Wählen Sie den Standortindex aus: universeller LQI oder lokaler LQI (bis zu 70 unterschiedliche LQI verfügbar). Der Luftqualitätsindex (LQI) ist die Skala, nach der ein bestimmtes Land, z. B. die US-amerikanische EPA, verschiedene Luftqualitätsstufen kategorisiert. Grundlage hierfür sind verschiedene Berechnungsmethoden, Datenquellen und festgelegte Zwecke.
  • Sie können den Hauptwert der Air Quality API und den Farbcode direkt in der Ortssuche visualisieren.

Die Standardanzeige kann nur den Farbcode enthalten.


Bei der Auswahl der Markierung können Sie weitere Informationen zur Air Quality API anzeigen lassen:

  • Bedeutung des universellen LQI / lokalen LQI
  • Schadstoffkonzentrationen, ein Maß für Partikel und Gase in der Luft: Vorherrschender Schadstoff, Konzentration, Quellen und Auswirkungen.
  • Gesundheitsempfehlungen: Empfehlungen für die aktuelle Luftqualität.
  • Sie können die Standardeinstellung für die angezeigten Informationen an Ihre Anforderungen anpassen. Datenpunkte für einen Standort sind oft im Vergleich zu anderen Standorten nützlich.

Beispiel für die Anzeige des Bereichs „Luftqualität“

Luftqualitätsreaktion

{
    "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": …
    }
}
  • Alternativ können Sie Luftqualitätsdaten nur bei Interaktion mit einem Standort abfragen.

  • Mit dem Index der Luftqualitäts-API können Sie Orte in der Nähe filtern. Wenn Sie beispielsweise nach Parks in Ihrer Nähe suchen, werden nur Parks mit guter Luftqualität angezeigt.

Reaktion auf die Luftqualität

...
"color":{
  "red": 0.9490196,
  "green": 0.98039216,
  "blue": 0.019607844
}
...
 In RGB konvertieren 
  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)

Air Quality API-Heatmap-Ebene auf einer Karte anzeigen

Farbige Heatmaps bieten eine gute Möglichkeit:

  • einen großen Überblick.
  • um schnell Nuancen in diesem Bereich zu zeigen.

Verwenden Sie die Maps JavaScript API mit dem ImateMapType, um die einzelnen Kacheln anzuzeigen, die erforderlich sind, um den gesamten Darstellungsbereich Ihrer Google-Karte abzudecken. Heatmap-Kacheln werden aktualisiert, wenn der Nutzer durch Schwenken, Zoomen oder Ändern des Standorts mit der Karte interagiert.

Der zulässige Wert für die Zoomstufe ist 16.
 Die Heatmap-Kachelebene der Air Quality API wird bei hyperlokalen Suchanfragen möglicherweise nicht angezeigt.

Sie können Heatmap-Kartentypen für eine begrenzte Anzahl von Luftqualitätsindexen auswählen:

  • UAQI_RED_GREEN – Rot-Grün-Farbvorlage für den universellen Luftqualitätsindex.
  • UAQI_INDIGO_PERSIAN – Universal Air Quality Index-Indigo-persische Palette.
  • PM25_INDIGO_PERSIAN – PM2.5-Index mit Indigo-persischer Palette
  • GBR_DEFRA – Farbvorlage für den täglichen Luftqualitätsindex (Vereinigtes Königreich)
  • DEU_UBA – Farbpalette für den deutschen lokalen Luftqualitätsindex.
  • CAN_EC – Farbpalette für den kanadischen Luftqualitätsindex
  • FRA_ATMO – Farbpalette für den Luftqualitätsindex in Frankreich
  • US_AQI – Farbpalette für den Luftqualitätsindex (USA)

    • Geben Sie die Farbskala an, damit Nutzer den Wert und seine Farbrangfolge verstehen können:

    • Farbverlaufsskala für UAQI (0–100): Schlecht / Hervorragend

    CSS-Snippet für die Farbpalette: 

    .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 */
   );
}

    • Einfarbig, um wichtige Punkte auf der UAQI-Skala (0–100) darzustellen: Schlecht / Hervorragend

    Anzahl der Abfragen und zugehörige Kosten

    • Maps JavaScript API: 1 Karte beim Laden der Website.
    • Air Quality API:
      • 1 Suchanfrage pro Ort (alle beim Kartenaufruf oder nur bei Nutzerauswahl)
      • Heatmap-Kachelebene: Jedes Kachelbild hat eine Größe von 256 × 256 Pixeln. Für eine Standardkarte, die auf einem Mobilgerät oder im Web angezeigt wird, sind 12 bis 14 Kacheln erforderlich. Jede abgerufene Kachel wird als eine SKU-Einheit gezählt.
    • Nearby Search (New) API: 1 Anfrage pro 20 angezeigte Orte. Unterschiedliche Abrechnung gemäß den Place-Daten, die Teil der Abfrageantwort sind.

    Fazit

    Wir haben gezeigt, dass die Luftqualitäts-API ein wichtiger Datenpunkt für Nutzer sein kann, um sich für einen Ort zu entscheiden, den sie besuchen möchten. Daher sollten die Daten zur Luftqualität so früh wie möglich in der Suche angezeigt werden. Dabei ist darauf zu achten, wie viele Informationen gleichzeitig angezeigt werden und wie sie dargestellt werden.

    Nächste Aktionen

    Weitere Informationen:

    Beitragende

    Dieser Artikel wird von Google gepflegt. Die folgenden Mitwirkenden haben den Artikel ursprünglich verfasst.
    Hauptautor:

    Thomas Anglaret | Solutions Engineer