Wettersymbole

Übersicht

Alle Vorhersageantworten enthalten ein icon-Feld in jedem Datenpunkt, das eine Wetterbedingung darstellt. Dieser Stringwert enthält alles, was nötig ist, um ein passendes Wettersymbol oder eine Bedingungsbezeichnung anzuzeigen.

Das icon-Feld ist ein String wie "01d" oder "07n", wobei die ersten zwei Ziffern der Bedingungscode sind und das Suffix Tag (d) oder Nacht (n) angibt.

Symbolcodes

Tag-/Nacht-Kennzeichnung

Das letzte Zeichen des icon-Strings gibt Tag (d) oder Nacht (n) an. Dies entspricht der Frage, ob der Datenpunkt während der Tageslichtstunden am angefragten Standort liegt, basierend auf Sonnenaufgangs- und Sonnenuntergangszeiten. Das boolesche Feld is_day wird ebenfalls zusammen mit icon bereitgestellt.

Verwende das Tag-/Nacht-Suffix, um die richtige Darstellung auszuwählen. Zum Beispiel sollte "00d" (Klar, Tag) eine Sonne anzeigen, während "00n" (Klar, Nacht) einen Mond anzeigen sollte. Die meisten Bedingungen (Regen, Schnee, Nebel usw.) benötigen keine Tag-/Nacht-Variante.

Wo diese Felder vorkommen

Sowohl icon als auch is_day sind vorhanden in:

• currently – dem Objekt mit den aktuellen Bedingungen
• hourly.data[] – jedem stündlichen Vorhersagepunkt
• daily.data[] – jedem täglichen Vorhersageeintrag (repräsentiert die Tagesbedingung; Suffix ist immer d)

Beispiel

{
  "currently": {
    "time": 1709132400,
    "summary": "Partly Cloudy",
    "icon": "01d",
    "is_day": true,
    "temperature": 8.2
  },
  "hourly": {
    "data": [
      {
        "time": 1709132400,
        "icon": "01d",
        "is_day": true,
        "temperature": 8.2
      },
      {
        "time": 1709175600,
        "icon": "00n",
        "is_day": false,
        "temperature": 3.1
      }
    ]
  }
}

Hinweise zur Verwendung

• Symbolcodes sind stabil und ändern ihre Bedeutung nicht. Neue Codes können am Ende des Bereichs hinzugefügt werden.
• Codes 00 und 01 (Klar und Teilweise bewölkt) sind die einzigen Bedingungen, bei denen eine visuelle Unterscheidung zwischen Tag und Nacht typischerweise nötig ist. Alle anderen Bedingungen können unabhängig vom Tag-/Nacht-Suffix ein einzelnes Symbol verwenden.