Method: projects.map.export

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

string

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 : projects/{project-id}.

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

  • earthengine.exports.create

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 (Expression)
  },
  "description": string,
  "tileOptions": {
    object (TileOptions)
  },
  "tileExportOptions": {
    object (ImageFileExportOptions)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer
}
Champs
expression

object (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

string

Nom de la tâche lisible par l'humain.

tileOptions

object (TileOptions)

Options décrivant les mosaïques de carte à générer.

tileExportOptions

object (ImageFileExportOptions)

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

string

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 requestId non vide, une seule d'entre elles peut démarrer une opération de longue durée. requestId peut contenir les caractères a..z, A..Z, 0-9 ou '-'. requestId Sa longueur maximale est de 60 caractères.

workloadTag

string

Libellé fourni par l'utilisateur pour suivre ce calcul.

priority

integer

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/earthengine
  • https://www.googleapis.com/auth/cloud-platform
  • https://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 (GridDimensions)
  },
  "tileDimensions": {
    object (GridDimensions)
  },
  "stride": integer,
  "zoomSubset": {
    object (ZoomSubset)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "endZoom": integer,
  "maxZoom": integer,
  "scale": number
  // End of mutually exclusive fields.
}
Champs
startZoom

integer

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
(deprecated)

integer

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

boolean

Si la valeur est "true", ignore l'écriture des mosaïques de carte vides (c'est-à-dire entièrement transparentes).

skipEmptyTiles
(deprecated)

boolean

Si la valeur est "true", ignore l'écriture des mosaïques de carte vides (c'est-à-dire entièrement transparentes).

mapsApiKey

string

Clé API Google Maps Platform facultative pour la visionneuse de mosaïques de carte générée.

dimensions

object (GridDimensions)

Largeur et hauteur des mosaïques vidéo de sortie, utilisées uniquement pour exporter des pyramides vidéo en mosaïque (ExportVideoMap).

tileDimensions
(deprecated)

object (GridDimensions)

Largeur et hauteur des mosaïques vidéo de sortie, utilisées uniquement pour exporter des pyramides vidéo en mosaïque (ExportVideoMap).

stride

integer

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

object (ZoomSubset)

Sous-ensemble de niveaux de zoom pour lesquels générer des mosaïques. Ne peut être spécifié que dans un appel à ExportVideoMap.

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

integer

Niveau de zoom à partir duquel arrêter de générer des mosaïques de carte pour.

maxZoom
(deprecated)

integer

Niveau de zoom à partir duquel arrêter de générer des mosaïques de carte pour.

scale

number

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

number

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

number

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
(deprecated)

number

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
(deprecated)

number

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.