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)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "endZoom": integer,
  "maxZoom": integer,
  "scale": number
  // End of mutually exclusive fields.
}
ช่อง
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
ระดับการซูมหรือมาตราส่วนที่จะหยุดสร้างส่วนของแผนที่ ต้องระบุอย่างใดอย่างหนึ่ง รายการต่อไปนี้คือรายการช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ
endZoom

integer

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

integer

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

number

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

ZoomSubset

ชุดย่อยของระดับการซูมที่จะสร้างส่วน (ExportVideoMap) ชุดย่อยเริ่มต้นและสิ้นสุดเป็นค่าความแม่นยำสองเท่า ซึ่งช่วยให้คุณแสดงผลระดับการซูมหรือระดับต่างๆ ได้ทีละน้อย หากต้องการแสดงผลพีระมิดทั้งหมดด้วยการซูมเริ่มต้นที่ 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) ในที่นี้ ชุดย่อยเป็นค่าความแม่นยำสองเท่า ซึ่งช่วยให้คุณแสดงผลระดับการซูมได้ทีละน้อย ดังนั้น 12.1 จึงเป็น 10% แรกของส่วนในการซูม 12 ตามลำดับที่ไม่ได้ระบุแต่กำหนดได้
end

number

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

number

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

number

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