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 à la carte Google Maps standard.

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 au service Google Maps Platform, telles qu'acceptées par Google et vous.

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

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 les Contenus Google Maps applicables de l'API Weather pour 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 au service Google Maps Platform.

Contenu 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 concernant les 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 de précipitations à haute résolution pour l'Europe.

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 tuiles

L'API utilise le système de coordonnées de tuiles 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, allant de 0 (le plus à l'ouest) à 2zoom - 1 (le plus à l'est).
  • y : coordonnée Y (ligne) de la tuile, allant de 0 (la plus au nord) à 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 des paramètres de sérialisation spécifiques, tels que ?alt=json.