Cette page a été traduite par l'API Cloud Translation.

Method: projects.map.export

Lance un processus par lot qui calcule une carte en tuiles et écrit le résultat dans Google Cloud Storage.

Requête HTTP

POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/map:export

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres

Paramètres
`project`	`string` ID ou numéro du projet Google Cloud Platform à traiter comme client du service pour cette requête. Format : `projects/{project-id}` L'autorisation IAM suivante est requise pour la ressource `project` indiquée : `earthengine.exports.create`

project

string

ID ou numéro du projet Google Cloud Platform à traiter comme client du service pour cette requête. Format : projects/{project-id}

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

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

Représentation JSON
{ "expression": { object (`Expression`) }, "description": string, "tileOptions": { object (`TileOptions`) }, "tileExportOptions": { object (`ImageFileExportOptions`) }, "requestId": string, "workloadTag": string, "priority": integer }

{
  "expression": {
    object (Expression)
  },
  "description": string,
  "tileOptions": {
    object (TileOptions)
  },
  "tileExportOptions": {
    object (ImageFileExportOptions)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer
}

Champs
`expression`	`object (Expression)` Expression qui renvoie l'image à calculer et à exporter. Les limites de l'image permettent de déterminer l'ensemble de tuiles de carte à afficher. Pour contrôler la zone exportée, découpez l'image avant de l'exporter.
`description`	`string` Nom lisible de la tâche.
`tileOptions`	`object (TileOptions)` Options décrivant les tuiles de carte à générer.
`tileExportOptions`	`object (ImageFileExportOptions)` Options pour l'emplacement et le format d'exportation des tuiles de carte. Cloud Storage est actuellement la seule destination compatible avec les exportations de cartes.
`requestId`	`string` Chaîne unique utilisée pour détecter les requêtes dupliquées. Si le même utilisateur effectue plusieurs requêtes avec le même `requestId` non vide, seule l'une d'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` ne doit pas dépasser 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é plus élevée sont planifiées plus tôt. Il doit s'agir d'un entier compris entre 0 et 9 999. Si cette valeur n'est pas définie, elle est définie par défaut sur 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 champs d'application OAuth suivants :

https://www.googleapis.com/auth/earthengine
https://www.googleapis.com/auth/cloud-platform
https://www.googleapis.com/auth/devstorage.full_control

Pour en savoir plus, consultez OAuth 2.0 Overview.

TileOptions

Options décrivant les tuiles d'un plan image ou vidéo à exporter.

Représentation JSON

Représentation JSON
{ "startZoom": integer, "skipEmpty": boolean, "mapsApiKey": string, "dimensions": { object (`GridDimensions`) }, "stride": integer, "zoomSubset": { object (`ZoomSubset`) }, // Union field `end_zoom_or_scale` can be only one of the following: "endZoom": integer, "scale": number // End of list of possible types for union field `end_zoom_or_scale`. }

{
  "startZoom": integer,
  "skipEmpty": boolean,
  "mapsApiKey": string,
  "dimensions": {
    object (GridDimensions)
  },
  "stride": integer,
  "zoomSubset": {
    object (ZoomSubset)
  },

  // Union field end_zoom_or_scale can be only one of the following:
  "endZoom": integer,
  "scale": number
  // End of list of possible types for union field end_zoom_or_scale.
}

Champs
`startZoom`	`integer` Niveau de zoom à partir duquel commencer à générer des tuiles de carte à exporter. Prend la valeur zéro par défaut.
`skipEmpty`	`boolean` Si la valeur est définie sur "true", l'écriture des tuiles de carte vides (c'est-à-dire entièrement transparentes) est ignorée.
`mapsApiKey`	`string` Clé API Google Maps Platform facultative pour l'affichage des tuiles de carte générées.
`dimensions`	`object (GridDimensions)` Largeur et hauteur des tuiles vidéo de sortie, utilisées uniquement pour exporter des pyramides vidéo en tuiles (ExportVideoMap).
`stride`	`integer` Étape de ligne et de colonne de la carte. (ExportVideoMap) Définissez la valeur sur 4 pour les tuiles espacées (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 tuiles. Ne peut être spécifié que dans un appel à `ExportVideoMap`.
Champ d'union `end_zoom_or_scale`. Niveau de zoom ou échelle à partir duquel la génération de tuiles de carte doit s'arrêter. Vous devez spécifier l'un ou l'autre. `end_zoom_or_scale` ne peut être qu'un des éléments suivants :
`endZoom`	`integer` Niveau de zoom au-delà duquel la génération de tuiles de carte doit s'arrêter.
`scale`	`number` Résolution d'image maximale en mètres par pixel. L'échelle sera convertie en niveau de zoom maximal le plus approprié à l'équateur.

ZoomSubset

Sous-ensemble de niveaux de zoom pour lesquels générer des tuiles (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% 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 }

Champs

Champs
`start`	`number` Sous-ensemble du niveau de zoom de départ pour lequel générer des tuiles (ExportVideoMap) Ici, le sous-ensemble est une valeur à double précision, qui vous permet d'afficher un niveau de zoom de manière incrémentielle. Par exemple, 12.1 correspond aux 10% premiers des tuiles au niveau de zoom 12 dans un ordre non spécifié, mais déterministe.
`end`	`number` Sous-ensemble de niveaux de zoom de fin pour lesquels générer des tuiles (ExportVideoMap). Vous pouvez ainsi afficher un niveau de zoom de manière incrémentielle, jusqu'au sous-ensemble maximal (le cas échéant), mais sans l'inclure, dans un ordre non spécifié, mais déterministe.

start

number

Sous-ensemble du niveau de zoom de départ pour lequel générer des tuiles (ExportVideoMap) Ici, le sous-ensemble est une valeur à double précision, qui vous permet d'afficher un niveau de zoom de manière incrémentielle. Par exemple, 12.1 correspond aux 10% premiers des tuiles au niveau de zoom 12 dans un ordre non spécifié, mais déterministe.

end