หน้านี้ได้รับการแปลโดย Cloud Translation API

Method: projects.image.import

นําเข้ารูปภาพ

คำขอ HTTP

POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/image:import

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

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

พารามิเตอร์

พารามิเตอร์
`project`	`string` รหัสหรือหมายเลขโปรเจ็กต์ Google Cloud Platform ที่ควรถือว่าเป็นผู้บริโภคบริการสำหรับคำขอนี้ รูปแบบคือ `projects/{project-id}` การให้สิทธิ์ต้องใช้สิทธิ์ IAM ต่อไปนี้ในทรัพยากร `project` ที่ระบุ `earthengine.imports.create`

project

string

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

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

earthengine.imports.create

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

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

การแสดง JSON
{ "imageManifest": { object (`ImageManifest`) }, "description": string, "overwrite": boolean, "requestId": string }

ช่อง
`imageManifest`	`object (ImageManifest)` ไฟล์ Manifest ของรูปภาพ
`description`	`string` ชื่องานที่มนุษย์อ่านได้
`overwrite`	`boolean` อนุญาตให้เขียนทับชิ้นงานที่มีอยู่หรือไม่
`requestId`	`string` สตริงที่ไม่ซ้ำกันซึ่งใช้ในการตรวจหาคําขอที่ซ้ำกัน หากผู้ใช้รายเดียวกันส่งคําขอมากกว่า 1 รายการที่มี `requestId` ที่ไม่ว่างเปล่าเหมือนกัน จะมีเพียงคําขอเดียวที่เริ่มการดําเนินการแบบต่อเนื่องได้สําเร็จ `requestId` อาจมีอักขระ a..z, A..Z, 0-9 หรือ '-' `requestId` ต้องมีความยาวไม่เกิน 60 อักขระ

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

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

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

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

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

ImageManifest

อธิบายวิธีที่บริการ EarthEngine ควรจัดองค์ประกอบรูปภาพจากชุดไฟล์

การแสดง JSON

การแสดง JSON
{ "name": string, "properties": { object }, "uriPrefix": string, "tilesets": [ { object (`Tileset`) } ], "bands": [ { object (`TilesetBand`) } ], "maskBands": [ { object (`TilesetMaskBand`) } ], "footprint": { object (`PixelFootprint`) }, "missingData": { object (`MissingData`) }, "pyramidingPolicy": enum (`PyramidingPolicy`), "startTime": string, "endTime": string, "skipMetadataRead": boolean, "memo": string }

{
  "name": string,
  "properties": {
    object
  },
  "uriPrefix": string,
  "tilesets": [
    {
      object (Tileset)
    }
  ],
  "bands": [
    {
      object (TilesetBand)
    }
  ],
  "maskBands": [
    {
      object (TilesetMaskBand)
    }
  ],
  "footprint": {
    object (PixelFootprint)
  },
  "missingData": {
    object (MissingData)
  },
  "pyramidingPolicy": enum (PyramidingPolicy),
  "startTime": string,
  "endTime": string,
  "skipMetadataRead": boolean,
  "memo": string
}

