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 |
Identyfikator lub numer projektu Google Cloud Platform, który powinien być traktowany jako konsument usługi w przypadku tej prośby. Format to Autoryzacja wymaga tych uprawnień IAM w przypadku określonego zasobu:
|
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"tableManifest": {
object ( |
Pola | |
---|---|
tableManifest |
Plik manifestu tabeli. |
description |
Zrozumiała dla człowieka nazwa zadania. |
overwrite |
Określa, czy można zastąpić istniejący zasób. |
requestId |
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ą |
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 ( |
Pola | |
---|---|
name |
Nazwa zasobu do utworzenia. |
properties |
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 |
uriPrefix |
Opcjonalny prefiks dodawany do wszystkich |
sources[] |
Źródła, które składają się na tę tabelę. |
startTime |
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: |
endTime |
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: |
csvColumnDataTypeOverrides |
Zamiast tego użyj kolumny DataTypeOverrides. Obiekt zawierający listę par |
columnDataTypeOverrides |
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 |
memo |
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[] |
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 |
charset |
Nazwa domyślnego zestawu znaków do dekodowania ciągu znaków. Jeśli jest pusty, domyślnie przyjmuje się kodowanie „utf-8”. |
maxErrorMeters |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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ą |