お知らせ:
2025 年 4 月 15 日より前に Earth Engine の使用を登録したすべての非商用プロジェクトは、Earth Engine へのアクセスを維持するために
非商用目的での利用資格を確認する必要があります。
Method: projects.locations.tables.create
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
「表」データをレンダリングするために使用できる ID を作成します。
これは GetTableFeatures と組み合わせて使用します。tables.create を呼び出すと、式といくつかの出力オプションが提供されます。tables.create の結果は、その式を評価してオプションを適用した結果のテーブルを表す ID です。その後、GetTableFeatures を呼び出して、結果テーブル全体のテーブルデータを取得できます。ID は一定期間（数時間）有効です。
このエンドポイントのペアの最も一般的なユースケースは、tables.create への POST を介して複雑な式を指定し、GetTableFeatures への GET を介して計算されたテーブルを取得することです。この 2 段階のプロセスにより、ComputeFeatures よりも多くの状況で使用できます。特に、ComputeFeatures の結果では、すべての特徴を取得するためにページ分割が必要です。また、返されるのは個々の Feature のみです。- ComputeFeatures は、適切なスコープの OAuth トークンを使用して、承認されたユーザーのみが呼び出すことができます。tables.create には同じ制限がありますが、GetTableData は API キーを含む URL で呼び出せるため、呼び出し元の URL をより広範囲に使用できます。
HTTP リクエスト
POST https://earthengine.googleapis.com/v1/{parent=projects/*/locations/*}/tables
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
| パラメータ |
parent |
string
必須。テーブルが作成されるロケーションの親（例: 「projects/*」）。
|
クエリ パラメータ
| パラメータ |
workloadTag |
string
この計算をトラッキングするためにユーザーが指定したタグ。
|
リクエストの本文
リクエストの本文には Table のインスタンスが含まれます。
レスポンスの本文
成功した場合、レスポンスの本文には、新しく作成された Table のインスタンスが含まれます。
認可スコープ
以下のいずれかの OAuth スコープが必要です。
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
詳細については、OAuth 2.0 Overview をご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[[["\u003cp\u003eThe \u003ccode\u003etables.create\u003c/code\u003e endpoint generates a unique ID representing a table derived from a given expression and output options.\u003c/p\u003e\n"],["\u003cp\u003eThis ID can then be used with \u003ccode\u003eGetTableFeatures\u003c/code\u003e to retrieve the entire table data, facilitating complex data fetching scenarios.\u003c/p\u003e\n"],["\u003cp\u003eUsing \u003ccode\u003etables.create\u003c/code\u003e and \u003ccode\u003eGetTableFeatures\u003c/code\u003e together offers advantages over \u003ccode\u003eComputeFeatures\u003c/code\u003e, such as bypassing pagination and broader sharing capabilities with API keys.\u003c/p\u003e\n"],["\u003cp\u003eThis two-step process enables complex expression evaluation via a POST request to \u003ccode\u003etables.create\u003c/code\u003e, followed by data retrieval using a GET request to \u003ccode\u003eGetTableFeatures\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required for \u003ccode\u003etables.create\u003c/code\u003e but \u003ccode\u003eGetTableFeatures\u003c/code\u003e can be accessed with an API key for wider usage.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.tables.create\n\nCreates an ID that can be used to render \"table\" data.\n\nThis is used in conjunction with `GetTableFeatures`. A call to `tables.create` provides an expression and some output options. The result of `tables.create` is an ID that represents a table that is the result of evaluating that expression and applying those options. Subsequently, calls to `GetTableFeatures` can be made to get the table data for the entire resulting table. The ID will be valid for a moderate period (a few hours).\n\nThe most common use case for this pair of endpoints is to provide a complex expression via a POST to `tables.create`, and then fetch the computed table via a GET to `GetTableFeatures`. This two-part process allows for use in more situations than `ComputeFeatures`. In particular: - the result of `ComputeFeatures` requires pagination to get the entirety of the features. Additionally only individual `Feature`s are returned. - `ComputeFeatures` can only be called by an authorized user, using a properly-scoped OAuth token. `tables.create` has the same restriction, but `GetTableData` can be invoked with a URL containing an API key, so URLs invoking it can be used more broadly.\n\n### HTTP request\n\n`POST https://earthengine.googleapis.com/v1/{parent=projects/*/locations/*}/tables`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The parent of the location where the table will be created (e.g., \"projects/\\*\"). |\n\n### Query parameters\n\n| Parameters ||\n|---------------|-------------------------------------------------------|\n| `workloadTag` | `string` User supplied tag to track this computation. |\n\n### Request body\n\nThe request body contains an instance of [Table](/earth-engine/reference/rest/v1/projects.locations.tables#Table).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Table](/earth-engine/reference/rest/v1/projects.locations.tables#Table).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/earthengine`\n- `\n https://www.googleapis.com/auth/earthengine.readonly`\n- `\n https://www.googleapis.com/auth/cloud-platform`\n- `\n https://www.googleapis.com/auth/cloud-platform.read-only`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
