Method: projects.locations.tables.create
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tạo một mã nhận dạng có thể dùng để hiển thị dữ liệu "bảng".
Phương thức này được dùng cùng với GetTableFeatures. Lệnh gọi đến tables.create cung cấp một biểu thức và một số tuỳ chọn đầu ra. Kết quả của tables.create là một mã nhận dạng đại diện cho một bảng là kết quả của việc đánh giá biểu thức đó và áp dụng các tuỳ chọn đó. Sau đó, bạn có thể thực hiện lệnh gọi đến GetTableFeatures để lấy dữ liệu bảng cho toàn bộ bảng kết quả. Giấy tờ tuỳ thân này sẽ có hiệu lực trong một khoảng thời gian vừa phải (vài giờ).
Trường hợp sử dụng phổ biến nhất cho cặp điểm cuối này là cung cấp một biểu thức phức tạp thông qua phương thức POST đến tables.create, sau đó tìm nạp bảng được tính toán thông qua phương thức GET đến GetTableFeatures. Quy trình hai phần này cho phép sử dụng trong nhiều trường hợp hơn so với ComputeFeatures. Cụ thể: – kết quả của ComputeFeatures yêu cầu phân trang để có được toàn bộ các tính năng. Ngoài ra, chỉ các Feature riêng lẻ mới được trả về. – Chỉ người dùng được uỷ quyền mới có thể gọi ComputeFeatures bằng mã thông báo OAuth có phạm vi thích hợp. tables.create có cùng quy định hạn chế, nhưng GetTableData có thể được gọi bằng một URL chứa khoá API, vì vậy, các URL gọi API này có thể được sử dụng rộng rãi hơn.
Yêu cầu HTTP
POST https://earthengine.googleapis.com/v1/{parent=projects/*/locations/*}/tables
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Thông số |
parent |
string
Bắt buộc. Phần tử mẹ của vị trí sẽ tạo bảng (ví dụ: "projects/*").
|
Tham số truy vấn
| Thông số |
workloadTag |
string
Thẻ do người dùng cung cấp để theo dõi phép tính này.
|
Nội dung yêu cầu
Nội dung yêu cầu chứa một bản sao của Table.
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một thực thể Table mới tạo.
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau:
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
Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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)."]]
