Method: projects.table.import

Importuje tabelę.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
project

string

Identyfikator lub numer projektu Google Cloud Platform, który powinien być traktowany jako konsument usługi w przypadku tej prośby. Format to projects/{project-id}.

Autoryzacja wymaga tych uprawnień IAM w przypadku określonego zasobu: project

  • earthengine.assets.create

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

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

object (TableManifest)

Plik manifestu tabeli.

description

string

Zrozumiała dla człowieka nazwa zadania.

overwrite

boolean

Określa, czy można zastąpić istniejący zasób.

requestId

string

Unikalny ciąg znaków służący do wykrywania zduplikowanych żądań. Jeśli ten sam użytkownik wyśle więcej niż 1 żądanie z tą samą niepustą wartością requestId, tylko jedno z tych żądań może rozpocząć długotrwałą operację. requestId może zawierać znaki a–z, A–Z, 0–9 lub „–”. requestId może mieć maksymalnie 60 znaków.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Operation.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.

TableManifest

Opisuje, jak usługa EarthEngine powinna tworzyć tabelę z zestawu plików.

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

string

Nazwa zasobu do utworzenia. name ma format „projects/*/assets/**” (np. „projects/earthengine-legacy/assets/users//”). Wszystkie zasoby należące do użytkowników znajdują się w projekcie „earthengine-legacy” (np. „projects/earthengine-legacy/assets/users/foo/bar”). Wszystkie pozostałe zasoby znajdują się w projekcie „earthengine-public” (np. „projects/earthengine-public/assets/LANDSAT”).

properties

object (Struct format)

Dodatkowe właściwości komponentu. Nazwy właściwości „system:time_start” i „system:time_end” zostały wycofane. Zamiast niej użyj pól startTimeendTime.

uriPrefix

string

Opcjonalny prefiks dodawany do wszystkich uri zdefiniowanych w tym pliku manifestu.

sources[]

object (TableSource)

Źródła, które składają się na tę tabelę.

startTime

string (Timestamp format)

Sygnatura czasowa powiązana z zasobem (jeśli występuje), np. czas wykonania zdjęcia satelitarnego. W przypadku zasobów odpowiadających intervalom czasowym, np. średnich wartości w ciągu miesiąca lub roku, ten znacznik czasu odpowiada początkowi tego przedziału.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

W przypadku zasobów odpowiadających intervalom czasowym, np. średnich wartości z miesiąca lub roku, ta sygnatura czasowa odpowiada końcowi tego przedziału (nie licząc go).

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

csvColumnDataTypeOverrides
(deprecated)

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

Zamiast tego użyj kolumny DataTypeOverrides.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

columnDataTypeOverrides

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

Mapowanie nazwy kolumny na typ, którego należy użyć w tej kolumnie. Typy kolumn, które nie zostały tutaj określone, zostaną wywnioskowane. Kolumny liczbowe staną się liczbami, kolumny WKT staną się geometrią itd.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

memo

string

Pole do dowolnego formatowania na potrzeby przechowywania notatek użytkownika. Nieużywany podczas przetwarzania.

TableSource

Plik tabeli.

Zapis 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
}
Pola
uris[]

string

Identyfikatory URI danych do zaimportowania. Obecnie obsługiwane są tylko identyfikatory URI Google Cloud Storage. Każdy identyfikator URI musi mieć format „gs://identyfikator_zasobnika/identyfikator_obiektu”. Główny obiekt powinien być pierwszym elementem listy, a pliki pomocnicze są określane na podstawie ścieżki do pliku głównego obiektu. Obecnie obsługiwany jest tylko 1 identyfikator URI. Jeśli podano więcej niż 1 identyfikator URI, zwracany jest błąd INALID_ARGUMENT.

charset

string

Nazwa domyślnego zestawu znaków do dekodowania ciągu znaków. Jeśli jest pusty, domyślnie przyjmuje się kodowanie „utf-8”.

maxErrorMeters

number

Maksymalny dopuszczalny błąd w metrach podczas przekształcania geometrii między układami współrzędnych. Jeśli to pole jest puste, domyślna maksymalna wartość błędu to 1 metr.

maxVertices

integer

Maksymalna liczba wierzchołków. Jeśli nie zero, geometria zostanie podzielona na przestrzennie rozdzielone części, z których każda mieści się w tym limicie.

crs

string

Domyślny kod CRS lub ciąg WKT określający układ współrzędnych odniesienia dowolnej geometrii, która nie ma określonego układu. Jeśli pozostawisz to pole puste, domyślnie zostanie użyty EPSG:4326: https://epsg.io/4326. Tylko w przypadku źródeł CSV/TFRecord.

geodesic

boolean

Domyślna strategia interpretowania krawędzi w geometrii, która nie ma określonej innej strategii. Jeśli jest ustawiona na wartość false (fałsz), krawędzie są proste w projekcji. Jeśli ma wartość Prawda, krawędzie są zaokrąglone, aby prowadzić najkrótszą drogą po powierzchni Ziemi. Jeśli to pole jest puste, domyślnie ustawiana jest wartość false, jeśli „crs” to rzutowany układ współrzędnych. Tylko w przypadku źródeł CSV/TFRecord.

primaryGeometryColumn

string

Kolumna geometry, która ma być używana jako główna geometria wiersza, gdy istnieje więcej niż 1 kolumna geometry.

Jeśli pole to jest puste i istnieje więcej niż 1 kolumna geometrii, zostanie użyta pierwsza napotkana kolumna geometrii. Tylko w przypadku źródeł CSV/TFRecord.

xColumn

string

Nazwa kolumny liczbowej współrzędnej X służącej do określania geometrii punktu. Jeśli kolumna yColumn jest również określona, a obie kolumny zawierają wartości liczbowe, kolumna geometrycznych współrzędnych punktu zostanie utworzona z wartościami x,y w układzie współrzędnych podanym w parametrze „crs”. Jeśli pole pozostanie puste, a opcja „crs” nie określa rzutowanego układu współrzędnych, domyślnie zostanie użyta opcja „longitude” (szerokość geograficzna). Jeśli pole „crs” pozostanie puste, a system CRS nie będzie określał rzutowanego układu współrzędnych, domyślnie zostanie użyte „"" i nie zostanie wygenerowana geometria punktów.

Wygenerowana kolumna geometrii punktu będzie mieć nazwę {xColumn}_{yColumn}_N, gdzie N jest dołączane w taki sposób, aby ciąg {xColumn}_{yColumn}_N był unikalny, jeśli kolumna o nazwie {xColumn}_{yColumn} już istnieje. Tylko w przypadku źródeł CSV/TFRecord.

yColumn

string

Nazwa kolumny liczbowej współrzędnej Y służącej do określania geometrii punktu. Jeśli kolumna xColumn jest również określona, a obie kolumny zawierają wartości liczbowe, kolumna geometrycznych współrzędnych punktu zostanie utworzona z wartościami x,y w układzie współrzędnych podanym w parametrze „crs”. Jeśli pole pozostanie puste, a opcja „crs” nie określa rzutowanego układu współrzędnych, domyślnie zostanie wybrana opcja „latitude” (szerokość geograficzna). Jeśli pole „crs” pozostanie puste, a system CRS nie będzie określał rzutowanego układu współrzędnych, domyślnie zostanie użyte „"" i nie zostanie wygenerowana geometria punktów.

Wygenerowana kolumna geometrii punktu będzie mieć nazwę {xColumn}_{yColumn}_N, gdzie N jest dołączane w taki sposób, aby ciąg {xColumn}_{yColumn}_N był unikalny, jeśli kolumna o nazwie {xColumn}_{yColumn} już istnieje. Tylko w przypadku źródeł CSV/TFRecord.

dateFormat

string

Format, w którym można analizować pola kodujące daty. Wzorzec formatu musi być zgodny z opisem na stronie http://joda-time.sourceforge.net/apidocs/org/joda/time/format/DateTimeFormat.html. Jeśli pozostawisz to pole puste, daty zostaną zaimportowane jako ciągi znaków. Tylko w przypadku źródeł CSV/TFRecord.

csvDelimiter

string

Podczas przetwarzania plików CSV pojedynczy znak używany jako ogranicznik między wartościami kolumn w wierszu. Jeśli pozostawisz to pole puste, domyślnie zostanie ustawiona wartość „,”. Dotyczy tylko źródeł CSV.

csvQualifier

string

Podczas przetwarzania plików CSV znak otaczający wartości kolumn (zwanego też „znakiem cudzysłowu”). Jeśli pozostawisz to pole puste, domyślnie zostanie ustawiona wartość „"”. Dotyczy tylko źródeł CSV.

Jeśli wartość kolumny nie jest ujęta w kwalifikatory, spacja na początku i na końcu jest usuwana. Na przykład: ..., test,... <== ta wartość nie jest kwalifikowana, staje się wartością ciągu znaków: "test" <== spacje są usuwane

gdzie: ...," test",... <== ta wartość jest ujęta w cudzysłowie i staje się ciągiem znaków: " test" <== spacje pozostają