Importa una tabla.
Solicitud HTTP
POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/table:import
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros | |
|---|---|
project |
El ID o el número de proyecto de Google Cloud Platform que se debe considerar como el consumidor de servicios para esta solicitud. El formato es La autorización requiere el siguiente permiso IAM en el recurso especificado
|
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
| Representación JSON |
|---|
{
"tableManifest": {
object ( |
| Campos | |
|---|---|
tableManifest |
El manifiesto de la tabla |
description |
Es el nombre legible de la tarea. |
overwrite |
Indica si se debe permitir reemplazar un recurso existente. |
requestId |
Es una cadena única que se usa para detectar solicitudes duplicadas. Si el mismo usuario realiza más de una solicitud con el mismo |
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Operation.
Alcances de autorización
Se necesita uno de los siguientes permisos de OAuth:
https://www.googleapis.com/auth/earthenginehttps://www.googleapis.com/auth/cloud-platform
Para obtener más información, consulta OAuth 2.0 Overview.
TableManifest
Describe cómo el servicio de EarthEngine debe componer una tabla a partir de un conjunto de archivos.
| Representación JSON |
|---|
{ "name": string, "properties": { object }, "uriPrefix": string, "sources": [ { object ( |
| Campos | |
|---|---|
name |
Es el nombre del recurso que se creará. |
properties |
Son propiedades adicionales del activo. Los nombres de las propiedades "system:time_start" y "system:time_end" dejaron de estar disponibles. En su lugar, usa los campos |
uriPrefix |
Es el prefijo opcional que se agrega a todos los |
sources[] |
Las fuentes que componen esta tabla. |
startTime |
Es la marca de tiempo asociada con el recurso, si corresponde, p.ej., la hora en la que se tomó una imagen satelital. En el caso de los recursos que corresponden a un intervalo de tiempo, como los valores promedio durante un mes o un año, esta marca de tiempo corresponde al inicio de ese intervalo. Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: |
endTime |
En el caso de los recursos que corresponden a un intervalo de tiempo, como los valores promedio durante un mes o un año, esta marca de tiempo corresponde al final de ese intervalo (exclusivo). Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: |
csvColumnDataTypeOverrides |
En su lugar, usa columnDataTypeOverrides. Es un objeto que contiene una lista de pares |
columnDataTypeOverrides |
Es un mapa del nombre de la columna al tipo que se usará para esa columna. Se inferirá el tipo de las columnas que no se especifiquen aquí, de modo que las columnas de números se conviertan en números, las columnas de WKT se conviertan en geometría, etcétera. Es un objeto que contiene una lista de pares |
memo |
Es un campo de formato libre para almacenar notas del usuario. No se usa en la transferencia. |
TableSource
Un archivo de tabla.
| Representación 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 } |
| Campos | |
|---|---|
uris[] |
Los URIs de los datos que se importarán. Actualmente, solo se admiten los URIs de Google Cloud Storage. Cada URI debe especificarse en el siguiente formato: "gs://id-bucket/id-objeto". El objeto principal debe ser el primer elemento de la lista. Los archivos secundarios se infieren de la ruta de acceso del objeto principal. Por el momento, solo se admite un URI. Si se especifica más de un URI, se muestra un error de |
charset |
Es el nombre del conjunto de caracteres predeterminado que se usará para decodificar cadenas. Si está vacío, se supone que el conjunto de caracteres es "utf-8" de forma predeterminada. |
maxErrorMeters |
Es el error máximo permitido en metros cuando se transforma la geometría entre sistemas de coordenadas. Si está vacío, el error máximo es de 1 metro de forma predeterminada. |
maxVertices |
Es la cantidad máxima de vértices. Si no es cero, la geometría se subdividirá en piezas espacialmente disjuntas que estarán por debajo de este límite. |
crs |
Es el código CRS predeterminado o la cadena WKT que especifica el sistema de referencia de coordenadas de cualquier geometría que no tenga uno especificado. Si se deja en blanco, el valor predeterminado será EPSG:4326: https://epsg.io/4326. Solo para fuentes de CSV o TFRecord. |
geodesic |
Es la estrategia predeterminada para interpretar los bordes en la geometría que no tienen uno especificado de otra manera. Si es falso, los bordes son rectos en la proyección. Si es verdadero, los bordes se curvan para seguir la ruta más corta en la superficie de la Tierra. Si está en blanco, se establece de forma predeterminada como falso si "crs" es un sistema de coordenadas proyectado. Solo para fuentes de CSV o TFRecord. |
primaryGeometryColumn |
Es la columna de geometría que se usará como geometría principal de una fila cuando haya más de una columna de geometría. Si se deja en blanco y existe más de una columna de geometría, se usa la primera columna de geometría que se encuentre. Solo para fuentes de CSV o TFRecord. |
xColumn |
Es el nombre de la columna numérica de la coordenada X para deducir la geometría del punto. Si también se especifica la columna y y ambas columnas contienen valores numéricos, se construirá una columna de geometría de punto con valores x,y en el sistema de coordenadas que se proporciona en "crs". Si se deja en blanco y "crs" no especifica un sistema de coordenadas proyectado, el valor predeterminado es "longitud". Si se deja en blanco y "crs" especifica un sistema de coordenadas proyectado, el valor predeterminado es "" y no se genera ninguna geometría de punto. Una columna de geometría de punto generada se llamará {xColumn}_{yColumn}_N, donde se agrega N para que {xColumn}_{yColumn}_N sea única si ya existe una columna llamada {xColumn}_{yColumn}. Solo para fuentes de CSV o TFRecord. |
yColumn |
Es el nombre de la columna de coordenadas Y numéricas para deducir la geometría del punto. Si también se especifica la columna x y ambas columnas contienen valores numéricos, se construirá una columna de geometría de punto con valores x,y en el sistema de coordenadas que se proporciona en "crs". Si se deja en blanco y "crs" no especifica un sistema de coordenadas proyectado, el valor predeterminado es "latitude". Si se deja en blanco y "crs" especifica un sistema de coordenadas proyectado, el valor predeterminado es "" y no se genera ninguna geometría de punto. Una columna de geometría de punto generada se llamará {xColumn}_{yColumn}_N, donde se agrega N para que {xColumn}_{yColumn}_N sea única si ya existe una columna llamada {xColumn}_{yColumn}. Solo para fuentes de CSV o TFRecord. |
dateFormat |
Es un formato con el que se analizan los campos que codifican fechas. El patrón de formato debe ser como se describe en http://joda-time.sourceforge.net/apidocs/org/joda/time/format/DateTimeFormat.html. Si se deja en blanco, las fechas se importarán como cadenas. Solo para fuentes de CSV o TFRecord. |
csvDelimiter |
Cuando se transfieren archivos CSV, se usa un solo carácter como delimitador entre los valores de las columnas en una fila. Si se deja en blanco, el valor predeterminado es “,”. Solo para fuentes CSV. |
csvQualifier |
Cuando se transfieren archivos CSV, es un carácter que rodea los valores de las columnas (también conocido como "carácter de comillas"). Si se deja en blanco, el valor predeterminado es "". Solo para fuentes CSV. Si un valor de columna no está entre calificadores, se recortan los espacios en blanco iniciales y finales. Por ejemplo: …, prueba,… <== este valor no se califica y se convierte en el valor de cadena: "test" <== se quitan los espacios en blanco where: ...," test",... <== Este valor se califica con comillas y se convierte en el valor de la cadena: " test" <== Se mantienen los espacios en blanco. |