Wetterkarten abrufen (experimentell)

Der Endpunkt mapTypes stellt Rasterkartenkacheln bereit, die verschiedene Wetterphänomene wie Niederschlagsvorhersagen darstellen. Diese Kartenkacheln können über Standard-Google Maps gelegt werden.

Nutzungsbedingungen

Diese Bedingungen werden gemäß Paragraf 6 (Pre-GA-Angebotsbedingungen) der dienstspezifischen Nutzungsbedingungen für die Google Maps Platform herausgegeben, denen Sie und Google zugestimmt haben.

1.1 Anforderungen für Quellenangaben. Wenn der Kunde Google Maps-Inhalte aus der Weather API verwendet, muss er Google gemäß der Dokumentation als Quelle angeben.

1.2 Einschränkungen. Kunden dürfen Google Maps-Inhalte, die über die Weather API abgerufen wurden, nicht verwenden, um einen Google-Dienst oder ein Google-Produkt nachzubilden (z.B. Daten, die über die Weather API abgerufen wurden, in einer Wetter-App oder einem Wettermodell verwenden, deren Hauptzweck darin besteht, Wetterinformationen bereitzustellen).

1.3 Caching. Kunden können die entsprechenden Google Maps-Inhalte aus der Weather API für den entsprechenden Caching-Zeitraum vorübergehend im Cache speichern, wie in Tabelle 1.3.1 (Caching-Berechtigungen) beschrieben.

Tabelle 1.3.1 (Caching-Berechtigungen)

Diese Berechtigungen gelten zusätzlich zu den in Tabelle 17.2.1 der dienstspezifischen Nutzungsbedingungen für die Google Maps Platform beschriebenen Berechtigungen.

Inhalte aus Google Maps Caching-Zeitraum
Wetterkartenkacheln Eine Stunde, danach muss der Kunde die im Cache gespeicherten Google Maps-Inhalte löschen

Anfragen vom Typ „Wetterkarte“

Wenn Sie Wetterkarten anfordern möchten, senden Sie eine HTTP-GET-Anfrage an:

https://weather.googleapis.com/v1/mapTypes/{map_type}/mapTiles/{zoom}/{x}/{y}

Kartentypen

Die Weather API unterstützt verschiedene Wetterkartentypen, die unterschiedlichen zugrunde liegenden Wettermodellen und geografischen Gebieten entsprechen:

  • US_PRECIPITATION_CURRENT: Hochauflösende Nowcasting-Niederschlagsvorhersage für die USA.
  • EU_PRECIPITATION_CURRENT: Hochauflösende Nowcasting-Daten zu Niederschlägen in Europa.

Auf der folgenden Karte sehen Sie, in welchen Regionen Wetterkarten-Tiles verfügbar sind:

Abdeckung der Wetterkartenkacheln

Kachelkoordinatensystem

Die API verwendet das Standard-Web-Mercator-Kachelkoordinatensystem. Eine ausführliche Erläuterung der Karten- und Kachelkoordinaten finden Sie unter Straßenkarten-Kacheln und Karten- und Kachelkoordinaten.

In diesem System:

  • zoom: Die Zoomstufe (0 bis 16). Bei Zoomstufe 0 wird die ganze Welt in einer einzigen Kachel gerendert (20 × 20 = 1 Kachel). Bei Zoomstufe z wird die Welt in ein Raster aus 2z × 2z Kacheln unterteilt.
  • x: Die X-Koordinate (Spalte) der Kachel, von 0 (westlichste) bis 2zoom – 1 (östlichste).
  • y: Die Y-Koordinate (Zeile) der Kachel, von 0 (nördlichste) bis 2zoom - 1 (südlichste).

Wetterkarte anzeigen

Wenn Sie diese Kacheln in einer Webanwendung mit der Google Maps JavaScript API anzeigen möchten, können Sie einen benutzerdefinierten google.maps.ImageMapType erstellen:

const weatherMapType = new google.maps.ImageMapType({
  getTileUrl: function(coord, zoom) {
    const mapType = "US_PRECIPITATION_CURRENT";
    return `https://weather.googleapis.com/v1/mapTypes/${mapType}/mapTiles/${zoom}/${coord.x}/${coord.y}`;
  },
  tileSize: new google.maps.Size(256, 256),
  maxZoom: 16,
  minZoom: 0,
  name: "Weather"
});

// Overlay on existing map
map.overlayMapTypes.insertAt(0, weatherMapType);

Beispiel für eine Anfrage für eine Wetterkarte

Im folgenden Beispiel werden US-Niederschlagskartenkacheln für New Orleans angefordert:

curl -o tile.png -X GET "https://weather.googleapis.com/v1/mapTypes/US_PRECIPITATION_CURRENT/mapTiles/12/1025/1688?key=API_KEY"

Die Antwort ist binär. Der JSON-Wrapper wird nur unter bestimmten Serialisierungseinstellungen wie ?alt=json angezeigt.