Parameter peta untuk dasbor LookML

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

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

Contoh penggunaan

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


## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_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 | lines | areas
heatmap_gridlines: true | false
heatmap_gridlines_empty: true | false
heatmap_opacity: '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
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 elemen kiri-ke-kanan dalam satuan tile_size untuk dasbor layout: static
row Menentukan posisi elemen dari atas ke bawah dalam satuan baris untuk dasbor layout: newspaper
col Menentukan posisi elemen dari kiri ke kanan dalam satuan kolom untuk dasbor layout: newspaper
refresh (untuk elemen) Menetapkan interval saat elemen akan 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 Eksplorasi yang akan digunakan untuk kueri elemen
fields Menentukan kolom yang akan digunakan untuk kueri elemen. Hal 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 keburaman 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 garis 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 ukuran lingkaran ditentukan, untuk elemen dengan map_marker_type yang ditetapkan ke circle atau circle_and_icon
map_marker_radius_fixed Menetapkan radius tetap yang akan 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 satuan 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 tetap atau warna ditetapkan secara dinamis ke penanda berdasarkan nilai kueri pokok
map_marker_color Menentukan satu warna yang akan 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 mengodekan warna menurut ukuran
quantize_map_value_colors Mengubah skala warna dari gradien halus menjadi hanya warna tertentu yang telah Anda tetapkan
reverse_map_value_colors Mengganti warna yang menunjukkan nilai tinggi dan rendah pada diagram, membalikkan gradien 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 untuk setidaknya 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 menetapkan nama untuknya. Nama elemen harus unik. Nama terkadang direferensikan dalam parameter elements saat Anda menggunakan dasbor layout: grid.

- 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, bukan elemen yang muncul sebagai Ringkasan Penjualan, elemen tersebut akan muncul sebagai 1) Ringkasan Penjualan.

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 gabungan, yang dijelaskan di halaman dokumentasi parameter type (untuk gabungan).

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 pengukuran, yang dijelaskan di halaman dokumentasi Jenis pengukuran.

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

Lihat halaman dokumentasi type (untuk dasbor LookML) untuk 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 koran 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 tinggi elemen menjadi 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 secara default memiliki lebar 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, 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 elemen dari kiri ke kanan, 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.

Dasbor dimulai dengan baris 0 di bagian atas dasbor. Dasbor dengan tata letak koran 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 untuk ditempatkan di baris kedua elemen 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.

Dasbor dibagi menjadi 24 kolom. Dasbor dimulai dengan kolom 0 di sebelah kiri dasbor. Dasbor dengan tata letak koran 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 berdasarkan periode tertentu, sehingga mengambil data baru. Hal ini sering kali berguna dalam setelan saat dasbor ditampilkan 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 "memanaskan" 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 menyetel interval pemuatan ulang singkat. Jika kueri di balik elemen tersebut menggunakan 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 dimuat dalam satu baris dalam lebar elemen. Jika Anda memilih collapsed dan catatan terlalu panjang, catatan akan diakhiri dengan elipsis yang dapat diklik (...) yang dapat digunakan 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 mouse ke elemen untuk melihat catatan.

Parameter kueri

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

Untuk elemen dasbor LookML type: looker_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 dengan lapisan peta yang ditetapkan padanya. 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-ke-satu antara kode pos dan ZCTA yang digunakan untuk visualisasi peta, sehingga tidak semua titik akan divisualisasikan dalam peta.

Anda dapat menggunakan parameter kueri lainnya 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 peta interaktif di halaman dokumentasi Opsi diagram peta.

model

Parameter model menentukan model yang akan digunakan untuk kueri elemen. Jika tidak ditentukan, nilai defaultnya adalah model tempat dasbor berada.

- name: orders_by_date
  model: ecommerce

Parameter model menerima konstanta LookML. Anda dapat menentukan konstanta dalam file manifes untuk project, 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, 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 pengurutan yang akan digunakan untuk kueri elemen. Pengurutan utama dicantumkan terlebih dahulu, lalu pengurutan sekunder, dan seterusnya. Gunakan sintaksis view_name.field_name untuk menentukan dimensi atau ukuran. Jangan sertakan sorts jika Anda ingin menggunakan urutan pengurutan default Looker. Pengurutan menurun memiliki akhiran desc; pengurutan menaik tidak memerlukan akhiran.

## single sort example
- name: orders_by_date
  sorts: order.order_date desc

## multiple sort example
- name: orders_by_date
  sorts: [order.order_date desc, customer.name]

pivots

Parameter pivots menentukan dimensi yang harus diputar 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 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 pengukuran, yang dijelaskan di halaman dokumentasi parameter filters.

