שימוש
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"
}