Method: projects.table.import

Bir tabloyu içe aktarır.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
project

string

Bu istek için hizmet tüketicisi olarak değerlendirilmesi gereken Google Cloud Platform projesinin proje kimliği veya proje numarası. Biçim projects/{project-id}'tür.

Yetkilendirme, belirtilen kaynak project için aşağıdaki IAM iznini gerektirir:

  • earthengine.assets.create

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "tableManifest": {
    object (TableManifest)
  },
  "description": string,
  "overwrite": boolean,
  "requestId": string
}
Alanlar
tableManifest

object (TableManifest)

Tablo manifesti.

description

string

Görevin, kullanıcılar tarafından okunabilen adı.

overwrite

boolean

Mevcut bir öğenin üzerine yazılmasına izin verilip verilmeyeceği.

requestId

string

Yinelenen istekleri tespit etmek için kullanılan benzersiz bir dize. Aynı kullanıcı tarafından aynı boş olmayan requestId ile birden fazla istek gönderilirse bu isteklerden yalnızca biri uzun süren bir işlemi başarıyla başlatabilir. requestId, a..z, A..Z, 0-9 veya "-" karakterlerini içerebilir. requestId en fazla 60 karakter uzunluğunda olabilir.

Yanıt gövdesi

Başarılıysa yanıt metni, Operation öğesinin bir örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

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

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.

TableManifest

EarthEngine hizmetinin bir dosya grubundan nasıl tablo oluşturması gerektiğini açıklar.

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

string

Oluşturulacak öğenin adı. name, "projects/*/assets/**" biçimindedir (ör. "projects/earthengine-legacy/assets/users//"). Kullanıcıya ait tüm öğeler "earthengine-legacy" projesi altındadır (ör. "projects/earthengine-legacy/assets/users/foo/bar"). Diğer tüm öğeler "earthengine-public" projesi altındadır (ör. "projects/earthengine-public/assets/LANDSAT").

properties

object (Struct format)

Öğenin ek özellikleri. "system:time_start" ve "system:time_end" özellik adlarının desteği sonlandırıldı. Bunun yerine startTime ve endTime alanlarını kullanın.

uriPrefix

string

Bu manifest'te tanımlanan tüm uri öğelerinin önüne eklenen isteğe bağlı ön ek.

sources[]

object (TableSource)

Bu tabloyu oluşturan kaynaklar.

startTime

string (Timestamp format)

Öğeyle ilişkili zaman damgası (varsa) (ör. bir uydu görüntüsünün çekildiği zaman). Bir ay veya yıl boyunca ortalama değerler gibi bir zaman aralığına karşılık gelen öğeler için bu zaman damgası, söz konusu aralığın başlangıcına karşılık gelir.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

Bir ay veya yıl boyunca ortalama değerler gibi bir zaman aralığına karşılık gelen öğeler için bu zaman damgası, söz konusu aralığın sonuna (hariç) karşılık gelir.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

csvColumnDataTypeOverrides
(deprecated)

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

Bunun yerine columnDataTypeOverrides özelliğini kullanın.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

columnDataTypeOverrides

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

Sütun adından, ilgili sütun için kullanılacak türe bir eşleme. Burada belirtilmeyen sütunların türü tahmin edilir. Örneğin, sayı sütunları sayı, WKT sütunları geometri olur.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

memo

string

Kullanıcı notlarını depolamak için serbest biçimli alan. Beslemede kullanılmaz.

TableSource

Tablo dosyası.

JSON gösterimi
{
  "uris": [
    string
  ],
  "charset": string,
  "maxErrorMeters": number,
  "maxVertices": integer,
  "crs": string,
  "geodesic": boolean,
  "primaryGeometryColumn": string,
  "xColumn": string,
  "yColumn": string,
  "dateFormat": string,
  "csvDelimiter": string,
  "csvQualifier": string
}
Alanlar
uris[]

string

İçe aktarılacak verilerin URI'leri. Şu anda yalnızca Google Cloud Storage URI'leri desteklenmektedir. Her URI şu biçimde belirtilmelidir: "gs://bucket-id/object-id". Birincil nesne, listenin ilk öğesi olmalıdır. Yan araç dosyaları, birincil nesnenin dosya yolundan anlaşılır. Şu anda yalnızca bir URI desteklenmektedir. Birden fazla URI belirtilirse INALID_ARGUMENT hatası döndürülür.

charset

string

Dizelerin kodunu çözmek için kullanılacak varsayılan karakter kodunun adı. Boşsa varsayılan olarak "utf-8" karakter kümesi kullanılır.

maxErrorMeters

number

