map_layer

שימוש

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"
}
היררכיה
map_layer
ערך ברירת המחדל
ללא

מקבלים
מזהה של שכבת המפה, וגם תת-פרמטרים שמגדירים את המאפיינים של שכבת המפה.

הגדרה

הפרמטר map_layer מאפשר להגדיר שכבה במפה בהתאמה אישית, שאפשר להשתמש בה כדי לשרטט נתונים אזוריים, כמו מחוזות או מיקודים, ב-Looker וליצור תרשימי מפה.

כשיש שכבה במפה, בדרך כלל המחשת המפה האינטראקטיבית נבחרת כברירת המחדל להמחשת המפה. החריג היחיד הוא המפה של מדינות ארה"ב, שבה Looker משתמש בתרשים Static Map Region כברירת מחדל, כי הוא משתמש בתוספות לאלסקה ולהוואי.

אפשר להוסיף לשכבות במפה קובצי TopoJSON או GeoJSON. שכבות מפה בהתאמה אישית תומכות רק בגיאומטריות של קווים ופוליגונים, ולא בגיאומטריות של נקודות. כדי להציג נתוני נקודות במפה באמצעות קואורדינטות של קווי אורך ורוחב, צריך להגדיר מאפיין של type: location.

מידע נוסף על יצירת קובץ שכבה של מפה בהתאמה אישית זמין בדף השיטות המומלצות בנושא יצירת אזורים במפה בהתאמה אישית.

כדי לא להעמיס על הכרטיסייה בדפדפן של המשתמש, מומלץ שגודל הקבצים של שכבות המפה בהתאמה אישית יהיה קטן מ-5MB.

שכבות מובנות במפה

‫Looker כולל כמה שכבות מפה מובנות. לפני שאתם יוצרים שכבות משלכם במפה, כדאי לבדוק אם אתם יכולים להשתמש באחת מהשכבות המובנות במפה:

בשכבות המפה המובנות countries ו-us_states נעשה שימוש באותיות רישיות בשמות של מדינות. הנתונים משורטטים בשכבה במפה באופן שתלוי באותיות רישיות, לכן צריך להשתמש באותיות רישיות בצורה נכונה בנתונים כדי להשתמש בשכבות המובנות האלה במפה. לדוגמה, אם בקבוצת הנתונים שלכם כתוב "new delhi" באותיות קטנות, הנתונים לא יופיעו בצורה נכונה בשכבות המפה המובנות, שבהן כתוב "New Delhi".

  • ‫countries — אפשר להזין שמות מלאים של מדינות, קודי מדינה בני 3 אותיות לפי תקן ISO 3166-1 alpha-3 או קודי מדינה בני 2 אותיות לפי תקן ISO 3166-1 alpha-2. שימו לב שאתם צריכים להשתמש רק באחת משלוש האפשרויות האלה במערך הנתונים. אי אפשר לשלב ביניהן.

    אם הנתונים שלכם משתמשים ב-ISO 3166-1 alpha-2, צריך לכלול את הפרמטר map_layer_name בהגדרה של מאפיין המדינה כדי לוודא ש-Looker מזהה את הנתונים כקודי מדינה ולא מפרש אותם באופן שגוי כקודי מדינה בארה"ב. לדוגמה:

  dimension: country {
      type: string
      map_layer_name: countries
      sql: ${TABLE}.country ;;
  }
  • uk_postcode_areas – מקבל אזורי מיקוד בבריטניה (לדוגמה, L לליברפול, RH לרדהיל או EH לאדינבורו).

  • us_states — אפשר להזין שמות מלאים של מדינות וקיצורים של שתי אותיות.

  • ‫us_counties_fips – פועלת על שדות של מחרוזות שהם קודי FIPS בני חמישה תווים של מחוזות בארה"ב. השכבה הזו פועלת רק במפה האינטראקטיבית.

  • ‫us_zipcode_tabulation_areas – פועלת על שדות מחרוזת שהם מספרי מיקוד בארה"ב בני חמישה תווים. מאפיינים של type: zipcode משתמשים באופן אוטומטי בשכבה במפה של us_zipcode_tabulation_areas.

    אזורי המיקוד מבוססים על אזורי המיקוד בטבלה (ZCTA) משנת 2010, ולכן שכבת המפה הזו לא כוללת הרבה מיקודים, כמו אלה שהוקצו לתאי דואר, שלא ממופים ישירות לאזורים.

ציון שכבה במפה

אפשר לציין את המיקום של המפה באמצעות שם של קובץ או כתובת URL.

כשמשתמשים בקובץ GeoJSON, צריך להשתמש בתת-הפרמטר file או url. אפשר גם להשתמש ב-property_key וב-property_label_key. תת-הפרמטר feature_key לא נתמך בקובצי GeoJSON. התחביר הכללי להוספת שכבת GeoJSON במפה הוא:

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

התחביר הכללי להוספת שכבת מפה של TopoJSON הוא:

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
}

כאשר:

פרמטר סוג תיאור
identifier String שם המפה כפי שתתייחסו אליה ב-LookML.
file String מיקום המפה, שצוין לפי השם של קובץ JSON מהפרויקט של LookML. הקובץ צריך להיות בפורמט TopoJSON או GeoJSON, ולהשתמש באחת מהסיומות הבאות: .json,‏ .geojson או .topojson.

צריך להשתמש בנתיב המלא לקובץ ה-JSON, למשל "/maps/countryobjects.json" לקובץ בספרייה /maps/. אם קובץ ה-JSON נמצא בתיקיית השורש ולא בתיקייה, אפשר לציין את תיקיית השורש באמצעות לוכסן אחד, כך: "/countryobjects.json"

