Parameter Google Maps untuk dasbor LookML

Halaman ini menjelaskan parameter untuk membuat dan mengedit elemen dasbor LookML dari type: looker_google_map dengan parameter dasbor LookML dalam file dashboard.lkml.

Untuk mengetahui informasi tentang cara membuat diagram Google Maps melalui UI Looker, lihat halaman dokumentasi Opsi diagram Google Maps. Untuk mengetahui informasi tentang jenis kolom yang diperlukan untuk membuat diagram peta interaktif, lihat bagian Parameter kueri nanti di halaman ini.

Contoh penggunaan

N menunjukkan bahwa nilai numerik diperlukan. Tanda kutip tunggal menunjukkan teks deskriptif dan tidak boleh disertakan dalam kode aktif.


## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_google_map
height: N
width: N
top: N
left: N
row: N
col: N
refresh: N (seconds | minutes | hours | days)
note:
  text: 'note text'
  state: collapsed | expanded
  display: above | below | hover

## QUERY PARAMETERS
model: model_name
explore: explore_name
fields: [view_name.field_name, view_name.field_name, …]
dimensions: [view_name.field_name, view_name.field_name, …]
measures: [view_name.field_name, view_name.field_name, …]
sorts: [view_name.field_name asc | desc, view_name.field_name, …]
pivots: [view_name.field_name, view_name.field_name, …]
limit: N
column_limit: N
filters:
  view_name.field_name: 'looker filter expression'
listen:
  dashboard_filter_name: view_name.field_name
query_timezone: 'specific timezone' | user_timezone

## PLOT PARAMETERS
map_plot_mode: points | automagic_heatmap | heatmap | lines | areas
heatmap_gridlines: true | false
heatmap_gridlines_empty: true | false
heatmap_opacity: 'decimal number between 0 and 1'

## MAP PARAMETERS
map_tile_provider: light | light_no_labels | dark | dark_no_labels | satellite_streets |
                    satellite | streets | outdoors | traffic_day | traffic_night | minimal
map_position: fit_data | custom
map_latitude: 'latitude value'
map_longitude: 'longitude value'
map_zoom: N
map_scale_indicator: off | metric | imperial | metric_imperial
map_pannable: true | false
map_zoomable: true | false
show_view_names: true | false
show_legend: true | false
show_region_field: true | false
draw_map_labels_above_data: true | false

## POINT PARAMETERS
map_marker_type: circle | icon | circle_and_icon | none
map_marker_icon_name: default | airplane | ambulance | anchor | beaker | bell | bolt | briefcase |
                      building | camera | car | checkmark | coffee | comment | envelope | file |
                      gamepad | gavel | gift | glass | headphones | heart | house | key | leaf |
                      microphone | music | person | phone | restaurant | school | shopping_cart |
                      star | suitcase | taxi | tree | trophy | truck | university | wrench
map_marker_radius_mode: proportional_value | equal_to_value | fixed
map_marker_radius_fixed: N
map_marker_radius_min: N
map_marker_radius_max: N
map_marker_proportional_scale_type: linear | log
map_marker_units: meters | pixels
map_marker_color_mode: value | fixed
map_marker_color: ['color value']

## VALUE PARAMETERS
map_value_colors: ['one or more color values']
quantize_map_value_colors: true | false
reverse_map_value_colors: true | false
map_value_scale_clamp_min: N
map_value_scale_clamp_max: N

Definisi parameter

