REST Resource: projects.datasets

Tài nguyên: Tập dữ liệu

Hình minh hoạ một tập dữ liệu của nền tảng bản đồ.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "displayName": string,
  "description": string,
  "versionId": string,
  "usage": [
    enum (Usage)
  ],
  "status": {
    object (Status)
  },
  "createTime": string,
  "updateTime": string,
  "versionCreateTime": string,
  "versionDescription": string,

  // Union field data_source can be only one of the following:
  "localFileSource": {
    object (LocalFileSource)
  },
  "gcsSource": {
    object (GcsSource)
  }
  // End of list of possible types for union field data_source.
}
Các trường
name

string

Tên tài nguyên, dự án/{project}/tập dữ liệu/{dataset_id}
displayName

string

Tên dễ đọc, hiển thị trong giao diện người dùng của bảng điều khiển .
description

string

Mô tả của tập dữ liệu này .
versionId

string

Mã phiên bản của tập dữ liệu.
usage[]

enum (Usage)

(Các) trường hợp sử dụng được chỉ định cho tập dữ liệu này.
status

object (Status)

Chỉ có đầu ra. Trạng thái của phiên bản tập dữ liệu này.
createTime

string (Timestamp format)

Chỉ có đầu ra. Thời điểm tập dữ liệu được tạo lần đầu tiên.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Chỉ có đầu ra. Thời điểm cập nhật siêu dữ liệu gần đây nhất.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
versionCreateTime

string (Timestamp format)

Chỉ có đầu ra. Thời điểm phiên bản tập dữ liệu này được tạo. (Việc này xảy ra khi nhập dữ liệu vào tập dữ liệu)

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
versionDescription

string

Chỉ có đầu ra. Mô tả cho phiên bản tập dữ liệu này. Giá trị này được cung cấp khi nhập dữ liệu vào tập dữ liệu.
Trường nhóm data_source. Thông tin chi tiết về nguồn dữ liệu của tập dữ liệu. data_source chỉ có thể là một trong những trạng thái sau đây:
localFileSource

object (LocalFileSource)

Một nguồn tệp cục bộ cho tập dữ liệu để tải lên một lần.
gcsSource

object (GcsSource)

Nguồn tệp Google Cloud Storage cho tập dữ liệu để tải lên một lần.

Cách sử dụng

Trường hợp sử dụng chỉ định vị trí dự kiến sử dụng dữ liệu để cung cấp thông tin về cách xử lý dữ liệu.

Enum
USAGE_UNSPECIFIED Chưa đặt cách sử dụng tập dữ liệu này.
USAGE_DATA_DRIVEN_STYLING Tập dữ liệu này sẽ được dùng để định kiểu dựa trên dữ liệu.

LocalFileSource

Thông tin chi tiết về nguồn dữ liệu khi đó là một tệp cục bộ.

Biểu diễn dưới dạng JSON 
{
  "filename": string,
  "fileFormat": enum (FileFormat)
}
Các trường
filename

string

Tên và đuôi tệp của tệp đã tải lên.
fileFormat

enum (FileFormat)

Định dạng của tệp đang được tải lên.

FileFormat

Định dạng của tệp đang được tải lên.

Enum
FILE_FORMAT_UNSPECIFIED Định dạng tệp chưa được chỉ định.
FILE_FORMAT_GEOJSON Tệp GeoJson.
FILE_FORMAT_KML Tệp KML.
FILE_FORMAT_CSV CSV xuống.

GcsSource

Thông tin chi tiết về nguồn dữ liệu khi nguồn dữ liệu đó nằm trong Google Cloud Storage.

Biểu diễn dưới dạng JSON 
{
  "inputUri": string,
  "fileFormat": enum (FileFormat)
}
Các trường
inputUri

string

URI dữ liệu nguồn. Ví dụ: gs://my_bucket/my_object.
fileFormat

enum (FileFormat)

Định dạng tệp của đối tượng Google Cloud Storage. Thông tin này chủ yếu được dùng để xác thực.

Trạng thái

Trạng thái của tập dữ liệu.

Biểu diễn dưới dạng JSON 
{
  "state": enum (State),
  "errorMessage": string
}
Các trường
state

enum (State)

Enum trạng thái cho trạng thái.
errorMessage

string

Thông báo lỗi cho biết lý do không thực hiện được. Giá trị này sẽ trống nếu tập dữ liệu không ở trạng thái không đạt.

Tiểu bang

Danh sách các trạng thái của tập dữ liệu.

Enum
STATE_UNSPECIFIED Chưa đặt trạng thái của tập dữ liệu này.
STATE_IMPORTING Dữ liệu đang được nhập vào một tập dữ liệu.
STATE_IMPORT_SUCCEEDED Đã nhập thành công dữ liệu vào tập dữ liệu.
STATE_IMPORT_FAILED Không nhập được dữ liệu vào tập dữ liệu.
STATE_DELETING Tập dữ liệu đang trong quá trình xoá.
STATE_DELETION_FAILED Trạng thái không xoá được. Trạng thái này thể hiện việc xoá tập dữ liệu không thành công. Bạn có thể thử xoá lại.
STATE_PROCESSING Dữ liệu đang được xử lý.
STATE_PROCESSING_FAILED Trạng thái xử lý không thành công. Trạng thái này cho biết rằng quá trình xử lý đã không thành công và có thể báo lỗi.
STATE_NEEDS_REVIEW Trạng thái này hiện không được sử dụng.
STATE_PUBLISHING Trạng thái phát hành. Trạng thái này cho biết rằng hệ thống đang phát hành nội dung.
STATE_PUBLISHING_FAILED Trạng thái không xuất bản được. Trạng thái này cho biết quá trình xuất bản không thành công. Bạn có thể thử xuất bản lại.
STATE_COMPLETED Trạng thái đã hoàn thành. Trạng thái này thể hiện rằng tập dữ liệu có thể được sử dụng trong một số trường hợp cụ thể.

Phương thức

create

 Tạo tập dữ liệu mới cho dự án được chỉ định.

delete

 Xoá tập dữ liệu được chỉ định .

get

 Lấy tập dữ liệu.

list

 Liệt kê tất cả tập dữ liệu của dự án được chỉ định.

patch

 Cập nhật siêu dữ liệu cho tập dữ liệu.