Method: projects.image.import

Importe une image.

Requête HTTP

POST https://earthengine.googleapis.com/v1/{project=projects/*}/image:import

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 à 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.imports.create

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "imageManifest": {
    object (ImageManifest)
  },
  "description": string,
  "overwrite": boolean,
  "requestId": string
}
Champs
imageManifest

object (ImageManifest)

Fichier manifeste de l'image.
description

string

Nom lisible de la tâche.
overwrite

boolean

Indique si l'écrasement d'un élément existant est autorisé.
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.

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

Pour en savoir plus, consultez OAuth 2.0 Overview.

ImageManifest

Décrit comment le service EarthEngine doit composer une image à partir d'un ensemble de fichiers.

Représentation JSON 
{
  "name": string,
  "properties": {
    object
  },
  "uriPrefix": string,
  "tilesets": [
    {
      object (Tileset)
    }
  ],
  "bands": [
    {
      object (TilesetBand)
    }
  ],
  "maskBands": [
    {
      object (TilesetMaskBand)
    }
  ],
  "footprint": {
    object (PixelFootprint)
  },
  "missingData": {
    object (MissingData)
  },
  "pyramidingPolicy": enum (PyramidingPolicy),
  "startTime": string,
  "endTime": string,
  "skipMetadataRead": boolean,
  "memo": string
}
Champs
name

string

Nom de l'asset à créer. name est au format "projects/*/assets/**" (par exemple, "projects/earthengine-legacy/assets/users//"). Tous les éléments appartenant à l'utilisateur sont sous le projet "earthengine-legacy" (par exemple, "projects/earthengine-legacy/assets/users/foo/bar"). Tous les autres composants se trouvent dans le projet "earthengine-public" (par exemple, "projects/earthengine-public/assets/LANDSAT").
properties

object (Struct format)

Propriétés supplémentaires de l'asset. Les noms de propriétés "system:time_start" et "system:time_end" sont obsolètes. Utilisez plutôt les champs startTime et endTime.
uriPrefix

string

Préfixe facultatif ajouté au début de tous les uri définis dans ce fichier manifeste.
tilesets[]

object (Tileset)

Les ensembles de tuiles. Chaque ensemble de tuiles doit avoir un ID unique.
bands[]

object (TilesetBand)

Les bracelets. L'ordre des bandes de l'asset est identique à celui de bands.
maskBands[]

object (TilesetMaskBand)

Bandes de masque
footprint

object (PixelFootprint)

L'empreinte en coordonnées de pixels (et non en coordonnées de latitude/longitude). Si cette valeur est vide, l'empreinte correspond par défaut à l'ensemble de l'image. Pour obtenir une description plus détaillée des coordonnées de pixel, consultez PixelGrid.
missingData

object (MissingData)

Valeurs qui ne représentent aucune donnée dans toutes les bandes de l'image. S'applique à toutes les bandes qui ne spécifient pas leur propre missingData.
pyramidingPolicy

enum (PyramidingPolicy)

Règlement sur la pyramide. Si aucune valeur n'est spécifiée, la règle MEAN est appliquée par défaut. S'applique à toutes les bandes qui ne spécifient pas leur propre pyramidingPolicy.
startTime

string (Timestamp format)

Code temporel associé au composant, le cas échéant (par exemple, heure à laquelle une image satellite a été prise). Pour les composants qui correspondent à un intervalle de temps, comme les valeurs moyennes sur un mois ou une année, ce code temporel correspond au début de cet intervalle.

Utilise la norme RFC 3339, où la sortie générée est toujours normalisée avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Pour les composants qui correspondent à un intervalle de temps, comme les valeurs moyennes sur un mois ou une année, cet horodatage correspond à la fin de cet intervalle (exclusif).

Utilise la norme RFC 3339, où la sortie générée est toujours normalisée avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
skipMetadataRead

boolean

