Method: projects.map.export

เริ่มกระบวนการแบบเป็นกลุ่มที่คำนวณแผนที่แบบแบ่งส่วน และเขียนผลลัพธ์ไปยัง Google Cloud Storage

คำขอ HTTP

POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/map:export

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

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

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

string

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

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

  • earthengine.exports.create

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

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

การแสดง JSON 
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "tileOptions": {
    object (TileOptions)
  },
  "tileExportOptions": {
    object (ImageFileExportOptions)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer
}
ช่อง
expression

object (Expression)

นิพจน์ที่ประเมินเป็นรูปภาพเพื่อคํานวณและส่งออก ระบบจะใช้ขอบเขตของรูปภาพเพื่อกำหนดชุดไทล์แผนที่ที่จะแสดงผล หากต้องการควบคุมพื้นที่ที่ส่งออก ให้ตัดรูปภาพก่อนส่งออก
description

string

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

object (TileOptions)

ตัวเลือกที่อธิบายเกี่ยวกับการสร้างชิ้นส่วนแผนที่
tileExportOptions

object (ImageFileExportOptions)

ตัวเลือกสำหรับตำแหน่งและรูปแบบที่จะส่งออกชิ้นส่วนแผนที่ ปัจจุบัน Cloud Storage เป็นปลายทางเดียวที่รองรับการส่งออกแผนที่
requestId

string

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

string

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

integer

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

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

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ 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

TileOptions

ตัวเลือกที่อธิบายเกี่ยวกับชิ้นส่วนแผนที่รูปภาพหรือวิดีโอที่จะส่งออก

การแสดง JSON 
{
  "startZoom": integer,
  "skipEmpty": boolean,
  "mapsApiKey": string,
  "dimensions": {
    object (GridDimensions)
  },
  "stride": integer,
  "zoomSubset": {
    object (ZoomSubset)
  },

  // Union field end_zoom_or_scale can be only one of the following:
  "endZoom": integer,
  "scale": number
  // End of list of possible types for union field end_zoom_or_scale.
}
ช่อง
startZoom

integer

ระดับการซูมเพื่อเริ่มสร้างไทล์แผนที่สำหรับการส่งออก ค่าเริ่มต้นคือ 0
skipEmpty

boolean

หากเป็นจริง ระบบจะข้ามการเขียนไทล์แผนที่ว่าง (นั่นคือโปร่งใสทั้งหมด)
mapsApiKey

string

คีย์ API ของ Google Maps Platform (ไม่บังคับ) สำหรับโปรแกรมดูไทล์แผนที่ที่สร้างขึ้น
dimensions

object (GridDimensions)

ความกว้างและความสูงของไทล์วิดีโอเอาต์พุต ใช้สำหรับส่งออกพีระมิดวิดีโอที่แบ่งออกเป็นส่วนๆ (ExportVideoMap) เท่านั้น
stride

integer

ระยะห่างแถวและคอลัมน์ของไทล์ (ExportVideoMap) ตั้งค่าเป็น 4 สำหรับไทล์แบบเบาบาง (WebGL เท่านั้น) หรือ 1 (ค่าเริ่มต้น) เพื่อให้มีความเข้ากันได้มากที่สุด
zoomSubset

object (ZoomSubset)

ชุดย่อยของระดับการซูมที่จะสร้างไทล์ ระบุได้เฉพาะในการเรียกใช้ ExportVideoMap
ฟิลด์สหภาพ end_zoom_or_scale ระดับการซูมหรือมาตราส่วนที่จะหยุดสร้างไทล์แผนที่ คุณต้องระบุอย่างใดอย่างหนึ่ง end_zoom_or_scale ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
endZoom

integer

ระดับการซูมที่จะหยุดสร้างไทล์แผนที่
scale

number

ความละเอียดสูงสุดของรูปภาพเป็นเมตรต่อพิกเซล ระบบจะแปลงมาตราส่วนเป็นระดับการซูมสูงสุดที่เหมาะสมที่สุดที่เส้นศูนย์สูตร

ZoomSubset

ชุดย่อยของระดับการซูมที่จะสร้างไทล์ (ExportVideoMap) ชุดย่อยเริ่มต้นและชุดย่อยสิ้นสุดคือค่าความละเอียดแบบ Double ซึ่งช่วยให้คุณแสดงผลระดับการซูมได้ทีละระดับ หากต้องการแสดงผลพีระมิดทั้งรูปด้วยการซูมเริ่มต้น 12: startZoom=0, endZoom=12 อย่าตั้งค่าข้อความนี้ หากต้องการแสดงผลระดับ 0-11 และ 10% แรกของระดับ 12 ให้ใช้ startZoom=0, endZoom=12, subset = {min=0, max=12.1 } หากต้องการแสดงผล 10% ถัดไปของระดับ 12 ให้ใช้ startZoom=0, endZoom=12, subset = {min=12.1, max=12.2 } หากต้องการแสดงผล 80% ที่เหลือของระดับ 12 ให้ใช้ startZoom=0, endZoom=12, subset = {min=12.2, max=13 } นอกจากนี้ โปรดทราบว่ากลุ่มที่ส่งออกทั้งหมดต้องมีขนาดพีระมิด (เต็ม) เดียวกันใน start/endZoom

การแสดง JSON 
{
  "start": number,
  "end": number
}
ช่อง
start

number

ชุดย่อยระดับการซูมเริ่มต้นที่จะสร้างไทล์ (ExportVideoMap) ในที่นี้ ชุดย่อยคือค่าความละเอียดแบบ Double ซึ่งช่วยให้คุณแสดงผลระดับการซูมแบบเพิ่มทีละระดับได้ เช่น 12.1 คือ 10% แรกของไทล์ในการซูม 12 ในลำดับที่ไม่ระบุแต่มีการกำหนดไว้
end

number

ชุดย่อยระดับการซูมระดับสุดท้ายที่จะสร้างไทล์ (ExportVideoMap) ซึ่งช่วยให้คุณแสดงผลระดับการซูมแบบเพิ่มทีละระดับได้สูงสุดไม่เกินชุดย่อยสูงสุด (หากมี) ในลำดับที่ไม่ระบุแต่กำหนดได้