Nama Parameter Deskripsi
Parameter Dasar
name (untuk elemen) Membuat elemen
title (untuk elemen) Mengubah cara nama elemen ditampilkan kepada pengguna
type (untuk elemen) Menentukan jenis visualisasi yang akan digunakan dalam elemen
height (untuk elemen) Menentukan tinggi elemen dalam satuan tile_size untuk dasbor layout: tile dan layout: static
width (untuk elemen) Menentukan lebar elemen dalam satuan tile_size untuk dasbor layout: tile dan layout: static
top Menentukan posisi atas ke bawah elemen dalam satuan tile_size untuk dasbor layout: static
left Menentukan posisi kiri-ke-kanan elemen dalam satuan tile_size untuk dasbor layout: static
row Menentukan posisi atas ke bawah elemen dalam satuan baris untuk dasbor layout: newspaper
col Menentukan posisi kiri ke kanan elemen dalam satuan kolom untuk dasbor layout: newspaper
refresh (untuk elemen) Menetapkan interval untuk elemen agar diperbarui secara otomatis
note Memulai bagian LookML untuk menentukan catatan untuk elemen. Parameter ini memiliki subparameter text, state, dan display.
Parameter Kueri
model Menentukan model yang akan digunakan untuk kueri elemen
explore (untuk elemen) Menentukan Explore yang akan digunakan untuk kueri elemen
fields Menentukan kolom yang akan digunakan untuk kueri elemen. Ini dapat digunakan sebagai pengganti dimensions dan measures.
dimensions Menentukan dimensi yang akan digunakan untuk kueri elemen
measures Menentukan ukuran yang akan digunakan untuk kueri elemen
sorts Menentukan pengurutan yang akan digunakan untuk kueri elemen
pivots Menentukan dimensi yang harus di-pivot untuk digunakan dalam kueri elemen
limit Menentukan batas baris yang akan digunakan untuk kueri elemen
column_limit Menentukan batas kolom yang akan digunakan untuk kueri elemen
filters (untuk elemen) Menentukan filter yang tidak dapat diubah untuk kueri elemen
listen Menentukan filter yang dapat diubah untuk kueri elemen, jika filters (untuk dasbor) telah dibuat
query_timezone Menentukan zona waktu yang harus digunakan saat kueri dijalankan
Parameter Plot
map_plot_mode Menentukan cara data lokasi Anda diplot pada elemen type: looker_map
heatmap_gridlines Menambahkan batas di sekitar setiap garis petak yang digunakan untuk elemen peta panas
heatmap_gridlines_empty Untuk peta panas dengan heatmap_gridlines yang ditetapkan ke true, menampilkan garis batas di sekitar wilayah peta yang tidak memiliki data terkait
heatmap_opacity Menentukan opasitas warna yang digunakan dalam peta panas
Parameter Peta
map_tile_provider Menentukan jenis peta latar belakang dan apakah label peta ditampilkan
map_position Menentukan titik tengah dan tingkat zoom peta yang terlihat
map_latitude Menentukan lintang untuk peta dengan map_position yang ditetapkan ke custom
map_longitude Menentukan bujur untuk peta dengan map_position yang ditetapkan ke custom
map_zoom Menentukan zoom untuk peta dengan map_position yang ditetapkan ke custom
map_scale_indicator Menetapkan apakah skala peta akan ditampilkan dan jenis unit yang ditampilkan
map_pannable Menetapkan apakah pengguna dapat mengubah posisi peta dengan menariknya
map_zoomable Menetapkan apakah pengguna dapat memperbesar dan memperkecil peta
show_view_names Menetapkan apakah akan menampilkan nama tampilan bersama dengan nama kolom di tooltip peta
show_legend Menetapkan apakah legenda peta harus ditampilkan di kanan bawah visualisasi
show_region_field Menetapkan apakah akan menampilkan informasi wilayah di tooltip peta
draw_map_labels_above_data Menampilkan label peta di atas atau di bawah peta panas
Parameter Titik
map_marker_type Menentukan jenis titik yang ditampilkan di peta, untuk elemen dengan map_plot_mode yang ditetapkan ke points, lines, atau areas
map_marker_icon_name Menentukan jenis ikon yang akan ditampilkan di semua penanda peta, untuk elemen dengan map_marker_type yang ditetapkan ke icon atau circle_and_icon
map_marker_radius_mode Menetapkan cara penentuan ukuran lingkaran, untuk elemen dengan map_marker_type yang ditetapkan ke circle atau circle_and_icon
map_marker_radius_fixed Menetapkan radius tetap untuk diterapkan ke semua penanda peta, untuk elemen dengan map_marker_type yang ditetapkan ke circle atau circle_and_icon dan map_marker_radius_mode yang ditetapkan ke fixed
map_marker_radius_min Menetapkan radius minimum untuk lingkaran, untuk elemen dengan map_marker_radius_mode yang ditetapkan ke proportional_value
map_marker_radius_max Menetapkan radius maksimum untuk lingkaran, untuk elemen dengan map_marker_radius_mode yang ditetapkan ke proportional_value
map_marker_proportional_scale_type Menentukan apakah ukuran lingkaran didasarkan pada skala linear atau logaritmik, untuk elemen dengan map_marker_type yang ditetapkan ke circle atau circle_and_icon dan map_marker_radius_mode yang ditetapkan ke proportional_value
map_marker_units Menetapkan unit yang digunakan untuk radius lingkaran ke meters atau pixels, untuk elemen dengan map_marker_type yang ditetapkan ke circle atau circle_and_icon
map_marker_color_mode Menentukan apakah warna penanda peta bersifat tetap atau warna ditetapkan secara dinamis ke penanda berdasarkan nilai kueri yang mendasarinya
map_marker_color Menentukan satu warna untuk diterapkan ke semua penanda peta, untuk elemen dengan map_marker_color_mode yang ditetapkan ke fixed
Parameter Nilai
map_value_colors Menentukan warna titik peta, atau menentukan rentang warna yang akan digunakan jika Anda memberi kode warna sesuai dengan ukuran
quantize_map_value_colors Mengubah skala warna dari gradien halus menjadi hanya warna tertentu yang telah Anda tetapkan
reverse_map_value_colors Mengubah warna yang menunjukkan nilai tinggi dan rendah pada diagram, sehingga membalikkan gradasi warna
map_value_scale_clamp_min Menetapkan nilai minimum rentang warna
map_value_scale_clamp_max Menetapkan nilai maksimum rentang warna

Parameter dasar

Saat menentukan elemen dasbor LookML, Anda harus menentukan nilai setidaknya untuk parameter dasar name dan type. Parameter dasar lainnya, seperti title, height, dan width, memengaruhi tampilan dan posisi elemen di dasbor.

name

Bagian ini mengacu pada parameter name yang merupakan bagian dari elemen dasbor.

name juga dapat digunakan sebagai bagian dari filter dasbor, yang dijelaskan di halaman dokumentasi Parameter dasbor.

Setiap deklarasi name membuat elemen dasbor baru dan memberinya nama. Nama elemen harus unik. Nama terkadang direferensikan dalam parameter elements saat Anda menggunakan dasbor layout: grid, atau dalam parameter group elemen turunan saat Anda mengatur elemen ke dalam grup ubin (type: group).

- name: orders_by_date

title

Bagian ini mengacu pada parameter title yang merupakan bagian dari elemen dasbor.

title juga dapat digunakan sebagai bagian dari dasbor, yang dijelaskan di halaman dokumentasi Parameter dasbor.

title juga dapat digunakan sebagai bagian dari filter dasbor, yang dijelaskan di halaman dokumentasi Parameter dasbor.

Parameter title memungkinkan Anda mengubah cara nama elemen akan ditampilkan kepada pengguna. Jika tidak ditentukan, judul akan ditetapkan secara default ke elemen name.

Perhatikan contoh berikut:

- name: sales_overview
  title: '1) Sales Overview'

Jika Anda menggunakan format ini, elemen akan muncul sebagai 1) Sales Overview, bukan Sales Overview.

