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 Owner atau Editor untuk project tersebut.
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 operasi pada set data.
Untuk mengetahui 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.Saat mengupload data dari Cloud Storage, tentukan jalur file ke resource yang berisi data dalam Cloud Storage. Jalur ini akan terlihat seperti
gs://GCS_BUCKET/FILE
.Pengguna yang mengajukan permintaan memerlukan peran Storage Object Viewer, atau peran lain yang mencakup izin
storage.objects.get
. Untuk mengetahui 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 dalam project Google Cloud Anda harus berbeda-beda.
- 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 500 MB.
- Nama kolom atribut tidak boleh diawali dengan string "?_".
- Geometri tiga dimensi tidak didukung. Ini mencakup akhiran "Z" dalam format WKT, dan koordinat ketinggian dalam format GeoJSON.
Praktik terbaik persiapan data
Jika data sumber Anda kompleks atau besar, seperti titik padat, linestring panjang, atau poligon (sering kali ukuran file sumber yang lebih besar dari 50 MB termasuk dalam kategori ini), pertimbangkan untuk menyederhanakan data Anda sebelum mengupload untuk mendapatkan performa terbaik dalam peta visual.
Berikut adalah beberapa praktik terbaik untuk menyiapkan data Anda:
- Meminimalkan properti fitur. Hanya simpan properti fitur yang diperlukan untuk menata gaya peta Anda, misalnya "id" dan "kategori". Anda dapat menggabungkan properti tambahan ke fitur di klien aplikasi Anda menggunakan gaya berbasis data pada kunci ID unik. Misalnya, lihat Lihat data Anda secara real time dengan Gaya visual berbasis data.
- Gunakan jenis data sederhana untuk objek properti jika memungkinkan, seperti bilangan bulat, untuk meminimalkan ukuran petak dan meningkatkan performa peta.
- Sederhanakan geometri kompleks sebelum mengupload file. Anda dapat melakukannya di alat geospasial pilihan Anda, seperti open source Mapshaper.org, atau di BigQuery menggunakan ST_Simplify pada geometri poligon yang kompleks.
- Buat cluster titik yang sangat padat sebelum mengupload file. Anda dapat melakukannya di alat geospasial pilihan Anda, seperti open source fungsi cluster turf.js, atau di BigQuery menggunakan ST_CLUSTERDBSCAN tentang geometri titik padat.
Lihat panduan tambahan tentang praktik terbaik set data di Visualisasikan data Anda dengan Set Data dan BigQuery.
Persyaratan GeoJSON
Maps SDK for Android mendukung Spesifikasi GeoJSON. Maps SDK for Android 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 beserta pasangan nama/nilai tambahan, yang memiliki arti khusus untuk aplikasi.
- Koleksi fitur. Koleksi fitur adalah sekumpulan objek fitur.
Maps SDK for Android tidak mendukung file GeoJSON yang memiliki data dalam sistem referensi koordinat (CRS) selain WGS84.
Untuk mengetahui informasi selengkapnya tentang GeoJSON, lihat Dokumen RFC 7946.
Persyaratan KML
Maps SDK for Android 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.
- 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
- Satu kolom 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 hanya boleh untuk 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 terpisah. - Nama kolom tidak peka huruf besar/kecil.
- Urutan nama kolom tidak akan memengaruhi apa pun. Misalnya, jika file CSV Anda berisi kolom
lat
danlong
, 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, atautype
bukan string. File data GeoJSON yang diupload harus berisi kolom string dengan namatype
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
- Satu kolom yang berisi semua informasi alamat, seperti
1600 Amphitheatre Parkway Mountain View, CA 94043
- Jika
x
dany
adalah kolom geometri Anda, pastikan bahwa unitnya adalah bujur dan lintang. Beberapa set data publik menggunakan sistem koordinat yang berbeda di bagian headerx
dany
. 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:
- Di Konsol Google Cloud, buka halaman Datasets.
- Klik Create Dataset.
- Masukkan nama set data. Nama untuk semua set data harus berbeda-beda.
- Secara opsional, masukkan Description set data.
- Klik Continue. Halaman Import data akan muncul.
- 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 bucket Google Cloud Storage, klik Browse, lalu pilih bucket dan file yang berisi data.
- Pilih File format.
- Klik Continue untuk meninjau setelan.
Klik Create. Halaman Datasets akan muncul yang menampilkan set data baru Anda. Statusnya harus Processing.
Jika data berhasil diupload:
- Status set data ditetapkan ke SELESAI.
- Set data menjadi “aktif” dan merupakan versi yang digunakan oleh aplikasi Anda.
Jika terjadi error saat mengupload:
- Status versi {i>dataset<i} baru diatur ke status selain SELESAI.
Melihat atau mengubah set data
Setelah membuat set data, Anda dapat melihat atau mengubah set data tersebut:
- Di Konsol Google Cloud, buka halaman Datasets.
- Klik nama set data. Halaman Dataset details akan muncul.
- Klik tab Details untuk melihat informasi tentang set data tersebut. Di tab ini, Anda juga dapat mengedit nama dan deskripsi set data.
- Klik tab Preview untuk melihat set data Anda di peta (set data dengan status SELESAI atau REVERTED).
- Klik tab Table Data untuk melihat semua atribut set data (set data dengan status SELESAI atau REVERTED). Berikut adalah atribut yang dapat Anda gunakan untuk menata gaya set data pada peta.
- Klik tombol Download untuk mendownload data ke file lokal.
- Klik tombol Delete untuk menghapus set data.
Klik tombol Import Data File untuk mengupload data baru ke set data.
Mengunggah data baru ke {i>dataset<i} akan menciptakan versi {i>dataset<i} baru. Jika data baru upload berhasil:
- Status versi baru set data ditetapkan ke SELESAI.
- Versi baru menjadi "aktif" dan merupakan versi yang digunakan oleh aplikasi Anda.
Jika terjadi error saat mengupload:
- Status versi {i>dataset<i} baru diatur ke status selain SELESAI. Misalnya, jika ada status "aktif" sebelumnya versi, status set data ditetapkan ke REVERTED.
- Sebelumnya "aktif" versi set data tetap sebagai "aktif" dan merupakan versi yang digunakan oleh aplikasi Anda.