ช่อง
`name`	`string` ชื่อของชิ้นงานที่สร้างขึ้น `name` อยู่ในรูปแบบ "projects//assets/*" (เช่น "projects/earthengine-legacy/assets/users//") ชิ้นงานทั้งหมดที่ผู้ใช้เป็นเจ้าของจะอยู่ในโปรเจ็กต์ "earthengine-legacy" (เช่น "projects/earthengine-legacy/assets/users/foo/bar") ชิ้นงานอื่นๆ ทั้งหมดจะอยู่ภายใต้โปรเจ็กต์ "earthengine-public" (เช่น "projects/earthengine-public/assets/LANDSAT")
`properties`	`object (Struct format)` พร็อพเพอร์ตี้เพิ่มเติมของชิ้นงาน ระบบเลิกใช้งานชื่อพร็อพเพอร์ตี้ "system:time_start" และ "system:time_end" แล้ว โปรดใช้ช่อง `startTime` และ `endTime` แทน
`uriPrefix`	`string` คำนำหน้าที่ไม่บังคับซึ่งอยู่หน้า `uri` ทั้งหมดที่กําหนดไว้ในไฟล์ Manifest นี้
`tilesets[]`	`object (Tileset)` ชิ้นส่วนแผนที่ แต่ละชุดชิ้นส่วนต้องมีค่าที่ไม่ซ้ำกัน
`bands[]`	`object (TilesetBand)` ย่านความถี่ ลําดับของกลุ่มชิ้นงานจะเหมือนกับลําดับของ `bands`
`maskBands[]`	`object (TilesetMaskBand)` แถบมาสก์
`footprint`	`object (PixelFootprint)` ร่องรอยในพิกัดพิกเซล (ไม่ใช่พิกัดละติจูด/ลองจิจูด) หากเว้นว่างไว้ ข้อมูลร่องรอยจะเป็นทั้งรูปภาพโดยค่าเริ่มต้น ดูคำอธิบายพิกัดพิกเซลโดยละเอียดได้ที่ `PixelGrid`
`missingData`	`object (MissingData)` ค่าที่แสดงถึงไม่มีข้อมูลในย่านความถี่ทั้งหมดของรูปภาพ ใช้กับวงดนตรีทั้งหมดที่ไม่ได้ระบุ `missingData` ของตนเอง
`pyramidingPolicy`	`enum (PyramidingPolicy)` นโยบายการสร้างเครือข่ายแบบหลายชั้น หากไม่ระบุ ระบบจะใช้นโยบาย MEAN โดยค่าเริ่มต้น ใช้กับวงดนตรีทั้งหมดที่ไม่ได้ระบุ `pyramidingPolicy` ของตนเอง
`startTime`	`string (Timestamp format)` การประทับเวลาที่เชื่อมโยงกับชิ้นงาน หากมี เช่น เวลาถ่ายภาพจากดาวเทียม สําหรับเนื้อหาที่สอดคล้องกับช่วงเวลา เช่น ค่าเฉลี่ยในช่วง 1 เดือนหรือ 1 ปี การประทับเวลานี้จะสอดคล้องกับช่วงเริ่มต้นของช่วงเวลานั้น ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่างเช่น `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` หรือ `"2014-10-02T15:01:23+05:30"`
`endTime`	`string (Timestamp format)` สําหรับเนื้อหาที่สอดคล้องกับช่วงเวลา เช่น ค่าเฉลี่ยในช่วง 1 เดือนหรือ 1 ปี การประทับเวลานี้จะสอดคล้องกับช่วงสิ้นสุดของช่วงเวลานั้น (ไม่รวม) ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่างเช่น `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` หรือ `"2014-10-02T15:01:23+05:30"`
`skipMetadataRead`	`boolean` ข้ามการอ่านข้อมูลเมตาจากไฟล์โดยใช้ GDAL หรือไม่ เมื่อฟิลด์นี้เป็น "จริง" ข้อมูลชุดควรมีข้อมูลเมตา GDAL ที่สมบูรณ์ ได้แก่ ประเภทข้อมูล, crs, การเปลี่ยนรูปแบบ, มิติข้อมูลไฟล์ และค่าไม่มีข้อมูล
`memo`	`string` ฟิลด์แบบอิสระสำหรับจัดเก็บหมายเหตุของผู้ใช้ ไม่ใช้ในการส่งผ่านข้อมูล

TilesetBand

แสดงแถบเดียวที่มาจากชุดข้อมูลแผนที่

การแสดง JSON
{ "id": string, "tilesetId": string, "tilesetBandIndex": integer, "missingData": { object (`MissingData`) }, "pyramidingPolicy": enum (`PyramidingPolicy`) }

ช่อง
`id`	`string` รหัสของวง
`tilesetId`	`string` รหัสของชุดชิ้นส่วนที่สอดคล้องกับแถบ
`tilesetBandIndex`	`integer` ดัชนีแถบแบบ 0 ฐานจากชุดข้อมูลแผนที่ซึ่งสอดคล้องกับแถบ เช่น หากเป็น 1 พิกเซลของแถบจะเป็นพิกเซลของแถบที่อยู่ที่อินเด็กซ์ 1 ของชุดข้อมูล (ใน `ImageManifest.tilesets`) ที่มีรหัส `tilesetId`
`missingData`	`object (MissingData)` ค่าที่แสดงถึงไม่มีข้อมูลในย่านความถี่ หากตั้งค่า `MissingData` โดยไม่ระบุ `values` ระบบจะไม่สนใจค่า nodata ที่มีอยู่ในไฟล์ที่เกี่ยวข้องกับ `TilesetBand` นี้
`pyramidingPolicy`	`enum (PyramidingPolicy)` นโยบายการสร้างเครือข่ายแบบหลายชั้น

TilesetMaskBand

แสดงแถบมาสก์เดียวที่มาจากชุดข้อมูล

การแสดง JSON
{ "tilesetId": string, "bandIds": [ string ] }

ช่อง

ช่อง
`tilesetId`	`string` รหัสของชุดชิ้นส่วนที่สอดคล้องกับแถบมาสก์ ระบบจะใช้แถบสุดท้ายของชุดพื้นเป็นแถบมาสก์เสมอ
`bandIds[]`	`string` รหัสของวงดนตรีที่ใช้กับวงดนตรีมาสก์ หากเป็นค่าว่าง ระบบจะใช้ย่านความถี่มาสก์กับย่านความถี่ทั้งหมดในชิ้นงาน แต่ละย่านความถี่จะมีย่านการมาสก์ที่เกี่ยวข้องได้เพียงย่านเดียว หากย่านความถี่ใดย่านหนึ่งมีมาสก์ภายใน ระบบจะไม่สนใจมาสก์ภายในและจะใช้ย่านความถี่มาสก์นี้แทน

