Setelah membuat set data dan mengupload data ke set data tersebut, 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 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 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 sebagai 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
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 versi tersebut merupakan versi yang aktif atau tidak. 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 dari 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 dapatkan set data yang juga menyertakan ID set data:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID
Permintaan ini menampilkan informasi tentang set data versi terbaru,
terlepas dari apakah versi tersebut merupakan versi yang aktif atau tidak. 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 set data versi terbaru, 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 dalam 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