map_layer_name

用量

view: view_name {
  dimension: field_name {
    map_layer_name: name_of_map_layer
  }
}
階層
map_layer_name
可能的欄位類型
維度

接受
在模型層級 map_layer 參數中指定的地圖名稱

基本資訊

map_layer_name 參數可讓您將維度與 TopoJSON 或 GeoJSON 地圖圖層建立關聯。這樣一來,使用者就能在地圖圖層上繪製維度中的值,建立地圖圖表。舉例來說,如要依美國各州繪製資料圖表,您可以將名為「州」的維度與內建地圖圖層 us_states 建立關聯。您也可以將「鄰近地區」維度中的資料,繪製到紐約市鄰近地區的自訂地圖上。

如果您使用自訂 TopoJSON 或 GeoJSON 地圖,則必須使用 map_layer 參數,在 LookML 模型中指定地圖圖層。

type: zipcode 的維度會自動接收 us_zipcode_tabulation_areas 的 map_layer_name。

內建地圖圖層

Looker 內建下列地圖圖層:

  • countries:接受國家/地區全名、ISO 3166-1 alpha-3 三字母國家/地區代碼,以及 ISO 3166-1 alpha-2 雙字母國家/地區代碼。如果資料包含 ISO 3166-1 alpha-2 國家/地區代碼,建議搭配 countries 地圖使用 map_layer_name,確保 Looker 將資料解讀為國家/地區代碼,而非州代碼。

  • uk_postcode_areas:接受英國郵遞區號區域 (例如:L 代表利物浦、RH 代表雷德希爾,或 EH 代表愛丁堡)。

  • us_states:接受完整州名或兩個字母的州名縮寫。基礎資料欄應採用單一一致的格式;如果資料欄混合使用州/省全名和雙字母縮寫 (例如 California 和 CA),這些值就不會在地圖上歸為同一組。

  • us_counties_fips:適用於字串欄位,該欄位為美國郡縣的五字元 FIPS 郡縣代碼。這個圖層僅適用於互動式地圖。

  • us_zipcode_tabulation_areas:適用於五個字元的美國郵遞區號字串欄位。type: zipcode 的維度會自動使用 us_zipcode_tabulation_areas 地圖圖層。

    郵遞區號區域是以 2010 年郵遞區號統計區域 (ZCTA) 為依據,因此這個地圖圖層不包含許多郵遞區號,例如指派給郵政信箱的郵遞區號,這些郵遞區號不會直接對應至區域。

範例

dimension: state {
  map_layer_name: us_states
  sql: ${TABLE}.state ;;
}