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
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 memplot data regional, seperti wilayah atau kode pos, di Looker dan membuat diagram peta.

Jika lapisan peta ada, 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 untuk membuat wilayah peta kustom.

Looker merekomendasikan agar Anda menyimpan file lapisan peta kustom yang berukuran kurang dari 5 MB untuk menghindari tab browser pengguna yang terlalu banyak.

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 kapitalisasi yang tepat untuk nama negara dan negara bagian. Data diplot ke lapisan peta dengan memperhatikan 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 "new delhi" dengan huruf kecil, data tersebut tidak akan diplot dengan benar pada lapisan peta bawaan, yang menggunakan "New Delhi".

  • countries — Menerima nama negara lengkap, ISO 3166-1 alpha-3 kode negara tiga huruf, atau ISO 3166-1 alpha-2 kode negara dua huruf. Perhatikan bahwa Anda hanya boleh menggunakan salah satu dari tiga opsi ini dalam set data Anda; Anda tidak dapat 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 (misalnya, L untuk Liverpool, RH untuk Redhill, atau EH untuk Edinburgh).

  • us_states — Menerima nama negara bagian lengkap dan singkatan negara bagian dua huruf.

  • us_counties_fips — Berfungsi pada kolom string yang merupakan kode wilayah FIPS lima karakter untuk wilayah AS. Lapisan ini hanya berfungsi pada peta interaktif.

  • us_zipcode_tabulation_areas — Berfungsi pada kolom string yang merupakan kode pos AS 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 kode pos yang ditetapkan ke kotak surat, 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 sebutkan 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 tidak berada di folder, Anda dapat menunjukkan direktori root dengan satu garis miring ke depan, 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 halaman ini untuk mengetahui LookML untuk setiap skenario ini.
extents_json_url String URL ke file JSON yang menentukan batas 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 sebagai nilai pemetaan fitur (seperti yang ditentukan oleh property_key) dan nilai sebagai array empat angka yang mewakili batas bujur barat, lintang selatan, bujur timur, dan lintang utara wilayah. Objek harus menyertakan kunci untuk setiap nilai property_key yang memungkinkan. 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 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 oleh 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 dari daftar file IDE LookML.

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 hanya dapat 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 Peta ke Otomatis di diagram Peta Statis (Wilayah) bergantung pada map_layer yang ditentukan dalam model LookML yang menentukan lapisan peta. Tanpa parameter tersebut ditetapkan, 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 menggunakan property_key dan property_label_key secara opsional.

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"
}