Membuat wilayah peta kustom

Catatan: Di Looker 22.14, dukungan untuk file GeoJSON telah ditambahkan ke parameter map_layer.

Looker menyertakan beberapa lapisan peta bawaan, tetapi Anda juga dapat menentukan wilayah peta kustom untuk menampilkan data geografis. Misalnya Anda memiliki tabel usia rata-rata untuk tiga kawasan, yang ditampilkan di bawah ini:

Lingkungan Pelanggan	Usia Rata-Rata Pelanggan
pusat kota	19,5292
Eastside	54,4626
Westside	34,9534

Anda mungkin ingin memetakan Lingkungan Pelanggan ke wilayah geografis tertentu agar dapat divisualisasikan di peta. Untuk melakukannya, ikuti langkah-langkah yang dijelaskan di halaman ini.

Menyiapkan data wilayah

Untuk menyiapkan data region, Anda memerlukan file data yang berisi bentuk geografis setiap region dan juga berisi metadata yang mengaitkan region tersebut dengan data dalam database.

Looker menggunakan format yang disebut TopoJSON untuk menyimpan data ini secara ringkas. File TopoJSON dapat dibuat dengan mudah dari berbagai format shapefile umum, atau Anda dapat menggambarnya sendiri menggunakan fitur online, seperti yang dijelaskan dalam Postingan komunitas Mengonversi shapefile ke TopoJSON.

Untuk tujuan contoh ini, akan ada file TopoJSON yang disiapkan yang menyediakan pemetaan ini. Setiap region dalam file TopoJSON memiliki properti bernama neighborhood yang cocok dengan nilai kolom Customer Neighborhood, yang ditentukan dalam project LookML sebagai dimensi bernama neighborhood.

Upload data wilayah

Untuk mengimpor data wilayah ke Looker, Anda dapat menarik lalu melepas file TopoJSON ke bagian Browser File pada project. Data ini akan di-commit bersama kode LookML dan diperbarui seperti kode lainnya dalam project LookML.

Membuat lapisan peta

Setelah memiliki data wilayah di project, Anda perlu membuat lapisan peta dalam model LookML.

Anda dapat menambahkan definisi dalam file model menggunakan parameter map_layer:

map_layer: my_neighborhood_layer {
  file: "neighborhoods.topojson"
  property_key: "neighborhood"
}

Parameter file mereferensikan nama file dalam project yang berisi data region, dan property_key adalah properti set data yang ingin ditampilkan dalam Looker. Jika Anda tidak yakin apa kuncinya, cukup hapus kunci properti dan Looker akan mencoba memilih kunci yang sesuai.

Tips: Anda juga dapat menggunakan file TopoJSON yang dihosting di tempat lain secara online, dengan menetapkan url, bukan file di definisi lapisan:

map_layer: my_neighborhood_layer {
  url: "https://raw.githubusercontent.com/cooluser/JSON_Stuff/master/Neighborhoods.topoJSON"
  property_key: "neighborhood"
}

Mengaitkan lapisan peta dengan data

Satu-satunya hal yang harus dilakukan adalah mengaitkan dimensi neighborhood dalam tampilan dengan lapisan peta yang baru dibuat dengan menerapkan parameter map_layer_name.

dimension: neighborhood {
  sql: ${TABLE}.neighborhood ;;
  map_layer_name: my_neighborhood_layer
}
  

Tindakan ini akan memberi tahu Looker bahwa nilai dimensi ini dikaitkan dengan property_key yang diekspos oleh lapisan peta. Ini juga memberi tahu Looker bahwa data ini dapat ditampilkan di peta.

Melihat peta

Kueri yang menggunakan dimensi neighborhood kini dapat ditampilkan di peta dari halaman Eksplorasi: