Obtenir des cartes météo (expérimental)

Le point de terminaison mapTypes fournit des tuiles de carte matricielle représentant divers phénomènes météorologiques, tels que les prévisions de précipitations. Ces tuiles de carte peuvent être superposées sur des cartes Google Maps standards.

Conditions d'utilisation

Ces conditions sont émises en vertu de la section 6 (Conditions des offres de pré-disponibilité générale) des Conditions spécifiques aux services Google Maps Platform, telles qu'acceptées par Google et vous.

1.1 Exigences d'attribution. Le Client doit fournir à Google une attribution conformément à la Documentation s'il utilise du Contenu Google Maps provenant de l'API Weather.

1.2 Restrictions. Les clients ne peuvent pas utiliser le contenu Google Maps récupéré à partir de l'API Weather pour recréer un service ou un produit Google (par exemple, utiliser les données récupérées à partir de l'API Weather dans une application ou un modèle météo dont l'objectif principal est de fournir des informations météorologiques).

1.3 Mise en cache. Les clients peuvent mettre en cache temporairement le contenu Google Maps applicable de l'API Weather pendant la période de mise en cache applicable, comme décrit dans le tableau 1.3.1 (Autorisations de mise en cache).

Tableau 1.3.1 (Autorisations de mise en cache)

Ces autorisations s'ajoutent à celles décrites dans le Tableau 17.2.1 des Conditions spécifiques du service Google Maps Platform.

Contenu de Google Maps Période de mise en cache
Tuiles de carte météo Une heure, après quoi le Client doit supprimer le Contenu Google Maps mis en cache

À propos des demandes de cartes météo

Pour demander des cartes météo, envoyez une requête HTTP GET à l'adresse suivante :

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

Types de carte

L'API Weather est compatible avec différents types de cartes météo, qui correspondent à différents modèles météo et zones géographiques sous-jacents :

  • US_PRECIPITATION_CURRENT : prévisions immédiates des précipitations aux États-Unis en haute résolution.
  • EU_PRECIPITATION_CURRENT : prévisions immédiates des précipitations en Europe en haute résolution.

La carte de couverture ci-dessous indique les régions où les tuiles de carte météo sont disponibles :

Couverture des tuiles de carte météo

Système de coordonnées de tuile

L'API utilise le système de coordonnées de tuile Web Mercator standard. Pour obtenir une explication complète des coordonnées de carte et de tuile, consultez Tuiles de feuille de route et Coordonnées de carte et de tuile.

Dans ce système :

  • zoom : niveau de zoom (de 0 à 16). Le niveau de zoom 0 représente le monde entier dans une seule tuile (20 x 20 = 1 tuile). Le niveau de zoom z divise le monde en une grille de 2z x 2z tuiles.
  • x : coordonnée X (colonne) de la tuile, comprise entre 0 (la plus à l'ouest) et 2zoom - 1 (la plus à l'est).
  • y : coordonnée Y (ligne) de la tuile, comprise entre 0 (la plus au nord) et 2zoom - 1 (la plus au sud).

Afficher la carte météo

Pour afficher ces tuiles dans une application Web à l'aide de l'API Google Maps JavaScript, vous pouvez créer un google.maps.ImageMapType personnalisé :

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

Exemple de requête de carte météo

L'exemple suivant demande des tuiles de carte météo des précipitations aux États-Unis pour La Nouvelle-Orléans :

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

La réponse est binaire. Le wrapper JSON n'apparaît que sous certains paramètres de sérialisation, tels que ?alt=json.