Method: projects.maps.create

Crée un ID pouvant être utilisé pour afficher des tuiles de carte montrant les résultats d'un calcul. L'ID obtenu doit être utilisé dans les requêtes GetTile.

Il est utilisé avec GetTile. Un appel à maps.create fournit une expression et certaines options de sortie. Le résultat de maps.create est un ID de carte qui représente une image obtenue à la suite de l'évaluation de cette expression et de l'application de ces options. Vous pouvez ensuite appeler GetTile pour obtenir les données d'image d'une tuile de l'image obtenue, à n'importe quel emplacement et à n'importe quel niveau de zoom. L'ID de carte est valide pendant une période modérée (quelques heures).

Le cas d'utilisation le plus courant de cette paire de points de terminaison consiste à remplir un affichage de carte avec une visualisation de la sortie d'un calcul. Pour que cela soit possible, la sortie du calcul doit répondre à certaines exigences raisonnables pour le format d'image demandé. Plus précisément, le format JPEG ou PNG nécessite une ou trois bandes de sortie, ainsi que des valeurs de coupure en dehors de la plage 0-255.

Requête HTTP

POST https://earthengine.googleapis.com/v1beta/{parent=projects/*}/maps

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Parent de la collection de cartes (par exemple, "projects/*").

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • earthengine.maps.create

Paramètres de requête

Paramètres
workloadTag

string

Balise fournie par l'utilisateur pour suivre ce calcul.

Corps de la requête

Le corps de la requête contient une instance de EarthEngineMap.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une nouvelle instance de EarthEngineMap.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/earthengine.readonly
  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-platform.read-only

Pour en savoir plus, consultez OAuth 2.0 Overview.