בדף הזה מוסבר איך ליצור מפה צבעונית באמצעות Graph API. התרשים הזה הוא גרסה חדשה ומשופרת שתומכת במפה גדולה יותר ובתכונות נוספות בהשוואה לתרשים המפה הישן (cht=t
).
תוכן העניינים
תכונות שספציפיות לתרשים |
תכונות רגילות
|
סקירה כללית
אפשר ליצור מפה שבה מדינות או מדינות שונות מודגשות בצבעים מותאמים אישית. אפשר לשנות את מרחק התצוגה במפה כדי שהמדינות שנבחרו יוצגו כראוי, או להגדיל או להקטין את התצוגה לרמה מותאמת אישית באמצעות ערכים של קווי אורך ורוחב.
פרמטרים נתמכים
תרשימי מפות תומכים בפרמטרים הבאים:
פרמטר | נדרש או אופציונלי | תיאור |
---|---|---|
cht=map<opt_zoom_and_center> |
חובה | מציין תרשים מפה. Opt_zoom_and_center - מחרוזת אופציונלית שמאפשרת לשנות את מרחק התצוגה או למרכז את התרשים באזור ספציפי. לפרטים נוספים. |
chs |
חובה | גודל המפה. המימדים המקסימליים של מפה הם רוחב של 600 פיקסלים, גובה של 600 פיקסלים או סה"כ 300,000 פיקסלים. |
chd= |
אופציונלי | אם נעשה בו שימוש, ערך הנתונים יציין את הצבע של המדינה התואמת, לאורך ההדרגתיות של הצבעים שצוינה על ידי chco . |
chld= |
חובה | רשימה מופרדת בקווים אנכיים של מדינות או מדינות, שתודגש בצבעים שמצוינים על ידי |
|
אופציונלי | צבעי התרשים. הפורמט של המחרוזת הזו תלוי באפשרות שבה משתמשים
ב-
|
chtt, chts |
אופציונלי | שם וסגנון של התרשים |
chm |
אופציונלי | סמנים לתרשים |
chma |
אופציונלי | השוליים של התרשים |
chf=bg... |
אופציונלי | מילויים מלאים (ברקע בלבד) |
chdl |
אופציונלי | מקרא לתרשימים |
דוגמאות
תיאור | דוגמה | |||
---|---|---|---|---|
בדוגמה הזו:
|
|
|||
מפה שמציגה את צרפת, עם שני אזורים מודגשים:
|
chld=FR-D|FR-B|FR |
|||
מפה זו מדגימה באמצעות הדרגה של צבעים.
|
chd=t:0,50,100 |
|||
חשוב לזכור שאפשר לחתוך את המפה בתוך הגודל שצוין בתרשים. הסיבה לכך היא שלא נעוות את המפה כך שתתאים לגודל התרשים שצוין, אבל אנחנו מגבילים את המפה לאזורים שציינת ב-chld. לכן, כדי למנוע חיתוך של אזורים שנמצאים בתוך גבולות התרשים, ייתכן שיהיה צורך להתאים את גודל המפה באופן ידני. |
|
שינוי מרחק התצוגה ומרכוז
כברירת מחדל, התרשים יותאם לגודל ולמרכז כדי למרכז את האזורים שנבחרו, כך שיתאימו ככל האפשר לאזור המוצג במסגרת גודל המפה המוגדר. עם זאת, אפשר להתאים אישית את רמת המרכז ושינוי מרחק התצוגה בתרשים בשתי דרכים שונות:
לפי פיקסל
כדי להתאים את הגבולות לפי גודל הפיקסל, יש להשתמש בפורמט הבא:
cht=map:auto=<left_border>,<right_border>,<top_border>,<bottom_border>
כאשר כל גודל גבול הוא הגבול הנוסף להצגה בפיקסלים, מעבר לרמת הזום שמחושבת באופן אוטומטי.
ניתן להתרחק רק (ערכים חיוביים); לא ניתן להתקרב (ערכים שליליים) קרוב יותר מרמת ברירת המחדל של מרחק התצוגה באמצעות התקרבות פיקסלים.
לדוגמה:
כולן מציגות את לונדון (Lat
ללא שינוי מרחק התצוגה (ברירת מחדל) | הקטנת התצוגה 30 פיקסלים בכל צד | הקטנת התצוגה מימין |
---|---|---|
|
cht=map:auto=30,30,30,30 |
cht=map:auto=50,0,80,0 |
לפי קו רוחב וקו אורך
ניתן לציין את הגבולות העליונים, התחתונים, השמאליים והימניים של המפה המעובדת לפי קווי רוחב ואורך בעזרת התחביר שמוצג כאן:
cht=map:fixed=<bottom_border_lat>,<left_border_long>,<top_border_lat>,<right_border_long>
כאשר <bottom_border_lat> ו-<top_border_lat> מציינים את קו הרוחב של הגבולות התחתון והגבול העליון, ו-<left_border_long> ו-<right_border_long> מציינים את קו האורך של הגבולות השמאליים והימניים.
הערה: בגלל עיוות ההיטל של Mercator (למעשה, הצגת מפה מעוקלת על תמונה שטוחה), התמקדות ברצועה צרה וגבוהה עלולה לגרום להבדלים לא צפויים בגודל המפה.
לדוגמה:
בדוגמאות הבאות אפשר לראות את לונדון (מודגש בכחול) – קו אורך של 0.1°, קו רוחב של 51.5°. שימו לב שיש חיתוך של המפה כי מתבצע ניסיון להציג במפה רק את בריטניה (כפי שצוין) ולמלא את התרשים הייעודי ללא עיוות.
מרוכזת | קווי הרוחב הוזזו +10* | שינוי מרחק התצוגה על ידי הקטנת כל הערכים |
---|---|---|
cht=map:fixed=40,-10,60,10 |
|
cht=map:fixed=48,-3,54,3 |
הערה: התמונה האמצעית קצת יותר קטנה מהגודל של התמונה הראשונה, על אף שהעברנו את אותו מספר מעלות למעלה. הסיבה לכך היא שאנחנו מקרינים כדור תלת-ממדי על תמונה דו-ממדית. צריך להגדיל את הרוחב של התרשים השני כדי שיהיה זהה לגודל התרשים הראשון.
תכונות רגילות
שאר התכונות בדף הזה הן תכונות רגילות של תרשים.
כותרת התרשים chtt
, chts
[כל
התרשימים]
אפשר לבחור את טקסט הכותרת, הצבע וגודל הגופן של התרשים.
תחביר
chtt=<chart_title> chts=<color>,<font_size>,<opt_alignment>
chtt
– מציין את כותרת התרשים.
- <chart_title>
- כותרת להצגה לתרשים. לא ניתן לציין איפה יופיע השם, אבל אפשר לציין את גודל הגופן והצבע. כדי לציין רווחים, צריך להשתמש בסימן + ובקו ניצב (
|
) כדי לציין מעברי שורה.
chts
[אופציונלי] – צבעים וגודל גופן
לפרמטר chtt
.
- <color>
- צבע הכותרת, בפורמט הקסדצימלי של RRGGBB. צבע ברירת המחדל הוא שחור.
- <font_size>
- גודל הגופן של הכותרת, בנקודות.
- <opt_alignment>
- [אופציונלי] יישור הכותרת. בוחרים אחד מערכי המחרוזת הבאים תלויי אותיות רישיות: "l" (שמאל), "c" (במרכז) "r" (ימין). ברירת המחדל היא "c".
דוגמאות
תיאור | דוגמה |
---|---|
תרשים עם כותרת, עם צבע וגודל גופן שמוגדרים כברירת מחדל. צריך לציין רווח עם סימן חיבור ( כדי לאלץ מעבר שורה, צריך להשתמש בתו קו אנכי (
|
chtt=Site+visitors+by+month| |
תרשים עם כותרת כחולה ביישור לימין של 20 נקודות. |
chtt=Site+visitors |
שולי התרשים chma
[כל
התרשימים]
אפשר לציין את גודל השוליים של התרשים, בפיקסלים. השוליים מחושבים פנימה מהגודל שצוין בתרשים (chs
). הגדלה של השוליים לא מגדילה את הגודל הכולל של התרשים, אלא רק מכווצת את שטח התרשים, במקרה הצורך.
כברירת מחדל, השוליים הם כל מה שנותר אחרי חישוב גודל התרשים. ערך ברירת המחדל משתנה לפי סוג התרשים. השוליים שציינתם הם ערך מינימלי. אם אזור התרשים מותיר מקום לשוליים, גודל השוליים יהיה כל מה שנשאר. לא ניתן לכווץ את השוליים שקטנים ממה שנדרש למקרא ולתוויות. זהו תרשים שמציג את החלקים הבסיסיים של התרשים:
שולי התרשים כוללים את תוויות הצירים ואת אזור המקרא. גודל האזור של המקרא משתנה באופן אוטומטי כך שיתאים בדיוק לטקסט, אלא אם מציינים רוחב גדול יותר באמצעות טיפ: בתרשים עמודות, אם לעמודות יש גודל קבוע (ברירת המחדל), לא ניתן להקטין את רוחב האזור בתרשים. צריך לציין פס קטן יותר או עמודה שניתן לשנות את הגודל שלה באמצעות |
תחביר
chma= <left_margin>,<right_margin>,<top_margin>,<bottom_margin>|<opt_legend_width>,<opt_legend_height>
- <left_margin>, <left_margin>, <left_margin>, <left_margin>
- גודל השוליים המינימלי מסביב לאזור התרשים, בפיקסלים. יש להגדיל את הערך כדי להוסיף מרווח פנימי מסוים כדי למנוע חפיפה בין תוויות הצירים לבין גבולות התרשים.
- <opt_legend_width>, <opt_legend_height>
- [אופציונלי] רוחב השוליים סביב המקרא, בפיקסלים. ניתן להשתמש באפשרות הזו כדי שהמקרא לא יקפוץ באזור התרשים או בקצוות התמונה.
דוגמאות
תיאור | דוגמה |
---|---|
בדוגמה הזו, בתרשים יש שוליים מינימליים של 30 פיקסלים בכל צד. המקרא של התרשים הוא ברוחב של יותר מ-30 פיקסלים, ולכן השוליים שבצד שמאל מוגדרים לרוחב של מקרא התרשים, והם שונים מהשוליים האחרים. תוויות הצירים נמצאות מחוץ לאזור התרשים, ולכן הן משורטטות בתוך שטח השוליים. |
|
כדי להוסיף שוליים סביב המקרא, מגדירים ערך לפרמטרים בדוגמה הזו, המקרא הוא ברוחב של כ-60 פיקסלים. אם תגדירו את |
|
מילוי ברקע chf
[כל
התרשימים]
אפשר לציין צבעים וסגנונות מילוי לאזור הנתונים של התרשים ו/או לכל הרקע של התרשים. סוגי המילוי כוללים מילויים מלאים, מילויים מפוספסים והדרגה.
אפשר לציין מילויים שונים לאזורים שונים (לדוגמה, לכל אזור התרשים או רק לאזור הנתונים). מילוי השטח של התרשים
יחליף את המילוי ברקע. כל המילויים מצוינים באמצעות הפרמטר chf
,
וניתן לשלב סוגי מילוי שונים (מלאים, פסים, צבעים הדרגתיים) באותו תרשים,
על ידי הפרדה בין ערכים באמצעות קו אנכי ( | ). מילוי אזור התרשים מחליף את מילויי הרקע של התרשים.
מילוי מלא chf
[כל
התרשימים]
אפשר לציין מילוי מלא לרקע ו/או לאזור התרשים, או להקצות
ערך שקיפות לכל התרשים. אפשר לציין מספר מילויים באמצעות התו בצינורות (|
). (מפות: רקע בלבד).
תחביר
chf=<fill_type>,s,<color>|...
- <fill_type>
- החלק בתרשים שממלא. אפשר לציין את אחד מהערכים הבאים:
bg
- מילוי רקעc
– מילוי אזור התרשים. האפשרות הזו לא נתמכת בתרשימי מפה.a
- הגדרת כל התרשים (כולל רקעים) שקופים. המערכת מתעלמת משש הספרות הראשונות של<color>
, ורק שתי הספרות האחרונות (ערך השקיפות) חלות על התרשים כולו ועל כל המילוי.b<index>
- מילויים מלאים בעמודות (בתרשימי עמודות בלבד). מחליפים את <index> באינדקס הסדרה של העמודות שיתמלאו בצבע אחיד. האפקט דומה לציון הערךchco
בתרשים עמודות. מידע נוסף מופיע בקטע צבעי סדרת העמודות.
- שנ'
- מציין מילוי מלא או שקיפות.
- <color>
- צבע המילוי, בפורמט הקסדצימלי של RRGGBB. במקרה של שקפים, המערכת מתעלמת משש הספרות הראשונות, אבל בכל זאת צריך לכלול אותן.
דוגמאות
תיאור | דוגמה |
---|---|
הדוגמה הזו ממלאת את רקע התרשים בצבע אפור בהיר ( |
|
הדוגמה הזו ממלאת את רקע התרשים בצבע אפור בהיר ( |
|
בדוגמה הזו ניתן להחיל שקיפות של 50% על כל התרשים (80 בהקסדצימליים הם 128, או כ-50% שקיפות). שמים לב לרקע של התא בטבלה שמוצג דרך התרשים. |
|
טקסט וסגנון של מקרא התרשים chdl
, chdlp
, chdls
[כל
התרשימים]
המקרא הוא קטע צדדי בתרשים, שמספק תיאור קצר של כל סדרה. אפשר לציין את הטקסט שמשויך לכל סדרה במקרא הזה ולציין איפה הוא יופיע בתרשים.
למידע נוסף על הגדרת השוליים סביב המקרא, אפשר לעיין גם בchma
.
הערה לגבי ערכי מחרוזת: מותר להשתמש רק בתווים שמתאימים לכתובת URL במחרוזות תוויות. מטעמי אבטחה, יש לקודד כתובות URL של מחרוזות שמכילות תווים שלא נכללים בקבוצת התווים 0-9a-zA-Z
.
אפשר למצוא מקודד של כתובות URL במסמכי התיעוד של Google החזותית.
תחביר
chdl=<data_series_1_label>|...|<data_series_n_label> chdlp=<opt_position>|<opt_label_order> chdls=<color>,<size>
chdl
– הטקסט של כל סדרה, שיוצג במקרא.
- <data_series_label>
- הטקסט של הפריטים מהמקרא. כל תווית חלה על הסדרה המתאימה במערך
chd
. הוספת סימן חיבור (+) למרחב משותף. אם לא מציינים את הפרמטר הזה, התרשים לא יקבל מקרא. אין אפשרות לציין מעבר שורה בתווית. המקרא בדרך כלל יורחב כדי להציג את הטקסט של המקרא, ואזור התרשים יצטמצם כדי להתאים למקרא.
chdlp
– [אופציונלי] המיקום של המקרא והסדר של שמות הפריטים במקרא. אפשר לציין <position>
ו/או <label_order>. אם מציינים את שניהם, צריך להפריד ביניהם באמצעות תו בר. אפשר להוסיף 's' לכל ערך אם רוצים לדלג על רשומות ריקות במקרא
chdl
במקרא. דוגמאות: chdlp=bv
, chdlp=r
, chdlp=bv|r
, chdlp=bvs|r
- <opt_position>
- [אופציונלי] מציין את המיקום של המקרא בתרשים. כדי להוסיף מרווח פנימי נוסף בין המקרא לאזור התרשים או לגבולות התמונה, אפשר להשתמש בפרמטר
chma
. בוחרים אחד מהערכים הבאים:b
- מקרא בתחתית התרשים, רשומות מקרא בשורה אופקית.bv
- מקרא בתחתית התרשים, רשומות מקרא בעמודה אנכית.t
- מקרא בראש התרשים, רשומות מקרא בשורה אופקית.tv
- מקרא בראש התרשים, ערכים מהמקרא בעמודה אנכית.r
- [ברירת מחדל] מקרא מימין לתרשים, הערכים של המקרא בעמודה אנכית.l
- מקרא משמאל לתרשים, ערכים מהמקרא בעמודה אנכית.
- <opt_label_order>
- [אופציונלי]
הסדר שבו התוויות מוצגות במקרא.
בוחרים אחד מהערכים הבאים:
l
- [ברירת המחדל של מקרא אנכי] הצגת התוויות לפי הסדר שנקבע ל-chdl
.r
- הצגת התוויות בסדר ההפוך כפי שניתן ל-chdl
. האפשרות הזו שימושית בתרשימי עמודות אופקיים מוערם כדי להציג את המקרא
באותו סדר שבו מופיעות העמודות.a
- [ברירת המחדל של מקרא אופקי] סידור אוטומטי: כלומר, מיון לפי אורך, הקצר ביותר תחילה, כפי שנמדד בבלוקים של 10 פיקסלים. כששני רכיבים הם באורך זהה (חלוקה ל-10 בלוקים של פיקסלים), הרכיב הראשון שמופיע ראשון מופיע ראשון.0,1,2...
- סדר של תוויות מותאמות אישית. זוהי רשימה של אינדקסים מבוססי-אפס של תוויות מ-chdl
, מופרדים בפסיקים.
chdls
– [אופציונלי] קביעת הצבע וגודל הגופן של הטקסט במקרא.
- <color>
- צבע הטקסט במקרא, בפורמט הקסדצימלי של RRGGBB.
- <size>
- גודל הנקודות בטקסט המקרא.
דוגמאות
תיאור | דוגמה |
---|---|
שתי דוגמאות של אגדות. ציון הטקסט במקרא באותו סדר כמו סדרת הנתונים. |
chdl=NASDAQ|FTSE100|DOW
chdl=First|Second|Third |
בתרשים הראשון מוצגים פריטים מהמקרא האופקי ( |
|
בדוגמה הזו אפשר לראות את שינוי גודל הגופן. |
|
סמני צורות chm
[סרגל, קו,
מכ"ם, פיזור]
אפשר לציין סמנים גרפיים לכל הנקודות או לנתונים בודדים בתרשים. אם שני סמנים או יותר נמצאים באותה נקודה, הסמנים משורטטים לפי הסדר שבו הם מופיעים בפרמטר chm
.
אפשר גם ליצור סמני טקסט בנקודות על הגרף. המידע הזה זמין במאמר סמנים של נקודות נתונים.
אפשר לשלב סמני צורות עם פרמטרים אחרים של chm
באמצעות תו קו אנכי ( |
) כדי להפריד בין הפרמטרים של chm
.
תחביר
יש לציין קבוצה אחת של הפרמטרים הבאים לכל סדרה שרוצים לסמן. כדי לסמן כמה סדרות, צריך ליצור קבוצות נוספות של פרמטרים שמופרדות באמצעות קו אנכי. אין צורך לסמן את כל הסדרות. אם לא מקצים סמנים לסדרת נתונים, היא לא תקבל סמנים.
הביצועים של סמני צורה שונים מעט בתרשימי פיזור. אפשר לקרוא מידע נוסף במסמכי התיעוד.
chm= [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset> |...| [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset>
- @
- [אופציונלי] אם לפני סוג הסמן מופיע תו @ אופציונלי, צריך להשתמש בפורמט x:y עבור <opt_what_points>.
- <mark_type>
- סוג הסמן שבו יש להשתמש. מציינים את אחד מהסוגים הבאים:
a
– חץc
– צלבC
– מלבן. אם סמן מלבן, צריך שיהיו לך לפחות שתי סדרות נתונים, כאשר סדרה 0 מציינת את הקצה התחתון וסדרה 1 מציינת את הקצה העליון. <size> מציין את רוחב המלבן, בפיקסלים.d
– יהלוםE
- סמן סרגל שגיאה ( ) כדי ליצור סמן זה, נדרשות שתי סדרות נתונים, ערך אחד לתחתית והנקודה המתאימה בסדרה השנייה בחלק העליון. הוא גם חושף תחביר מורחב של <size>: line_thickness[:top_and_bottom_width], כאשר top_and_bottom_width הוא אופציונלי. ראו דוגמאות בהמשך.h
- קו אופקי לרוחב התרשים בגובה שצוין. (הפורמט החוקי היחיד לפרמטר <opt_which_points> הוא opt_which_points.)H
- קו אופקי דרך סמן הנתונים שצוין. יש תמיכה בתחביר <size> מורחב שמאפשר לציין אורך שורה מדויק: line_thickness[:length]. התו :length הוא אופציונלי, וברירת המחדל היא רוחב השטח המלא של התרשים.o
- מעגלs
- ריבועv
- קו אנכי מציר ה-X לנקודת הנתוניםV
- קו אנכי באורך שניתן להתאמה. יש תמיכה בתחביר מורחב של ערכים מסוג <size> שמאפשר לציין אורך שורה מדויק: line_thickness[:length]. התו :length הוא אופציונלי, וברירת המחדל היא גובה השטח המלא של התרשים. הסמן ממורכז בנקודת הנתונים.x
– X
- <color>
- צבע הסמנים לסדרה הזו, בפורמט הקסדצימלי של RRGGBB.
- <series_index>
- האינדקס מבוסס האפס של סדרת הנתונים שעליו משרטטים את הסמנים. המערכת תתעלם
מסמנים וסמנים של
h
שמציינים מיקום לפי מיקום x/y (מתחילים בתו @). ניתן להשתמש בסדרות נתונים מוסתרות כמקור לסמנים. מידע נוסף זמין בתרשימים מורכבים. תרשימי עמודות אנכיים מקובצים תומכים בתחביר מורחב מיוחד לצורך יישור סמנים לעמודות מסוימות. - <opt_which_points>
- [אופציונלי] על אילו נקודות לשרטט סמנים. ברירת המחדל היא
כל הסמנים. צריך להשתמש באחד מהערכים הבאים:
n.d
– איפה לשרטט את הסמן. המשמעות תלויה בסוג הסמן:- כל הסוגים מלבד h - על אילו נתונים מצביעים על הסמן, כאשר n.d הוא האינדקס המבוסס על אפס בסדרה. אם מציינים ערך שאינו מספר שלם, השבר מציין נקודת ביניים מחושבת. לדוגמה, 3.5 הוא חצי הדרך בין נקודה 3 לנקודה 4.
h
- מספר בין 0.0 ל-1.0, כאשר 0.0 הוא החלק התחתון של התרשים ו-1.0 הוא החלק העליון של התרשים.
-1
- שרטט סמן בכל נקודות הנתונים. אפשר גם להשאיר את הפרמטר הזה ריק כדי לשרטט על כל נקודות הנתונים.-n
- שרטט סמן בכל נקודת נתונים n. ערך של נקודה צפה (floating-point). אם n קטן מ-1, התרשים יחשב עבורך נקודות ביניים נוספות . לדוגמה, הוספה של -0.5 תציב מספר כפול של סמנים מנקודות נתונים.start:end:n
- שרטט סמן על כל נקודת נתונים n בטווח, מערכי האינדקס התחלה עד סיום, כולל. כל הפרמטרים הם אופציונליים (ייתכן שחסר אותם), לכן 3::1 יופיע מהאלמנט הרביעי עד האחרון, שלב 1, ואם משמיטים את הפרמטר הזה לחלוטין, ברירת המחדל תהיה first:last:1. כל הערכים יכולים להיות מספרים של נקודות צפות. start ו-end יכולים להיות שליליים, על מנת לספור לאחור מהערך האחרון. אם גם start וגם end שליליים, כדאי לוודא שהם רשומים בערך עולה (לדוגמה, -6:-1:1). אם הערך של השלב n קטן מ-1, המערכת תחשב נקודות נתונים נוספות באמצעות אינטרפולציה של ערכי הנתונים הנתונים. ערכי ברירת המחדל הם first:last:1x:y
- שרטט סמן בנקודת x/y ספציפית בתרשים. הנקודה הזו לא חייבת להיות על קו. כדי להשתמש באפשרות הזו, צריך להוסיף את התו @ לפני סוג הסמן. אפשר לציין את הקואורדינטות כערכי נקודה צפה (floating-point). הערך0:0
הוא הפינה הימנית התחתונה של התרשים ו-1:1
הוא הפינה השמאלית העליונה של התרשים. לדוגמה, כדי להוסיף יהלום אדום בגודל 15 פיקסלים למרכז תרשים, אפשר להשתמש בפונקציה@d,FF0000,0,0.5:0.5,15
.
- <size>
- גודל הסמן, בפיקסלים. ברוב המקרים, הסמנים V , H ו-S תומכים בתחביר <size>[:width], כאשר החלק השני האופציונלי מציין את אורך הקו או הסמן.
- <opt_z_order>
- [אופציונלי] השכבה שבה יש לצייר את הסמן, בהשוואה לסמנים אחרים ולכל שאר האלמנטים בתרשים. זהו מספר נקודה צפה (floating-point) מ-1.0- עד 1.0, כולל, כאשר -1.0 הוא החלק התחתון ו-1.0 הוא החלק העליון. רכיבי תרשים (קווים ועמודות) נמוכים מאפס. אם לשני סמנים יש ערך זהה, הם ישורטטו לפי הסדר שנקבע על ידי כתובת ה-URL. ערך ברירת המחדל הוא 0.0 (מעל רכיבי התרשים).
- <opt_offset>
- [אופציונלי] הגדרת היסט אופקי ואנכי
מהמיקום שצוין. הנה התחביר, שמשתמש במפריד :
reserved:<horizontal_offset>:<vertical_offset>
. אם מציינים את הפרמטר הזה, אפשר לכלול ערך ריק במחרוזת הפרמטרchm
עבור <opt_z_order>. דוגמאות:o,FF9900,0,4,12,,:10 o,FF9900,0,4,12.0,,:-10:20 o,FF9900,0,4,12,1,::20
- reserve - משאירים ריק.
<horizontal_offset>
- מספר חיובי או שלילי לציון ההיסט האופקי, בפיקסלים. אופציונלי; אם לא נעשה שימוש, יש להשאיר ריק.<vertical_offset>
- מספר חיובי או שלילי לציון ההיסט האנכי, בפיקסלים. אופציונלי; אם לא נעשה שימוש, יש להשאיר ריק.
דוגמאות
תיאור | דוגמה |
---|---|
כאן מוצגת דוגמה של כמה מסמני צורה וקווים.
|
chm= |
בהמשך מוצגת דוגמה לשימוש ברמת יהלומים בסדרת נתונים אחת ובמעגלים אחרים בסדרת נתונים אחרת. אם שני סמנים או יותר שוכנים באותה נקודה, הסמנים משורטטים לפי הסדר שבו הם מופיעים בפרמטר |
chm= |
הנה תרשים קו עם סמן על כל נקודת נתונים שנייה (-2 פירושו כל נקודה אחרת). |
chd=t: |
לפניכם תרשים קו שמכיל מספר כפול של סמנים מנקודות נתונים ( -0.5 פירושו כל חצי נקודה). | chd=t: |
הדוגמה הזו מראה איך להשתמש בסמנים h ו-v כדי ליצור קווי רשת עם עובי וצבעים בהתאמה אישית. הערך של סדר ה-z (הערך האחרון) מוגדר ל-1-, כך שקווי הרשת ישורטטו מתחת לקו הנתונים. |
chm= |
בתרשים הזה מתווספים קווי מילוי אנכיים לתרשים קו:
|
chm= |
בדוגמה הזו מתווסף חץ וסמני טקסט לתרשים באמצעות קואורדינטות מדויקות. סמן D הראשון הוא קו המעקב שמתחת לעמודות. הסמן השני הוא החץ והסמן השלישי הוא טקסט החץ. | chm= |
קו אופקי הקבוע לנקודה ספציפית על הגרף (H )
יכול לעזור לך להציג ערכים יחסיים, או להדגיש את הגובה של ערך נתונים בתרשים. |
chm=H,FF0000,0,18,1 |
התרשים הזה מדגים את הסמנים שיכולים לציין את עובי והאורך של קו בפרמטר <size>.
|
title="cht=lc&chd=s:2gounjqLaCf,jqLaCf2goun&chco=008000,00008033&chls=2.0,4.0,1.0&chs=250x150&chm=H,990066,1,2,5:50chm=
|
סמנים של ערכי טקסט ונתונים chm
[סרגל, קו, מכ"ם, פיזור]
אפשר להוסיף תוויות לנקודות ספציפיות בתרשים באמצעות טקסט בהתאמה אישית או באמצעות גרסאות מעוצבות של הנתונים.
אפשר לשלב כל סמני chm
באמצעות תו קו אנכי ( |
) כדי להפריד בין קבוצות הפרמטרים של chm
.
הערה לגבי ערכי מחרוזת: מותר להשתמש רק בתווים שמתאימים לכתובת URL במחרוזות תוויות. מטעמי אבטחה, יש לקודד כתובות URL של מחרוזות שמכילות תווים שלא נכללים בקבוצת התווים 0-9a-zA-Z
.
אפשר למצוא מקודד של כתובות URL במסמכי התיעוד של Google החזותית.
תחביר
יש לציין קבוצה אחת של הפרמטרים הבאים לכל סדרה שרוצים לסמן. כדי לסמן כמה סדרות, צריך ליצור קבוצות נוספות של פרמטרים שמופרדות באמצעות קו אנכי. אין צורך לסמן את כל הסדרות. אם לא מקצים סמנים לסדרת נתונים, היא לא תקבל סמנים.
chm= <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement> |...| <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement>
- <mark_type>
- סוג הסמן שבו יש להשתמש. אפשר לבחור מבין הסוגים הבאים:
f<text>
– דגל שמכיל טקסט. צריך לציין את התו 'f' ואחריו טקסט בהתאמה אישית עם קידוד כתובת URL. כדי לסמן בתו בריחה (escape) פסיקים בסמני טקסט, צריך להוסיף את הסימן \ לפני הפסיק. דוגמה:fHello\,+World!
t<text>
- סמן טקסט פשוט. צריך לציין את התו 't' ואחריו טקסט מקודד בהתאמה אישית. כדי לסמן בתו בריחה (escape) פסיקים בסמני טקסט, צריך להוסיף את הסימן \ לפני הפסיק. דוגמה:tHello\,+World!
A<text>
– סמן הערות. פעולה זו דומה לסמן דגל, אבל סמנים יתאמו את המיקום שלהם כך שלא תהיה חפיפה. הפורמט החוקי היחיד עבור <opt_which_points> הוא opt_which_points, לציון האינדקס של נקודה בסדרה.N<formatting_string>
- ערך הנתונים בשלב זה, עם עיצוב אופציונלי. אם לא משתמשים בפרמטרchds
(התאמה אישית), הוא מספק את הערך המקודד המדויק. אם משתמשים בפרמטר הזה בכל סוג פורמט, הערך יותאם לטווח שתציינו. הנה דוגמה שלchds
עם סמנים מספריים. כשמציינים את סוג הסמן הזה בתרשים עמודות מוערם, אם מציינים -1 עבור <series_index>, נוצר סמן שמציג את סכום כל הערכים בעמודה המוערמת הזו. זהו התחביר של מחרוזת העיצוב:
<preceding_text>*<number_type><decimal_places>zs<x or y>*<following_text>
.
כל הרכיבים האלה הם אופציונליים. הסברים על המשמעות של כל רכיב:<preceding_text>
- הטקסט שמופיע לפני כל ערך.*...*
- בלוק אופציונלי שמוקף בכוכביות ליטרליות, שבו אפשר לציין פרטי עיצוב של מספרים. הערכים הבאים נתמכים, וכולם אופציונליים:<number_type>
- פורמט המספרים, לערכים מספריים. בוחרים אחת מהאפשרויות הבאות:f
- [ברירת מחדל] פורמט של נקודות צפות. כדאי לציין דיוק גם באמצעות הערך <decimal_places>.p
– פורמט באחוזים. סימן % מצורף באופן אוטומטי. הערה: כשמשתמשים בפורמט הזה, ערכי נתונים בין 0.0 ל-1.0 ממופים ל-0 עד 100% (לדוגמה, 0.43 יוצגו כ-43%).e
- פורמט סימון מדעי.c<CUR>
- פורמט המספר במטבע שצוין, עם סמן המטבע המתאים. מחליפים את הערך<CUR>
בקוד מטבע בן שלוש אותיות. דוגמה:cEUR
עבור אירו. אפשר למצוא רשימת קודים באתר האינטרנט של ISO, אם כי לא כל הסמלים נתמכים.
<decimal_places>
- מספר שלם שמציין כמה ספרות אחרי הנקודה העשרונית. הערך מעוגל (לא נחתך) לאורך הזה. ברירת המחדל היא 2.z
- הצגת אפסים בסוף. ברירת המחדל היא לא.s
- הצגה של מפרידי קבוצות. ברירת המחדל היא לא.x
אוy
-הצגת הנתונים מקואורדינטת ה-x או ה-Y, כפי שצוין. המשמעות של נתוני x משתנה לפי סוג התרשים: כדאי להתנסות בתרשים כדי להבין מה המשמעות שלו. ברירת המחדל היא 'y'.
<following_text>
- הטקסט שיופיע אחרי כל ערך.
- <color>
- צבע הסמנים עבור הקבוצה הזו, בפורמט הקסדצימלי של RRGGBB.
- <series_index>
- האינדקס מבוסס האפס של סדרת הנתונים שעליו משרטטים את הסמנים. אם מדובר בתרשים עמודות מוערם וסוג הסמן הוא N (ערכי נקודות על הגרף), אפשר לציין -1 כדי ליצור סמן ערכים מסכם לכל ערימת עמודות. אפשר לראות דוגמה בהמשך.
- <opt_which_points>
- [אופציונלי] על אילו נקודות לשרטט סמנים. ברירת המחדל היא כל הסמנים. צריך להשתמש באחד מהערכים הבאים:
n.d
– נקודת הגרף שעליה משרטטים את הסמן, כאשר n.d הוא האינדקס המבוסס על אפס בסדרה. אם מציינים ערך שאינו מספר שלם, השבר מציין נקודת ביניים מחושבת. לדוגמה, 3.5 הוא חצי הדרך בין נקודה 3 לנקודה 4.-1
- שרטט סמן בכל נקודות הנתונים. אפשר גם להשאיר את הפרמטר הזה ריק כדי לשרטט על כל נקודות הנתונים.-n
- שרטט סמן בכל נקודת נתונים n.start:end:n
- שרטט סמן על כל נקודת נתונים n בטווח, מערכי האינדקס התחלה עד סיום, כולל. כל הפרמטרים הם אופציונליים (ייתכן שחסר אותם), לכן 3::1 יופיע מהרכיב הרביעי עד האחרון, שלב 1, ואם משמיטים את הפרמטר הזה לחלוטין, ברירת המחדל תהיה first:last:1. כל הערכים יכולים להיות מספרים של נקודות צפות. start ו-end יכולים להיות שליליים, על מנת לספור לאחור מהערך האחרון. אם גם start וגם end הערכים שליליים, כדאי לוודא שהם רשומים בערך עולה (לדוגמה, -6:-1:1). אם ערך השלב n קטן מ-1, הוא יחשב נקודות נתונים נוספות באמצעות אינטרפולציה של ערכי הנתונים הנתונים. ערכי ברירת המחדל הם first:last:1x:y
- [התכונה לא נתמכת לסמנים מסוג N] משרטטים סמן בנקודת x/y ספציפית בתרשים. הנקודה הזו לא חייבת להיות על קו. כדי להשתמש באפשרות הזו, צריך להוסיף את התו (@
) לפני סוג הסמן. אפשר לציין את הקואורדינטות כערכי נקודות צפה (floating-point). הערך0:0
הוא הפינה הימנית התחתונה של התרשים,0.5:0.5
הוא מרכז התרשים ו-1:1
הוא הפינה הימנית העליונה של התרשים. לדוגמה, כדי להוסיף יהלום אדום בגודל 15 פיקסלים למרכז תרשים, אפשר להשתמש בפונקציה@d,FF0000,0,0.5:0.5,15
.
- <size>
- גודל הסמן בפיקסלים. אם מדובר בתרשים פיזור עם סדרת נתונים שלישית (משמשת לציון גודל הנקודות), הערך הזה יותאם לפי טווח הנתונים. לכן, אם טווח הנתונים הוא 0-100 ו-<size> הוא 30, ערך נתונים של 100 יהיה ברוחב של 30 פיקסלים, ערך נתונים של 50 יהיה ברוחב 15 פיקסלים וכן הלאה.
- <opt_z_order>
- [אופציונלי] השכבה שבה יש לצייר את הסמן, בהשוואה לסמנים אחרים ולכל שאר האלמנטים בתרשים. זהו מספר נקודה צפה (floating-point) מ-1.0- עד 1.0, כולל, כאשר -1.0 הוא החלק התחתון ו-1.0 הוא החלק העליון. רכיבי תרשים (קווים ועמודות) נמוכים מאפס. אם לשני סמנים יש ערך זהה, הם ישורטטו לפי הסדר שנקבע על ידי כתובת ה-URL. ערך ברירת המחדל הוא 0.0 (מעל רכיבי התרשים).
- <opt_placement>
- [אופציונלי] פרטים נוספים על מיקום הסמן ביחס לנקודה על הגרף. אפשר לציין מיקום יחסי אופקי ו/או אנכי, וכן קיזוזים. תחביר המיקום הוא מחרוזת עם תווי הפרדה:
, כפי שמוצג כאן. כל הרכיבים הם אופציונליים:
<horizontal_and_vertical_justification>:<horizontal_offset>:<vertical_offset>
. אם מציינים, אפשר לכלול ערך ריק במחרוזת הפרמטרchm
עבור <opt_z_order>. לדוגמה:N,000000,0,1,10,,b
,N,000000,0,1,10,,lv
וגםN,000000,0,1,10,,r::10
.- horizontal_and_vertical_justification
- נקודת העוגן של הסמן. ההתנהגות הזו הפוכה מהנימוקים, ולכן עוגן שמאלי למעשה מציב את הסמן לימין לנקודת הנתונים. אפשר לבחור מגביל אופקי
ו/או אנכי מהרשימה הבאה:
- מיקום אופקי: 'l', 'h' או 'r' – שמאל, מרכז או בעיגון ימני, אופקי. ברירת המחדל היא 'l'.
- מיקום אנכי: 'b', 'v', 't' - למטה, באמצע או למעלה, אנכית. ברירת המחדל היא 'b'.
- מיקום יחסי בר [תרשימי עמודות בלבד]: 's', 'c', 'e' – בסיס, מרכז או החלק העליון של עמודה. בתרשימים מוערם, זהו ביחס לקטע של העמודה בכל סדרה, ולא לעמודה כולה. אם אינדקס הסדרה הנתון הוא -1 (סכום כולל בערימה), הוא ביחס לעמודה כולה. ניתן לשלב זאת עם ערכים של מיקום אנכי: לדוגמה, 'be' או 'vs'. ערך ברירת המחדל הוא 'e'.
- horizontal_offset
- היסט אופקי לסמן הזה, בפיקסלים. ברירת המחדל היא 0.
- vertical_offset
- היסט אנכי לסמן הזה, בפיקסלים. ברירת המחדל של תרשים ללא עמודות: 15; ברירת המחדל של תרשים עמודות: 2.
תיאור | דוגמה | |
---|---|---|
דוגמה לתוויות של ערכים בתרשים עמודות. התרשים הראשון ( בתרשים השני ( |
|
|
אפשר להשתמש בפרמטר בדוגמה הזו מוצג תרשים עם הערכים בקידוד פשוט של 46, 39, 29, 30, 43, 41. טווח הקידוד הפשוט הוא 0-61
. הפרמטר |
chd=s:underp |
|
בהמשך מוצגת דוגמה לתרשים עם תווית טקסט בנקודה המינימלית ותווית דגל בנקודה המקסימלית. |
|
|
בדוגמה הזו מוצג תרשים מוערם עם ערכים לסדרות בודדות, וגם הסכום הכולל של הסדרה. כדי להציג את ערכי הסדרות המוערם, עלינו להשתמש באפשרות המיקום 'c'. אם לא, ערך העמודה העליונה יחפוף לערך הסכום בראש כל עמודה. | chm= |
|
כמה הדגמות נוספות של אופן הפעולה של מיקומי מודעות אנכיים ואופקיים. בדוגמה הזו מוצגים שילובים שונים של ערכי עוגן לתרשימי עמודות (שבהם נעשה שימוש ב-s , c ו-e למיקום אנכי). שימו לב איך עוגן ימני מזיז סמן שמאלה ועוגן עליון מזיז סמן למטה ולהפך. הנקודות האדומות מייצגות את הבסיס, המרכז ובחלק העליון של כל עמודה. המספר הוא ערך הנתונים, שקבוע באמצעות ערכי עוגן שונים בכל עמודה. | chm= |
|
סמני הערה מתאימים אוטומטית את מיקום התווית כך שלא תהיה חפיפה. הערך הראשון של chm מיועד למילוי השורה. הערכים הבאים הם כל סמני ההערות. |
chm=B,C5D4B5BB,0,0,0 |
|
דוגמה נוספת לסמן הערה שמראה את הגובה של העיר בשוויץ. |