Method: projects.assets.listFeatures
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
แสดงรายการฟีเจอร์ในเนื้อหาตาราง วิธีนี้ช่วยให้ผู้เรียกใช้สามารถใช้ตัวกรองเชิงพื้นที่และเวลา รวมถึงตัวกรองพร็อพเพอร์ตี้กับตารางได้ ระบบจะแสดงผลลัพธ์เป็นรายการออบเจ็กต์ฟีเจอร์ GeoJSON
คำขอ HTTP
GET https://earthengine.googleapis.com/v1beta/{asset=projects/*/assets/**}:listFeatures
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ |
asset |
string
ต้องระบุ ชื่อเนื้อหาตารางที่จะแสดง asset อยู่ในรูปแบบ "projects/*/assets/**" (เช่น "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). ชิ้นงานทั้งหมดที่ผู้ใช้เป็นเจ้าของจะอยู่ในโปรเจ็กต์ "earthengine-legacy" (เช่น "projects/earthengine-legacy/assets/users/foo/bar"). ชิ้นงานอื่นๆ ทั้งหมดจะอยู่ภายใต้โปรเจ็กต์ "earthengine-public" (เช่น "projects/earthengine-public/assets/LANDSAT").
การให้สิทธิ์ต้องใช้สิทธิ์ IAM ต่อไปนี้ในทรัพยากร asset ที่ระบุ
|
พารามิเตอร์การค้นหา
พารามิเตอร์ |
pageSize |
integer
จำนวนผลลัพธ์สูงสุดต่อหน้า เซิร์ฟเวอร์อาจแสดงผลชิ้นงานน้อยกว่าที่ขอ หากไม่ระบุ ค่าเริ่มต้นของขนาดหน้าจะเป็น 1, 000 ผลการค้นหาต่อหน้า
|
pageToken |
string
โทเค็นที่ระบุหน้าผลการค้นหาที่เซิร์ฟเวอร์ควรแสดง โดยปกติแล้ว ค่านี้คือค่าของ ListFeaturesResponse.next_page_token ที่แสดงผลจากการเรียกใช้เมธอด assets.listFeatures ก่อนหน้านี้
|
region |
string
รูปทรงเรขาคณิตที่กําหนดขอบเขตการค้นหา (หากมี) ซึ่งระบุเป็นสตริงรูปทรงเรขาคณิต GeoJSON (ดู RFC 7946)
|
filter |
string
(หากมี) ระบุตัวกรองพร็อพเพอร์ตี้แบบง่ายเพิ่มเติม
|
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
ข้อความตอบกลับสําหรับ EarthEngineService.ListFeatures
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
{
"type": string,
"features": [
{
object (Feature )
}
],
"nextPageToken": string
} |
ช่อง |
type |
string
มีสตริงคงที่ "FeatureCollection" เสมอ ซึ่งจะทําเครื่องหมายออบเจ็กต์นี้เป็นออบเจ็กต์ FeatureCollection ของ GeoJSON
|
features[] |
object (Feature )
รายการองค์ประกอบที่ตรงกับการค้นหา เป็นรายการออบเจ็กต์องค์ประกอบ GeoJSON (ดู RFC 7946) ที่มีสตริง "Feature" ในช่องชื่อ "type" เรขาคณิตในช่องชื่อ "geometry" และพร็อพเพอร์ตี้คีย์/ค่าในช่องชื่อ "properties"
|
nextPageToken |
string
โทเค็นสําหรับดึงข้อมูลหน้าถัดไปของผลการค้นหา ส่งค่านี้ในช่อง ListFeaturesRequest.page_token ในการเรียกใช้เมธอด assets.listFeatures ครั้งถัดไปเพื่อดึงข้อมูลหน้าถัดไป
|
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต 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\u003eLists features from a specified Earth Engine table asset using the \u003ccode\u003elistFeatures\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering of table data by spatiotemporal and property criteria using query parameters.\u003c/p\u003e\n"],["\u003cp\u003eReturns results as a GeoJSON FeatureCollection containing a list of features and a token for pagination.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific IAM permissions or OAuth scopes for authorization to access and retrieve data.\u003c/p\u003e\n"]]],[],null,["# Method: projects.assets.listFeatures\n\nLists the features in a table asset. This method allows the caller to apply spatiotemporal and property filters to a table. Results are returned as a list of GeoJSON feature objects.\n\n### HTTP request\n\n`GET https://earthengine.googleapis.com/v1beta/{asset=projects/*/assets/**}:listFeatures`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `asset` | `string` Required. The name of the table asset to list. `asset` is of the format \"projects/\\*/assets/\\*\\*\" (e.g., \"projects/earthengine-legacy/assets/users/\\[USER\\]/\\[ASSET\\]\"). All user-owned assets are under the project \"earthengine-legacy\" (e.g., \"projects/earthengine-legacy/assets/users/foo/bar\"). All other assets are under the project \"earthengine-public\" (e.g., \"projects/earthengine-public/assets/LANDSAT\"). Authorization requires the following [IAM](https://cloud.google.com/iam/docs/) permission on the specified resource `asset`: - `earthengine.assets.get` |\n\n### Query parameters\n\n| Parameters ||\n|-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of results per page. The server may return fewer assets than requested. If unspecified, the page size default is 1000 results per page. |\n| `pageToken` | `string` A token identifying a page of results the server should return. Typically, this is the value of [ListFeaturesResponse.next_page_token](/earth-engine/reference/rest/v1beta/projects.assets/listFeatures#body.ListFeaturesResponse.FIELDS.next_page_token) returned from the previous call to the `assets.listFeatures` method. |\n| `region` | `string` If present, a geometry defining a query region, specified as a GeoJSON geometry string (see RFC 7946). |\n| `filter` | `string` If present, specifies additional simple property filters. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for EarthEngineService.ListFeatures.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"type\": string, \"features\": [ { object (/earth-engine/reference/rest/v1beta/Feature) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `type` | `string` Always contains the constant string \"FeatureCollection\", marking this as a GeoJSON FeatureCollection object. |\n| `features[]` | `object (`[Feature](/earth-engine/reference/rest/v1beta/Feature)`)` The list of features matching the query, as a list of GeoJSON feature objects (see RFC 7946) containing the string \"Feature\" in a field named \"type\", the geometry in a field named \"geometry\", and key/value properties in a field named \"properties\". |\n| `nextPageToken` | `string` A token to retrieve the next page of results. Pass this value in the [ListFeaturesRequest.page_token](/earth-engine/reference/rest/v1beta/projects.assets/listFeatures#body.QUERY_PARAMETERS.page_token) field in the subsequent call to the `assets.listFeatures` method to retrieve the next page of results. |\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)."]]