Koordinat sistemleri arasında geometri dönüştürülürken izin verilen maksimum hata (metre cinsinden). Boş bırakılırsa varsayılan maksimum hata 1 metredir.

maxVertices

integer

Maksimum köşe sayısı. Sıfır değilse geometri, her biri bu sınırın altında olan, uzamsal olarak birbirinden ayrılmış parçalara bölünür.

crs

string

Belirtilmemiş herhangi bir geometrinin koordinat referans sistemini belirten varsayılan CRS kodu veya WKT dizesi. Boş bırakılırsa varsayılan olarak EPSG:4326 kullanılır: https://epsg.io/4326. Yalnızca CSV/TFRecord kaynakları için.

geodesic

boolean

Geometrideki başka bir şekilde belirtilmemiş kenarları yorumlamak için kullanılan varsayılan strateji. Yanlış ise kenarların projeksiyonda düz olması gerekir. Doğru ise kenarlar, Dünya'nın yüzeyindeki en kısa yolu izleyecek şekilde kavisli olur. Boş olduğunda, "crs" bir projeksiyon koordinat sistemiyse varsayılan olarak yanlış olur. Yalnızca CSV/TFRecord kaynakları için.

primaryGeometryColumn

string

Birden fazla geometri sütunu olduğunda satırın birincil geometrisi olarak kullanılacak geometri sütunu.

Boş bırakılırsa ve birden fazla geometri sütunu varsa karşılaşılan ilk geometri sütunu kullanılır. Yalnızca CSV/TFRecord kaynakları için.

xColumn

string

Nokta geometrisini çıkarmak için kullanılan sayısal x koordinatı sütununun adı. yColumn da belirtilmişse ve her iki sütun da sayı değerleri içeriyorsa "crs" içinde verilen koordinat sisteminde x,y değerleriyle bir nokta geometrisi sütunu oluşturulur. Boş bırakılırsa ve "crs" bir projeksiyon koordinat sistemi belirtmezse varsayılan olarak "boylam" olur. Boş bırakılırsa ve "crs" bir projeksiyon koordinat sistemi belirtirse varsayılan değeri "" olur ve nokta geometrisi oluşturulmaz.

Oluşturulan bir nokta geometrisi sütunu, {xColumn}_{yColumn} adlı bir sütun zaten mevcutsa {xColumn}_{yColumn}_N adlı sütun olacak şekilde N eklenerek {xColumn}_{yColumn}_N olarak adlandırılır. Yalnızca CSV/TFRecord kaynakları için.

yColumn

string

Nokta geometrisini çıkarmak için kullanılan sayısal y koordinatı sütununun adı. xColumn da belirtilmişse ve her iki sütun da sayı değerleri içeriyorsa "crs" içinde verilen koordinat sisteminde x,y değerleriyle bir nokta geometrisi sütunu oluşturulur. Boş bırakılırsa ve "crs" bir projeksiyon koordinat sistemi belirtmezse varsayılan olarak "enlem" olur. Boş bırakılırsa ve "crs" bir projeksiyon koordinat sistemi belirtirse varsayılan değeri "" olur ve nokta geometrisi oluşturulmaz.

Oluşturulan bir nokta geometrisi sütunu, {xColumn}_{yColumn} adlı bir sütun zaten mevcutsa {xColumn}_{yColumn}_N adlı sütun olacak şekilde N eklenerek {xColumn}_{yColumn}_N olarak adlandırılır. Yalnızca CSV/TFRecord kaynakları için.

dateFormat

string

Tarihleri kodlayan alanları ayrıştırmak için kullanılan bir biçim. Biçim kalıbı, http://joda-time.sourceforge.net/apidocs/org/joda/time/format/DateTimeFormat.html adresinde açıklandığı şekilde olmalıdır. Boş bırakılırsa tarihler dize olarak içe aktarılır. Yalnızca CSV/TFRecord kaynakları için.

csvDelimiter

string

CSV dosyaları beslenirken bir satırdaki sütun değerleri arasında ayırıcı olarak kullanılan tek bir karakter. Boş bırakılırsa varsayılan olarak "," olur. Yalnızca CSV kaynakları için.

csvQualifier

string

CSV dosyaları beslenirken sütun değerlerini çevreleyen karakter ("tırnak karakteri" olarak da bilinir). Boş bırakılırsa varsayılan olarak "" olur. Yalnızca CSV kaynakları için.

Bir sütun değeri, niteliklerle çevrili değilse başındaki ve sondaki boşluklar kırpılır. Örneğin: ..., test,... <== bu değer uygun değilse dize değeri olur: "test" <== boşluk kaldırılır

where: ...," test",... <== Bu değer tırnak içine alınarak dize değeri olur: " test" <== Boşluklar korunur.