Mendapatkan set data

Setelah membuat set data dan mengupload data ke set data tersebut, Anda dapat menggunakan permintaan GET HTTP untuk mengakses {i>dataset<i}. Halaman ini menjelaskan cara menampilkan daftar semua {i>dataset<i} Anda, cara mendapatkan informasi tentang {i>dataset<i} tertentu, dan cara mengunduh data tersebut dari sebuah {i>dataset.<i}

Tentang versi set data

Setelah unggahan data berhasil, status {i>dataset<i} akan diatur ke STATE_COMPLETED dan set data tersebut akan menjadi versi aktif. Artinya, siap digunakan di aplikasi Anda. Untuk menentukan state set data, Anda dapat mencantumkan semua {i>dataset<i} atau mendapatkan {i>dataset<i} tertentu.

Anda dapat mengunggah data baru ke {i>dataset<i} untuk membuat versi baru dari {i>dataset<i}:

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

  • Jika ada error saat upload, versi set data sebelumnya yang berhasil tetap "aktif" dan merupakan versi yang digunakan oleh aplikasi Anda.

Untuk informasi selengkapnya tentang membuat versi baru dari {i>dataset<i}, lihat Upload data baru ke set data.

Mencantumkan semua set data

Tampilkan daftar semua set data dengan mengirim permintaan GET HTTP ke Endpoint daftar set data:

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

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

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

Misalnya, panggilan ini menampilkan informasi tentang versi terbaru dari semua {i>datasets<i}:

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 mendapatkan endpoint yang juga berisi ID set data:

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

Permintaan ini menampilkan informasi tentang versi terbaru {i>dataset<i}, terlepas dari apakah versinya adalah versi yang aktif atau tidak. Jika Anda menginginkan informasi tentang versi aktif set data, tambahkan tag @active ke bagian 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 set data versi terbaru, kirim GET HTTP permintaan ke download set data endpoint 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 yang menyimpan data yang diunduh. Misalnya, flag --output berikut menentukan untuk mengunduh kumpulan data ke file bernama myjson.json dalam direktori yang digunakan untuk menjalankan perintah cURL:

--output myjson.json

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

--output /tmp/myjson.json