Wetterkarten abrufen (experimentell)

Der Endpunkt mapTypes stellt Rasterkartenkacheln dar, die verschiedene Wetterphänomene wie Niederschlagsvorhersagen darstellen. Diese Kartenkacheln können auf Standardkarten von Google Maps gelegt werden.

Nutzungsbedingungen

Diese Nutzungsbedingungen werden gemäß Abschnitt 6 (Nutzungsbedingungen für Pre-GA-Angebote) der Google Maps Platform Service Specific Terms herausgegeben, wie zwischen Google und Ihnen vereinbart.

1.1 Anforderungen an die Quellenangabe. Der Kunde muss Google gemäß der Dokumentation eine Quellenangabe machen, wenn er Google Maps-Inhalte aus der Weather API verwendet.

1.2 Einschränkungen. Kunden dürfen Google Maps-Inhalte, die aus der Weather API abgerufen wurden, nicht verwenden, um einen Google-Dienst oder ein Google-Produkt nachzubilden. Sie dürfen beispielsweise keine Daten aus der Weather API in einer Wetter-App oder einem Wettermodell verwenden, dessen 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.

Google Maps-Inhalte Caching-Zeitraum
Kartenkacheln mit Wetterdaten Eine Stunde. Danach muss der Kunde die im Cache gespeicherten Google Maps-Inhalte löschen.

Anfragen zu Wetterkarten

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 Niederschlagsvorhersage für die USA.
  • EU_PRECIPITATION_CURRENT: Hochauflösende Niederschlagsvorhersage für Europa.

Auf der folgenden Karte sind die Regionen dargestellt, in denen Kartenkacheln mit Wetterdaten verfügbar sind:

Abdeckung von Wetterkartenkacheln

Kachelkoordinatensystem

Die API verwendet das standardmäßige Web Mercator-Kachelkoordinatensystem. Eine umfassende Erläuterung der Karten- und Kachelkoordinaten finden Sie unter Kartenkacheln und Karten- und Kachel Koordinaten.

In diesem System:

  • zoom: Die Zoomstufe (0 bis 16). Zoomstufe 0 stellt die gesamte Welt in einer einzigen Kachel dar (20 × 20 = 1 Kachel). Bei Zoomstufe z wird die Welt in ein Raster von 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 zu einer Wetterkarte

Im folgenden Beispiel werden Kartenkacheln mit Niederschlagsdaten 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 angezeigt, z. B. ?alt=json.