Method: projects.table.import

Importe une table.

Requête HTTP

POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/table: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.assets.create

Corps de la requête

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

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

object (TableManifest)

Le fichier manifeste de la table.

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.

TableManifest

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

Représentation JSON
{
  "name": string,
  "properties": {
    object
  },
  "uriPrefix": string,
  "sources": [
    {
      object (TableSource)
    }
  ],
  "startTime": string,
  "endTime": string,
  "csvColumnDataTypeOverrides": {
    string: enum (CsvColumnDataType),
    ...
  },
  "columnDataTypeOverrides": {
    string: enum (ColumnDataType),
    ...
  },
  "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.

sources[]

object (TableSource)

Sources de cette table.

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".

csvColumnDataTypeOverrides
(deprecated)

map (key: string, value: enum (CsvColumnDataType))

Utilisez plutôt columnDataTypeOverrides.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

columnDataTypeOverrides

map (key: string, value: enum (ColumnDataType))

Mappage du nom de la colonne sur le type à utiliser pour cette colonne. Le type des colonnes non spécifiées ici sera déduit, de sorte que les colonnes numériques deviennent des nombres, les colonnes WKT deviennent des géométries, etc.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

memo

string

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

TableSource

Fichier de table.

Représentation JSON
{
  "uris": [
    string
  ],
  "charset": string,
  "maxErrorMeters": number,
  "maxVertices": integer,
  "crs": string,
  "geodesic": boolean,
  "primaryGeometryColumn": string,
  "xColumn": string,
  "yColumn": string,
  "dateFormat": string,
  "csvDelimiter": string,
  "csvQualifier": string
}
Champs
uris[]

string

URI des données à importer. Actuellement, seuls les URI Google Cloud Storage sont acceptés. Chaque URI doit être spécifié au format suivant: "gs://id-bucket/id-objet". L'objet principal doit être le premier élément de la liste. Les fichiers associés sont inférés à partir du chemin d'accès de l'objet principal. Un seul URI est actuellement accepté. Si plusieurs URI sont spécifiés, une erreur INALID_ARGUMENT est renvoyée.

charset

string

Nom du jeu de caractères par défaut à utiliser pour décoder les chaînes. Si cet élément est vide, le jeu de caractères "utf-8" est utilisé par défaut.

maxErrorMeters

number

Erreur maximale autorisée en mètres lors de la transformation de la géométrie entre les systèmes de coordonnées. Si ce champ est vide, l'erreur maximale est de 1 mètre par défaut.

maxVertices

integer

Nombre maximal de sommets. Si la valeur n'est pas nulle, la géométrie est subdivisée en éléments spatialement disjoints, chacun étant inférieur à cette limite.

crs

string

Code de système de coordonnées de référence (CRS) ou chaîne WKT par défaut spécifiant le système de coordonnées de référence de toute géométrie pour laquelle aucun n'est spécifié. Si vous ne renseignez pas ce champ, la valeur par défaut est EPSG:4326: https://epsg.io/4326. Pour les sources CSV/TFRecord uniquement.

geodesic

boolean

Stratégie par défaut pour l'interprétation des arêtes dans une géométrie pour laquelle aucune stratégie n'est spécifiée. Si la valeur est "false", les arêtes sont droites dans la projection. Si la valeur est "true", les arêtes sont incurvées pour suivre le chemin le plus court à la surface de la Terre. Si ce champ est vide, la valeur par défaut est "false" si "crs" est un système de coordonnées projeté. Pour les sources CSV/TFRecord uniquement.

primaryGeometryColumn

string

Colonne de géométrie à utiliser comme géométrie principale d'une ligne lorsqu'il existe plusieurs colonnes de géométrie.

Si vous ne renseignez pas ce champ et qu'il existe plusieurs colonnes de géométrie, la première colonne de géométrie rencontrée est utilisée. Pour les sources CSV/TFRecord uniquement.

xColumn

string

Nom de la colonne de coordonnées X numériques pour déduire la géométrie des points. Si la colonne "yColumn" est également spécifiée et que les deux colonnes contiennent des valeurs numériques, une colonne de géométrie de point est créée avec des valeurs x,y dans le système de coordonnées indiqué dans "crs". Si ce champ est laissé vide et que aucun système de coordonnées projeté n'est spécifié dans "crs", la valeur par défaut est "longitude". Si vous ne renseignez pas ce champ et que 'crs' spécifie un système de coordonnées projeté, la valeur par défaut est "" et aucune géométrie de point n'est générée.

Une colonne de géométrie de point générée sera nommée {xColumn}_{yColumn}_N, où N est ajouté de sorte que {xColumn}_{yColumn}_N soit unique si une colonne nommée {xColumn}_{yColumn} existe déjà. Pour les sources CSV/TFRecord uniquement.

yColumn

string

Nom de la colonne de coordonnées Y numériques pour déduire la géométrie des points. Si la colonne "xColumn" est également spécifiée et que les deux colonnes contiennent des valeurs numériques, une colonne de géométrie de point est créée avec des valeurs x,y dans le système de coordonnées indiqué dans "crs". Si ce champ est laissé vide et que aucun système de coordonnées projeté n'est spécifié dans "crs", la valeur par défaut est "latitude". Si vous ne renseignez pas ce champ et que 'crs' spécifie un système de coordonnées projeté, la valeur par défaut est "" et aucune géométrie de point n'est générée.

Une colonne de géométrie de point générée sera nommée {xColumn}_{yColumn}_N, où N est ajouté de sorte que {xColumn}_{yColumn}_N soit unique si une colonne nommée {xColumn}_{yColumn} existe déjà. Pour les sources CSV/TFRecord uniquement.

dateFormat

string

Format permettant d'analyser les champs encodant des dates. Le format doit être conforme à la description disponible sur http://joda-time.sourceforge.net/apidocs/org/joda/time/format/DateTimeFormat.html. Si vous ne renseignez pas ce champ, les dates seront importées sous forme de chaînes. Pour les sources CSV/TFRecord uniquement.

csvDelimiter

string

Lors de l'ingestion de fichiers CSV, un seul caractère est utilisé comme séparateur entre les valeurs des colonnes d'une ligne. Si ce champ n'est pas renseigné, la valeur par défaut est ",". Pour les sources CSV uniquement.

csvQualifier

string

Lors de l'ingestion de fichiers CSV, caractère qui entoure les valeurs des colonnes (également appelé "caractère de guillemet"). Si vous ne renseignez pas ce champ, la valeur par défaut est "". Pour les sources CSV uniquement.

Si une valeur de colonne n'est pas entourée de qualificatifs, les espaces de début et de fin sont supprimés. Par exemple: ..., test,... <== cette valeur n'est pas qualifiée et devient la valeur de chaîne: "test" <== les espaces sont supprimés

where: ...," test",... <== cette valeur EST qualifiée par des guillemets devient la valeur de chaîne: " test" <== l'espace reste !