Method: projects.table.import

Nhập bảng.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
project

string

Mã dự án hoặc số dự án của dự án Google Cloud Platform sẽ được coi là người dùng dịch vụ cho yêu cầu này. Định dạng là projects/{project-id}.

Việc uỷ quyền yêu cầu quyền IAM sau đây trên tài nguyên project đã chỉ định:

  • earthengine.assets.create

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON
{
  "tableManifest": {
    object (TableManifest)
  },
  "description": string,
  "overwrite": boolean,
  "requestId": string
}
Trường
tableManifest

object (TableManifest)

Tệp kê khai bảng.

description

string

Tên công việc mà con người đọc được.

overwrite

boolean

Cho phép ghi đè thành phần hiện có hay không.

requestId

string

Một chuỗi duy nhất dùng để phát hiện các yêu cầu trùng lặp. Nếu cùng một người dùng thực hiện nhiều yêu cầu với cùng một requestId không trống, thì chỉ một trong các yêu cầu đó mới có thể bắt đầu thành công một thao tác chạy trong thời gian dài. requestId có thể chứa các ký tự a..z, A..Z, 0-9 hoặc "-". requestId có thể dài tối đa 60 ký tự.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Operation.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

TableManifest

Mô tả cách dịch vụ EarthEngine tạo một bảng từ một tập hợp tệp.

Biểu diễn dưới dạng JSON
{
  "name": string,
  "properties": {
    object
  },
  "uriPrefix": string,
  "sources": [
    {
      object (TableSource)
    }
  ],
  "startTime": string,
  "endTime": string,
  "csvColumnDataTypeOverrides": {
    string: enum (CsvColumnDataType),
    ...
  },
  "columnDataTypeOverrides": {
    string: enum (ColumnDataType),
    ...
  },
  "memo": string
}
Trường
name

string

Tên của thành phần sẽ được tạo. name có định dạng "projects/*/assets/**" (ví dụ: "projects/earthengine-legacy/assets/users//"). Tất cả tài sản thuộc sở hữu của người dùng đều nằm trong dự án "earthengine-legacy" (ví dụ: "projects/earthengine-legacy/assets/users/foo/bar"). Tất cả tài sản khác đều thuộc dự án "earthengine-public" (ví dụ: "projects/earthengine-public/assets/LANDSAT").

properties

object (Struct format)

Các thuộc tính bổ sung của thành phần. Không dùng tên thuộc tính "system:time_start" và "system:time_end" nữa. Thay vào đó, hãy sử dụng các trường startTimeendTime.

uriPrefix

string

Tiền tố không bắt buộc được thêm vào tất cả uri được xác định trong tệp kê khai này.

sources[]

object (TableSource)

Các nguồn tạo nên bảng này.

startTime

string (Timestamp format)

Dấu thời gian liên kết với thành phần (nếu có), ví dụ: thời gian chụp ảnh vệ tinh. Đối với những thành phần tương ứng với một khoảng thời gian, chẳng hạn như giá trị trung bình trong một tháng hoặc một năm, dấu thời gian này tương ứng với thời điểm bắt đầu khoảng thời gian đó.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

Đối với những thành phần tương ứng với một khoảng thời gian, chẳng hạn như giá trị trung bình trong một tháng hoặc một năm, dấu thời gian này tương ứng với thời điểm kết thúc khoảng thời gian đó (không bao gồm).

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

csvColumnDataTypeOverrides
(deprecated)

map (key: string, value: enum (CsvColumnDataType))

Thay vào đó, hãy sử dụng columnDataTypeOverrides.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

columnDataTypeOverrides

map (key: string, value: enum (ColumnDataType))

Bản đồ từ tên cột đến loại cần sử dụng cho cột đó. Các cột không được chỉ định ở đây sẽ có kiểu được suy luận, chẳng hạn như cột số trở thành số, cột WKT trở thành hình học, v.v.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

memo

string

Trường dạng tự do để lưu trữ ghi chú của người dùng. Không được dùng trong quá trình truyền dẫn.

TableSource

Tệp bảng.

Biểu diễn dưới dạng 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
}
Trường
uris[]

string

URI của dữ liệu cần nhập. Hiện tại, chúng tôi chỉ hỗ trợ URI Google Cloud Storage. Mỗi URI phải được chỉ định theo định dạng sau: "gs://mã-vùng-đổ-vào/mã-đối-tượng". Đối tượng chính phải là phần tử đầu tiên của danh sách, các tệp sidecar được suy ra từ đường dẫn tệp của đối tượng chính. Hiện chỉ hỗ trợ một URI. Nếu bạn chỉ định nhiều URI, hệ thống sẽ trả về lỗi INALID_ARGUMENT.

charset

string

Tên của bộ ký tự mặc định để dùng cho việc giải mã chuỗi. Nếu trống, theo mặc định, bộ ký tự "utf-8" sẽ được giả định.