Parameter filters menentukan filter yang tidak dapat diubah yang harus digunakan untuk kueri elemen. Jika Anda menginginkan 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 yang diikuti dengan titik dua dan referensi ke kolom tempat filter harus diterapkan, menggunakan sintaksis view_name.field_name. Misalnya, Anda dapat membuat filter bernama Tanggal yang mengharuskan pengguna memasukkan tanggal ke dalam 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
    ...

Untuk contoh tambahan penggunaan parameter filters dan parameter listen untuk menerapkan filter dasbor ke setiap elemen dasbor, lihat Membangun 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 nilai 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_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_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 dengan sendirinya menempatkan titik-titik berukuran dan warna seragam di peta. Dengan menambahkan ukuran ke kueri, titik dapat 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. Fitur ini berfungsi dengan membagi peta yang terlihat menjadi kotak yang sama dan kemudian menghitung nilai mana dalam data Anda yang sesuai dengan setiap kotak. Kotak diwarnai sesuai dengan ukuran yang Anda pilih. Memperbesar atau memperkecil peta ini akan meminta Looker 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.

lines

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

areas

Menetapkan map_plot_mode ke areas akan mengambil satu dimensi type: location dan menghubungkan semua titik dalam urutan yang telah Anda urutkan. Ini membentuk batas area pada elemen peta. Dengan menambahkan ukuran ke kueri, Anda dapat 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 yang 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 disetel ke true untuk elemen peta panas, menyetel 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 keburaman warna yang digunakan dalam peta panas. Tentukan angka antara 0 dan 1 sebagai nilai untuk heatmap_opacity, dengan 0 berarti tidak ada warna dan 1 berarti benar-benar buram.


heatmap_opacity: 0.5

Parameter peta

Sebagian besar parameter yang dijelaskan di bagian ini sesuai dengan opsi di bagian Peta pada 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 berwarna terang yang halus, dirancang untuk memberikan konteks geografis sekaligus menyoroti data Anda
  • light_no_labels: Sama seperti light, kecuali peta tidak menyertakan label seperti nama kota
  • dark: Peta gelap yang halus dan dirancang untuk memberikan konteks geografis sekaligus menyoroti data Anda
  • dark_no_labels: Sama seperti dark, kecuali peta tidak menyertakan label seperti nama kota
  • satellite_streets: Peta yang menampilkan citra udara dan satelit global
  • satellite: Sama seperti satellite_streets, kecuali peta tidak menyertakan label seperti nama kota
  • streets: Peta serbaguna yang menekankan gaya yang mudah dibaca dari jaringan jalan dan transportasi umum
  • outdoors: Peta serbaguna yang disesuaikan untuk hiking, bersepeda, dan penggunaan luar ruangan lainnya
  • traffic_day: Peta berwarna cerah 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

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: Secara otomatis memusatkan dan melakukan zoom pada peta sehingga semua titik data kueri Anda terlihat
  • custom: Memungkinkan Anda menentukan garis 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 garis 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 membuat level zoom yang lebih dekat.


map_zoom: 10

map_scale_indicator

Disetel 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 bersama dengan 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 terutama signifikan dengan nilai opasitas peta panas yang lebih tinggi. Jika peta panas Anda buram, label tidak akan ditampilkan kecuali jika ditampilkan di atas data.


draw_map_labels_above_data: true | false

Parameter poin

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

map_marker_type

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

  • circle
  • icon
  • circle_and_icon
  • none

Nilai yang Anda tentukan untuk map_marker_type 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 menentukan ukuran 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 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 disetel ke circle atau circle_and_icon dan map_marker_radius_mode yang disetel 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 disetel ke value, warna akan ditetapkan secara dinamis ke penanda berdasarkan nilai kueri pokok Anda. Anda dapat menggunakan parameter nilai untuk mengonfigurasi warna di legenda untuk opsi ini.
  • Jika map_marker_color_mode disetel ke fixed, Anda dapat menggunakan parameter map_marker_color untuk menetapkan satu warna yang akan digunakan untuk semua penanda peta. Nilai warna dapat diformat sebagai string heksadesimal RGB, seperti 2ca6cd, atau sebagai nama warna CSS seperti mediumblue.

map_marker_color

Jika map_marker_color_mode disetel ke fixed, tetapkan satu warna yang akan digunakan untuk semua penanda peta.


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 disetel ke value, atau untuk elemen peta dengan map_plot_mode disetel ke automagic_heatmap, lines, atau areas.

map_value_colors

Anda dapat menggunakan parameter map_value_colors untuk menetapkan warna titik peta atau, jika Anda mengodekan warna menurut 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 dikaitkan dengan nilai terendah.


map_value_colors: [green, mediumblue]

quantize_map_value_colors

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


quantize_map_value_colors: true | false

reverse_map_value_colors

Jika disetel ke true, parameter reverse_map_value_colors akan menukar warna yang menunjukkan nilai tinggi dan rendah pada diagram, sehingga membalikkan gradien 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 batas 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 mengodekan warna 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