ประกาศ: โปรเจ็กต์ที่ไม่ใช่เชิงพาณิชย์ทั้งหมดที่ลงทะเบียนเพื่อใช้ Earth Engine ก่อนวันที่ 15 เมษายน 2025 ต้องยืนยันการมีสิทธิ์ที่ไม่ใช่เชิงพาณิชย์เพื่อรักษาสิทธิ์เข้าถึง Earth Engine

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

Method: projects.table.import

นําเข้าตาราง

คำขอ HTTP

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

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

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

พารามิเตอร์

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

project

string

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

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

earthengine.assets.create

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

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

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

ช่อง
`tableManifest`	`object (TableManifest)` ไฟล์ 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

TableManifest

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

การแสดง JSON

การแสดง JSON
{ "name": string, "properties": { object }, "uriPrefix": string, "sources": [ { object (`TableSource`) } ], "startTime": string, "endTime": string, "csvColumnDataTypeOverrides": { string: enum (`CsvColumnDataType`), ... }, "columnDataTypeOverrides": { string: enum (`ColumnDataType`), ... }, "memo": string }

{
  "name": string,
  "properties": {
    object
  },
  "uriPrefix": string,
  "sources": [
    {
      object (TableSource)
    }
  ],
  "startTime": string,
  "endTime": string,
  "csvColumnDataTypeOverrides": {
    string: enum (CsvColumnDataType),
    ...
  },
  "columnDataTypeOverrides": {
    string: enum (ColumnDataType),
    ...
  },
  "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 นี้
`sources[]`	`object (TableSource)` แหล่งที่มาที่ประกอบกันเป็นตารางนี้
`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"`
`csvColumnDataTypeOverrides (deprecated)`	`map (key: string, value: enum (CsvColumnDataType))` รายการนี้เลิกใช้งานแล้ว ให้ใช้ columnDataTypeOverrides แทน ออบเจ็กต์ที่มีรายการคู่ `"key": value` ตัวอย่าง: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`
`columnDataTypeOverrides`	`map (key: string, value: enum (ColumnDataType))` การแมปจากชื่อคอลัมน์กับประเภทที่จะใช้กับคอลัมน์นั้น ระบบจะอนุมานประเภทของคอลัมน์ที่ไม่ได้ระบุไว้ที่นี่ เช่น คอลัมน์ตัวเลขจะกลายเป็นตัวเลข คอลัมน์ WKT จะกลายเป็นเรขาคณิต เป็นต้น ออบเจ็กต์ที่มีรายการคู่ `"key": value` ตัวอย่าง: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`
`memo`	`string` ฟิลด์แบบอิสระสำหรับจัดเก็บหมายเหตุของผู้ใช้ ไม่ใช้ในการส่งผ่านข้อมูล

TableSource

ไฟล์ตาราง

การแสดง JSON
{ "uris": [ string ], "charset": string, "maxErrorMeters": number, "maxVertices": integer, "crs": string, "geodesic": boolean, "primaryGeometryColumn": string, "xColumn": string, "yColumn": string, "dateFormat": string, "csvDelimiter": string, "csvQualifier": string }

การแสดง JSON

{
  "uris": [
    string
  ],
  "charset": string,
  "maxErrorMeters": number,
  "maxVertices": integer,
  "crs": string,
  "geodesic": boolean,
  "primaryGeometryColumn": string,
  "xColumn": string,
  "yColumn": string,
  "dateFormat": string,
  "csvDelimiter": string,
  "csvQualifier": string
}

ช่อง
`uris[]`	`string` URI ของข้อมูลที่จะนําเข้า ปัจจุบันระบบรองรับเฉพาะ URI ของ Google Cloud Storage เท่านั้น URI แต่ละรายการต้องระบุในรูปแบบ "gs://bucket-id/object-id" ออบเจ็กต์หลักควรเป็นองค์ประกอบแรกของรายการ ระบบจะอนุมานไฟล์ Sidecar จากเส้นทางไฟล์ของออบเจ็กต์หลัก ปัจจุบันระบบรองรับ URI เพียงรายการเดียวเท่านั้น หากระบุ URI มากกว่า 1 รายการ ระบบจะแสดงข้อผิดพลาด `INALID_ARGUMENT`
`charset`	`string` ชื่อชุดอักขระเริ่มต้นที่จะใช้ถอดรหัสสตริง หากเป็นค่าว่าง ระบบจะถือว่าชุดอักขระเป็น "utf-8" โดยค่าเริ่มต้น
`maxErrorMeters`	`number` ข้อผิดพลาดสูงสุดที่อนุญาตเป็นเมตรเมื่อเปลี่ยนรูปแบบเรขาคณิตระหว่างระบบพิกัด หากเว้นว่างไว้ ระบบจะกำหนดข้อผิดพลาดสูงสุดเป็น 1 เมตรโดยค่าเริ่มต้น
`maxVertices`	`integer` จํานวนจุดยอดสูงสุด หากไม่ใช่ 0 ระบบจะแบ่งรูปทรงเรขาคณิตออกเป็นชิ้นส่วนที่ไม่ต่อเนื่องกันในพื้นที่ ซึ่งแต่ละชิ้นส่วนมีขนาดไม่เกินขีดจำกัดนี้
`crs`	`string` รหัส CRS หรือสตริง WKT เริ่มต้นที่ระบุระบบพิกัดอ้างอิงสำหรับเรขาคณิตที่ไม่มีการกำหนดไว้ หากเว้นว่างไว้ ค่าเริ่มต้นจะเป็น EPSG:4326: https://epsg.io/4326 สำหรับแหล่งที่มา CSV/TFRecord เท่านั้น
`geodesic`	`boolean` กลยุทธ์เริ่มต้นสำหรับการตีความขอบในเรขาคณิตที่ไม่มีการกำหนดไว้เป็นอย่างอื่น หากเป็นเท็จ ขอบจะตรงในการแสดงผล หากเป็น "จริง" ขอบจะโค้งตามเส้นทางที่สั้นที่สุดบนพื้นผิวโลก หากปล่อยว่างไว้ ระบบจะตั้งค่าเริ่มต้นเป็น "เท็จ" หาก "crs" เป็นระบบพิกัดที่โปรเจ็กต์ สำหรับแหล่งที่มา CSV/TFRecord เท่านั้น
`primaryGeometryColumn`	`string` คอลัมน์เรขาคณิตที่จะใช้เป็นเรขาคณิตหลักของแถวเมื่อมีคอลัมน์เรขาคณิตมากกว่า 1 คอลัมน์ หากปล่อยว่างไว้และมีคอลัมน์เรขาคณิตมากกว่า 1 คอลัมน์ ระบบจะใช้คอลัมน์เรขาคณิตคอลัมน์แรกที่พบ สำหรับแหล่งที่มา CSV/TFRecord เท่านั้น
`xColumn`	`string` ชื่อของคอลัมน์พิกัด x แบบตัวเลขสําหรับการอนุมานเรขาคณิตของจุด หากระบุ yColumn ด้วยและทั้ง 2 คอลัมน์มีค่าตัวเลข ระบบจะสร้างคอลัมน์เรขาคณิตจุดด้วยค่า x,y ในระบบพิกัดที่ระบุใน "crs" หากปล่อยว่างไว้และ "crs" ไม่ได้ระบุระบบพิกัดเชิงโปรเจ็กต์ ค่าเริ่มต้นจะเป็น "ลองจิจูด" หากเว้นว่างไว้และ "crs" ไม่ได้ระบุระบบพิกัดที่โปรเจ็กต์ ระบบจะตั้งค่าเริ่มต้นเป็น "" และจะไม่สร้างเรขาคณิตจุด ระบบจะตั้งชื่อคอลัมน์เรขาคณิตจุดที่สร้างขึ้นเป็น {xColumn}_{yColumn}_N โดยต่อท้ายด้วย N เพื่อให้ {xColumn}_{yColumn}_N ซ้ำกันไม่ได้ หากมีคอลัมน์ชื่อ {xColumn}_{yColumn} อยู่แล้ว สำหรับแหล่งที่มา CSV/TFRecord เท่านั้น
`yColumn`	`string` ชื่อคอลัมน์พิกัด y แบบตัวเลขสําหรับการอนุมานเรขาคณิตของจุด หากระบุ xColumn ด้วย และทั้ง 2 คอลัมน์มีค่าตัวเลข ระบบจะสร้างคอลัมน์เรขาคณิตจุดด้วยค่า x,y ในระบบพิกัดที่ระบุใน "crs" หากปล่อยว่างไว้และ "crs" ไม่ได้ระบุระบบพิกัดที่โปรเจ็กต์ ค่าเริ่มต้นจะเป็น "latitude" หากเว้นว่างไว้และ "crs" ไม่ได้ระบุระบบพิกัดที่โปรเจ็กต์ ระบบจะตั้งค่าเริ่มต้นเป็น "" และจะไม่สร้างเรขาคณิตจุด ระบบจะตั้งชื่อคอลัมน์เรขาคณิตจุดที่สร้างขึ้นเป็น {xColumn}_{yColumn}_N โดยต่อท้ายด้วย N เพื่อให้ {xColumn}_{yColumn}_N ซ้ำกันไม่ได้ หากมีคอลัมน์ชื่อ {xColumn}_{yColumn} อยู่แล้ว สำหรับแหล่งที่มา CSV/TFRecord เท่านั้น
`dateFormat`	`string` รูปแบบที่ใช้แยกวิเคราะห์ฟิลด์ที่เข้ารหัสวันที่ รูปแบบต้องเป็นไปตามที่อธิบายไว้ใน http://joda-time.sourceforge.net/apidocs/org/joda/time/format/DateTimeFormat.html หากเว้นว่างไว้ ระบบจะนําเข้าวันที่เป็นสตริง สำหรับแหล่งที่มา CSV/TFRecord เท่านั้น
`csvDelimiter`	`string` เมื่อนำเข้าไฟล์ CSV อักขระเดี่ยวที่ใช้เป็นตัวคั่นระหว่างค่าคอลัมน์ในแถว หากเว้นว่างไว้ ระบบจะใช้ค่าเริ่มต้นเป็น "," สําหรับแหล่งที่มา CSV เท่านั้น
`csvQualifier`	`string` อักขระที่ล้อมรอบค่าคอลัมน์ (หรือที่เรียกว่า "อักขระคำพูด") เมื่อนำเข้าไฟล์ CSV หากเว้นว่างไว้ ระบบจะใช้ค่าเริ่มต้นเป็น "" สําหรับแหล่งที่มา CSV เท่านั้น หากค่าคอลัมน์ไม่ได้อยู่ในเครื่องหมายระบุ ระบบจะตัดช่องว่างหน้าและหลังออก เช่น ..., test,... <== this value is not qualified becomes the string value: "test" <== whitespace is stripped where: ...," test",... <== this value IS qualified with quotes becomes the string value: " test" <== whitespace remains!