Method: projects.assets.getPixels

ดึงข้อมูลพิกเซลจากชิ้นงานรูปภาพ เมธอดที่กําหนดเองนี้ช่วยให้ผู้เรียกใช้สามารถขอไทล์พิกเซลแบบสุ่มจากรูปภาพ โดยระบุย่านและการวางผังแผนที่ได้ (ไม่บังคับ) ระบบจะเข้ารหัสข้อมูลที่ปกปิดหรือขาดหายไปเป็น 0

คำขอมีขีดจำกัดอยู่ที่ 48 MB สำหรับข้อมูลที่ไม่มีการบีบอัดต่อคำขอ ซึ่งคำนวณจากผลคูณของขนาดคำขอเป็นพิกเซล จำนวนแถบรูปภาพที่ขอ และจำนวนไบต์ต่อพิกเซลสำหรับแต่ละแถบ นอกจากนี้ คำขอยังจำกัดให้มีความละเอียดไม่เกิน 32,000 พิกเซลในด้านใดด้านหนึ่งและไม่เกิน 1,024 ย่านความถี่ คำขอที่เกินขีดจำกัดเหล่านี้จะส่งผลให้เกิดรหัสข้อผิดพลาด 400 (BAD_REQUEST)

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลพิกเซลที่ขอในการเข้ารหัสที่ระบุในช่อง fileFormat ของคำขอ

คำขอ HTTP

POST https://earthengine.googleapis.com/v1beta/{name=projects/*/assets/**}:getPixels

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
name

string

ต้องระบุ ชื่อชิ้นงานรูปภาพที่จะดึงข้อมูลพิกเซล name อยู่ในรูปแบบ "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 ต่อไปนี้ในทรัพยากร name ที่ระบุ

  • earthengine.assets.get

เนื้อหาของคำขอ

เนื้อความของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "fileFormat": enum (ImageFileFormat),
  "grid": {
    object (PixelGrid)
  },
  "region": {
    object
  },
  "bandIds": [
    string
  ],
  "visualizationOptions": {
    object (VisualizationOptions)
  },
  "workloadTag": string
}
ช่อง
fileFormat

enum (ImageFileFormat)

รูปแบบไฟล์เอาต์พุตที่จะแสดงค่าพิกเซล
grid

object (PixelGrid)

พารามิเตอร์ที่อธิบายตารางพิกเซลที่จะดึงข้อมูล ค่าเริ่มต้นคือตารางพิกเซลของข้อมูล
region

object (Struct format)

ภูมิภาคของข้อมูลที่จะแสดง (หากมี) ซึ่งระบุเป็นออบเจ็กต์เรขาคณิต GeoJSON (ดู RFC 7946) เนื่องจากรูปภาพที่แสดงผลจะเป็นสี่เหลี่ยมผืนผ้าเสมอ ระบบจะใช้กล่องขอบเขตของรูปทรงเรขาคณิตที่ระบุในระบบพิกัดเอาต์พุต หากระบุ grid.dimensions ด้วย ระบบจะปรับขนาดตารางกริดเป็นขนาดที่ขอในขั้นตอนสุดท้าย
bandIds[]

string

(หากมี) ระบุชุดแถบที่ต้องการใช้รับพิกเซล แถบจะระบุด้วยรหัสตามที่ระบุไว้ในช่อง id ของโปรโตคอล ImageBand
visualizationOptions

object (VisualizationOptions)

ชุดตัวเลือกการแสดงภาพ (หากมี) เพื่อใช้สร้างการแสดงภาพ RGB 8 บิตของข้อมูลแทนการแสดงผลข้อมูลดิบ
workloadTag

string

แท็กที่ผู้ใช้ระบุเพื่อติดตามการคํานวณนี้

เนื้อหาการตอบกลับ

หากดำเนินการสำเร็จ การตอบกลับจะเป็นคำตอบ HTTP ทั่วไปซึ่งรูปแบบจะกำหนดโดยเมธอด

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต 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