Wetterkarten abrufen (experimentell)

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

Nutzungsbedingungen

Diese Bedingungen werden gemäß Paragraf 6 (Nutzungsbedingungen für Pre-GA-Angebote) der dienstspezifischen Nutzungsbedingungen für die Google Maps Platform herausgegeben, die zwischen Google und Ihnen vereinbart wurden.

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

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

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

Tabelle 1.3.1 (Berechtigungen für das Caching)

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
Wetterkartenkacheln Eine Stunde, nach der der Kunde die zwischengespeicherten Google Maps-Inhalte löschen muss

Anfragen für 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: Nowcast für Niederschlag in den USA mit hoher Auflösung.
  • EU_PRECIPITATION_CURRENT: Hochauflösende Niederschlagsvorhersage für Europa.

Auf der Karte unten sehen Sie die Regionen, in denen Wetterkartenkacheln verfügbar sind:

Abdeckung von Wetterkartenkacheln

Kachelkoordinatensystem

In der API wird das Standard-Web-Mercator-Kachelkoordinatensystem verwendet. Eine umfassende Erklärung von Karten- und Kachelkoordinaten finden Sie unter Roadmap-Kacheln und Karten- und Kachelkoordinaten.

In diesem System:

  • zoom: Der Zoomfaktor (0 bis 16). Bei Zoomstufe 0 wird die gesamte Welt in einer einzigen Kachel dargestellt (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, die von 0 (westlichste) bis 2zoom – 1 (östlichste) reicht.
  • y: Die Y-Koordinate (Zeile) der Kachel, die von 0 (nördlichste) bis 2zoom – 1 (südlichste) reicht.

Wetterkarte anzeigen

Wenn Sie diese Kacheln in einer Webanwendung mit der Google Maps JavaScript API anzeigen möchten, können Sie ein benutzerdefiniertes 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 bei bestimmten Serialisierungseinstellungen wie ?alt=json angezeigt.