Method: projects.image.export

เริ่มกระบวนการแบบเป็นชุดที่คำนวณรูปภาพและเขียนผลลัพธ์ไปยังปลายทางหลายแห่ง

คำขอ HTTP

POST https://earthengine.googleapis.com/v1/{project=projects/*}/image:export

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

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

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

string

รหัสหรือหมายเลขโปรเจ็กต์ของโปรเจ็กต์ Google Cloud Platform ที่ควรได้รับการพิจารณาว่าเป็นผู้ใช้บริการสำหรับคำขอนี้ รูปแบบคือ projects/{project-id}

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

  • earthengine.exports.create

เนื้อความของคำขอ

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

การแสดง JSON 
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "maxPixels": string,
  "grid": {
    object (PixelGrid)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fileExportOptions": {
    object (ImageFileExportOptions)
  },
  "assetExportOptions": {
    object (ImageAssetExportOptions)
  }
  // End of mutually exclusive fields.
}
ช่อง
expression

object (Expression)

นิพจน์ที่ประเมินเป็นรูปภาพที่จะคำนวณและส่งออก
description

string

ชื่อที่มนุษย์อ่านได้ของงาน
maxPixels

string (Int64Value format)

จำนวนพิกเซลสูงสุดที่จะคำนวณและส่งออก นี่คือการป้องกันเพื่อไม่ให้คุณเริ่มการส่งออกขนาดใหญ่กว่าที่ตั้งใจไว้โดยไม่ได้ตั้งใจ ค่าเริ่มต้นคือ 1e8 พิกเซล แต่คุณสามารถตั้งค่าอย่างชัดเจนเพื่อเพิ่มหรือลดขีดจำกัดนี้
grid

object (PixelGrid)

พารามิเตอร์ที่อธิบายวิธีฉายภาพใหม่และตัดรูปภาพที่คำนวณโดย expression หากไม่มี ระบบจะแสดงผลรูปภาพที่คำนวณทั้งหมดในการฉายภาพดั้งเดิม
requestId

string

สตริงที่ไม่ซ้ำกันซึ่งใช้เพื่อตรวจหาคำขอที่ซ้ำกัน หากผู้ใช้คนเดียวกันส่งคำขอมากกว่า 1 รายการโดยใช้ requestId ที่ไม่ว่างเปล่าเหมือนกัน ระบบอาจเริ่มการดำเนินการที่ใช้เวลานานได้สำเร็จเพียงคำขอเดียว requestId อาจมีอักขระ a..z, A..Z, 0-9 หรือ '-' และrequestIdมีความยาวไม่เกิน 60 อักขระ
workloadTag

string

ป้ายกำกับที่ผู้ใช้ระบุเพื่อติดตามการคำนวณนี้
priority

integer

ไม่บังคับ ลำดับความสำคัญของงานส่งออกภายในโปรเจ็กต์ ระบบจะกำหนดเวลาให้งานที่มีลำดับความสำคัญสูงกว่าก่อน ต้องเป็นจำนวนเต็มระหว่าง 0 ถึง 9999 ค่าเริ่มต้นคือ 100 หากไม่ได้ตั้งค่าไว้
ตัวเลือกที่อธิบายตำแหน่งและวิธีจัดเก็บผลลัพธ์ รายการต่อไปนี้คือรายการช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ
fileExportOptions

object (ImageFileExportOptions)

หากระบุไว้ จะกำหนดค่าการส่งออกเป็นไฟล์
assetExportOptions

object (ImageAssetExportOptions)

หากระบุไว้ จะกำหนดค่าการส่งออกเป็นเนื้อหาของ Earth Engine
สิ้นสุดช่องที่ใช้ร่วมกันไม่ได้

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

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Operation

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

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/devstorage.full_control

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview.

ImageAssetExportOptions

ตัวเลือกสำหรับการบันทึกรูปภาพเป็นเนื้อหาของ Earth Engine

การแสดง JSON 
{
  "pyramidingPolicy": enum (PyramidingPolicy),
  "pyramidingPolicyOverrides": {
    string: enum (PyramidingPolicy),
    ...
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of mutually exclusive fields.
}
ช่อง
pyramidingPolicy

enum (PyramidingPolicy)

นโยบายการสร้างพีระมิดที่จะใช้กับทุกแบนด์โดยค่าเริ่มต้น
pyramidingPolicyOverrides

map (key: string, value: enum (PyramidingPolicy))

การลบล้างนโยบายพีระมิดเฉพาะต่อแบนด์

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่าง: { "name": "wrench", "mass": "1.3kg", "count": "3" }
ตำแหน่งที่จะเขียนผลลัพธ์ รายการต่อไปนี้คือรายการช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ
earthEngineDestination

object (EarthEngineDestination)

หากระบุไว้ จะกำหนดค่าการส่งออกไปยัง Earth Engine
สิ้นสุดช่องที่ใช้ร่วมกันไม่ได้