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 |
ID ou numéro du projet Google Cloud Platform à traiter comme client du service pour cette requête. Format : L'autorisation IAM suivante est requise pour la ressource
|
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 ( |
Champs | |
---|---|
tableManifest |
Le fichier manifeste de la table. |
description |
Nom lisible de la tâche. |
overwrite |
Indique si l'écrasement d'un élément existant est autorisé. |
requestId |
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 |
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 ( |
Champs | |
---|---|
name |
Nom de l'asset à créer. |
properties |
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 |
uriPrefix |
Préfixe facultatif ajouté au début de tous les |
sources[] |
Sources de cette table. |
startTime |
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: |
endTime |
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: |
csvColumnDataTypeOverrides |
Utilisez plutôt columnDataTypeOverrides. Objet contenant une liste de paires |
columnDataTypeOverrides |
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 |
memo |
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[] |
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 |
charset |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 ! |