סקירה כללית
תרשים גיאוגרפי הוא מפה של מדינה, יבשת או אזור, כאשר האזורים מזוהים באחת משלוש דרכים:
- המצב region מייצג אזורים שלמים, כמו מדינות, מחוזות או מדינות.
- במצב סמנים משתמשים במעגלים כדי לציין אזורים שגודלם משתנה בהתאם לערך שציינתם.
- במצב text אפשר להוסיף תוויות לאזורים לפי מזהים (למשל, "רוסיה" או "אסיה").
התרשים מוצג בדפדפן באמצעות SVG או VML. חשוב לזכור שהתרשים הגאוגרפי לא ניתן לגלילה או לגרירה, והוא מאפשר שרטוט של קו ולא מפת פני שטח. אם ברצונך ליצור תרשים , מומלץ להשתמש בהצגה חזותית של המפה.
תרשימים אזוריים
הסגנון regions ממלא אזורים שלמים (בדרך כלל
מדינות) בצבעים שתואמים את הערכים שמקצים.
<html>
<head>
<script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script>
<script type="text/javascript">
google.charts.load('current', {
'packages':['geochart'],
});
google.charts.setOnLoadCallback(drawRegionsMap);
function drawRegionsMap() {
var data = google.visualization.arrayToDataTable([
['Country', 'Popularity'],
['Germany', 200],
['United States', 300],
['Brazil', 400],
['Canada', 500],
['France', 600],
['RU', 700]
]);
var options = {};
var chart = new google.visualization.GeoChart(document.getElementById('regions_div'));
chart.draw(data, options);
}
</script>
</head>
<body>
<div id="regions_div" style="width: 900px; height: 500px;"></div>
</body>
</html>
תרשימים גיאוגרפיים של סמנים
הסגנון markers מעבד מעגלים במיקומים ספציפיים בתרשים הגיאוגרפי, בצבע ובגודל שציינתם.
נסו להעביר את העכבר מעל הסמנים העמוסים ברחבי רומא וזכוכית מגדלת תיפתח כדי להציג את הסמנים בפירוט. (זכוכית המגדלת אינה נתמכת ב-Internet Explorer גרסה 8 או קודמת).
<html>
<head>
<script type='text/javascript' src='https://www.gstatic.com/charts/loader.js'></script>
<script type='text/javascript'>
google.charts.load('current', {
'packages': ['geochart'],
// Note: Because markers require geocoding, you'll need a mapsApiKey.
// See: https://developers.google.com/chart/interactive/docs/basic_load_libs#load-settings
'mapsApiKey': 'AIzaSyD-9tSrke72PouQMnMX-a7eZSW0jkFMBWY'
});
google.charts.setOnLoadCallback(drawMarkersMap);
function drawMarkersMap() {
var data = google.visualization.arrayToDataTable([
['City', 'Population', 'Area'],
['Rome', 2761477, 1285.31],
['Milan', 1324110, 181.76],
['Naples', 959574, 117.27],
['Turin', 907563, 130.17],
['Palermo', 655875, 158.9],
['Genoa', 607906, 243.60],
['Bologna', 380181, 140.7],
['Florence', 371282, 102.41],
['Fiumicino', 67370, 213.44],
['Anzio', 52192, 43.43],
['Ciampino', 38262, 11]
]);
var options = {
region: 'IT',
displayMode: 'markers',
colorAxis: {colors: ['green', 'blue']}
};
var chart = new google.visualization.GeoChart(document.getElementById('chart_div'));
chart.draw(data, options);
};
</script>
</head>
<body>
<div id="chart_div" style="width: 900px; height: 500px;"></div>
</body>
</html>
הצגת סמנים יחסיים
בדרך כלל, התרשימים הגיאוגרפיים מציגים את ערך הסמן הקטן ביותר כנקודה מינימלית. אם במקום זאת תרצו להציג ערכים יחסיים של סמנים (למשל, כי מדובר באחוזים), השתמשו באפשרות sizeAxis כדי להגדיר את minValue ואת maxValue באופן מפורש.
לדוגמה, זוהי מפה של מערב אירופה עם אוכלוסיה ואזורים של שלוש מדינות: צרפת, גרמניה ופולין. האוכלוסיה היא מספר מוחלט (למשל 65 מיליון בצרפת), אבל כל האזורים הם אחוזים שלמים: הסמן הצרפתי הוא סיגל צבעוני מפני שהאוכלוסייה שלו בינונית, אבל הגודל שלו הוא 50 ( מתוך 100 אפשריים) מפני שהוא מכיל 50% מהאזור המשולב.
בקוד הזה, אנחנו משתמשים ב-sizeAxis לציון גודלי הסמנים בטווח שבין 0 ל-100. בנוסף, אנחנו משתמשים בשיטת colorAxis עם ערכי RGB כדי להציג את האוכלוסיות בטווח של צבעים, מכתום לכחול – טווח רחב לטובת משתמשים עם ליקויי ראייה. לבסוף, אנחנו מציינים את מערב אירופה עם region מתוך 155 בקטע 'היררכיית קוד וקודים של תוכן' בהמשך המסמך.
<html>
<head>
<script type='text/javascript' src='https://www.gstatic.com/charts/loader.js'></script>
<script type='text/javascript'>
google.charts.load('current', {
'packages': ['geochart'],
// Note: Because markers require geocoding, you'll need a mapsApiKey.
// See: https://developers.google.com/chart/interactive/docs/basic_load_libs#load-settings
'mapsApiKey': 'AIzaSyD-9tSrke72PouQMnMX-a7eZSW0jkFMBWY'
});
google.charts.setOnLoadCallback(drawMarkersMap);
function drawMarkersMap() {
var data = google.visualization.arrayToDataTable([
['Country', 'Population', 'Area Percentage'],
['France', 65700000, 50],
['Germany', 81890000, 27],
['Poland', 38540000, 23]
]);
var options = {
sizeAxis: { minValue: 0, maxValue: 100 },
region: '155', // Western Europe
displayMode: 'markers',
colorAxis: {colors: ['#e7711c', '#4374e0']} // orange to blue
};
var chart = new google.visualization.GeoChart(document.getElementById('chart_div'));
chart.draw(data, options);
};
</script>
</head>
<body>
<div id="chart_div" style="width: 900px; height: 500px;"></div>
</body>
</html>
תרשימים גיאוגרפיים
ניתן להוסיף שכבות-על של תוויות טקסט לתרשים גיאוגרפי באמצעות displayMode:
text.
var data = google.visualization.arrayToDataTable([
['Country', 'Popularity'],
['South America', 600],
['Canada', 500],
['France', 600],
['Russia', 700],
['Australia', 600]
]);
var options = { displayMode: 'text' };
<html>
<head>
<script type='text/javascript' src="https://www.gstatic.com/charts/loader.js"></script>
<div id="regions_div" style="width: 900px; height: 500px;"></div>
<script type="text/javascript">
google.charts.load('current', {
'packages': ['geochart'],
// Note: Because this chart requires geocoding, you'll need a mapsApiKey.
// See: https://developers.google.com/chart/interactive/docs/basic_load_libs#load-settings
'mapsApiKey': 'AIzaSyD-9tSrke72PouQMnMX-a7eZSW0jkFMBWY'
});
google.charts.setOnLoadCallback(drawRegionsMap);
function drawRegionsMap() {
var data = google.visualization.arrayToDataTable([
['Country', 'Popularity'],
['South America', 600],
['Canada', 500],
['France', 600],
['Russia', 700],
['Australia', 600]
]);
var options = { displayMode: 'text' };
var chart = new google.visualization.GeoChart(document.getElementById('regions_div'));
chart.draw(data, options);
}
</script>
</head>
<body>
<div id="chart_div" style="width: 900px; height: 500px;"></div>
</body>
</html>
צביעת התרשים
יש כמה אפשרויות להתאמה אישית של הצבעים של GeoCharts:
colorAxis: קשת הצבעים שבה אפשר להשתמש באזורים שבטבלת הנתונים.backgroundColor: צבע הרקע של התרשים.datalessRegionColor: הצבע שרוצים להקצות לאזורים שלא משויכים אליהם נתונים.defaultColor: הצבע שרוצים להקצות לאזורים בטבלת הנתונים, שהערך שלהם הואnullאו שלא צוין.
האפשרות colorAxis היא החשובה: היא מציינת את טווח הצבעים של ערכי הנתונים. במערך colorAxis, הרכיב הראשון הוא הצבע שניתן לערך הקטן ביותר במערך הנתונים, והרכיב האחרון הוא הצבע הנתון לערך הגדול ביותר במערך הנתונים. אם תציינו יותר משני צבעים, אינטרפולציה תופיע ביניהם.
בתרשים הבא נשתמש בכל ארבע האפשרויות. אפשר להשתמש ב-colorAxis כדי להציג את אפריקה בצבעי הדגל הפאן-אפריקאי, באמצעות קווי הרוחב של המדינות: מאדום בצפון, בשחור, בירוק ובדרום. האפשרות backgroundColor משמשת לצביעת הרקע בכחול בהיר, datalessRegionColor לצבעי המדינות שאינן אפריקאיות בוורוד בהיר וdefaultColor למדגסקר.
var options = {
region: '002', // Africa
colorAxis: {colors: ['#00853f', 'black', '#e31b23']},
backgroundColor: '#81d4fa',
datalessRegionColor: '#f8bbd0',
defaultColor: '#f5f5f5',
};
<html>
<head>
<script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script>
<script type="text/javascript">
google.charts.load('current', {
'packages':['geochart'],
// Note: Because this chart requires geocoding, you'll need mapsApiKey.
// See: https://developers.google.com/chart/interactive/docs/basic_load_libs#load-settings
'mapsApiKey': 'AIzaSyD-9tSrke72PouQMnMX-a7eZSW0jkFMBWY'
});
google.charts.setOnLoadCallback(drawRegionsMap);
function drawRegionsMap() {
var data = google.visualization.arrayToDataTable([
['Country', 'Latitude'],
['Algeria', 36], ['Angola', -8], ['Benin', 6], ['Botswana', -24],
['Burkina Faso', 12], ['Burundi', -3], ['Cameroon', 3],
['Canary Islands', 28], ['Cape Verde', 15],
['Central African Republic', 4], ['Ceuta', 35], ['Chad', 12],
['Comoros', -12], ['Cote d\'Ivoire', 6],
['Democratic Republic of the Congo', -3], ['Djibouti', 12],
['Egypt', 26], ['Equatorial Guinea', 3], ['Eritrea', 15],
['Ethiopia', 9], ['Gabon', 0], ['Gambia', 13], ['Ghana', 5],
['Guinea', 10], ['Guinea-Bissau', 12], ['Kenya', -1],
['Lesotho', -29], ['Liberia', 6], ['Libya', 32], ['Madagascar', null],
['Madeira', 33], ['Malawi', -14], ['Mali', 12], ['Mauritania', 18],
['Mauritius', -20], ['Mayotte', -13], ['Melilla', 35],
['Morocco', 32], ['Mozambique', -25], ['Namibia', -22],
['Niger', 14], ['Nigeria', 8], ['Republic of the Congo', -1],
['Réunion', -21], ['Rwanda', -2], ['Saint Helena', -16],
['São Tomé and Principe', 0], ['Senegal', 15],
['Seychelles', -5], ['Sierra Leone', 8], ['Somalia', 2],
['Sudan', 15], ['South Africa', -30], ['South Sudan', 5],
['Swaziland', -26], ['Tanzania', -6], ['Togo', 6], ['Tunisia', 34],
['Uganda', 1], ['Western Sahara', 25], ['Zambia', -15],
['Zimbabwe', -18]
]);
var options = {
region: '002', // Africa
colorAxis: {colors: ['#00853f', 'black', '#e31b23']},
backgroundColor: '#81d4fa',
datalessRegionColor: '#f8bbd0',
defaultColor: '#f5f5f5',
};
var chart = new google.visualization.GeoChart(document.getElementById('geochart-colors'));
chart.draw(data, options);
};
</script>
</head>
<body>
<div id="geochart-colors" style="width: 700px; height: 433px;"></div>
</body>
</html>
בטעינה
שם החבילה של google.charts.load הוא "geochart".
לתשומת לבך, אין להעתיק את המפות של ApiKey; זה לא יעבוד. אם אין צורך ב-geocoding כדי להשתמש בתרשים או להשתמש בקודים לא סטנדרטיים כדי לזהות מיקומים, אין צורך ב-mapsApiKey. לפרטים נוספים, אפשר לקרוא על
הגדרות טעינה.
google.charts.load('current', {
'packages': ['geochart'],
// Note: if your chart requires geocoding or uses nonstandard codes, you'll
// need to get a mapsApiKey for your project. The one below won't work.
// See: https://developers.google.com/chart/interactive/docs/basic_load_libs#load-settings
'mapsApiKey': 'AIzaSyD-9tSrke72PouQMnMX-a7eZSW0jkFMBWY'
});
שם הסיווג של התרשים החזותי הוא google.visualization.GeoChart.
var visualization = new google.visualization.GeoChart(container);
פורמט נתונים
הפורמט של ה-DataTable ישתנה בהתאם למצב התצוגה שבו אתם משתמשים:
regions, markers או text.
פורמט מצב Regions
המיקום מוזן בעמודה אחת, בתוספת עמודה אופציונלית כפי שמתואר כאן:
-
מיקום האזור [מחרוזת, חובה] – אזור להדגשה.
ניתן להשתמש בכל הפורמטים הבאים. אפשר להשתמש בפורמטים שונים בשורות שונות:
- שם מדינה כמחרוזת (לדוגמה, "אנגליה") או קוד ISO-3166-1 alpha-2 באותיות גדולות או שווה-ערך באנגלית (לדוגמה, "GB" או "בריטניה").
- שם אזור באותיות גדולות מסוג ISO-3166-2 או בפורמט טקסט מקביל באנגלית (לדוגמה, "US-NJ" או "New לבני ג'רזי").
- קוד אזור במטרופוליטן . אלו הם קודים של אזורי מטרופולין באורך שלוש ספרות המשמשים להקצאה של אזורים שונים. קודים של ארה"ב נתמכים רק. חשוב לשים לב שאלה לא זהים לקידומות אזור חיוג בטלפון.
- כל ערך שנתמך על ידי המאפיין
region.
-
צבע האזור [מספר, אופציונלי] – עמודה מספרית אופציונלית
המשמשת לצביעה באזור זה, על סמך קנה המידה שצוין בנכס
colorAxis.colors. אם העמודה הזו לא קיימת, כל האזורים יהיו באותו צבע. אם העמודה קיימת, אסור להשתמש בערכים ריקים (null). הערכים מותאמים לערכיsizeAxis.minValue/sizeAxis.maxValueאו לערכים שצוינו בנכסcolorAxis.values, אם צוינו.
הפורמט של מצב הסמנים
מספר העמודות משתנה בהתאם לפורמט הסימון שבו משתמשים, וכן לעמודות אופציונליות אחרות.
-
מיקום הסמן [חובה]
או
העמודה הראשונה היא כתובת מחרוזת ספציפית (לדוגמה, "שדרות פנסיון 1600").שתי העמודות הראשונות הן מספריות, כאשר העמודה הראשונה היא קו הרוחב והעמודה השנייה היא קו האורך.
הערה: אנחנו ממליצים להשתמש בקודי ISO 3166 גם במצב 'אזורים', אבל מצב 'סמנים' פועל בצורה מועילה עם שמות ארוכים יותר לאזורים (כמו גרמניה, פנמה וכו'). הסיבה לכך היא שתרשימים גיאוגרפיים, במצב 'סמנים', משתמשים במפות Google לקידוד גיאוגרפי של המיקומים (המרת מיקום של מחרוזת לקו רוחב וקו אורך). שינוי זה עלול לגרום לכך שמיקומים דו-משמעיים לא יסונכרנו כפי שניתן לצפות. למשל, מצב 'DE' לגרמניה או דלאוור, או 'PA' לפנמה או לפנסילבניה.
-
צבע סמן [מספר, אופציונלי] העמודה הבאה היא עמודה מספרית אופציונלית
המשמשת לצביעה של הסמן הזה, על בסיס קנה המידה שצוין בנכס
colorAxis.colors. אם עמודה זו לא קיימת, כל הסמנים יהיו באותו צבע. אם העמודה קיימת, אסור להשתמש בערכים ריקים (null). הערכים מדורגים זה ביחס לזה או באופן מוחלט לערכים שצוינו במאפייןcolorAxis.values. - גודל הסמן [מספר, אופציונלי] עמודה מספרית אופציונלית המשמשת להקצאת גודל הסמן, ביחס לגודלי הסמן האחרים. אם עמודה זו לא קיימת, המערכת תשתמש בערך שמופיע בעמודה הקודמת (או בגודל ברירת המחדל, אם לא סופקה גם עמודה). אם העמודה קיימת, אסור להשתמש בערכים ריקים (null).
פורמט של מצב טקסט
התווית מוזנת בעמודה הראשונה ועמודה אופציונלית אחת:
- Label text [מחרוזת, חובה] כתובת ספציפית של מחרוזת (לדוגמה "1600 Pennsylvania Ave").
- Size text [Number, optional] העמודה השנייה היא עמודה נומרית אופציונלית שמשמשת להקצאת גודל התווית. אם העמודה הזו לא קיימת, כל התוויות יהיו באותו גודל.
אפשרויות הגדרה
| שם | |
|---|---|
| צבע רקע |
צבע הרקע של האזור הראשי בתרשים. הוא יכול להיות מחרוזת צבע פשוטה ב-HTML, לדוגמה: Type: מחרוזת או אובייקט
ברירת מחדל: לבן
|
| backgroundColor.fill |
צבע המילוי של התרשים, כמחרוזת צבע של HTML. סוג: מחרוזת
ברירת מחדל: לבן
|
| הפעלה ברקע |
צבע הגבול של התרשים, כמחרוזת צבע של HTML. סוג: מחרוזת
ברירת מחדל: '#666'
|
| colorColor.stringWidth |
רוחב הגבול, בפיקסלים. סוג: מספר
ברירת מחדל: 0
|
| צבע ציר |
אובייקט שמציין מיפוי בין ערכים וצבעים של עמודת צבע או סולם הדרגתי. כדי לציין מאפיינים של אובייקט זה, ניתן להשתמש בסימון מילולי של אובייקט, כפי שמוצג כאן: {minValue: 0, colors: ['#FF0000', '#00FF00']}
Type: אובייקט
ברירת מחדל: null
|
| colorAxis.minValue |
אם השדה הזה קיים, מציין ערך מינימלי לנתוני צבע של תרשים. הערכים של נתוני צבעים מהערך הזה
ונמוכים יותר יוצגו כצבע הראשון בטווח של סוג: מספר
ברירת מחדל: הערך המינימלי של עמודת הצבע בנתוני התרשים
|
| colorAxis.maxValue |
אם השדה הזה קיים, הוא מציין ערך מקסימלי לנתוני צבע של תרשים. הערכים של נתוני צבעים מהערך הזה
ומעלה יוצגו כצבע האחרון בטווח סוג: מספר
ברירת מחדל: הערך המקסימלי של עמודת הצבע בנתוני התרשים
|
| צבעAxis.values |
אם השדה הזה קיים, שולט באופן שבו הערכים משויכים לצבעים. כל ערך משויך לצבע שתואם במערך Type: מערך של מספרים
ברירת מחדל: null
|
| צבעAxis.colors |
הצבעים שרוצים להקצות לערכים בתצוגה החזותית. מערך של מחרוזות, כאשר כל רכיב הוא מחרוזת צבע HTML. לדוגמה: סוג: מערך של מחרוזות צבע
ברירת מחדל: null
|
| datalessRegionColor |
הצבע שצריך להקצות לאזורים שאין להם נתונים משויכים. סוג: מחרוזת
ברירת מחדל: ' #F5F5F5'
|
| ברירת מחדל של צבע |
הצבע של נקודות נתונים בתרשים גיאוגרפי במיקום הנוכחי (למשל: סוג: מחרוזת
ברירת מחדל: '#267114'
|
| מצב תצוגה |
סוג סוג של תרשים גיאוגרפי. פורמט DataTable חייב להתאים לערך שצוין. יש תמיכה בערכים הבאים:
סוג: מחרוזת
ברירת מחדל: 'אוטומטי'
|
| דומיין |
הצגת התרשים הגיאוגרפי כאילו הוא הוצג באזור הזה. לדוגמה, הגדרת הערך סוג: מחרוזת
ברירת מחדל: null
|
| enableRegionInteractivity |
אם הערך הוא True, יש להפעיל אינטראקטיביות של אזור, כולל העברת המיקוד והטיפים על כלי העכבר
בהעברת העכבר מעליו, וגם בחירת אזור והפעלה של אירועים מסוג ברירת המחדל היא 'מצב אזור' ו-FALSE במצב סמן. סוג: בוליאני
ברירת מחדל: אוטומטי
|
| forceIFrame |
משרטט את התרשים בתוך מסגרת מוטבעת. (שימו לב שב-IE8 המערכת מתעלמת מהאפשרות הזו. כל התרשימים של IE8 מצוירים ב-i-frames). סוג: בוליאני
ברירת מחדל: False
|
| גרסה גיאוגרפית |
גרסת נתוני הגבולות הגיאוגרפיים של התרשים. גרסאות סוג: מספר
ברירת מחדל:10
|
| גובה |
גובה התצוגה, בפיקסלים. גובה ברירת המחדל הוא 347 פיקסלים, אלא אם האפשרות
סוג: מספר
ברירת מחדל: אוטומטי
|
| keepAspectRatio |
אם היא מקבלת את הערך true, התרשים יעוצב בתוך הגודל הגדול ביותר שניתן להתאים בתוך שטח התרשים
ביחס הגובה-רוחב הטבעי. אם צוינה רק אחת מהאפשרויות של
אם False, התרשים יימתח לאורך המדויק של התרשים כפי שצוין באפשרויות
סוג: בוליאני
ברירת מחדל: נכון
|
| מקרא |
אובייקט עם חברים כדי להגדיר היבטים שונים של המקרא, או 'ללא', אם לא אמור להופיע מקרא. כדי לציין מאפיינים של אובייקט זה, ניתן להשתמש בסימון מילולי של אובייקט, כפי שמוצג כאן: {textStyle: {color: 'blue', fontSize: 16}}
Type: אובייקט / 'none'
ברירת מחדל: null
|
| האגדה.מספרהפורמט |
מחרוזת פורמט עבור תוויות מספריות. זו קבוצת משנה של
קבוצת דפוסי ICU
.
למשל, הערכים "10.66", "10.6" ו-"10.0" יוצגו על ידי סוג: מחרוזת
ברירת מחדל: אוטומטי
|
| style.textStyle |
אובייקט שמציין את סגנון הטקסט של המקרא. לאובייקט יש את הפורמט הבא:
{ color: <string>,
fontName: <string>,
fontSize: <number>,
bold: <boolean>,
italic: <boolean> }
השדה Type: אובייקט
ברירת מחדל:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| region |
האזור שיש להציג בתרשים הגיאוגרפי. (יוצגו גם אזורים מסביב). יכול להיות אחת מהאפשרויות הבאות:
סוג: מחרוזת
ברירת מחדל: 'עולם'
|
| זכוכית מגדלת |
אובייקט עם חברים שמגדיר היבטים שונים של הזכוכית המגדלת. כדי לציין מאפיינים של אובייקט זה, ניתן להשתמש בסימון מילולי של אובייקט, כפי שמוצג כאן: {enable: true, zoomFactor: 7.5}
סוג: אובייקט
ברירת מחדל:
{enable: true, zoomFactor: 5.0} |
| זכוכית מגדלת.enable |
אם True, כשהמשתמש משתהה על סמן מבולגן, נפתחת זכוכית מגדלת. הערה: התכונה הזו לא נתמכת בדפדפנים שלא תומכים ב-SVG, כלומר Internet Explorer גרסה 8 או גרסאות קודמות. סוג: בוליאני
ברירת מחדל: נכון
|
| זכוכית מגדלת.מרחק מתצוגה |
גורם הזום של זכוכית המגדלת. יכול להיות כל מספר שגדול מ-0. סוג: מספר
ברירת מחדל: 5.0
|
| cursorOpacity (סמן |
השקיפות של השקיפות, כאשר 0.0 היא שקופה לחלוטין ו-1.0 אטומה לחלוטין. סוג: מספר, 0.0–1.0
ברירת מחדל: 1.0
|
| גרסת אזור שוק |
הגרסה של נתוני המקודד האזורי. גרסאות סוג: מספר
ברירת מחדל: 0
|
| רזולוציה |
הרזולוציה של גבולות התרשים הגיאוגרפי. יש לבחור אחד מהערכים הבאים:
סוג: מחרוזת
ברירת מחדל: 'מדינות'
|
| גודלציר |
אובייקט עם חברים כדי להגדיר איך הערכים ישויכו לגודל הבועה. כדי לציין מאפיינים של אובייקט זה, ניתן להשתמש בסימון מילולי של אובייקט, כפי שמוצג כאן: {minValue: 0, maxSize: 20}
Type: אובייקט
ברירת מחדל: null
|
| גודלAxis.maxSize |
הרדיוס המקסימלי של הבועה הכי גדולה שאפשר, בפיקסלים. סוג: מספר
ברירת מחדל: 12
|
| sizeAxis.maxValue |
ערך הגודל (כפי שמופיע בנתוני התרשים) למיפוי אל סוג: מספר
ברירת מחדל: הערך המקסימלי של עמודת הגודל בנתוני התרשים
|
| sizeAxis.minSize |
רדיוס מינימלי של הבועה הקטנה ביותר האפשרית, בפיקסלים. סוג: מספר
ברירת מחדל: 3
|
| sizeAxis.minValue |
ערך הגודל (כפי שמופיע בנתוני התרשים) למיפוי אל סוג: מספר
ברירת מחדל: הערך המינימלי של עמודת הגודל בנתוני התרשים
|
| הסבר קצר |
אובייקט עם חברים להגדרת אלמנטים שונים של הסבר קצר. כדי לציין מאפיינים של אובייקט זה, ניתן להשתמש בסימון מילולי של אובייקט, כפי שמתואר כאן: {textStyle: {color: '#FF0000'}, showColorCode: true}
Type: אובייקט
ברירת מחדל: null
|
| overview.textStyle |
אובייקט שמציין את סגנון הטקסט של ההסבר הקצר. לאובייקט יש את הפורמט הבא:
{ color: <string>,
fontName: <string>,
fontSize: <number>,
bold: <boolean>,
italic: <boolean> }
השדה Type: אובייקט
ברירת מחדל:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| overview.trigger |
האינטראקציה של המשתמש שגרמה להצגת ההסבר הקצר:
סוג: מחרוזת
ברירת מחדל: 'התמקדות'
|
| רוחב |
רוחב התצוגה, בפיקסלים. רוחב ברירת המחדל הוא 556 פיקסלים, אלא אם האפשרות
סוג: מספר
ברירת מחדל: אוטומטי
|
היררכיה וקודים של מדינות יבשתיות
ניתן להציג תרשימים גיאוגרפיים של יבשות/יבשות על ידי הגדרת האפשרות
region באחד מ-3 הספרות הבאות. הקודים וההיררכיה מבוססים, למעט כמה יוצאים מן הכלל, על אלה שפותחו ומתוחזקים על ידי
החטיבה הסטטיסטית של האו"ם
.
| יבשת | תת-יבשת | מדינות |
|---|---|---|
002 – אפריקה |
015 – צפון אפריקה |
DZ, EG, EH, LY, MA, SD, SS, TN |
011 – מערב אפריקה |
BF, BJ, CI, CV, GH, GM, GN, GW, LR, ML, 2{2,NN{2,N{2,N{2,NN{2,NNNNNNNNNNNNNNNNNN} | |
017 – מרכז אפריקה |
AO, CD, ZR, CF, CG, CM, GA, GQ, ST, TD | |
014 – מזרח אפריקה |
||
018 – דרום אפריקה |
BW, LS, NA, SZ, ZA | |
150 – אירופה |
154 – צפון אירופה |
GG, JE, AX, DK, EE, FI, FO, GB, IE, IM, 22{2,NO} |
155 – מערב אירופה |
AT, BE, CH, DE, DD, FR, FX, LI, LU, MC, NL | |
151 – מזרח אירופה |
BG, BY, CZ, HU, MD, PL, RO, RU, SU, SK, UA} | |
039 – דרום אירופה |
AD, AL, BA, ES, GI, GR, HR, IT, ME, M2,222,22}2222 | |
019 – אמריקה |
021 – צפון אמריקה |
BM , CA , GL , PM, US |
029 – קאריבי |
||
013 – מרכז אמריקה |
BZ, CR, GT, HN, MX, NI, PA, SV | |
005 – דרום אמריקה |
AR, BO, BR, CL, CO, EC, FK, GF, GY, PE{/29, {2{/22,22{/22 {2, {2 | |
142 – אסיה |
143 – מרכז אסיה |
TM, TJ, KG, KZ, UZ |
030 – מזרח אסיה |
CN, HK, JP, KP, KR, MN, MO, TW | |
034 – דרום אסיה |
AF, BD, BT, IN, IR, LK, MV, NP, PK | |
035 – דרום-מזרח אסיה |
BN, ID, KH, LA, MM, BU, MY, PH, SG, TH, TL{/2,2{2,2 {2,T{/22,2{2,2{/2 2 | |
145 – מערב אסיה |
||
009 – אוקיאניה |
053 – אוסטרליה וניו זילנד |
AU, NF, NZ |
054 – מלנזיה |
FJ, NC, PG, SB, VU | |
057 – מיקרונזיה |
FM, GU, KI, MH, MP, NR, PW | |
061 – פולינזיה |
AS, CK, NU, PF, PN, TK, TO, טלוויזיה, WF, WS |
שיטות
| שיטה | |
|---|---|
clearChart() |
ניקוי התרשים ושחרור כל המשאבים שהוקצו לו. סוג החזרה: אין
|
draw(data, options) |
משרטט את התרשים. התרשים מקבל קריאות נוספות לשיטה רק אחרי
האירוע סוג החזרה: אין
|
getImageURI() |
מחזירה את התרשים בהמשכים כ-URI של תמונה. כדאי לקרוא לזה אחרי שהתרשים משורטט. מידע נוסף זמין במאמר הדפסה של תרשימי PNG. סוג החזרה: מחרוזת
|
getSelection() |
היא מחזירה מערך של ישויות התרשים שנבחרו.
ישויות לבחירה הן אזורים עם ערך שהוקצה.
בתרשים הזה אפשר לבחור רק ישות אחת בכל רגע נתון.
סוג החזרה: מערך של רכיבי בחירה
|
setSelection() |
בחירת ישויות התרשים שצוינו. ביטול כל בחירה קודמת.
ישויות לבחירה הן אזורים עם ערך שהוקצה.
בתרשים הזה אפשר לבחור רק ישות אחת בכל פעם.
סוג החזרה: אין
|
אירועים
| שם | |
|---|---|
error |
מופעל כשמתרחשת שגיאה במהלך הניסיון לעבד את התרשים. מאפיינים: מזהה, הודעה
|
ready |
התרשים מוכן לקריאות חיצוניות לשיטה אם רוצים ליצור אינטראקציה עם התרשים ועם
שיטות השיחה אחרי ששרטטים אותו, צריך להגדיר למאזינים אירוע זה לפני שמתקשרים אל השיטה מאפיינים: ללא
|
regionClick |
מתקשרים כשלוחצים על אזור. המערכת לא תשלים לגבי המדינה הספציפית שצוינה באפשרות 'אזור' (אם מדינה מסוימת נכללה ברשימה).
מאפיינים:
אובייקט עם מאפיין יחיד (
region), שהוא מחרוזת בפורמט ISO-3166
שמתארת את האזור שעליו לוחצים.
|
select |
מופעל כשהמשתמש לוחץ על ישות חזותית. כדי לראות מה נבחר, צריך להתקשר למספר מאפיינים: ללא
|
מדיניות נתונים
המיקומים מופיעים במפות גיאוגרפיות על ידי מפות Google. נתונים שאינם דורשים קידוד גיאוגרפי לא נשלחים לאף שרת. יש לעיין בתנאים ובהגבלות של מפות Google לקבלת מידע נוסף על מדיניות הנתונים שלהם.