공지사항:
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을 통해 계산된 표를 가져오는 것입니다. 이 두 부분으로 구성된 프로세스를 사용하면 ComputeFeatures보다 더 많은 상황에서 사용할 수 있습니다. 특히 ComputeFeatures의 결과를 전체적으로 가져오려면 페이지로 나누기가 필요합니다. 또한 개별 Feature만 반환됩니다. - ComputeFeatures는 적절한 범위의 OAuth 토큰을 사용하는 승인된 사용자만 호출할 수 있습니다. tables.create에도 동일한 제한사항이 적용되지만 GetTableData는 API 키가 포함된 URL로 호출할 수 있으므로 이를 호출하는 URL을 더 광범위하게 사용할 수 있습니다.
HTTP 요청
POST https://earthengine.googleapis.com/v1/{parent=projects/*/locations/*}/tables
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
| 매개변수 |
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를 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 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)."]]
