Method: projects.map.export

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

คำขอ HTTP

POST https://earthengine.googleapis.com/v1alpha/{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,
  "minZoom": integer,
  "skipEmpty": boolean,
  "skipEmptyTiles": boolean,
  "mapsApiKey": string,
  "dimensions": {
    object (GridDimensions)
  },
  "tileDimensions": {
    object (GridDimensions)
  },
  "stride": integer,
  "zoomSubset": {
    object (ZoomSubset)
  },

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

integer

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

integer

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

boolean

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

boolean

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

string

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

object (GridDimensions)

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

object (GridDimensions)

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

integer

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

object (ZoomSubset)

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

integer

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

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,
  "min": number,
  "max": number
}
ช่อง
start

number

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

number

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

number

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

number

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