type

Bagian ini mengacu pada parameter type yang merupakan bagian dari elemen dasbor.

type juga dapat digunakan sebagai bagian dari filter dasbor, yang dijelaskan di halaman dokumentasi Parameter dasbor.

type juga dapat digunakan sebagai bagian dari join, yang dijelaskan di halaman dokumentasi parameter type (untuk join).

type juga dapat digunakan sebagai bagian dari dimensi, yang dijelaskan di halaman dokumentasi Jenis dimensi, filter, dan parameter.

type juga dapat digunakan sebagai bagian dari ukuran, yang dijelaskan di halaman dokumentasi Jenis ukuran.

Parameter type menentukan jenis visualisasi yang akan digunakan dalam elemen.

- name: element_name
  type: text | looker_grid | table | single_value | looker_single_record |
        looker_column | looker_bar | looker_scatter | looker_line | looker_area |
        looker_pie | looker_donut_multiples | looker_funnel | looker_timeline |
        looker_map | looker_google_map | looker_geo_coordinates | looker_geo_choropleth |
        looker_waterfall | looker_wordcloud | looker_boxplot | button | group

Lihat halaman dokumentasi type (untuk dasbor LookML) guna mengetahui ringkasan berbagai jenis elemen dasbor LookML.

height

Bagian ini mengacu pada parameter height yang merupakan bagian dari elemen dasbor.

height juga dapat digunakan sebagai bagian dari baris dasbor, yang dijelaskan di halaman dokumentasi Parameter dasbor.

Untuk dasbor dengan tata letak tile atau static

Parameter height menentukan tinggi elemen, dalam satuan tile_size (yang ditentukan dalam piksel), untuk dasbor layout: tile dan layout: static.

Misalnya, kode berikut menentukan tile_size: 100 dan height: 4, sehingga elemen orders_by_date memiliki tinggi 400 piksel.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    height: 4
    ...

Untuk dasbor dengan tata letak newspaper

Parameter height menentukan tinggi elemen, dalam satuan baris, untuk dasbor layout: newspaper.

Dasbor dengan tata letak surat kabar secara default memiliki tinggi elemen 6 baris, atau sekitar 300 piksel. Tinggi minimum adalah 1 baris untuk dasbor dengan parameter preferred viewer yang ditetapkan ke dashboards-next. Tinggi minimum adalah 2 baris untuk dasbor dengan parameter preferred viewer yang ditetapkan ke dashboards.

Misalnya, kode berikut menetapkan elemen menjadi setinggi 12 baris, atau dua kali lebih tinggi dari elemen lain yang ditetapkan ke default:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    height: 12
    ...

width

Bagian ini mengacu pada parameter width yang merupakan bagian dari elemen dasbor.

width juga dapat digunakan sebagai bagian dari dasbor, yang dijelaskan di halaman dokumentasi Parameter dasbor.

Parameter width menentukan lebar elemen, dalam satuan tile_size, untuk dasbor layout: tile dan layout: static.

Misalnya, kode berikut menentukan tile_size: 100 dan width: 4, sehingga elemen orders_by_date memiliki lebar 400 piksel.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    width: 4
    ...

Parameter width menentukan lebar elemen, dalam satuan kolom, untuk dasbor layout: newspaper.

Dasbor dengan tata letak koran memiliki lebar default 24 kolom.

Misalnya, kode berikut menetapkan elemen ke setengah lebar dasbor:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    width: 12
    ...

top

Parameter top menentukan posisi elemen dari atas ke bawah, dalam satuan tile_size, untuk dasbor layout: static.

Misalnya, kode berikut menentukan tile_size: 100 dan top: 4, yang memosisikan tepi atas elemen orders_by_date 400 piksel dari bagian atas dasbor.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    top: 4
    ...

left

Parameter left menentukan posisi kiri-ke-kanan elemen, dalam satuan tile_size, untuk dasbor layout: static.

Misalnya, kode berikut menentukan tile_size: 100 dan left: 4, yang memosisikan tepi kiri elemen orders_by_date 400 piksel dari sisi kiri dasbor.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    left: 4
    ...

row

Untuk dasbor layout: newspaper, parameter row menentukan baris tempat tepi atas elemen ditempatkan. Jika elemen ditempatkan di dalam grup kartu menggunakan parameter group, row akan menentukan posisi baris elemen relatif terhadap bagian atas penampung grup (row: 0).

Dasbor dimulai dengan baris 0 di bagian atas dasbor. Dasbor dengan tata letak surat kabar secara default memiliki tinggi elemen 6 baris, yang berarti elemen dasbor di bagian atas dasbor (row: 0) secara default akan menempati baris 0-5.

Setiap baris memiliki tinggi 50 piksel, yang berarti tinggi elemen default 6 baris adalah 300 piksel.

Misalnya, kode berikut menetapkan elemen yang akan ditetapkan pada baris elemen kedua di dasbor, dengan asumsi elemen ditetapkan pada tinggi default:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    row: 6
    ...

col

Untuk dasbor layout: newspaper, parameter col menentukan kolom tempat tepi kiri elemen ditempatkan. Jika elemen ditempatkan di dalam grup kartu menggunakan parameter group, col menentukan posisi kolom elemen relatif terhadap tepi kiri penampung grup (col: 0).

Dasbor dibagi menjadi 24 kolom. Dasbor dimulai dengan kolom 0 di sebelah kiri dasbor. Dasbor dengan tata letak surat kabar secara default memiliki lebar elemen 8 kolom, yang berarti elemen dasbor di sebelah kiri dasbor (col: 0) secara default akan menempati kolom 0-7.

Misalnya, kode berikut menetapkan elemen yang akan ditetapkan di kolom ketiga elemen di dasbor:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    col: 16
    ...

