Anda sedang melihat dokumentasi untuk Looker 26.0. Klik link ini untuk melihat dokumentasi terbaru.

map_layer

Penggunaan

map_layer: company_regions {
  feature_key: "ISO_A3"
  file: "/map_folder/regions.json"
  format: topojson
  label: "desired label for chart visualization"
  max_zoom_level: 12
  min_zoom_level: 2
  projection: airy
  property_key: "ISO_A3"
  property_label_key: "NAME"
}

Hierarki

File Model

map_layer

Nilai Default

Tidak ada

Menerima

ID untuk lapisan peta Anda, ditambah subparameter yang menentukan properti lapisan peta Anda.

Definisi

Parameter map_layer memungkinkan Anda menentukan lapisan peta kustom yang kemudian dapat digunakan untuk memetakan data regional, seperti wilayah atau kode pos, di Looker dan membuat diagram peta.

Jika ada lapisan peta, biasanya visualisasi peta interaktif dipilih sebagai visualisasi peta default. Satu-satunya pengecualian adalah peta Negara Bagian AS, tempat Looker menggunakan diagram Wilayah Peta Statis secara default karena menggunakan inset untuk Alaska dan Hawaii.

Lapisan peta dapat menerima file TopoJSON atau GeoJSON.

Untuk mengetahui informasi selengkapnya tentang cara membuat file lapisan peta kustom, lihat halaman Praktik Terbaik Membuat wilayah peta kustom.

Looker merekomendasikan agar Anda menjaga ukuran file lapisan peta kustom kurang dari 5 MB untuk menghindari membebani tab browser pengguna.

Lapisan peta bawaan

Looker menyertakan beberapa lapisan peta bawaan. Sebelum membuat lapisan peta Anda sendiri, periksa apakah Anda dapat menggunakan salah satu lapisan peta bawaan:

Lapisan peta bawaan countries dan us_states menggunakan huruf kapital yang tepat untuk nama negara dan negara bagian. Data diplot ke lapisan peta dengan cara yang peka huruf besar/kecil, sehingga data Anda juga harus menggunakan kapitalisasi yang tepat untuk menggunakan lapisan peta bawaan ini. Misalnya, jika set data Anda menggunakan huruf kecil "new delhi", data tidak akan diplot dengan benar di lapisan peta bawaan, yang menggunakan "New Delhi".

countries — Menerima nama lengkap negara, kode negara tiga huruf ISO 3166-1 alpha-3, atau kode negara dua huruf ISO 3166-1 alpha-2. Perhatikan bahwa Anda hanya boleh menggunakan salah satu dari ketiga opsi ini dalam set data; Anda tidak boleh menggunakan campuran opsi ini.

Jika data Anda menggunakan ISO 3166-1 alpha-2, sertakan parameter map_layer_name dalam definisi untuk dimensi negara Anda guna memastikan Looker mengenali data Anda sebagai kode negara dan tidak salah menafsirkan data sebagai kode negara bagian. Contoh:

  dimension: country {
      type: string
      map_layer_name: countries
      sql: ${TABLE}.country ;;
  }

uk_postcode_areas — Menerima area kode pos Inggris Raya (misalnya, L untuk Liverpool, RH untuk Redhill, atau EH untuk Edinburgh).
us_states — Menerima nama lengkap negara bagian dan singkatan dua huruf negara bagian.
us_counties_fips — Berfungsi pada kolom string yang merupakan kode county FIPS lima karakter untuk county di Amerika Serikat. Lapisan ini hanya berfungsi di peta interaktif.
us_zipcode_tabulation_areas — Berfungsi pada kolom string yang merupakan kode pos Amerika Serikat lima karakter. Dimensi type: zipcode otomatis menggunakan lapisan peta us_zipcode_tabulation_areas.

Wilayah kode pos didasarkan pada area tabulasi kode pos (ZCTA) tahun 2010, sehingga lapisan peta ini tidak menyertakan banyak kode pos, seperti yang ditetapkan ke kotak pos, yang tidak dipetakan secara langsung ke wilayah.

Menentukan lapisan peta

Lokasi peta dapat ditentukan menggunakan nama file atau URL.

Saat menggunakan file GeoJSON, Anda harus menggunakan subparameter file atau url. Anda juga dapat menggunakan property_key dan property_label_key secara opsional. Subparameter feature_key tidak didukung untuk file GeoJSON. Sintaksis umum untuk menambahkan lapisan peta GeoJSON adalah:

map_layer: identifier {
  file: "/file_path/file_name.geojson" # or use the url subparameter
  url: "string" # or use the file subparameter
  property_key: "string"
  property_label_key: "string"
}

Sintaksis umum untuk menambahkan lapisan peta TopoJSON adalah:

map_layer: identifier {
  extents_json_url: "string"
  feature_key: "string"
  file: "/file_path/file_name.json" # or use the url subparameter
  format: topojson | vector_tile_region
  label: "string"
  max_zoom_level: number
  min_zoom_level: number
  projection: airy  # or one of many other choices
  property_key: "string"
  property_label_key: "string"
  url: "string" # or use the file subparameter
}

Dengan:

