Method: projects.table.import

Mengimpor tabel.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
project

string

Project ID atau nomor project project Google Cloud Platform yang harus diperlakukan sebagai konsumen layanan untuk permintaan ini. Format adalah projects/{project-id}.

Otorisasi memerlukan izin IAM berikut pada resource project yang ditentukan:

  • earthengine.assets.create

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON
{
  "tableManifest": {
    object (TableManifest)
  },
  "description": string,
  "overwrite": boolean,
  "requestId": string
}
Kolom
tableManifest

object (TableManifest)

Manifes tabel.

description

string

Nama tugas yang dapat dibaca manusia.

overwrite

boolean

Apakah akan mengizinkan penimpaan aset yang ada.

requestId

string

String unik yang digunakan untuk mendeteksi permintaan yang diduplikasi. Jika lebih dari satu permintaan dibuat oleh pengguna yang sama dengan requestId yang sama dan tidak kosong, hanya satu dari permintaan tersebut yang dapat berhasil memulai operasi yang berjalan lama. requestId dapat berisi karakter a..z, A..Z, 0-9, atau '-'. requestId dapat berisi maksimal 60 karakter.

Isi respons

Jika berhasil, isi respons memuat instance Operation.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

TableManifest

Menjelaskan cara layanan EarthEngine menyusun tabel dari kumpulan file.

Representasi JSON
{
  "name": string,
  "properties": {
    object
  },
  "uriPrefix": string,
  "sources": [
    {
      object (TableSource)
    }
  ],
  "startTime": string,
  "endTime": string,
  "csvColumnDataTypeOverrides": {
    string: enum (CsvColumnDataType),
    ...
  },
  "columnDataTypeOverrides": {
    string: enum (ColumnDataType),
    ...
  },
  "memo": string
}
Kolom
name

string

Nama aset yang akan dibuat. name memiliki format "projects/*/assets/**" (misalnya, "projects/earthengine-legacy/assets/users//"). Semua aset milik pengguna berada dalam project "earthengine-legacy" (misalnya, "projects/earthengine-legacy/assets/users/foo/bar"). Semua aset lainnya berada dalam project "earthengine-public" (misalnya, "projects/earthengine-public/assets/LANDSAT").

properties

object (Struct format)

Properti tambahan aset. Nama properti "system:time_start" dan "system:time_end" tidak digunakan lagi. Sebagai gantinya, gunakan kolom startTime dan endTime.

uriPrefix

string

Awalan opsional yang ditambahkan ke semua uri yang ditentukan dalam manifes ini.

sources[]

object (TableSource)

Sumber yang membentuk tabel ini.

startTime

string (Timestamp format)

Stempel waktu yang terkait dengan aset, jika ada, misalnya waktu pengambilan gambar satelit. Untuk aset yang sesuai dengan interval waktu, seperti nilai rata-rata selama sebulan atau setahun, stempel waktu ini sesuai dengan awal interval tersebut.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

Untuk aset yang sesuai dengan interval waktu, seperti nilai rata-rata selama sebulan atau setahun, stempel waktu ini sesuai dengan akhir interval tersebut (eksklusif).

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

csvColumnDataTypeOverrides
(deprecated)

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

Sebagai gantinya, gunakan columnDataTypeOverrides.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

columnDataTypeOverrides

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

Peta dari nama kolom ke jenis yang akan digunakan untuk kolom tersebut. Kolom yang tidak ditentukan di sini akan memiliki jenis yang disimpulkan, sehingga kolom angka menjadi angka, kolom WKT menjadi geometri, dll.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

memo

string

Kolom freeform untuk menyimpan catatan pengguna. Tidak digunakan dalam proses transfer.

TableSource

File tabel.

Representasi 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
}
Kolom
uris[]

string

URI data yang akan diimpor. Saat ini, hanya URI Google Cloud Storage yang didukung. Setiap URI harus ditentukan dalam format berikut: "gs://bucket-id/object-id". Objek utama harus berupa elemen pertama dalam daftar, file sidecar disimpulkan dari jalur file objek utama. Saat ini hanya satu URI yang didukung. Jika lebih dari satu URI ditentukan, error INALID_ARGUMENT akan ditampilkan.

charset

string

Nama set karakter default yang akan digunakan untuk mendekode string. Jika kosong, charset "utf-8" diasumsikan secara default.

maxErrorMeters

number

Error maksimum yang diizinkan dalam meter saat mengubah geometri di antara sistem koordinat. Jika kosong, error maksimumnya adalah 1 meter secara default.