אם הפרויקט לא מוגדר לתיקיות, Looker מציג קובצי JSON בקטע Data ברשימת הקבצים של LookML IDE. בקטע דוגמאות בהמשך הדף מופיע קוד LookML לכל אחד מהתרחישים האלה.
extents_json_url String כתובת ה-URL של קובץ JSON שמגדיר את ההיקפים הגיאוגרפיים של כל אזור שזמין בשכבה במפה. הנתונים האלה משמשים למרכז אוטומטית את המפה על הנתונים הזמינים למטרות המחשה. קובץ ה-JSON חייב להיות אובייקט JSON שבו המפתחות הם ערך המיפוי של המאפיין (כפי שצוין על ידי property_key) והערכים הם מערכים של ארבעה מספרים שמייצגים את קו האורך המערבי, קו הרוחב הדרומי, קו האורך המזרחי וקו הרוחב הצפוני של האזור. האובייקט חייב לכלול מפתח לכל ערך אפשרי של property_key. לדוגמה, extents_json_url: "https://mycompany.com/mapserver/json-extent.js". אם משתמשים בפרמטר הזה, צריך לציין את מיקום המפה באמצעות הפרמטר url.
feature_key String השם של אובייקט TopoJSON ששכבת המפה מפנה אליו. אם לא מציינים אובייקט, המערכת משתמשת באובייקט הראשון.
format מילת מפתח

topojson או vector_tile_region
פורמט הנתונים של פרטי האזור. בדרך כלל אנשים משתמשים ב-topojson.
label String מוצג בממשק המשתמש של הגדרות התרשים.
max_zoom_level מספר רמת הזום המקסימלית להגדלת התצוגה של שכבת המפה, בתצוגות שתומכות בזום.
min_zoom_level מספר רמת הזום המינימלית להגדלת התצוגה בשכבה במפה, בתצוגות שתומכות בהגדלה.
projection מילת מפתח ההיטל הגיאוגרפי המועדף של שכבת המפה כשהיא מוצגת בתצוגה שתומכת בכמה היטלים גיאוגרפיים. כשמוסיפים פרמטר של היטל, עורך LookML מציג את ההיטלים הרבים שזמינים.
property_key String המאפיין מנתוני TopoJSON שרוצים להציג בתרשים. ‫TopoJSON תומך במטא-נתונים שרירותיים לכל אזור. כברירת מחדל, המערכת משתמשת במאפיין הראשון שמתאים. אם יש מאפיין מטא-נתונים מסוים שרוצים להציג בתרשים, מציינים אותו כאן.
property_label_key String מאפיין מנתוני TopoJSON שמשמש לסימון האזור. האפשרות הזו שימושית כשערך המיפוי (שמוגדר על ידי property_key) לא קריא לאנשים.
url String מיקום המפה, שצוין על ידי כתובת URL שמכילה את קובץ המפה.

דוגמאות

אם אפשר, הוסיפו את קובץ המפה לפרויקט ואז השתמשו בפרמטר file כדי להפנות לקובץ המפה.

צריך להשתמש בנתיב המלא לקובץ ה-JSON. אם הפרויקט לא מוגדר לתיקיות, Looker מציג קובצי JSON בקטע Data ברשימת הקבצים של LookML IDE.

לדוגמה, אם הפרויקט שלכם מוגדר לתיקיות ויש לכם מפה בהתאמה אישית של שכונות בשם my_neighborhoods.json בספרייה בשם maps, צריך להשתמש בנתיב המלא באופן הבא:

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

אם בפרויקט שלכם אין תיקיות, קובצי המפות שהעליתם יוצגו בקטע Data של הפרויקט. במקרה כזה, אתם יכולים פשוט לציין את שם הקובץ של my_neighborhoods.json:

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

לחלופין, אפשר לציין שמפה מותאמת אישית של neighborhoods מתארחת במקום אחר, למשל ב-https://wherever.com/my_neighborhoods.json:

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

אחרי שמגדירים את שכבת המפה (על ידי ציון קובץ או שימוש בפרמטר url), אפשר לציין שהערכים של מאפיין מסוים צריכים להיות משויכים לאזור גיאוגרפי במפה בהתאמה אישית. במאפיין, משתמשים בפרמטר map_layer_name כדי לציין את השם שבו השתמשתם בפרמטר map_layer.

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

כששולחים שאילתה למאפיין הזה ופותחים את הקטע של התצוגה החזותית, Looker מציג את הנתונים בתרשים באמצעות קובץ ה-JSON של neighborhoods, כפי שמוגדר בפרמטר map_layer בקובץ המודל.

חשוב לדעת

תרשימי מפה סטטית (אזורים)

הגדרת מפה לאוטומטי בתרשימי מפה סטטית (אזורים) מסתמכת על כך ש-map_layer צוין במודל LookML שמציין שכבה במפה. אם הפרמטר הזה לא מוגדר, המשתמשים מקבלים הודעת שגיאה אם הם בוחרים באפשרות Auto, אבל הם עדיין יכולים להשתמש במפות המובנות של Looker.

קובצי GeoJSON

בדומה לקובצי TopoJSON, קובצי GeoJSON יכולים להשתמש בסיומת שם הקובץ .geojson או .json, אבל הם חייבים להכיל נתונים גיאוגרפיים בפורמט GeoJSON. כשמשתמשים בקובץ GeoJSON, צריך להשתמש בתת-הפרמטר file או url, ואפשר להשתמש גם ב-property_key וב-property_label_key.

שימוש ב-map_layer עם תיקיות IDE

אם הפעלתם תיקיות IDE בפרויקט, אתם צריכים להשתמש בנתיב כשאתם מציינים קובץ פרויקט ל-map_layer:

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