תרשים מפה (גרסה שהוצאה משימוש)

 

התראת החלפה: תרשים המפה הזה הוחלף בגרסה חדשה יותר.

בדף הזה מוסבר איך ליצור מפה צבעונית באמצעות Graph API.

תוכן העניינים

תכונות שספציפיות לתרשים סקירה כללית קודי מדינה של ארצות הברית

תכונות רגילות כותרת התרשים (chtt, chts) שולי התרשים (chma) מילויים ברקע Solid Fills (chf)

סקירה כללית

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

תרשימי מפות תומכים בפרמטרים הבאים:

פרמטר	נדרש או אופציונלי	תיאור
cht=t	חובה	מציין תרשים מפה.
chs	חובה	גודל המפה. הגודל המקסימלי של מפה הוא 440x220.
chtm=<zoom_area>	חובה	האזור הגיאוגרפי שמוצג בתרשים. zoom_area – אחד מהערכים הבאים africa asia europe middle_east south_america usa world
chld=<country_or_state_codes>	חובה	רשימה של המדינות או המדינות שעליהן אתם מחילים ערכים. country_or_state קודים – אלו הם קבוצה של קודים בני שני תווים, ללא מפריד ביניהם. אפשר להשתמש בכל אחד מהסוגים הבאים (אי אפשר לשלב בין סוגים): קודי ISO 3166-1-alpha-2 עבור מדינות, או קודי מדינה בארה"ב לדוגמה: chld=DZEGMG
chd=<country_values>	חובה	רשימת ערכים מקבילים לרשימת האזורים, שבה הערך חל על האזור המתאים. הערכים הם ערכים רגילים של נתונים בפורמט. לכל אזור יוקצה צבע לאורך קנה המידה שצוין ב-chco, כאשר הערך הנמוך ביותר בטווח חל על הצבע הנמוך ביותר והערך הגבוה ביותר בטווח הזה חל על הצבע האחרון. country_values - רשימה במחרוזת הפורמט המתאימה. דוגמאות: t:10,20,30, s:aU2Ff ו-e:BaPoqM-A.
chco=<default_color>,<start_of_gradient>,...,<end_of_gradient>	אופציונלי	טווח צבעים התואם לערכים הנמוכים והגבוהים של הנתונים בטווח של פורמטים של הנתונים. ערכי הנתונים עוברים המרה לערכי צבעים לאורך ההדרגתיות הזו ומיושמים על המדינות המתאימות. default_color – [אופציונלי] הצבע של אזורים שלא הוקצו להם נתונים. ברירת המחדל היא BEBEBE (אפור בינוני). מספר הקסדצימלי בפורמט RRGGBB. start_of_gradient - [start_of_gradient] הצבע שתואם לערך המינימלי בטווח של פורמט הנתונים. ערך ברירת המחדל הוא 0000FF (כחול). מספר הקסדצימלי בפורמט RRGGBB. ... - [אופציונלי] אפשר לבחור כמה צבעי ביניים שרוצים. end_of_gradient - [end_of_gradient] הצבע שתואם לערך המקסימלי בטווח של פורמט הנתונים. ברירת המחדל היא FF0000 (אדום). מספר הקסדצימלי בפורמט RRGGBB
chtt, chts	אופציונלי	שם וסגנון של התרשים
chma	אופציונלי	השוליים של התרשים
chf=bg	אופציונלי	מילויים מלאים (ברקע בלבד)

 

דוגמאות

