Membuat dan mengelola set data

Produk atau fitur ini ada dalam Pratinjau (pra-GA). Produk dan fitur pra-GA mungkin memiliki dukungan terbatas, dan perubahan pada produk serta fitur pra-GA mungkin tidak kompatibel dengan versi pra-GA lainnya. Penawaran Pra-GA tercakup dalam Persyaratan Khusus Layanan Google Maps Platform. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Dengan set data, Anda dapat mengupload data geospasial dari file lokal atau dari Google Cloud Storage ke Google Maps Platform. Selanjutnya, Anda dapat mengaitkan set data dengan satu atau beberapa gaya peta di Konsol Cloud. Setelah mengaitkan set data dengan gaya peta, gunakan API untuk gaya visual berbasis data untuk menata gaya aplikasi peta Anda secara dinamis.

Anda juga dapat menggunakan REST API untuk mengupload data geospasial Anda ke set data. Untuk informasi selengkapnya, lihat Maps Datasets API

Mengonfigurasi peran

Untuk membuat dan mengelola set data dalam project Google Cloud, Anda harus memiliki peran IAM Pemilik atau Editor untuk project tersebut.

Catatan: Jika Anda pernah membuat project, berarti Anda memiliki peran Pemilik untuk project tersebut. Halaman IAM di Konsol Google Cloud menampilkan pemilik dan editor project.

Atau, Anda dapat menetapkan peran IAM berikut ke akun pengguna atau akun layanan yang Anda gunakan untuk mengelola set data:

• Peran Maps Platform Datasets Admin memberikan akses baca/tulis ke set data dalam project kepada pengguna atau akun layanan. Peran ini memungkinkan pengguna melakukan semua operasi pada set data.
• Peran Maps Platform Datasets Viewer memberikan akses hanya baca ke set data dalam project. Peran ini memungkinkan Anda mencantumkan, mendapatkan, atau mendownload set data.

Untuk informasi selengkapnya, lihat Memberikan peran IAM dengan menggunakan Konsol Google Cloud.

Sumber data untuk set data

Setelah Anda membuat set data, upload data ke set data dari Google Cloud Storage atau dari file lokal.

Catatan: Anda hanya dapat mengupload data ke set data satu kali. Artinya, setelah menjalankan permintaan untuk mengupload data dari Cloud Storage atau dari file lokal, Anda tidak dapat mengupload data lagi ke set data yang sama. Jika terjadi error selama upload, Anda harus membuat ulang set data dan mencoba mengupload lagi.

• Saat mengupload data dari Cloud Storage, tentukan jalur file ke resource yang berisi data dalam Cloud Storage. Jalur ini dalam bentuk gs://GCS_BUCKET/FILE.

  Pengguna yang mengajukan permintaan memerlukan peran Storage Object Viewer, atau peran lain yang mencakup izin storage.objects.get. Untuk informasi selengkapnya tentang pengelolaan akses ke Cloud Storage, lihat Ringkasan kontrol akses.

• Saat mengupload data dari file lokal, tentukan jalur ke file GeoJSON, KML, atau CSV yang berisi data yang akan diupload.

Prasyarat

Saat membuat set data:

• Nama tampilan harus unik dalam project Google Cloud Anda.
• Nama tampilan harus kurang dari 64 byte (Karena karakter ini direpresentasikan dalam UTF-8, dalam beberapa bahasa, setiap karakter dapat direpresentasikan oleh beberapa byte).
• Deskripsi harus kurang dari 1000 byte.

Saat mengupload data:

• Jenis file yang didukung adalah CSV, GeoJSON, dan KML.
• Ukuran file maksimum yang didukung adalah 350 MB.
• Nama kolom atribut tidak boleh diawali dengan string "?_".
• Geometri tiga dimensi tidak didukung. Geometri 3D ini mencakup akhiran "Z" dalam format WKT, dan koordinat ketinggian dalam format GeoJSON.

Catatan: Bergantung pada ukuran file data, proses upload dapat memerlukan waktu beberapa menit atau bahkan jam. Jika terjadi error pada proses upload, Anda akan menerima pesan error. Jangan mencoba menghapus set data hingga ada respons dari operasi upload.

Tips: Jika file data Anda berukuran besar dan memiliki banyak atribut yang tidak diperlukan untuk penataan gaya, dan Anda ingin mengoptimalkan performa rendering, edit file data tersebut untuk menghapus atribut yang tidak diperlukan. Mengurangi jumlah atribut akan mengurangi ukuran ubin peta, sehingga meningkatkan performa rendering.

Persyaratan GeoJSON

Maps JavaScript API mendukung spesifikasi GeoJSON saat ini. Maps JavaScript API juga mendukung file GeoJSON yang berisi salah satu jenis objek berikut:

• Objek geometri. Objek geometri adalah bentuk spasial, yang digambarkan sebagai gabungan titik, garis, dan poligon dengan lubang opsional.
• Objek fitur. Objek fitur berisi geometri plus pasangan nama/nilai tambahan, yang memiliki arti khusus untuk aplikasi.
• Koleksi fitur. Koleksi fitur adalah sekumpulan objek fitur.

Maps JavaScript API tidak mendukung file GeoJSON yang memiliki data dalam sistem referensi koordinat (CRS) selain WGS84.

