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 |
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à Việc uỷ quyền yêu cầu quyền IAM sau đây trên tài nguyên
|
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 ( |
Trường | |
---|---|
tableManifest |
Tệp kê khai bảng. |
description |
Tên công việc mà con người đọc được. |
overwrite |
Cho phép ghi đè thành phần hiện có hay không. |
requestId |
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 |
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 ( |
Trường | |
---|---|
name |
Tên của thành phần sẽ được tạo. |
properties |
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 |
uriPrefix |
Tiền tố không bắt buộc được thêm vào tất cả |
sources[] |
Các nguồn tạo nên bảng này. |
startTime |
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ụ: |
endTime |
Đố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ụ: |
csvColumnDataTypeOverrides |
Thay vào đó, hãy sử dụng columnDataTypeOverrides. Một đối tượng chứa danh sách các cặp |
columnDataTypeOverrides |
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 |
memo |
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[] |
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 |
charset |
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 |
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 |
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 |
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 |
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 |
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 |
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" có 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 |
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" có 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 |
Đị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 |
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 |
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! |