refresh

Bagian ini mengacu pada parameter refresh yang merupakan bagian dari elemen dasbor.

refresh juga dapat digunakan sebagai bagian dari dasbor, yang dijelaskan di halaman dokumentasi Parameter dasbor.

Parameter refresh memungkinkan elemen dimuat ulang secara otomatis secara berkala, sehingga mengambil data baru. Hal ini sering kali berguna dalam setelan yang menampilkan dasbor secara terus-menerus, seperti di TV kantor. Perhatikan bahwa dasbor harus dibuka di jendela browser agar parameter ini dapat diterapkan. Setelan ini tidak berjalan di latar belakang untuk "melakukan pra-pemanasan" cache dasbor.

Kecepatan refresh dapat berupa angka (tanpa desimal) detik, menit, jam, atau hari. Contoh:

- name: orders_by_date
  refresh: 2 hours

Berhati-hatilah saat menetapkan interval refresh yang singkat. Jika kueri di balik elemen memerlukan banyak resource, elemen tertentu dapat membebani database Anda lebih dari yang diinginkan.

note

Anda dapat menambahkan catatan deskriptif ke elemen seperti ini:

- name: element_name
  note:
    text: 'note text'
    state: collapsed | expanded
    display: above | below | hover

note memiliki subparameter text, state, dan display.

text

Subparameter text menentukan teks yang ditampilkan dalam catatan. Teks dapat dilokalkan.

state

Subparameter state menentukan apakah catatan akan collapsed atau expanded jika terlalu besar untuk muat dalam satu baris dalam lebar elemen. Jika Anda memilih collapsed dan catatan terlalu panjang, catatan akan diakhiri dengan elipsis yang dapat diklik (...) untuk membaca catatan lengkap.

display

Subparameter display menentukan tempat catatan ditampilkan pada elemen. above menempatkan catatan di bagian atas elemen, below menempatkannya di bagian bawah elemen, dan hover mengharuskan pengguna mengarahkan kursor ke elemen untuk melihat catatan.

Parameter kueri

Saat menentukan elemen dasbor LookML, Anda harus menentukan nilai setidaknya untuk parameter kueri model dan explore.

Untuk elemen dasbor LookML type: looker_google_map, Anda juga harus menentukan setidaknya satu kolom geografis sebagai nilai parameter dimensions atau fields. Kolom geografis dapat berupa salah satu dari berikut:

  • Dimensi berdasarkan data lintang dan bujur, yang ditentukan di LookML sebagai dimensi type: location.
  • Dimensi yang memiliki lapisan peta yang ditetapkan ke dimensi tersebut. Developer LookML dapat menambahkan lapisan peta bawaan atau lapisan peta kustom ke ukuran menggunakan parameter map_layer_name.
  • Dimensi kode pos. Wilayah kode pos didasarkan pada area tabulasi kode pos (ZCTA) tahun 2010. Jika Anda memvisualisasikan kode pos, mungkin tidak ada korespondensi satu per satu antara kode pos dan ZCTA yang digunakan untuk visualisasi peta, sehingga mungkin tidak semua titik akan divisualisasikan di peta.

Anda juga dapat menggunakan parameter kueri lain yang dijelaskan berikutnya untuk mengontrol cara data ditampilkan dalam elemen dasbor. Untuk mengetahui informasi selengkapnya tentang persyaratan untuk membuat diagram peta interaktif dengan UI Looker, lihat bagian Membuat diagram Google Maps di halaman dokumentasi Opsi diagram peta.

model

Parameter model menentukan model yang akan digunakan untuk kueri elemen. Jika tidak ditentukan, model akan ditetapkan secara default ke model tempat dasbor berada.

- name: orders_by_date
  model: ecommerce

Parameter model menerima konstanta LookML. Anda dapat menentukan konstanta dalam file manifes untuk project Anda, lalu menggunakan sintaksis "@{constant_name}" untuk menetapkan konstanta sebagai nilai untuk model. Dengan menggunakan konstanta, Anda dapat menentukan nama model di satu tempat, yang sangat berguna jika Anda memperbarui nama model yang digunakan oleh beberapa elemen dasbor.

Untuk mengetahui informasi selengkapnya dan contoh penggunaan konstanta dengan dasbor LookML, lihat halaman dokumentasi parameter constant.

explore

Bagian ini mengacu pada parameter explore yang merupakan bagian dari elemen dasbor.

explore juga dapat digunakan sebagai bagian dari model, yang dijelaskan di halaman dokumentasi parameter explore.

explore juga dapat digunakan sebagai bagian dari filter dasbor, yang dijelaskan di halaman dokumentasi Parameter dasbor.

Parameter explore menentukan Eksplorasi yang akan digunakan untuk kueri elemen.

- name: orders_by_date
  explore: order

Parameter explore menerima konstanta LookML. Anda dapat menentukan konstanta dalam file manifes untuk project Anda, lalu menggunakan sintaksis "@{constant_name}" untuk menetapkan konstanta sebagai nilai untuk explore. Dengan menggunakan konstanta, Anda dapat menentukan nama Eksplorasi di satu tempat, yang sangat berguna jika Anda memperbarui nama Eksplorasi yang digunakan oleh beberapa elemen dasbor.

Untuk mengetahui informasi selengkapnya dan contoh penggunaan konstanta dengan dasbor LookML, lihat halaman dokumentasi parameter constant.

fields

Parameter fields menentukan kolom yang akan digunakan untuk kueri elemen. Gunakan sintaksis view_name.dimension_name untuk menentukan kolom.

## single field example
- name: orders_by_date
  fields: order.order_date

## multiple fields example
- name: orders_by_date
  fields: [order.order_date, order.order_count]