maxVertices

integer

Jumlah maksimum verteks. Jika bukan nol, geometri akan dibagi lagi menjadi beberapa bagian yang terpisah secara spasial yang masing-masing berada di bawah batas ini.

crs

string

Kode CRS default atau string WKT yang menentukan sistem referensi koordinat dari geometri apa pun yang tidak ditentukan. Jika dibiarkan kosong, defaultnya adalah EPSG:4326: https://epsg.io/4326. Hanya untuk sumber CSV/TFRecord.

geodesic

boolean

Strategi default untuk menafsirkan tepi dalam geometri yang tidak memiliki strategi yang ditentukan. Jika salah, tepi akan lurus dalam proyeksi. Jika true, tepi akan melengkung untuk mengikuti jalur terpendek di permukaan Bumi. Jika kosong, defaultnya adalah salah jika 'crs' adalah sistem koordinat yang diproyeksikan. Hanya untuk sumber CSV/TFRecord.

primaryGeometryColumn

string

Kolom geometri yang akan digunakan sebagai geometri utama baris jika ada lebih dari satu kolom geometri.

Jika dibiarkan kosong dan ada lebih dari satu kolom geometri, kolom geometri pertama yang ditemukan akan digunakan. Hanya untuk sumber CSV/TFRecord.

xColumn

string

Nama kolom koordinat x numerik untuk menyimpulkan geometri titik. Jika yColumn juga ditentukan, dan kedua kolom berisi nilai angka, kolom geometri titik akan dibuat dengan nilai x,y dalam sistem koordinat yang diberikan di 'crs'. Jika dibiarkan kosong dan 'crs' tidak menentukan sistem koordinat yang diproyeksikan, setelan defaultnya adalah "bujur". Jika dibiarkan kosong dan 'crs' tidak menentukan sistem koordinat yang diproyeksikan, nilai defaultnya adalah "" dan tidak ada geometri titik yang dihasilkan.

Kolom geometri titik yang dihasilkan akan diberi nama {xColumn}_{yColumn}_N dengan N ditambahkan sehingga {xColumn}_{yColumn}_N unik jika kolom bernama {xColumn}_{yColumn} sudah ada. Hanya untuk sumber CSV/TFRecord.

yColumn

string

Nama kolom koordinat y numerik untuk menyimpulkan geometri titik. Jika xColumn juga ditentukan, dan kedua kolom berisi nilai angka, kolom geometri titik akan dibuat dengan nilai x,y dalam sistem koordinat yang diberikan di 'crs'. Jika dibiarkan kosong dan 'crs' tidak menentukan sistem koordinat yang diproyeksikan, setelan defaultnya adalah "latitude". Jika dibiarkan kosong dan 'crs' tidak menentukan sistem koordinat yang diproyeksikan, nilai defaultnya adalah "" dan tidak ada geometri titik yang dihasilkan.

Kolom geometri titik yang dihasilkan akan diberi nama {xColumn}_{yColumn}_N dengan N ditambahkan sehingga {xColumn}_{yColumn}_N unik jika kolom bernama {xColumn}_{yColumn} sudah ada. Hanya untuk sumber CSV/TFRecord.

dateFormat

string

Format yang digunakan untuk mengurai kolom yang mengenkode tanggal. Pola format harus seperti yang dijelaskan di http://joda-time.sourceforge.net/apidocs/org/joda/time/format/DateTimeFormat.html. Jika dibiarkan kosong, tanggal akan diimpor sebagai string. Hanya untuk sumber CSV/TFRecord.

csvDelimiter

string

Saat menyerap file CSV, satu karakter digunakan sebagai pemisah antara nilai kolom dalam baris. Jika dibiarkan kosong, setelan defaultnya adalah ','. Khusus untuk sumber CSV.

csvQualifier

string

Saat menyerap file CSV, karakter yang mengapit nilai kolom (alias "karakter tanda petik"). Jika dibiarkan kosong, setelan defaultnya adalah '"'. Khusus untuk sumber CSV.

Jika nilai kolom tidak diapit oleh penentu, spasi kosong di awal dan di akhir akan dipangkas. Misalnya: ..., pengujian,... <== nilai ini tidak memenuhi syarat menjadi nilai string: "test" <== spasi kosong dihapus

where: ...," test",... <== nilai ini DIKUTIFKAN dengan tanda kutip menjadi nilai string: " test" <== spasi kosong tetap ada.