Untuk informasi selengkapnya tentang GeoJSON, lihat mematuhi RFC 7946.

Persyaratan KML

Maps JavaScript API memiliki persyaratan berikut:

• Semua URL harus bersifat lokal (atau relatif) terhadap file tersebut.
• Geometri titik, garis, dan poligon didukung.
• Semua atribut data dianggap sebagai string.

Fitur KML berikut tidak didukung:

• Ikon atau <styleUrl> yang ditentukan di luar file.
• Network link, seperti <NetworkLink>
• Overlay bumi, seperti <GroundOverlay>
• Geometri 3D atau tag terkait ketinggian seperti <altitudeMode>
• Spesifikasi kamera seperti <LookAt>
• Gaya yang ditentukan di dalam file KML.

Persyaratan CSV

Untuk file CSV, nama kolom yang didukung tercantum di bawah ini sesuai urutan prioritas:

• latitude, longitude
• lat, long
• x, y
• wkt (Well-Known Text)
• address, city, state, zip
• address
• Kolom tunggal yang berisi semua informasi alamat, seperti 1600 Amphitheatre Parkway Mountain View, CA 94043

Misalnya, file Anda berisi kolom bernama x, y, dan wkt. Karena x dan y memiliki prioritas yang lebih tinggi, sebagaimana ditentukan oleh urutan nama kolom yang didukung dalam daftar di atas, nilai dalam kolom x dan y akan digunakan dan kolom wkt akan diabaikan.

Selain itu:

• Setiap nama kolom harus dimiliki oleh satu kolom. Artinya, Anda tidak dapat memiliki kolom bernama xy yang berisi data koordinat x dan y. Koordinat x dan y harus berada dalam kolom yang terpisah.
• Nama kolom tidak peka huruf besar/kecil.
• Urutan nama kolom tidak menjadi masalah. Misalnya, jika file CSV Anda berisi kolom lat dan long, keduanya dapat muncul dalam urutan apa pun.

Menangani error upload data

Saat mengupload data ke set data, Anda mungkin mengalami salah satu error umum yang dijelaskan di bagian ini.

Error GeoJSON

Error GeoJSON umum mencakup:

• Kolom type tidak ada, atau type bukan string. File data GeoJSON yang diupload harus berisi kolom string dengan nama type sebagai bagian dari definisi Objek fitur dan Objek geometri masing-masing.

Error KML

Error KML umum mencakup:

• File data tidak boleh berisi salah satu fitur KML yang tidak didukung yang tercantum di atas. Jika tidak, impor data mungkin akan gagal.

Error CSV

Error CSV umum mencakup:

• Beberapa baris tidak memiliki nilai untuk kolom geometri. Semua baris dalam file CSV harus berisi nilai yang tidak kosong untuk kolom geometri. Kolom geometri mencakup:
  • latitude, longitude
  • lat, long
  • x, y
  • wkt
  • address, city, state, zip
  • address
  • Kolom tunggal yang berisi semua informasi alamat, seperti 1600 Amphitheatre Parkway Mountain View, CA 94043
  Catatan: Error ini sering kali dijelaskan dalam pesan "Unable to convert ' ' to a double" atau "Could not parse input to geography: Geography value is missing".
• Jika x dan y adalah kolom geometri Anda, pastikan bahwa unitnya adalah bujur dan lintang. Beberapa set data publik menggunakan sistem koordinat yang berbeda di bawah header x dan y. Jika unit yang salah digunakan, set data mungkin berhasil diimpor, tetapi data yang dirender dapat menampilkan titik set data di lokasi yang tidak terduga.

Membuat set data

Untuk membuat set data:

1. Di Konsol Google Cloud, buka halaman Datasets.
2. Klik Create Dataset.
3. Masukkan nama set data. Nama harus unik di antara semua set data.
4. Secara opsional, masukkan Description set data.
5. Klik Continue. Halaman Import data akan muncul.
6. Pilih Upload source data yang digunakan untuk mengisi set data sebagai Desktop, artinya file lokal di sistem Anda, atau Google Cloud Storage bucket.
   • Untuk Desktop, klik Browse, lalu pilih file dari pemilih file.
   • Untuk Google Cloud Storage bucket, klik Browse, lalu pilih bucket dan file yang berisi data.
7. Pilih File format.
8. Klik Continue untuk meninjau setelan.
9. Klik Create. Halaman Datasets akan muncul yang menampilkan set data baru Anda. Statusnya harus Processing.
10. Tunggu hingga set data Anda berstatus Completed.

Melihat atau mengubah set data

Setelah berhasil membuat set data, statusnya akan muncul sebagai Completed. Anda kemudian dapat memeriksa detail set data.

Untuk melihat set data:

1. Di Konsol Google Cloud, buka halaman Datasets.
2. Klik nama set data. Halaman Dataset details akan muncul.
   1. Klik tab Details untuk melihat informasi tentang set data. Di tab ini, Anda juga dapat mengedit nama dan deskripsi set data.
   2. Klik tab Preview untuk melihat set data Anda di peta.
   3. Klik tab Table Data untuk melihat subkumpulan data yang terkait dengan set data.
   4. Klik tombol Download untuk mendownload data ke file lokal.
   5. Klik tombol Delete untuk menghapus set data.