Method: projects.thumbnails.create

สร้างรหัสที่ใช้แสดงผลรูปภาพ "ภาพปก" ได้

ใช้ร่วมกับ thumbnails.getPixels การเรียกใช้ thumbnails.create จะแสดงนิพจน์และตัวเลือกเอาต์พุตบางอย่าง ผลลัพธ์ของ thumbnails.create คือรหัสที่แสดงรูปภาพซึ่งเป็นผลมาจากการประเมินนิพจน์นั้นและใช้ตัวเลือกเหล่านั้น จากนั้นจะเรียกใช้ thumbnails.getPixels เพื่อรับข้อมูลรูปภาพสำหรับรูปภาพทั้งหมดที่แสดงผลได้ บัตรประจำตัวจะใช้งานได้เป็นระยะเวลาหนึ่ง (2-3 ชั่วโมง)

Use Case ที่พบบ่อยที่สุดสำหรับคู่ปลายทางนี้คือการให้นิพจน์ที่ซับซ้อนผ่าน POST ไปยัง thumbnails.create จากนั้นดึงข้อมูลรูปภาพที่คำนวณแล้วผ่าน GET ไปยัง thumbnails.getPixels กระบวนการ 2 ส่วนนี้ช่วยให้ใช้ได้ในสถานการณ์มากกว่า ComputePixels โดยเฉพาะอย่างยิ่ง - ผลลัพธ์ของ ComputePixels ต้องได้รับการถอดแพ็กเก็ตเพื่อรับไบต์รูปภาพที่เข้ารหัส ผลการค้นหาของ thumbnails.getPixels สามารถแสดงโดยเบราว์เซอร์ได้โดยตรง - ComputePixels เรียกใช้ได้เฉพาะโดยผู้ใช้ที่ได้รับอนุญาตโดยใช้โทเค็น OAuth ที่มีขอบเขตที่เหมาะสม thumbnails.create มีข้อจํากัดเดียวกัน แต่ thumbnails.getPixels สามารถเรียกใช้ด้วย URL ที่มีคีย์ API ได้ ดังนั้น URL ที่เรียกใช้จึงใช้ได้ในวงกว้างมากขึ้น

ผลลัพธ์จากการประเมินนิพจน์ต้องเป็นไปตามข้อกำหนดที่สมเหตุสมผลสำหรับรูปแบบรูปภาพที่ขอ โดยเฉพาะอย่างยิ่ง รูปแบบ JPEG หรือ PNG กำหนดให้มีย่านความถี่เอาต์พุต 1 หรือ 3 ย่าน และตัดค่าที่อยู่นอกช่วง 0-255

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

คำขอ HTTP

POST https://earthengine.googleapis.com/v1alpha/{parent=projects/*}/thumbnails

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

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

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

string

ต้องระบุ รายการหลักของคอลเล็กชันภาพปก (เช่น "projects/*")

การให้สิทธิ์ต้องใช้สิทธิ์ IAM ต่อไปนี้ในทรัพยากร parent ที่ระบุ

  • earthengine.thumbnails.create

พารามิเตอร์การค้นหา

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

string

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

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

เนื้อความของคำขอมีอินสแตนซ์ของ Thumbnail

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

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Thumbnail ที่สร้างขึ้นใหม่

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

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