תיאור	דוגמה
בדוגמה הזו: אזור המרחק מהתצוגה של התרשים הוא אפריקה (chtm=africa). לשלוש המדינות יוקצו ערכים: אלג'יריה, מצרים ומדגסקר (chld=DZEGMG) שלושת הערכים שהוקצו למדינות האלה הם 0, 100 ו-50 בהתאמה (chd=t:0,100,50), שהם הערכים המינימליים, המקסימליים והאמצעיים לנתונים של פורמט טקסט. טווח הצבעים הוא אדום עבור 0, ירוק עבור 100 ולבן עבור מדינות שלא הוקצו (chco=FFFFFF,FF0000,00FF00). יש בתרשים גם מילוי רקע בצבע תכלת (chf=bg,s,EAF7FE).	cht=t chtm=africa chld=DZEGMG chd=t:0,100,50 chco=FFFFFF,FF0000,00FF00 chf=bg,s,EAF7FE
התרשים הזה דומה לתרשים הקודם, אבל עם פרטים רבים יותר.	chtm=africa chld=DZEGMGAOBWNGCFKECGCVSNDJTZGHMZZM chco=FFFFFF,FF0000,FFFF00,00FF00 chd=t:0,100,50,32,60,40,43,12,14,54,98,17,70,76,18,29 chf=bg,s,EAF7FE
התרשים הזה מציין שאף מדינה לא תודגש על ידי ציון ערך יחיד לא מוגדר (chd=t:-1).	chs=440x220 chd=t:-1 cht=t chtm=world

חזרה למעלה

קודי מדינה של ארצות הברית

בהמשך מפורטים קודי המדינות הנתמכים במפה של ארצות הברית (chld=usa).

AL	אלבמה	לוס אנג'לס	לואיזיאנה	אוהיו	אוהיו
ארקנסו	אלסקה	אני	מיין	אישור	אוקלהומה
אריזונה	אריזונה	MD	מרילנד	או	אורגון
AR	ארקנסו	MA	מסצ'וסטס	PA	פנסילבניה
CA	קליפורניה	MI	מישיגן	RI	רוד איילנד
CO	קולורדו	ז'	מינסוטה	SC	קרוליינה הדרומית
CT	קונטיקט	MS	מיסיסיפי	SD	דקוטה הדרומית
DE	דלאוור	מיזורי	מיזורי	TN	טנסי
FL	פלורידה	MT	מונטנה	TX	טקסס
GA	ג'ורג'יה	צפ'-מז'	נברסקה	יוטה	יוטה
HI	הוואי	NV	נבדה	שיעור המרה (VT)	ורמונט
מזהה	איידהו	NH	ניו המפשייר	VA	וירג'יניה
IL	אילינוי	ניו ג'רזי	ניו ג'רזי	WA	וושינגטון
IN	אינדיאנה	NM	ניו מקסיקו	WV	וירג'יניה המערבית
איווה	איווה	ניו יורק	ניו יורק	WI	וויסקונסין
קנזס	קנזס	NC	קרוליינה הצפונית	WY	וויומינג
קנטקי	קנטקי	דק'	דקוטה הצפונית

חזרה למעלה

תכונות רגילות

שאר התכונות בדף הזה הן תכונות רגילות של תרשים.

כותרת התרשים 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".

 

דוגמאות

תיאור	דוגמה
תרשים עם כותרת, עם צבע וגודל גופן שמוגדרים כברירת מחדל. צריך לציין רווח עם סימן חיבור (+). כדי לאלץ מעבר שורה, צריך להשתמש בתו קו אנכי (|). chts לא צוין כאן.	chtt=Site+visitors+by+month| January+to+July
תרשים עם כותרת כחולה ביישור לימין של 20 נקודות.	chtt=Site+visitors chts=FF0000,20,r

חזרה למעלה

שולי התרשים chma [כל התרשימים]

אפשר לציין את גודל השוליים של התרשים, בפיקסלים. השוליים מחושבים פנימה מהגודל שצוין בתרשים (chs). הגדלה של השוליים לא מגדילה את הגודל הכולל של התרשים, אלא רק מכווצת את שטח התרשים, במקרה הצורך.

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

שולי התרשים כוללים את תוויות הצירים ואת אזור המקרא. גודל האזור של המקרא משתנה באופן אוטומטי כך שיתאים בדיוק לטקסט, אלא אם מציינים רוחב גדול יותר באמצעות chma. במקרה כזה הוא מרחיבים את השוליים ומכווצים את שטח התרשים. לא ניתן לחתוך מקרא על ידי ציון גודל קטן מדי, אבל אפשר לתפוס יותר מקום מהנדרש. טיפ: בתרשים עמודות, אם לעמודות יש גודל קבוע (ברירת המחדל), לא ניתן להקטין את רוחב האזור בתרשים. צריך לציין פס קטן יותר או עמודה שניתן לשנות את הגודל שלה באמצעות chbh.

 

