Lance un processus par lot qui calcule une carte en mosaïque et écrit le résultat dans Google Cloud Storage.
Requête HTTP
POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/map:export
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres | |
|---|---|
project |
ID ou numéro du projet Google Cloud Platform qui doit être traité comme le consommateur de services pour cette requête. Le format est le suivant : L'autorisation IAM suivante est requise pour la ressource indiquée
|
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
| Représentation JSON |
|---|
{ "expression": { object ( |
| Champs | |
|---|---|
expression |
Expression qui correspond à l'image à calculer et à exporter. Les limites de l'image seront utilisées pour déterminer l'ensemble des mosaïques de carte à afficher. Pour contrôler la région exportée, découpez l'image avant de l'exporter. |
description |
Nom de la tâche lisible par l'humain. |
tileOptions |
Options décrivant les mosaïques de carte à générer. |
tileExportOptions |
Options permettant de définir où et sous quelle forme exporter les mosaïques de carte. Cloud Storage est actuellement la seule destination acceptée pour les exportations de cartes. |
requestId |
Chaîne unique utilisée pour détecter les requêtes en double. Si plusieurs requêtes sont effectuées par le même utilisateur avec le même |
workloadTag |
Libellé fourni par l'utilisateur pour suivre ce calcul. |
priority |
Facultatif. Priorité de la tâche d'exportation dans le projet. Les tâches à priorité élevée sont planifiées plus tôt. Doit être un entier compris entre 0 et 9999. Si cette clause n'est pas définie, la valeur par défaut est 100. |
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une instance de Operation.
Champs d'application des autorisations
Nécessite l'un des niveaux d'accès OAuth suivants :
https://www.googleapis.com/auth/earthenginehttps://www.googleapis.com/auth/cloud-platformhttps://www.googleapis.com/auth/devstorage.full_control
Pour plus d'informations, consultez la OAuth 2.0 Overview.
TileOptions
Options décrivant les mosaïques de carte d'image ou de vidéo à exporter.
| Représentation JSON |
|---|
{ "startZoom": integer, "minZoom": integer, "skipEmpty": boolean, "skipEmptyTiles": boolean, "mapsApiKey": string, "dimensions": { object ( |
| Champs | |
|---|---|
startZoom |
Niveau de zoom à partir duquel générer des mosaïques de carte pour l'exportation. Prend la valeur zéro par défaut. |
minZoom |
Niveau de zoom à partir duquel générer des mosaïques de carte pour l'exportation. Prend la valeur zéro par défaut. |
skipEmpty |
Si la valeur est "true", ignore l'écriture des mosaïques de carte vides (c'est-à-dire entièrement transparentes). |
skipEmptyTiles |
Si la valeur est "true", ignore l'écriture des mosaïques de carte vides (c'est-à-dire entièrement transparentes). |
mapsApiKey |
Clé API Google Maps Platform facultative pour la visionneuse de mosaïques de carte générée. |
dimensions |
Largeur et hauteur des mosaïques vidéo de sortie, utilisées uniquement pour exporter des pyramides vidéo en mosaïque (ExportVideoMap). |
tileDimensions |
Largeur et hauteur des mosaïques vidéo de sortie, utilisées uniquement pour exporter des pyramides vidéo en mosaïque (ExportVideoMap). |
stride |
Pas de ligne et de colonne de mosaïque. (ExportVideoMap) Définissez la valeur sur 4 pour les mosaïques éparses (WebGL uniquement) ou sur 1 (par défaut) pour une compatibilité maximale. |
zoomSubset |
Sous-ensemble de niveaux de zoom pour lesquels générer des mosaïques. Ne peut être spécifié que dans un appel à |
| Niveau de zoom ou échelle à partir duquel arrêter de générer des mosaïques de carte pour. L'un ou l'autre doit être spécifié. Voici une liste de champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse : | |
endZoom |
Niveau de zoom à partir duquel arrêter de générer des mosaïques de carte pour. |
maxZoom |
Niveau de zoom à partir duquel arrêter de générer des mosaïques de carte pour. |
scale |
Résolution maximale de l'image en mètres par pixel. L'échelle sera convertie au niveau de zoom maximal le plus approprié au niveau de l'équateur. |
| Fin des champs mutuellement exclusifs. | |
ZoomSubset
Sous-ensemble de niveaux de zoom pour lesquels générer des mosaïques (ExportVideoMap). Les sous-ensembles de début et de fin sont des valeurs à double précision, ce qui vous permet d'afficher un ou plusieurs niveaux de zoom de manière incrémentielle. Pour afficher une pyramide entière avec un zoom de début de 12 : startZoom=0, endZoom=12, ne définissez pas ce message. Pour afficher les niveaux 0 à 11 et les 10 premiers% du niveau 12 : startZoom=0, endZoom=12, subset = {min=0, max=12.1 }. Pour afficher les 10% suivants du niveau 12 : startZoom=0, endZoom=12, subset = {min=12.1, max=12.2 }. Pour afficher les 80% restants du niveau 12 : startZoom=0, endZoom=12, subset = {min=12.2, max=13 }. Notez également que tous les fragments d'exportation doivent avoir la même taille de pyramide (complète) dans start/endZoom.
| Représentation JSON |
|---|
{ "start": number, "end": number, "min": number, "max": number } |
| Champs | |
|---|---|
start |
Sous-ensemble de niveau de zoom de début pour lequel générer des mosaïques (ExportVideoMap). Ici, le sous-ensemble est une valeur à double précision, ce qui vous permet d'afficher un niveau de zoom de manière incrémentielle. Par exemple, 12.1 correspond aux 10 premiers% des mosaïques du zoom 12 dans un ordre non spécifié, mais déterministe. |
end |
Sous-ensemble de niveau de zoom de fin pour lequel générer des mosaïques (ExportVideoMap), ce qui vous permet d'afficher un niveau de zoom de manière incrémentielle, jusqu'au sous-ensemble maximal (s'il est fourni), mais sans l'inclure, dans un ordre non spécifié, mais déterministe. |
min |
Sous-ensemble de niveau de zoom de début pour lequel générer des mosaïques (ExportVideoMap). Ici, le sous-ensemble est une valeur à double précision, ce qui vous permet d'afficher un niveau de zoom de manière incrémentielle. Par exemple, 12.1 correspond aux 10 premiers% des mosaïques du zoom 12 dans un ordre non spécifié, mais déterministe. |
max |
Sous-ensemble de niveau de zoom de fin pour lequel générer des mosaïques (ExportVideoMap), ce qui vous permet d'afficher un niveau de zoom de manière incrémentielle, jusqu'au sous-ensemble maximal (s'il est fourni), mais sans l'inclure, dans un ordre non spécifié, mais déterministe. |