Method: projects.locations.tables.create
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
สร้างรหัสที่ใช้ในการแสดงผลข้อมูล "ตาราง"
ใช้ร่วมกับ GetTableFeatures การเรียกใช้ tables.create จะแสดงนิพจน์และตัวเลือกเอาต์พุตบางอย่าง ผลลัพธ์ของ tables.create คือรหัสที่แสดงตารางซึ่งเป็นผลลัพธ์จากการประเมินนิพจน์นั้นและใช้ตัวเลือกเหล่านั้น จากนั้นจะเรียกใช้ GetTableFeatures เพื่อรับข้อมูลตารางของตารางผลลัพธ์ทั้งหมดได้ บัตรประจำตัวจะใช้งานได้เป็นระยะเวลาหนึ่ง (2-3 ชั่วโมง)
Use Case ที่พบบ่อยที่สุดสำหรับคู่ปลายทางนี้คือการให้นิพจน์ที่ซับซ้อนผ่าน POST ไปยัง tables.create จากนั้นดึงข้อมูลตารางที่คำนวณแล้วผ่าน GET ไปยัง GetTableFeatures กระบวนการ 2 ส่วนนี้ช่วยให้ใช้ได้ในสถานการณ์มากกว่า ComputeFeatures โดยเฉพาะอย่างยิ่ง ผลลัพธ์ของ ComputeFeatures ต้องมีการแบ่งหน้าเพื่อดูฟีเจอร์ทั้งหมด นอกจากนี้ ระบบจะแสดงเฉพาะ Feature แต่ละรายการ - ComputeFeatures เรียกใช้ได้เฉพาะโดยผู้ใช้ที่ได้รับอนุญาตโดยใช้โทเค็น OAuth ที่มีขอบเขตที่เหมาะสม tables.create มีข้อจํากัดเดียวกัน แต่ GetTableData สามารถเรียกใช้ด้วย URL ที่มีคีย์ API ได้ ดังนั้น 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
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 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)."]]