maxErrorMeters

number

Lỗi tối đa được phép tính bằng mét khi biến đổi hình học giữa các hệ toạ độ. Nếu để trống, theo mặc định, lỗi tối đa là 1 mét.

maxVertices

integer

Số đỉnh tối đa. Nếu không bằng 0, hình học sẽ được chia thành các phần riêng biệt về không gian, mỗi phần nằm trong giới hạn này.

crs

string

Mã CRS hoặc chuỗi WKT mặc định chỉ định hệ toạ độ tham chiếu của mọi hình học không có hệ toạ độ tham chiếu được chỉ định. Nếu bạn để trống, giá trị mặc định sẽ là EPSG:4326: https://epsg.io/4326. Chỉ dành cho các nguồn CSV/TFRecord.

geodesic

boolean

Chiến lược mặc định để diễn giải các cạnh trong hình học không có cạnh nào được chỉ định. Nếu giá trị là false, các cạnh sẽ thẳng trong phép chiếu. Nếu là true, các cạnh sẽ được uốn cong để đi theo đường ngắn nhất trên bề mặt Trái Đất. Khi để trống, giá trị mặc định là false nếu "crs" là hệ toạ độ chiếu. Chỉ dành cho các nguồn CSV/TFRecord.

primaryGeometryColumn

string

Cột hình học để sử dụng làm hình học chính của hàng khi có nhiều cột hình học.

Nếu bạn để trống và có nhiều cột hình học, thì cột hình học đầu tiên được tìm thấy sẽ được sử dụng. Chỉ dành cho các nguồn CSV/TFRecord.

xColumn

string

Tên của cột toạ độ x dạng số để suy luận hình học của điểm. Nếu bạn cũng chỉ định yColumn và cả hai cột đều chứa giá trị số, thì cột hình học điểm sẽ được tạo bằng các giá trị x,y trong hệ toạ độ được cung cấp trong "crs". Nếu để trống và "crs" không chỉ định hệ toạ độ chiếu, thì giá trị mặc định sẽ là "kinh độ". Nếu để trống và "crs" chỉ định hệ toạ độ chiếu, giá trị mặc định sẽ là "" và không có hình học điểm nào được tạo.

Cột hình học điểm được tạo sẽ có tên là {xColumn}_{yColumn}_N, trong đó N được thêm vào để {xColumn}_{yColumn}_N là duy nhất nếu cột có tên {xColumn}_{yColumn} đã tồn tại. Chỉ dành cho các nguồn CSV/TFRecord.

yColumn

string

Tên của cột toạ độ y dạng số để suy luận hình học của điểm. Nếu bạn cũng chỉ định xColumn và cả hai cột đều chứa giá trị số, thì cột hình học điểm sẽ được tạo bằng các giá trị x,y trong hệ toạ độ được cung cấp trong "crs". Nếu để trống và "crs" không chỉ định hệ toạ độ chiếu, giá trị mặc định sẽ là "vĩ độ". Nếu để trống và "crs" chỉ định hệ toạ độ chiếu, giá trị mặc định sẽ là "" và không có hình học điểm nào được tạo.

Cột hình học điểm được tạo sẽ có tên là {xColumn}_{yColumn}_N, trong đó N được thêm vào để {xColumn}_{yColumn}_N là duy nhất nếu cột có tên {xColumn}_{yColumn} đã tồn tại. Chỉ dành cho các nguồn CSV/TFRecord.

dateFormat

string

Định dạng để phân tích cú pháp các trường mã hoá ngày. Mẫu định dạng phải như mô tả tại http://joda-time.sourceforge.net/apidocs/org/joda/time/format/DateTimeFormat.html. Nếu để trống, ngày sẽ được nhập dưới dạng chuỗi. Chỉ dành cho các nguồn CSV/TFRecord.

csvDelimiter

string

Khi nhập tệp CSV, một ký tự duy nhất được dùng làm dấu phân cách giữa các giá trị cột trong một hàng. Nếu để trống, giá trị mặc định sẽ là ",". Chỉ dành cho nguồn CSV.

csvQualifier

string

Khi nhập tệp CSV, một ký tự bao quanh các giá trị cột (còn gọi là "ký tự ngoặc kép"). Nếu để trống, giá trị mặc định sẽ là "". Chỉ dành cho nguồn CSV.

Nếu giá trị cột không được đặt trong bộ hạn định, thì khoảng trắng ở đầu và cuối sẽ bị cắt bớt. Ví dụ: ..., kiểm thử,... <== giá trị này không đủ điều kiện trở thành giá trị chuỗi: "test" <== khoảng trắng bị xoá

trong đó: ...," kiểm thử",... <== giá trị này ĐƯỢC đủ điều kiện với dấu ngoặc kép sẽ trở thành giá trị chuỗi: " kiểm thử" <== khoảng trắng vẫn còn!