Jika menggunakan parameter fields, Anda tidak perlu menggunakan parameter dimensions dan measures.

dimensions

Parameter dimensions menentukan dimensi yang akan digunakan untuk kueri elemen. Gunakan sintaksis view_name.dimension_name untuk menentukan dimensi. Jangan sertakan dimensions jika kueri tidak memilikinya.

## single dimension example
- name: orders_by_date
  dimensions: order.order_date

## multiple dimension example
- name: orders_by_date
  dimensions: [order.order_date, customer.name]

measures

Parameter measures menentukan ukuran yang akan digunakan untuk kueri elemen. Gunakan sintaksis view_name.measure_name untuk menentukan ukuran. Jangan sertakan measures jika kueri tidak memilikinya.

## single measure example
- name: orders_by_date
  measures: order.count

## multiple measure example
- name: orders_by_date
  measures: [order.count, order_item.count]

sorts

Parameter sorts menentukan perilaku pengurutan untuk kueri elemen. Cantumkan kolom pengurutan utama terlebih dahulu, diikuti dengan kolom pengurutan sekunder. Gunakan sintaksis view_name.field_name untuk menentukan dimensi atau ukuran yang akan diurutkan.

Jika Anda menghapus parameter sorts, elemen akan menggunakan urutan pengurutan default Looker. Pengurutan menaik tidak memerlukan akhiran, sedangkan pengurutan menurun memerlukan akhiran desc.

Contoh berikut menentukan satu pengurutan:

- name: orders_by_date
  sorts: order.order_date desc

Contoh berikut menentukan beberapa pengurutan:

- name: orders_by_date
  sorts: [order.order_date desc, customer.name]

Jika melakukan pivot dimensi, Anda dapat mengurutkan hasil kueri dengan menentukan nama ukuran, arah pengurutan, dan nomor indeks berbasis 0 dari kolom target dalam tabel data. Misalnya, elemen berikut mengurutkan berdasarkan kolom pivot pertama menggunakan indeks 0:

- name: orders_by_category
  sorts: [orders.count desc 0]

Untuk mengurutkan berdasarkan total baris, tentukan indeks kolom total. Misalnya, elemen berikut mengurutkan berdasarkan total baris menggunakan indeks 2, yang mewakili kolom total untuk kueri dengan dua kolom pivot:

- name: orders_by_cohort
  sorts: [users.count desc 2]

pivots

Parameter pivots menentukan dimensi yang harus di-pivot untuk kueri elemen. Gunakan sintaksis view_name.dimension_name untuk menentukan dimensi. Jangan sertakan pivots jika kueri tidak memilikinya.

## single pivot example
- name: orders_by_date
  pivots: customer.gender

## multiple pivot example
- name: orders_by_date
  pivots: [customer.gender, customer.age_tier]

limit

Parameter limit menentukan batas baris yang harus digunakan untuk kueri elemen. Batas ini berlaku untuk jumlah baris sebelum pivot diterapkan.

- name: orders_by_date
  limit: 100

column_limit

Parameter column_limit menentukan batas kolom yang harus digunakan untuk kueri elemen. Batas ini berlaku untuk jumlah kolom setelah pivot diterapkan.

- name: orders_by_date
  column_limit: 100

filters

Bagian ini mengacu pada parameter filters yang merupakan bagian dari elemen dasbor.

filters juga dapat digunakan sebagai bagian dari dasbor, yang dijelaskan di halaman dokumentasi Parameter dasbor.

filters juga dapat digunakan sebagai bagian dari ukuran, yang dijelaskan di halaman dokumentasi parameter filters.

Parameter filters menentukan filter yang tidak dapat diubah yang harus digunakan untuk kueri elemen. Jika Anda ingin filter yang dapat diubah pengguna di dasbor, Anda harus menyiapkan filter menggunakan filters untuk dasbor, lalu menerapkannya ke elemen menggunakan listen.

Sintaksis untuk filters adalah:

- name: element_name
  filters:
    orders.created_date: 2020/01/10 for 3 days
    orders.status: Shipped
    # You can create multiple filter statements

Setiap filter dapat menerima ekspresi filter Looker atau konstanta nilai. Anda juga dapat menggunakan variabel Liquid _localization atau _user_attributes dalam ekspresi filter untuk nilai filter yang fleksibel.

listen

Filter dasbor memungkinkan pelihat menyaring data yang ditampilkan dalam elemen dasbor secara interaktif. Tentukan filter dasbor dengan parameter filters untuk dasbor LookML. Kemudian, gunakan parameter listen untuk menautkan elemen dasbor ke filter dasbor.

Sintaksis untuk listen adalah sebagai berikut:

- name: element_name
  listen:
    filter_name_goes_here: dimension or measure on which to apply
                           the filter using view_name.field_name syntax
    # You can add more than one listen statement

Tambahkan parameter listen ke elemen, lalu berikan nama filter diikuti dengan titik dua dan referensi ke kolom yang akan diterapkan filter, menggunakan sintaksis view_name.field_name. Misalnya, Anda dapat membuat filter bernama Date yang mengharuskan pengguna memasukkan tanggal ke kolom filter di UI. Kemudian, Anda dapat menerapkan nilai yang dimasukkan pengguna ke elemen orders_by_date seperti ini:

- dashboard: sales_overview
  ...

  filters:
  - name: date
    type: date_filter

  elements:
 - name: orders_by_date
    listen:
      date: order.order_date
    ...

Jika filter yang dipantau dikonfigurasi dengan parameter vis_filter: true, kontrol filter akan muncul di panel filter langsung di bagian atas ubin visualisasi tersebut, bukan di panel filter dasbor atas.