תחביר

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 פיקסלים, ולכן השוליים שבצד שמאל מוגדרים לרוחב של מקרא התרשים, והם שונים מהשוליים האחרים. תוויות הצירים נמצאות מחוץ לאזור התרשים, ולכן הן משורטטות בתוך שטח השוליים.	chma=30,30,30,30
כדי להוסיף שוליים סביב המקרא, מגדירים ערך לפרמטרים <opt_legend_width> ו-<opt_legend_height>. בדוגמה הזו, המקרא הוא ברוחב של כ-60 פיקסלים. אם תגדירו את <opt_legend_width> ל-80 פיקסלים, השוליים יורחבו ל-20 פיקסלים מחוץ למקרא.	chma=20,20,20,30|80,20

חזרה למעלה

מילוי ברקע chf [כל התרשימים]

אפשר לציין צבעים וסגנונות מילוי לאזור הנתונים של התרשים ו/או לכל הרקע של התרשים. סוגי המילוי כוללים מילויים מלאים, מילויים מפוספסים והדרגה. אפשר לציין מילויים שונים לאזורים שונים (לדוגמה, לכל אזור התרשים או רק לאזור הנתונים). מילוי השטח של התרשים יחליף את המילוי ברקע. כל המילויים מצוינים באמצעות הפרמטר chf, וניתן לשלב סוגי מילוי שונים (מלאים, פסים, צבעים הדרגתיים) באותו תרשים, על ידי הפרדה בין ערכים באמצעות קו אנכי ( | ). מילוי אזור התרשים מחליף את מילויי הרקע של התרשים.

מילוי מלא chf [כל התרשימים]

אפשר לציין מילוי מלא לרקע ו/או לאזור התרשים, או להקצות ערך שקיפות לכל התרשים. אפשר לציין מספר מילויים באמצעות התו בצינורות (|). (מפות: רקע בלבד).

תחביר

chf=<fill_type>,s,<color>|...

<fill_type>

החלק בתרשים שממלא. אפשר לציין את אחד מהערכים הבאים:

• bg - מילוי רקע
• c – מילוי אזור התרשים. האפשרות הזו לא נתמכת בתרשימי מפה.
• a - הגדרת כל התרשים (כולל רקעים) שקופים. המערכת מתעלמת משש הספרות הראשונות של <color>, ורק שתי הספרות האחרונות (ערך השקיפות) חלות על התרשים כולו ועל כל המילוי.
• b<index> - מילויים מלאים בעמודות (בתרשימי עמודות בלבד). מחליפים את <index> באינדקס הסדרה של העמודות שיתמלאו בצבע אחיד. האפקט דומה לציון הערך chco בתרשים עמודות. מידע נוסף מופיע בקטע צבעי סדרת העמודות.

שנ'

מציין מילוי מלא או שקיפות.

<color>

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

 

דוגמאות

תיאור	דוגמה
הדוגמה הזו ממלאת את רקע התרשים בצבע אפור בהיר (EFEFEF).	chf=bg,s,EFEFEF
הדוגמה הזו ממלאת את רקע התרשים בצבע אפור בהיר (EFEFEF) וממלאת את אזור התרשים בשחור (000000).	chf=c,s,000000| bg,s,EFEFEF
בדוגמה הזו ניתן להחיל שקיפות של 50% על כל התרשים (80 בהקסדצימליים הם 128, או כ-50% שקיפות). שמים לב לרקע של התא בטבלה שמוצג דרך התרשים.	chf=a,s,00000080

חזרה למעלה

פורמט צבע

צריך לציין צבעים באמצעות מחרוזת בת 6 תווים של ערכים הקסדצימליים, בתוספת שני ערכי שקיפות אופציונליים, בפורמט RRGGBB[AA]. לדוגמה:

• FF0000 = אדום
• 00FF00 = ירוק
• 0000FF = כחול
• 000000 = שחור
• FFFFFF = לבן

AA הוא ערך שקיפות אופציונלי, שבו הערך 00 הוא שקיפות מלאה ו-FF אטום לחלוטין. לדוגמה:

• 0000FFFF = כחול מלא
• 0000FF66 = כחול שקוף

חזרה למעלה