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
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 county atau kode pos, di Looker dan membuat diagram peta.
Jika lapisan peta ada, biasanya visualisasi peta interaktif dipilih sebagai visualisasi peta default. Satu 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. Lapisan peta kustom hanya mendukung geometri garis dan poligon; geometri titik tidak didukung. Untuk memetakan data titik pada peta menggunakan koordinat lintang dan bujur, tentukan dimensi type: location.
Untuk mengetahui informasi selengkapnya tentang cara membuat file lapisan peta kustom, lihat halaman Praktik Terbaik Membuat region peta kustom.
Looker merekomendasikan agar Anda menjaga ukuran file lapisan peta kustom tetap di bawah 5 MB untuk menghindari beban berlebih pada 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
countriesdanus_statesmenggunakan kapitalisasi 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 agar dapat menggunakan lapisan peta bawaan ini. Misalnya, jika set data Anda menggunakan huruf kecil "new delhi", data tersebut tidak akan diplot dengan benar pada lapisan peta bawaan, yang menggunakan "New Delhi".
countries— Menerima nama negara lengkap, 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 tiga opsi ini dalam set data; Anda tidak dapat menggunakan kombinasi opsi ini.Jika data Anda menggunakan ISO 3166-1 alpha-2, sertakan parameter
map_layer_namedalam definisi untuk dimensi negara 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,Luntuk Liverpool,RHuntuk Redhill, atauEHuntuk Edinburgh).us_states— Menerima nama lengkap negara bagian dan singkatan negara bagian dua huruf.us_counties_fips— Berfungsi pada kolom string yang merupakan kode county FIPS lima karakter untuk county di AS. Lapisan ini hanya berfungsi di peta interaktif.us_zipcode_tabulation_areas— Berfungsi di kolom string yang merupakan kode pos AS lima karakter. Dimensitype: zipcodeotomatis menggunakan lapisan petaus_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 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 seperti yang akan Anda rujuk di LookML. |
file |
String | Lokasi peta, yang 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 pada daftar file LookML IDE. 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 otomatis memusatkan peta 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 nilainya berupa array yang terdiri dari empat angka yang mewakili 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 yang diinginkan 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 plot, tentukan di sini. |
property_label_key |
String | Properti dari data TopoJSON yang akan digunakan untuk memberi label pada wilayah. Hal ini berguna jika nilai pemetaan (yang ditentukan oleh property_key) tidak terlalu mudah dibaca manusia. |
url |
String | Lokasi peta, yang 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 pada daftar file LookML IDE.
Misalnya, jika project Anda diaktifkan untuk folder dan Anda memiliki peta kustom lingkungan bernama my_neighborhoods.json di 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 membuat diagram data menggunakan file JSON neighborhoods, seperti yang ditentukan dalam parameter map_layer di file model Anda.
Yang perlu diketahui
Diagram peta statis (wilayah)
Menetapkan Map ke Auto di diagram Static Map (Regions) bergantung pada map_layer yang ditentukan dalam model LookML yang menentukan lapisan peta. Tanpa parameter tersebut, pengguna akan mendapatkan error jika memilih Auto, tetapi masih dapat menggunakan peta bawaan Looker.
File GeoJSON
Serupa 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 menggunakan property_key dan property_label_key secara opsional.
Menggunakan map_layer dengan folder IDE
Jika folder IDE diaktifkan untuk project, Anda harus menggunakan jalur saat menentukan file project untuk map_layer:
map_layer: neighborhoods {
file: "/maps/my_neighborhoods.json"
}