Untuk contoh tambahan penggunaan parameter filters dan parameter listen untuk menerapkan filter dasbor ke elemen dasbor tertentu, lihat Membuat dasbor LookML.

query_timezone

Parameter query_timezone menentukan zona waktu tempat kueri akan dijalankan. Opsi zona waktu ditampilkan di halaman dokumentasi Nilai untuk timezone. Jika ingin kueri dijalankan menggunakan zona waktu pelihat, Anda dapat menetapkan nilainya sebagai user_timezone.

- name: orders_by_date
  query_timezone: America/Los Angeles
- name: orders_by_customer
  query_timezone: user_timezone

Parameter plot

Parameter yang dijelaskan di bagian ini sesuai dengan opsi di bagian Plot editor visualisasi untuk diagram peta.

Parameter yang dapat Anda gunakan dengan elemen type: looker_google_map bergantung pada apakah kueri Anda menyertakan dimensi type: location atau memiliki lapisan peta yang terkait dengannya.

map_plot_mode

Parameter map_plot_mode menentukan cara data Anda diplot pada elemen type: looker_google_map yang didasarkan pada dimensi type: location. Parameter ini tidak tersedia untuk peta berdasarkan dimensi dengan lapisan peta terkait atau untuk dimensi kode pos. Parameter map_plot_mode menerima nilai berikut:

points

Menetapkan map_plot_mode ke points akan memetakan setiap baris dalam tabel data pokok sebagai titik terpisah di peta.

Dimensi type: location saja akan menempatkan titik dengan ukuran dan warna yang seragam di peta. Menambahkan ukuran ke kueri memungkinkan titik diskalakan berdasarkan warna atau ukuran menggunakan parameter map_marker_radius_mode dan map_marker_color_mode.

automagic_heatmap

Menetapkan map_plot_mode ke automagic_heatmap akan menampilkan data dalam kueri pokok sebagai petak peta panas. Cara kerjanya adalah dengan membagi peta yang terlihat menjadi kotak-kotak yang sama, lalu menghitung nilai mana dalam data Anda yang sesuai dengan setiap kotak. Kotak-kotak tersebut diwarnai sesuai dengan ukuran yang Anda pilih. Memperbesar atau memperkecil peta ini akan meminta Looker untuk menghitung ulang petak, sehingga perinciannya sesuai dengan tingkat zoom.

Kueri Anda harus menyertakan dimensi type: location dan ukuran agar jenis plot ini berfungsi dengan benar.

heatmap

Menetapkan map_plot_mode ke heatmap akan menghasilkan peta yang dapat menampilkan data lokasi dalam jumlah besar dengan banyak titik yang dikelompokkan secara berdekatan. Intensitas warna dan skala warna menunjukkan konsentrasi titik data di setiap area.

Kueri Anda harus menyertakan dimensi type: location. Jika mau, Anda dapat menambahkan ukuran.

lines

Menetapkan map_plot_mode ke lines akan mengambil dua dimensi type: location dari kueri Anda dan menghubungkannya dalam visualisasi. Menambahkan ukuran ke kueri memungkinkan Anda menambahkan skala warna ke garis.

areas

Menetapkan map_plot_mode ke areas akan mengambil satu dimensi type: location dan menghubungkan semua titik sesuai urutan yang Anda tentukan. Tindakan ini akan membentuk batas area pada elemen peta. Menambahkan ukuran ke kueri memungkinkan Anda memformat ukuran dan warna setiap titik lokasi yang membentuk batas area.

heatmap_gridlines

Untuk elemen peta panas, menyetel heatmap_gridlines ke true akan menambahkan batas di sekitar setiap garis petak yang digunakan untuk peta panas. Parameter ini tersedia saat Anda memetakan dimensi type: location dengan map_plot_mode ditetapkan ke automagic_heatmap, atau saat Anda memetakan dimensi kode pos atau dimensi dengan lapisan peta terkait.


heatmap_gridlines: true | false

heatmap_gridlines_empty

Jika heatmap_gridlines ditetapkan ke true untuk elemen peta panas, dan Anda memetakan data dengan map_layer yang ditentukan, menetapkan heatmap_gridlines_empty ke true akan menampilkan garis batas di sekitar wilayah peta yang tidak memiliki data terkait.


heatmap_gridlines_empty: true | false

heatmap_opacity

Untuk elemen peta panas, Anda dapat menggunakan heatmap_opacity untuk menentukan opasitas warna yang digunakan dalam peta panas. Tentukan angka desimal antara 0 dan 1 sebagai nilai untuk heatmap_opacity, dengan 0 berarti tidak ada warna dan 1 berarti sepenuhnya buram.


heatmap_opacity: 0.5

Parameter peta

Sebagian besar parameter yang dijelaskan di bagian ini sesuai dengan opsi di bagian Opsi menu peta di editor visualisasi untuk diagram kolom.

map_tile_provider

Tersedia untuk semua peta, parameter map_tile_provider memungkinkan Anda mengubah jenis peta latar belakang dan menentukan apakah label peta (seperti kota dan jalan) ditampilkan.

  • light: Peta halus berwarna terang yang dirancang untuk memberikan konteks geografis sekaligus menyoroti data Anda
  • light_no_labels: Sama seperti light, kecuali peta menghilangkan label seperti nama kota
  • dark: Peta halus berwarna gelap yang dirancang untuk memberikan konteks geografis sekaligus menyoroti data Anda
  • dark_no_labels: Sama seperti dark, kecuali peta menghilangkan label seperti nama kota
  • satellite_streets: Peta yang menampilkan citra satelit dan udara global
  • satellite: Sama seperti satellite_streets, kecuali peta menghilangkan label seperti nama kota
  • streets: Peta tujuan umum yang menekankan gaya visual yang jelas untuk jaringan jalan dan transportasi umum
  • outdoors: Peta tujuan umum yang disesuaikan untuk hiking, bersepeda, dan penggunaan luar ruangan lainnya
  • traffic_day: Peta berwarna terang yang menekankan jaringan transportasi umum dan jalan, termasuk informasi lalu lintas saat ini
  • traffic_night: Peta berwarna gelap yang menekankan jaringan transportasi umum dan jalan, termasuk informasi lalu lintas saat ini
  • minimal: Peta berwarna terang tanpa label atau garis batas