Parameter	Jenis	Deskripsi
`identifier`	String	Nama peta yang akan Anda gunakan di LookML.
`file`	String	Lokasi peta, ditentukan oleh nama file JSON dari project LookML Anda. File harus dalam format TopoJSON atau GeoJSON dan menggunakan salah satu ekstensi berikut: `.json`, `.geojson`, atau `.topojson`. Anda harus menggunakan jalur lengkap untuk file JSON, seperti `"/maps/countryobjects.json"` untuk file di direktori `/maps/`. Jika file JSON berada di direktori root dan bukan di folder, Anda dapat menunjukkan direktori root dengan satu garis miring, seperti ini: `"/countryobjects.json"` Jika project Anda tidak diaktifkan untuk folder, Looker akan menampilkan file JSON di bagian Data dari daftar file IDE LookML. Lihat bagian Contoh di bagian selanjutnya di halaman ini untuk mengetahui LookML untuk setiap skenario ini.
`extents_json_url`	String	URL ke file JSON yang menentukan cakupan geografis setiap wilayah yang tersedia di lapisan peta. Data ini digunakan untuk memusatkan peta secara otomatis pada data yang tersedia untuk tujuan visualisasi. File JSON harus berupa objek JSON dengan kunci berupa nilai pemetaan fitur (seperti yang ditentukan oleh `property_key`) dan nilai berupa array empat angka yang merepresentasikan batas bujur barat, lintang selatan, bujur timur, dan lintang utara wilayah. Objek harus menyertakan kunci untuk setiap kemungkinan nilai `property_key`. Misalnya, `extents_json_url: "https://mycompany.com/mapserver/json-extent.js"`. Jika menggunakan parameter ini, Anda harus menentukan lokasi peta menggunakan parameter `url`.
`feature_key`	String	Nama objek TopoJSON yang dirujuk oleh lapisan peta. Jika tidak ditentukan, objek pertama akan digunakan.
`format`	Kata kunci `topojson` atau `vector_tile_region`	Format data informasi wilayah. Biasanya orang menggunakan `topojson`.
`label`	String	Ditampilkan di UI konfigurasi diagram.
`max_zoom_level`	Angka	Tingkat zoom maksimum untuk memperbesar lapisan peta, untuk visualisasi yang mendukung zoom.
`min_zoom_level`	Angka	Tingkat zoom minimum untuk memperbesar lapisan peta, untuk visualisasi yang mendukung zoom.
`projection`	Kata kunci	Proyeksi geografis pilihan untuk lapisan peta saat ditampilkan dalam visualisasi yang mendukung beberapa proyeksi geografis. Editor LookML mencantumkan banyak proyeksi yang tersedia saat Anda menambahkan parameter proyeksi.
`property_key`	String	Properti dari data TopoJSON yang akan diplot. TopoJSON mendukung metadata arbitrer untuk setiap wilayah. Secara default, properti pertama yang cocok akan digunakan. Jika ada properti metadata tertentu yang ingin Anda petakan, tentukan di sini.
`property_label_key`	String	Properti dari data TopoJSON yang akan digunakan untuk memberi label pada wilayah. Hal ini berguna saat nilai pemetaan (yang ditentukan oleh `property_key`) tidak mudah dibaca.
`url`	String	Lokasi peta, ditentukan oleh URL yang berisi file peta Anda.

Contoh

Jika memungkinkan, tambahkan file peta ke project Anda, lalu gunakan parameter file untuk mengarah ke file peta.

Anda harus menggunakan jalur lengkap untuk file JSON. Jika project Anda tidak diaktifkan untuk folder, Looker akan menampilkan file JSON di bagian Data dari daftar file IDE LookML.

Misalnya, jika project Anda diaktifkan untuk folder dan Anda memiliki peta khusus lingkungan bernama my_neighborhoods.json dalam direktori bernama maps, Anda akan menggunakan jalur lengkap seperti ini:

map_layer: neighborhoods {
  file: "/maps/my_neighborhoods.json"
}

Jika project Anda tidak menggunakan folder, file peta yang diupload akan ditampilkan di bagian Data project. Dalam hal ini, Anda cukup memberikan nama file my_neighborhoods.json:

map_layer: neighborhoods {
  file: "my_neighborhoods.json"
}

Atau, Anda dapat menentukan bahwa peta neighborhoods kustom dihosting di tempat lain, seperti di https://wherever.com/my_neighborhoods.json:

map_layer: neighborhoods {
  url: "https://wherever.com/my_neighborhoods.json"
}

Setelah lapisan peta ditentukan (dengan menentukan file atau menggunakan parameter url), Anda dapat menentukan bahwa nilai dimensi harus dikaitkan dengan wilayah geografis di peta kustom Anda. Dalam dimensi, gunakan parameter map_layer_name untuk menentukan nama yang Anda gunakan dalam parameter map_layer.

dimension: neighborhood {
  type: string
  map_layer_name: neighborhoods    # this is your map layer
  sql: ${TABLE}.neighborhood_code
}

Saat Anda membuat kueri dimensi ini dan membuka bagian visualisasi, Looker akan memetakan data menggunakan file JSON neighborhoods, seperti yang ditentukan dalam parameter map_layer di file model Anda.

Yang perlu diketahui

Diagram peta statis (wilayah)

Menyetel Peta ke Otomatis dalam diagram Peta Statis (Region) bergantung pada map_layer yang ditentukan dalam model LookML yang menentukan lapisan peta. Jika parameter tersebut tidak disetel, pengguna akan mendapatkan error jika memilih Otomatis, tetapi masih dapat menggunakan peta bawaan Looker.

File GeoJSON

Mirip dengan file TopoJSON, file GeoJSON dapat menggunakan ekstensi nama file .geojson atau .json, tetapi harus berisi data geografis dalam format GeoJSON. Saat menggunakan file GeoJSON, Anda harus menggunakan subparameter file atau url, dan Anda dapat secara opsional menggunakan property_key dan property_label_key.

Menggunakan `map_layer` dengan folder IDE

Jika Anda mengaktifkan folder IDE untuk project, Anda harus menggunakan jalur saat menentukan file project untuk map_layer:

map_layer: neighborhoods {
  file: "/maps/my_neighborhoods.json"
}

map_layer Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.