Halaman ini diterjemahkan oleh Cloud Translation API.

Mendapatkan set data

Setelah membuat set data dan mengupload data ke dalamnya, Anda dapat menggunakan permintaan HTTP GET untuk mengakses set data tersebut. Halaman ini menjelaskan cara mencantumkan semua set data Anda, cara mendapatkan informasi tentang set data tertentu, dan cara mendownload data dari set data.

Tentang versi set data

Setelah upload data berhasil, status set data akan ditetapkan ke STATE_COMPLETED dan set data tersebut akan menjadi versi aktif. Artinya, set data siap digunakan di aplikasi Anda. Untuk menentukan state set data, Anda dapat mencantumkan semua set data atau mendapatkan set data tertentu.

Anda dapat mengupload data baru ke set data untuk membuat set data versi baru:

Jika upload data baru berhasil, versi baru akan menjadi versi "aktif" dan merupakan versi yang digunakan oleh aplikasi Anda.
Jika terjadi error saat upload, versi set data yang berhasil diupload sebelumnya akan tetap menjadi versi "aktif" dan merupakan versi yang digunakan oleh aplikasi Anda.

Untuk mengetahui informasi selengkapnya tentang cara membuat versi baru set data, lihat Mengupload data baru ke set data.

Mencantumkan semua set data

Mencantumkan semua set data dengan mengirim permintaan GET HTTP ke endpoint list datasets:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets

Permintaan ini menampilkan informasi tentang versi terbaru semua set data, terlepas dari apakah versi tersebut adalah versi aktif atau tidak. Jika Anda hanya ingin mencantumkan versi aktif setiap set data, tambahkan parameter kueri tag=active ke permintaan:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets?tag=active

Misalnya, panggilan ini menampilkan informasi tentang versi terbaru semua set data:

curl -X GET \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H 'Authorization: Bearer $TOKEN' \
"https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets"

Panggilan ini menampilkan respons dalam bentuk:

{
  "datasets": [
    {
      "name": "projects/PROJECT_NUMBER_OR_ID/datasets/f57074a0-a8b6-403e-9df1-e8a9e4f9fc46",
      "displayName": "My Test Dataset",
      "versionId": "5fb34e-1405-4ecd-8f81-31f1c07",
      "usage": [
        "USAGE_DATA_DRIVEN_STYLING"
      ],
      "gcsSource": {
        "inputUri": "gs://mybucket/my.csv",
        "fileFormat": "FILE_FORMAT_CSV"
      },
      "createTime": "2023-03-24T14:47:37.308977Z",
      "updateTime": "2023-03-24T14:48:05.053114Z",
      "versionCreateTime": "2023-03-24T14:48:05.053114Z",
      "status": {
        "state": "STATE_COMPLETED"
      }
    },
    {
      "name": "projects/PROJECT_NUMBER_OR_ID/datasets/2c8ae479-96704-89c6435ca959",
      "displayName": "My Other Test Dataset",
      "versionId": "0d2e3-b9da-47cc-819f-7ac67562",
      "usage": [
        "USAGE_DATA_DRIVEN_STYLING"
      ],
      "localFileSource": {
        "fileFormat": "FILE_FORMAT_CSV"
      },
      "createTime": "2023-03-24T14:41:52.579755Z",
      "updateTime": "2023-03-24T14:42:56.784122Z",
      "versionCreateTime": "2023-03-24T14:42:56.784122Z",
      "status": {
        "state": "STATE_COMPLETED"
      }
    }
  ]
}

Mendapatkan informasi tentang set data

Untuk mendapatkan informasi tentang set data tertentu, kirim permintaan HTTP GET ke endpoint get dataset yang juga mencakup ID set data:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID

Permintaan ini menampilkan informasi tentang versi terbaru set data, terlepas dari apakah versi tersebut adalah versi aktif. Jika Anda menginginkan informasi tentang versi aktif set data, tambahkan tag @active ke permintaan:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID@active

Contoh:

curl -X GET \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H 'Authorization: Bearer $TOKEN' \
"https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/f57074a0-a8b6-403e-9df1-e8a9e4f9fc46@active"

Permintaan ini menampilkan respons dalam bentuk:

{
  "name": "projects/PROJECT_NUMBER_OR_ID/datasets/f57074a0-a8b6-403e-9df1-e8a9e4f9fc46",
  "displayName": "My Test Dataset",
  "versionId": "5fb34e-1405-4ecd-8f81-31f1c07",
  "usage": [
    "USAGE_DATA_DRIVEN_STYLING"
  ],
  "gcsSource": {
    "inputUri": "gs://mybucket/my.csv",
    "fileFormat": "FILE_FORMAT_CSV"
  },
  "createTime": "2023-03-24T14:47:37.308977Z",
  "updateTime": "2023-03-24T14:48:05.053114Z",
  "versionCreateTime": "2023-03-24T14:48:05.053114Z",
  "status": {
    "state": "STATE_COMPLETED"
  }
}

Mendownload set data

Untuk mendownload data dari versi terbaru set data, kirim permintaan GET HTTP ke endpoint download dataset yang juga menyertakan ID set data:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID:download?alt=media