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

Conditions d'utilisation

Ces conditions sont émises en vertu de la section 6 (Conditions des offres avant disponibilité générale) des Conditions spécifiques au service Google Maps Platform, telles qu'elles ont été convenues entre Google et vous.

1.1 Exigences d'attribution. Le Client doit fournir une attribution à Google en conformité avec la Documentation s'il utilise du Contenu Google Maps à partir 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 à partir 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 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 requêtes de carte 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éorologiques et zones géographiques sous-jacents :

  • US_PRECIPITATION_CURRENT: prévision immédiate des précipitations aux États-Unis en haute résolution.
  • EU_PRECIPITATION_CURRENT : prévision immédiate 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 tuiles 2z x 2z.
  • 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 (le plus au nord) à 2zoom - 1 (le plus au sud).

Afficher une carte météo

Pour afficher ces tuiles dans une application Web à l'aide de l'API 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.