Mendapatkan set data

Setelah membuat set data dan mengupload data ke dalamnya, Anda dapat menggunakan permintaan GET HTTP untuk mengakses set data. Halaman ini menjelaskan cara menampilkan daftar semua set data, 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 ditetapkan ke STATE_COMPLETED dan set data tersebut menjadi versi aktif. Artinya, set data sudah 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 versi baru set data:

  • Jika data baru berhasil diupload, versi baru akan menjadi versi "aktif" dan merupakan versi yang digunakan oleh aplikasi Anda.

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

Untuk mengetahui informasi selengkapnya tentang cara membuat versi baru dari set data, baca bagian Mengupload data baru ke set data.

Mencantumkan semua set data

Cantumkan 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. Jika Anda hanya ingin menampilkan versi aktif dari 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 GET HTTP ke endpoint get dataset yang juga menyertakan ID set data:

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

Permintaan ini menampilkan informasi tentang versi set data terbaru, terlepas dari apakah versi tersebut adalah versi aktif. Jika Anda menginginkan informasi tentang versi set data yang aktif, 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"
  }
}

Mengunduh {i>dataset<i}

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

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

Contoh:

curl -X GET -L \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H 'Authorization: Bearer $TOKEN' \
--output LOCAL_LOCATION_TO_OUTPUT \
"https://mapsplatformdatasets.googleapis.com/download/v1/projects/PROJECT_NUMBER_OR_ID/datasets/f57074a0-a8b6-403e-9df1-e8a9e4f9fc46:download?alt=media"

Dalam contoh ini, Anda menggunakan opsi cURL --output untuk menentukan nama file yang menyimpan data yang didownload. Misalnya, tanda --output berikut menentukan untuk mendownload set data ke file bernama myjson.json di direktori yang sama dengan yang digunakan untuk menjalankan perintah cURL:

--output myjson.json

Atau, gunakan flag berikut untuk mendownload data ke myjson.json di direktori /tmp:

--output /tmp/myjson.json