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

In diesem Dokument erfahren Sie, wie Sie mit der Air Quality API eine umfassende Ortssuche erstellen können. Wir zeigen Ihnen, wie die Luftqualität von Anfang bis Ende des Trichters für Nutzer ein Wertsignal sein kann und wie die Daten der Air Quality API in bestehende Umgebungen eingebettet werden können.

Anwendungsfälle und Mehrwert

Signale der Air Quality API können bei verschiedenen Suchfunktionen berücksichtigt werden, z. B. wenn Nutzer nach einem Ort suchen, den sie besuchen möchten. Die Air Quality API bietet:

  • Echtzeit * und Verlaufsdaten: aktuelle, genaue Daten, die den aktuellen Status sowie Daten aus der Vergangenheit innerhalb eines 30-Tage-Zeitfensters in stündlicher Auflösung darstellen. (* Stündliche Momentaufnahme der Luftqualität im Freien)
  • Globale und lokale Daten: Die Daten der Air Quality API decken ganze Gebiete in mehr als 100 Ländern ab und sind dabei stark lokalisiert (bis zu 500 m). Sie liefern Nutzern wichtige Signale, um die für sie geeigneten Orte zu vergleichen und Entscheidungen zu treffen.

Auch in der Nähe von Standorten kann die Luftqualität sehr unterschiedlich sein.

Beispielhafte Schritt-für-Schritt-Anleitung

Daten zur Luftqualität in einem frühen Stadium anzeigen

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

Air Quality API-Daten auf Standortmarkierungen anzeigen

  • Wähle deinen Standortindex aus: „Universaler Luftqualitätsindex“ oder „Lokaler LQI“ (bis zu 70 verschiedene Luftqualitätsindexe (AQI)) sind verfügbar. Der Luftqualitätsindex (Air Quality Index, AQI) ist die Skala, nach der ein bestimmtes Land, z.B. die US EPA, verschiedene Luftqualitätsstufen auf der Grundlage verschiedener Berechnungsmethoden, Datenquellen und Verwendungszwecke kategorisiert.
  • Beginnen Sie damit, den Hauptwert und den Farbcode der Air Quality API direkt über die Ortssuche zu visualisieren.

Standarddisplay könnte nur den Farbcode enthalten.


Weitere Air Quality API-Informationen bei der Auswahl der Markierung anzeigen:

  • Universelle AQI / lokale AQI – Bedeutung.
  • Schadstoffgehalt: Dieser Wert gibt die Partikel und Gase in der Luft an: dominanter Schadstoff, Konzentration, Quellen und Auswirkungen.
  • Gesundheitsempfehlungen: Empfehlungen für die aktuelle Luftqualität.
  • Sie können den Informationsgrad, der standardmäßig angezeigt wird, an Ihre Anforderungen anpassen. Datenpunkte für einen Standort sind oft im Vergleich zu anderen Standorten nützlich.

Beispiel für die Anzeige des Abschnitts zur Luftqualität

Antwort auf die Luftqualität

{
    "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 Daten zur Luftqualität nur bei Interaktion mit einem Standort abfragen.

  • Mithilfe des Air Quality API-Index können Sie Orte in der Nähe filtern. Wenn Sie z. B. nach Parks in Ihrer Nähe suchen, werden nur Parks mit guter Luftqualität angezeigt.

Antwort 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)

Heatmap-Ebene der Air Quality API auf einer Karte anzeigen

Mit Heatmap-Farben gekennzeichnete Kacheln sind eine gute Möglichkeit:

  • um einen großen Überblick zu geben.
  • um schnell Nuancen innerhalb dieses Bereichs anzuzeigen.

Verwenden Sie die Maps JavaScript API mit ImateMapType, um die einzelnen Kacheln anzuzeigen, die für den gesamten Darstellungsbereich Ihrer Google-Karte erforderlich sind. Heatmap-Kacheln werden aktualisiert, wenn Nutzer mit der Karte interagieren, indem sie schwenken, zoomen oder den Standort ändern.

Beachten Sie, dass der zulässige Wert für die Zoomstufe maximal 16 beträgt.
Die Heatmap-Kachelebene der Air Quality API verschwindet bei der hyperlokalen Suche.

Sie können innerhalb einer begrenzten Reihe von Luftqualitätsindexen Heatmap-Kartentypen auswählen:

  • UAQI_RED_GREEN: rot-grüne Palette für den universellen Luftqualitätsindex.
  • UAQI_INDIGO_PERSIAN – indigo-persische Farbpalette für Universal Air Quality Index.
  • PM25_INDIGO_PERSIAN – indigo-persische Farbpalette für PM2,5-Index.
  • GBR_DEFRA – Farbvorlage für den täglichen Luftqualitätsindex (UK).
  • DEU_UBA – Farbvorlage für den deutschen Luftqualitätsindex
  • CAN_EC – Farbpalette für den kanadischen Luftqualitätsindex
  • FRA_ATMO: Farbpalette für den Luftqualitätsindex Frankreich
  • US_AQI: Farbpalette für den Luftqualitätsindex (USA)

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

    • Gradientenskala (UAQI) (0–100): Schlecht / Sehr gut

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

    • Volltonfarben zur Darstellung eines wichtigen Punkts auf der UAQI-Skala (0–100): Schlecht / Hervorragend

    Anzahl der Abfragen und zugehörige Kosten

    • Maps JavaScript API: 1 Karte beim Laden des Tests.
    • Air Quality API:
      • 1 Abfrage für jeden Ort (alle beim Laden der Karte oder nur bei Auswahl des Nutzers)
      • Heatmap-Kachelebene: Jedes Kachelbild ist 256 × 256 Pixel groß. Um eine Standardkarte auf einem Mobilgerät oder im Web abzudecken, sind 12–14 Kacheln erforderlich. Jede abgerufene Kachel wird als eine SKU-Einheit gezählt.
    • Nearby Search (New) API: 1 Abfrage alle 20 angezeigten Orte. Unterschiedliche Abrechnung gemäß den Place-Daten, die Teil der Abfrageantwort sind.

    Fazit

    Wir haben gezeigt, dass die Air Quality API für Nutzer ein wichtiger Datenpunkt bei der Entscheidung für einen Ort sein kann. Daher sollten die Daten zur Luftqualität bei der Suche so früh wie möglich sichtbar sein. Berücksichtigen Sie dabei die Menge der gleichzeitig angezeigten Informationen und die Art und Weise, wie sie sichtbar gemacht werden.

    Nächste Aktionen

    Weitere Informationen:

    Beitragende

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

    Thomas Anglaret | Solutions Engineer