Method: projects.tables.create

Erstellt eine ID, mit der Tabellendaten gerendert werden können.

Dies wird in Verbindung mit tables.getFeatures verwendet. Ein Aufruf von tables.create liefert einen Ausdruck und einige Ausgabeoptionen. Das Ergebnis von tables.create ist eine ID, die eine Tabelle darstellt, die durch die Auswertung dieses Ausdrucks und das Anwenden dieser Optionen entstanden ist. Anschließend können Aufrufe von tables.getFeatures erfolgen, um die Tabellendaten für die gesamte resultierende Tabelle abzurufen. Die ID ist für einen begrenzten Zeitraum (einige Stunden) gültig.

Der häufigste Anwendungsfall für dieses Endpunktpaar besteht darin, einen komplexen Ausdruck über eine POST-Anfrage an tables.create zu senden und dann die berechnete Tabelle über eine GET-Anfrage an tables.getFeatures abzurufen. Dieser zweiteilige Prozess kann in mehr Situationen als ComputeFeatures verwendet werden. Insbesondere: Für das Ergebnis von ComputeFeatures ist eine Paginierung erforderlich, um alle Funktionen nutzen zu können. Außerdem werden nur einzelne Feature zurückgegeben. – ComputeFeatures kann nur von einem autorisierten Nutzer mit einem OAuth-Token mit korrektem Gültigkeitsbereich aufgerufen werden. tables.create unterliegt derselben Einschränkung, GetTableData kann jedoch mit einer URL aufgerufen werden, die einen API-Schlüssel enthält. Daher können URLs, die GetTableData aufrufen, breiter verwendet werden.

HTTP-Anfrage

POST https://earthengine.googleapis.com/v1/{parent=projects/*}/tables

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Das übergeordnete Element des Speicherorts, an dem die Tabelle erstellt wird (z.B. „projects/*“).

Abfrageparameter

Parameter
workloadTag

string

Vom Nutzer bereitgestelltes Tag zum Erfassen dieser Berechnung.

Anfragetext

Der Anfragetext enthält eine Instanz von Table.

Antworttext

Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Table.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.