map_tile_provider: light | light_no_labels | dark | dark_no_labels | satellite_streets |
                    satellite | streets | outdoors | traffic_day | traffic_night

map_position

Anda dapat menggunakan parameter map_position untuk menetapkan titik tengah dan tingkat zoom peta yang terlihat. Ada dua opsi untuk menentukan posisi ini:

  • fit_data: Memusatkan dan memperbesar peta secara otomatis sehingga semua titik data kueri Anda terlihat
  • custom: Memungkinkan Anda menentukan lintang, bujur, dan tingkat zoom secara manual menggunakan parameter map_latitude, map_longitude, dan map_zoom

map_position: fit_data | custom

map_latitude

Parameter map_latitude menentukan lintang untuk elemen peta dengan map_position yang ditetapkan ke custom.


map_latitude: -5.804047131379801

map_longitude

Parameter map_longitude menentukan bujur untuk elemen peta dengan map_position yang ditetapkan ke custom.


 map_longitude: 113.34732055664064

map_zoom

Parameter map_zoom memungkinkan Anda menentukan tingkat zoom untuk elemen peta dengan map_position yang ditetapkan ke custom. Angka yang lebih tinggi akan menghasilkan tingkat zoom yang lebih dekat.


map_zoom: 10

map_scale_indicator

Ditetapkan ke 'off' secara default, parameter map_scale_indicator memungkinkan Anda menentukan apakah skala peta ditampilkan dan menetapkan jenis unit yang ditampilkan.


map_scale_indicator: 'off' | metric | imperial | metric_imperial

map_pannable

Parameter map_pannable menentukan apakah pengguna dapat memosisikan ulang peta dengan menariknya. Opsi ini diaktifkan secara default.


map_pannable: true | false

map_zoomable

Parameter map_zoomable menentukan apakah pengguna dapat memperbesar dan memperkecil elemen peta. Opsi ini diaktifkan secara default.


map_zoomable: true | false

show_view_names

Parameter show_view_names menentukan apakah akan menampilkan nama tampilan beserta nama kolom di tooltip peta, yang ditampilkan saat pengguna mengklik titik data peta.


show_view_names: true | false

show_legend

Tentukan apakah legenda peta harus ditampilkan di kanan bawah visualisasi. Legenda menampilkan skala warna yang Anda gunakan, jika Anda telah menambahkan ukuran ke visualisasi.

Parameter show_legend tersedia jika opsi plot berikut telah ditentukan:


show_legend: true | false

show_region_field

Untuk peta berdasarkan lapisan peta atau kode pos, parameter show_region_field menampilkan informasi di tooltip peta. Pengguna dapat mengklik titik di peta untuk melihat nama wilayah.


show_region_field: true | false

draw_map_labels_above_data

Untuk peta lapisan peta atau peta berdasarkan dimensi kode pos, Anda dapat menggunakan parameter draw_map_labels_above_data untuk menampilkan label peta di atas atau di bawah peta panas. Hal ini sangat signifikan dengan nilai opasitas peta panas yang lebih tinggi. Jika peta panas Anda buram, label tidak akan terlihat kecuali jika ditampilkan di atas data.


draw_map_labels_above_data: true | false

Parameter titik

Opsi titik tidak tersedia untuk peta dengan map_plot_mode yang ditetapkan ke automagic_heatmap atau heatmap.

map_marker_type

Untuk peta berdasarkan dimensi lokasi dan dengan map_plot_mode yang ditetapkan ke points, lines, atau areas, parameter map_marker_type menentukan jenis titik yang ditampilkan di elemen peta. Parameter map_marker_type menerima nilai berikut:

  • circle
  • icon
  • circle_and_icon
  • none

Nilai yang Anda tentukan untuk map_marker_type akan memengaruhi parameter yang tersedia untuk memformat titik yang ditampilkan di peta.

map_marker_icon_name

Jika map_marker_type ditetapkan ke icon atau circle_and_icon, Anda dapat menggunakan parameter map_marker_icon_name untuk menetapkan jenis ikon yang akan ditampilkan di semua penanda peta.


map_marker_icon_name: default | airplane | ambulance | anchor | beaker | bell | bolt | briefcase |
                      building | camera | car | checkmark | coffee | comment | envelope | file |
                      gamepad | gavel | gift | glass | headphones | heart | house | key | leaf |
                      microphone | music | person | phone | restaurant | school | shopping_cart |
                      star | suitcase | taxi | tree | trophy | truck | university | wrench

map_marker_radius_mode

Untuk peta dengan map_marker_type yang ditetapkan ke circle atau circle_and_icon, Anda dapat menggunakan parameter map_marker_radius_mode untuk menetapkan ukuran lingkaran sesuai dengan opsi berikut:

  • proportional_value: Opsi ini menyesuaikan ukuran relatif lingkaran sesuai dengan ukuran yang telah Anda tambahkan ke kueri. Anda dapat menggunakan parameter map_marker_radius_min dan map_marker_radius_max dengan opsi ini untuk menetapkan radius minimum dan radius maksimum untuk lingkaran. Anda juga dapat menggunakan parameter map_marker_proportional_scale_type untuk menetapkan apakah skala linear atau logaritmik digunakan untuk mengukur lingkaran.
  • equal_to_value: Setelan ini menyesuaikan radius lingkaran dengan nilai ukuran sebenarnya dalam kueri pokok Anda.
  • fixed: Opsi ini memungkinkan Anda menetapkan radius tetap untuk diterapkan ke semua penanda peta menggunakan parameter map_marker_radius_fixed. Nilai defaultnya adalah 500.