Indique si la lecture des métadonnées à partir des fichiers doit être ignorée à l'aide de GDAL. Lorsque ce champ est défini sur "true", les cartes doivent contenir des métadonnées GDAL complètes: type de données, système de coordonnées, transformation, dimensions de fichier et aucune valeur de données.
memo

string

Champ de format libre permettant de stocker les notes des utilisateurs. Non utilisé lors de l'ingestion.

TilesetBand

Représente une bande unique provenant d'un ensemble de tuiles.

Représentation JSON 
{
  "id": string,
  "tilesetId": string,
  "tilesetBandIndex": integer,
  "missingData": {
    object (MissingData)
  },
  "pyramidingPolicy": enum (PyramidingPolicy)
}
Champs
id

string

ID de la bande.
tilesetId

string

ID de la carte de tuiles correspondant à la bande.
tilesetBandIndex

integer

Index de bande basé sur zéro du jeu de tuiles correspondant à la bande. Par exemple, si la valeur est 1, les pixels de la bande sont les pixels de la bande à l'indice 1 de la carte de tuiles (dans ImageManifest.tilesets) avec l'ID tilesetId.
missingData

object (MissingData)

Valeurs qui ne représentent aucune donnée dans la bande. Si MissingData est défini sans values, toute valeur nodata présente pour les fichiers correspondant à ce TilesetBand est ignorée.
pyramidingPolicy

enum (PyramidingPolicy)

Règlement sur la pyramide.

TilesetMaskBand

Représente une bande de masque unique provenant d'un ensemble de tuiles.

Représentation JSON 
{
  "tilesetId": string,
  "bandIds": [
    string
  ]
}
Champs
tilesetId

string

ID du jeu de tuiles correspondant à la bande de masque. La dernière bande de la carte est toujours utilisée comme bande de masque.
bandIds[]

string

ID des bandes auxquelles la bande de masquage s'applique. Si elle est vide, la bande de masque est appliquée à toutes les bandes du composant. Chaque bande ne peut avoir qu'une seule bande de masque correspondante. Si l'une de ces bandes comporte un masque interne, il est ignoré au profit de cette bande de masque.

PixelFootprint

Empreinte de tous les pixels valides d'une image.

Représentation JSON 
{
  "points": [
    {
      object (GridPoint)
    }
  ],
  "bandId": string
}
Champs
points[]

object (GridPoint)

Anneau qui forme l'extérieur d'un polygone simple qui doit contenir les centres de tous les pixels valides de l'image. Il doit s'agir d'un anneau linéaire: le dernier point doit être identique au premier. Les coordonnées sont dans la projection de la bande spécifiée par bandId.

Remarque: Utilisez des coordonnées non entières, telles que le centre de chaque pixel, car l'empreinte est considérée comme incluant un pixel si et seulement si le pixel (un rectangle de 1 x 1) intersecte l'empreinte. Pour éviter de sélectionner accidentellement des pixels voisins, n'utilisez pas de coordonnées à valeurs entières, car ce sont les limites entre les pixels. Dessiner l'empreinte le long des centres de pixel empêche d'inclure des pixels non intentionnels, ce qui peut entraîner des erreurs lorsque les pixels prévus sont adjacents à une limite de carte, comme l'antiméridien ou un pôle.

Par exemple, pour une image 2x2 avec les quatre pixels valides, voici un anneau possible: [{"x": 0.5, "y": 0.5}, {"x": 0.5, "y": 1.5}, {"x": 1.5, "y": 1.5}, {"x": 1.5, "y": 0.5}, {"x": 0.5, "y": 0.5}]
bandId

string

ID de la bande dont le système de coordonnées définit les coordonnées de l'empreinte. Si ce champ est vide, la première bande est utilisée.

GridPoint

Point ou vecteur bidimensionnel.

Représentation JSON 
{
  "x": number,
  "y": number
}
Champs
x

number

Valeur de la coordonnée x.
y

number

Valeur de la coordonnée Y.