tilesetId

string

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

bandIds[]

string

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

PixelFootprint

ร่องรอยของพิกเซลที่ถูกต้องทั้งหมดในรูปภาพ

การแสดง JSON
{ "points": [ { object (`GridPoint`) } ], "bandId": string }

ช่อง

ช่อง
`points[]`	`object (GridPoint)` วงแหวนที่ประกอบเป็นด้านนอกของรูปหลายเหลี่ยมธรรมดาซึ่งต้องมีจุดศูนย์กลางของพิกเซลที่ถูกต้องทั้งหมดของรูปภาพ เส้นนี้ต้องเป็นวงแหวนเชิงเส้น: จุดสุดท้ายต้องเท่ากับจุดแรก พิกัดอยู่ในการฉายภาพของย่านที่ `bandId` ระบุ หมายเหตุ: ใช้พิกัดที่ไม่ใช่จำนวนเต็ม เช่น ตรงกลางของพิกเซลแต่ละพิกเซล เนื่องจากระบบจะถือว่าร่องรอยรวมพิกเซลนั้นด้วยหากพิกเซล (สี่เหลี่ยมผืนผ้าขนาด 1x1) ตัดกับร่องรอย อย่าใช้พิกัดที่มีค่าเป็นจำนวนเต็มเพื่อหลีกเลี่ยงการเลือกพิกเซลที่อยู่ใกล้เคียงโดยไม่ตั้งใจ เนื่องจากพิกัดดังกล่าวเป็นขอบเขตระหว่างพิกเซล การวาดร่องรอยตามจุดศูนย์กลางของพิกเซลจะช่วยป้องกันไม่ให้รวมพิกเซลที่ไม่ต้องการ ซึ่งอาจทำให้เกิดข้อผิดพลาดเมื่อพิกเซลที่ต้องการอยู่ติดกับขอบแผนที่ เช่น เส้นเมริเดียนคู่ขนานหรือเสา ตัวอย่างเช่น สำหรับรูปภาพขนาด 2x2 ที่มีพิกเซลที่ถูกต้องทั้งหมด 4 รายการ วงแหวนที่เป็นไปได้รูปแบบหนึ่งคือ [{"x": 0.5, "y": 0.5}, {"x": 0.5, "y": 1.5}, {"x": 1.5, "y": 1.5}, {"x": 1.5, "y": 0.5}, {"x": 0.5, "y": 0.5}]
`bandId`	`string` รหัสของย่านความถี่ที่มี CRS กำหนดพิกัดของร่องรอย หากเป็นค่าว่าง ระบบจะใช้ย่านความถี่แรก

points[]

object (GridPoint)

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

หมายเหตุ: ใช้พิกัดที่ไม่ใช่จำนวนเต็ม เช่น ตรงกลางของพิกเซลแต่ละพิกเซล เนื่องจากระบบจะถือว่าร่องรอยรวมพิกเซลนั้นด้วยหากพิกเซล (สี่เหลี่ยมผืนผ้าขนาด 1x1) ตัดกับร่องรอย อย่าใช้พิกัดที่มีค่าเป็นจำนวนเต็มเพื่อหลีกเลี่ยงการเลือกพิกเซลที่อยู่ใกล้เคียงโดยไม่ตั้งใจ เนื่องจากพิกัดดังกล่าวเป็นขอบเขตระหว่างพิกเซล การวาดร่องรอยตามจุดศูนย์กลางของพิกเซลจะช่วยป้องกันไม่ให้รวมพิกเซลที่ไม่ต้องการ ซึ่งอาจทำให้เกิดข้อผิดพลาดเมื่อพิกเซลที่ต้องการอยู่ติดกับขอบแผนที่ เช่น เส้นเมริเดียนคู่ขนานหรือเสา

ตัวอย่างเช่น สำหรับรูปภาพขนาด 2x2 ที่มีพิกเซลที่ถูกต้องทั้งหมด 4 รายการ วงแหวนที่เป็นไปได้รูปแบบหนึ่งคือ [{"x": 0.5, "y": 0.5}, {"x": 0.5, "y": 1.5}, {"x": 1.5, "y": 1.5}, {"x": 1.5, "y": 0.5}, {"x": 0.5, "y": 0.5}]

bandId

string

รหัสของย่านความถี่ที่มี CRS กำหนดพิกัดของร่องรอย หากเป็นค่าว่าง ระบบจะใช้ย่านความถี่แรก

GridPoint

จุดหรือเวกเตอร์ 2 มิติ

การแสดง JSON
{ "x": number, "y": number }

ช่อง

ช่อง
`x`	`number` ค่าพิกัด x
`y`	`number` ค่าพิกัด y

x

number

ค่าพิกัด x

y

number

ค่าพิกัด y