map_marker_radius_mode: proportional_value | equal_to_value | fixed

map_marker_radius_fixed

Jika map_marker_radius_mode ditetapkan ke fixed dan map_marker_type ditetapkan ke circle atau circle_and_icon, Anda dapat menggunakan parameter map_marker_radius_fixed untuk menetapkan radius tetap yang berlaku untuk semua penanda peta.


map_marker_type: circle
map_marker_radius_mode: fixed
map_marker_radius_fixed: 60

map_marker_radius_min

Untuk peta dengan map_marker_type yang ditetapkan ke circle atau circle_and_icon dan map_marker_radius_mode yang ditetapkan ke proportional_value, Anda dapat menggunakan parameter map_marker_radius_min untuk menentukan radius minimum untuk lingkaran.


map_marker_type: circle
map_marker_radius_mode: proportional_value
map_marker_radius_min: 5

map_marker_radius_max

Untuk peta dengan map_marker_type yang ditetapkan ke circle atau circle_and_icon dan map_marker_radius_mode yang ditetapkan ke proportional_value, Anda dapat menggunakan parameter map_marker_radius_max untuk menentukan radius maksimum lingkaran.


map_marker_type: circle
map_marker_radius_mode: proportional_value
map_marker_radius_max: 50

map_marker_proportional_scale_type

Untuk peta dengan map_marker_type yang ditetapkan ke circle atau circle_and_icon dan map_marker_radius_mode yang ditetapkan ke proportional_value, Anda dapat menggunakan parameter map_marker_proportional_scale_type untuk menetapkan ukuran lingkaran berdasarkan skala linear atau logaritmik. Nilai parameter ini dapat berupa linear atau log.


map_marker_radius_mode: proportional_value
map_marker_proportional_scale_type: linear | log

map_marker_units

Untuk peta dengan map_marker_type yang ditetapkan ke circle atau circle_and_icon, Anda dapat menggunakan parameter map_marker_units untuk menetapkan unit yang digunakan untuk radius lingkaran ke meters atau pixels.


map_marker_units: meters | pixels

map_marker_color_mode

Anda dapat menggunakan map_marker_color_mode untuk menetapkan warna penanda peta:

  • Jika map_marker_color_mode ditetapkan ke value, warna akan ditetapkan secara dinamis ke penanda berdasarkan nilai kueri pokok Anda. Anda dapat menggunakan parameter nilai guna mengonfigurasi warna dalam legenda untuk opsi ini.
  • Jika map_marker_color_mode ditetapkan ke fixed, Anda dapat menggunakan parameter map_marker_color untuk menetapkan satu warna yang akan digunakan untuk semua penanda peta.

map_marker_color

Jika map_marker_color_mode ditetapkan ke fixed, map_marker_color_mode akan menetapkan satu warna untuk digunakan di semua penanda peta. Nilai warna dapat diformat sebagai string hex RGB, seperti 2ca6cd, atau sebagai nama warna CSS seperti mediumblue.


map_marker_color: [mediumblue]

Parameter nilai

Anda dapat menggunakan parameter ini untuk mengonfigurasi warna yang akan ditetapkan secara dinamis ke penanda berdasarkan nilai kueri pokok saat map_marker_color_mode ditetapkan ke value, atau untuk elemen peta dengan map_plot_mode ditetapkan ke automagic_heatmap, heatmap lines, atau areas.

map_value_colors

Anda dapat menggunakan parameter map_value_colors untuk menetapkan warna titik peta atau, jika Anda memberi kode warna sesuai dengan ukuran, untuk menentukan rentang warna yang akan digunakan. Anda dapat memasukkan daftar string hex, seperti #2ca6cd, atau nama warna CSS, seperti mediumblue. Warna yang Anda cantumkan pertama kali dikaitkan dengan nilai terendah.


map_value_colors: [green, mediumblue]

quantize_map_value_colors

Jika ditetapkan ke true, quantize_map_value_colors akan mengubah skala warna dari gradien halus menjadi hanya warna tertentu yang telah Anda tetapkan. Parameter ini ditetapkan ke false secara default.


quantize_map_value_colors: true | false

reverse_map_value_colors

Jika ditetapkan ke true, parameter reverse_map_value_colors akan mengubah warna yang menunjukkan nilai tinggi dan rendah pada diagram, sehingga membalikkan gradasi warna.


reverse_map_value_colors: true | false

map_value_scale_clamp_min

Anda dapat menggunakan parameter map_value_scale_clamp_min untuk menetapkan nilai minimum rentang warna. Dengan begitu, Anda dapat memberi kode warna pada semua titik di bawah nilai minimum tertentu (angka yang ditentukan) dengan warna terendah yang ditentukan dengan parameter map_value_colors. Secara default, nilai minimum yang diterapkan pada legenda adalah nilai minimum dari kueri Anda.


map_value_scale_clamp_min: 1000

map_value_scale_clamp_max

Anda dapat menggunakan parameter map_value_scale_clamp_max untuk menetapkan nilai maksimum rentang warna, yang memungkinkan Anda memberi kode warna pada semua titik di atas angka yang ditentukan dengan warna tertinggi yang ditentukan dengan parameter map_value_colors. Secara default, nilai maksimum yang diterapkan pada legenda adalah nilai maksimum dari kueri Anda.


map_value_scale_clamp_max: 50000