עריכת הדף "תבנית:GraphMap/תיעוד"

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

==צורת התבנית==

<code><nowiki>{{GraphMap|basemap=</nowiki>[//de.wikipedia.org/w/index.php?title=Modul:Graph/WorldMap-iso2.json&action=raw WorldMap-iso2.json]<nowiki>|DE=blue|CN=green|RU=#cc0333}}</nowiki></code> <br />
==פרמטרים==
* {{פרמטר|'''basemap:'''}} קובע את מפת הבסיס. הגדרות המפה חייבות להיות בהתאם לפורמט [https://github.com/topojson TopoJSON], שהוא הרחבה של GeoJSON. וכאשר הנתונים נשמרים בוויקיפדיה, הם זמינים עבור מודול זה. התבנית משתמשת בקובץ ברירת מחדל: WorldMap-iso2.json

* {{פרמטר|'''scale:'''}} פקטור קנה המידה של המפה (ברירת מחדל: 100)

* {{פרמטר|'''projection:'''}} היטל המפה. ערך ברירת המחדל הוא equirectangular עבור היטל שווה-מלבן. ערכים נוספים: mercator  ו-וconicEqualArea. 
:הערכים הנתמכים מפורטים בכתובת https://github.com/d3/d3-geo-projection.
:הערה: שם ההיטל יתחיל באות קטנה. (d3.geoMercator יהפוך ל-mercator)

* {{פרמטר| '''center:''' מרכז המפה (מתאים בנתוני המפה לשני הערכים המופרדים בפסיקים של שדה "scale")
* {{פרמטר|'''feature:'''}} אילו אובייקטים גאוגרפיים יש להציג (מתאים בנתוני המפה לשם השדה מתחת לשדה האובייקטים). ברירת המחדל היא מדינות ערך.
* {{פרמטר|'''ids of geographic entities:'''}} מזהים של ישויות גאוגרפיות: שמות הפרמטרים בפועל תלויים במפת הבסיס ובתכונה שנבחרה.  לדוגמה, עבור מפת העולם שהוזכרה לעיל המזהים הם [[ISO 3166-1|קודי מדינות ISO]]. הערכים יכולים להיות שמות צבעים (בפורמט [www.w3schools.com/cssref/css_colors.asp css_colors]) קודי מספרי צבעים, או מספרים במקרה שיש לשייך את הישויות הגאוגרפיות לנתונים מספריים: blue=DE מסמן את גרמניה בצבע כחול, ו-DE=80.6 מקצה לגרמניה את הערך 80.6 (אוכלוסייה במיליונים). במקרה האחרון, הצבע בפועל תלוי בפרמטרים הבאים. את ערכי המדינות יש לכתוב באופן הבא: |קוד מדינה=צבע.

*.{{פרמטר|'''colorScale:'''}} לוח הצבעים לשימוש עבור סולם הצבעים. יש לספק את הפלטה כרשימה מופרדת בפסיקים של ערכי צבעים. ערכי הצבע חייבים להינתן בתור {{קוד|#rgb/#rrggbb}} או בשם צבע (בפורמט [www.w3schools.com/cssref/css_colors.asp css_colors]).  במקום רשימה, ניתן להשתמש גם בפלטות הצבע המובנות {{קוד|category10}} ו {{קוד|category20}}

* {{פרמטר|'''scaleType:'''}} הערכים הנתמכים הם '''linear''' עבור מיפוי ליניארי בין ערכי הנתונים וסולם הצבעים, '''log''' עבור מיפוי לוג, '''pow''' עבור מיפוי חזקה (ניתן לספק את המעריך כ-pow 0.5), '''sqrt''' עבור מיפוי שורש ריבועי, ו-'''quantize''' עבור  סולם כמותי, כלומר הנתונים מקובצים בכמה מחלקות כמו שבפלטת הצבעים קיימים צבעים.
* {{פרמטר|'''domainMin:'''}} גבול תחתון של ערכי הנתונים, כלומר ערכי נתונים קטנים יותר ממופים לגבול התחתון.
* {{פרמטר|'''domainMax:'''}} גבול עליון של ערכי הנתונים, כלומר ערכי נתונים גדולים יותר ממופים לגבול העליון.
* {{פרמטר|'''legend:'''}} הצג מקרא צבע (לא עובד עם quantize)
* {{פרמטר|'''defaultValue:'''}} ערך ברירת מחדל עבור ישויות גאוגרפיות שאינן בשימוש.  במקרה שערכי המזהה הם צבעים, ערך ברירת המחדל הוא כסוף, במקרה של מספרים הוא 0.

== תבנית מאסטר ==
התבנית מכילה את כל קודי המדינות. יש למלא את הפרמטרים של המדינות הנחוצות. כמו כן, ניתן להעתיק לתבנית חדשה את קודי המדינות הנצרכות.
 <div style="max-height:400px; overflow:auto;">
 <pre>
 {{GraphMap
 |basemap = WorldMap-iso2.json
 |<!-- אפגניסטן --> AF =
 |<!-- מצרים --> EG =
 |<!-- אלבניה --> AL =
 |<!-- אלג'יריה --> DZ =
 |<!-- אנדורה --> AD =
 |<!-- אנגולה --> AO =
 |<!-- אנטיגואה וברבודה --> AG =
 |<!-- גינאה המשוונית --> GQ =
 |<!-- ארגנטינה --> AR =
 |<!-- ארמניה --> AM =
 |<!-- אזרבייג'ן --> AZ =
 |<!-- אתיופיה --> ET =
 |<!-- אוסטרליה --> AU =
 |<!-- איי בהאמה --> BS =
 |<!-- בחריין --> BH =
 |<!-- בנגלדש --> BD =
 |<!-- ברבדוס --> BB =
 |<!-- בלארוס --> BY =
 |<!-- בלגיה --> BE =
 |<!-- בליז --> BZ =
 |<!-- בנין --> BJ =
 |<!-- בהוטן --> BT =
 |<!-- בוליביה --> BO =
 |<!-- בוסניה והרצגובינה --> BA =
 |<!-- בוצואנה --> BW =
 |<!-- ברזיל --> BR =
 |<!-- ברוניי דארוסלם --> BN =
 |<!-- בולגריה --> BG =
 |<!-- בורקינה פאסו --> BF =
 |<!-- בורונדי --> BI =
 |<!-- צ'ילה --> CL =
 |<!-- סין, הרפובליקה העממית --> CN =
 |<!-- קוסטה ריקה --> CR =
 |<!-- חוף השנהב (חוף השנהב) --> CI =
 |<!-- דנמרק --> DK =
 |<!-- גרמניה --> DE =
 |<!-- הרפובליקה הדומיניקנית --> DO =
 |<!-- ג'יבוטי --> DJ =
 |<!-- אקוודור --> EC =
 |<!-- אל סלבדור --> SV =
 |<!-- אריתריאה --> ER =
 |<!-- אסטוניה --> EE =
 |<!-- איי פוקלנד --> FK =
 |<!-- פיג'י --> FJ =
 |<!-- פינלנד --> FI =
 |<!-- צרפת --> FR =
 |<!-- הטריטוריות הדרומיות והאנטארקטיות הצרפתיות --> TF =
 |<!-- צרפת, קלדוניה החדשה --> NC =
 |<!-- גבון --> GA =
 |<!-- גמביה --> GM =
 |<!-- ג'ורג'יה --> GE =
 |<!-- גאנה --> GH =
 |<!-- גרנדה --> GD =
 |<!-- יוון --> GR =
 |<!-- גרינלנד --> GL =
 |<!-- גואטמלה --> GT =
 |<!-- גינאה --> GN =
 |<!-- גינאה-ביסאו --> GW =
 |<!-- גיאנה --> GY =
 |<!-- האיטי --> HT =
 |<!-- הונדורס --> HN =
 |<!-- הודו --> IN =
 |<!-- אינדונזיה --> ID =
 |<!-- עיראק --> IQ =
 |<!-- איראן --> IR =
 |<!-- אירלנד --> IE =
 |<!-- איסלנד --> IS =
 |<!-- ישראל --> IL =
 |<!-- איטליה --> IT =
 |<!-- ג'מייקה --> JM =
 |<!-- יפן --> JP =
 |<!-- תימן --> YE =
 |<!-- ירדן --> JO =
 |<!-- קמבודיה --> KH =
 |<!-- קמרון --> CM =
 |<!-- קנדה --> CA =
 |<!-- קייפ ורדה --> CV =
 |<!-- קזחסטן --> KZ =
 |<!-- קטאר --> QA =
 |<!-- קניה --> KE =
 |<!-- קירגיזסטן --> KG =
 |<!-- קיריבטי --> KI =
 |<!-- קולומביה --> CO =
 |<!-- קומורו --> KM =
 |<!-- קונגו, הרפובליקה הדמוקרטית (זאיר לשעבר) --> CD =
 |<!-- קונגו, הרפובליקה (לשעבר K.-Brazzaville) --> CG =
 |<!-- קוריאה, הרפובליקה הדמוקרטית העממית (צפון קוריאה) --> KP =
 |<!-- קוריאה, הרפובליקה של (דרום קוריאה) --> KR =
 |<!-- קוסובו --> KOSOVO =
 |<!-- קרואטיה --> HR =
 |<!-- קובה --> CU =
 |<!-- כווית --> KW =
 |<!-- לאוס --> LA =
 |<!-- לסוטו --> LS =
 |<!-- לטביה --> LV =
 |<!-- לבנון --> LB =
 |<!-- ליבריה --> LR =
 |<!-- לוב --> LY =
 |<!-- ליכטנשטיין --> LI =
 |<!-- ליטא --> LT =
 |<!-- לוקסמבורג --> LU =
 |<!-- מדגסקר --> MG =
 |<!-- מלאווי --> MW =
 |<!-- מלזיה --> MY =
 |<!-- המלדיביים --> MV =
 |<!-- מאלי --> ML =
 |<!-- מלטה --> MT =
 |<!-- מרוקו --> MA =
 |<!-- איי מרשל --> MH =
 |<!-- מאוריטניה --> MR =
 |<!-- מאוריציוס --> MU =
 |<!-- מקדוניה --> MK =
 |<!-- מקסיקו --> MX =
 |<!-- מיקרונזיה, המדינות הפדרציות של --> FM =
 |<!-- מולדובה (הרפובליקה של מולדובה) --> MD =
 |<!-- מונקו --> MC =
 |<!-- מונגוליה --> MN =
 |<!-- מונטנגרו --> ME =
 |<!-- מוזמביק --> MZ =
 |<!-- מיאנמר (בורמה) --> MM =
 |<!-- נמיביה --> NA =
 |<!-- נאורו --> NR =
 |<!-- נפאל --> NP =
 |<!-- ניו זילנד --> NZ =
 |<!-- ניקרגואה --> NI =
 |<!-- הולנד --> NL =
 |<!-- ניז'ר --> NE =
 |<!-- ניגריה --> NG =
 |<!-- צפון קפריסין --> NORTHERN_CYPRUS =
 |<!-- נורבגיה --> NO =
 |<!-- עומאן --> OM =
 |<!-- אוסטריה --> AT =
 |<!-- מזרח טימור --> TL =
 |<!-- פקיסטן --> PK =
 |<!-- פלסטין --> PS =
 |<!-- פלאו --> PW =
 |<!-- פנמה --> PA =
 |<!-- פפואה גינאה החדשה --> PG =
 |<!-- פרגוואי --> PY =
 |<!-- פרו --> PE =
 |<!-- פיליפינים --> PH =
 |<!-- פולין --> PL =
 |<!-- פורטוגל --> PT =
 |<!-- פורטו ריקו --> יחסי ציבור =
 |<!-- הרפובליקה של סין (טייוואן) --> TW =
 |<!-- רואנדה --> RW =
 |<!-- רומניה --> RO =
 |<!-- הפדרציה הרוסית --> RU =
 |<!-- איי שלמה --> SB =
 |<!-- זמביה --> ZM =
 |<!-- סמואה --> WS =
 |<!-- סן מרינו --> SM =
 |<!-- סאו טומה ופרינסיפה --> ST =
 |<!-- ערב הסעודית --> SA =
 |<!-- שוודיה --> SE =
 |<!-- שוויץ --> CH =
 |<!-- סנגל --> SN =
 |<!-- סרביה --> RS =
 |<!-- איי סיישל --> SC =
 |<!-- סיירה לאון --> SL =
 |<!-- זימבבואה --> ZW =
 |<!-- סינגפור --> SG =
 |<!-- סלובקיה --> SK =
 |<!-- סלובניה --> SI =
 |<!-- סומליה --> SO =
 |<!-- סומלילנד --> SOMALILAND =
 |<!-- ספרד --> ES =
 |<!-- סרי לנקה --> LK =
 |<!-- סנט קיטס ונוויס --> KN =
 |<!-- סנט לוסיה --> LC =
 |<!-- סנט וינסנט והגרנדינים --> VC =
 |<!-- דרום אפריקה --> ZA =
 |<!-- סודן --> SD =
 |<!-- דרום סודן --> SS =
 |<!-- סורינאם --> SR =
 |<!-- סווזילנד --> SZ =
 |<!-- סוריה --> SY =
 |<!-- טג'יקיסטן --> TJ =
 |<!-- טנזניה --> TZ =
 |<!-- תאילנד --> TH =
 |<!-- טוגו --> TG =
 |<!-- טונגה --> TO =
 |<!-- טרינידד וטובגו --> TT =
 |<!-- צ'אד --> TD =
 |<!-- צ'כיה --> CZ =
 |<!-- תוניסיה --> TN =
 |<!-- טורקיה --> TR =
 |<!-- טורקמניסטן --> TM =
 |<!-- טובאלו --> TV =
 |<!-- אוגנדה --> UG =
 |<!-- אוקראינה --> UA =
 |<!-- הונגריה --> HU =
 |<!-- אורוגוואי --> UY =
 |<!-- אוזבקיסטן --> UZ =
 |<!-- ונואטו --> VU =
 |<!-- ונצואלה --> VE =
 |<!-- איחוד האמירויות הערביות --> AE =
 |<!-- ארצות הברית של אמריקה --> US =
 |<!-- בריטניה --> GB =
 |<!-- וייטנאם --> VN =
 |<!-- סהרה המערבית --> EH =
 |<!-- הרפובליקה המרכז אפריקאית --> CF =
 |<!-- קפריסין --> CY =
 }}
 </pre>
 </div>

== דוגמאות ==
===מפה בפורמט מקוצר===
כאשר לא מציינים בפרמטר {{פרמטר|basemap}} נתיב למפה, התבנית משתמשת בקובץ ברירת מחדל: WorldMap-iso2.json . וההיטל הוא {{פרמטר|projection}}  equirectangular.

<pre>
{{GraphMap|US=blue|CA=blue|GB=blue|AU =blue| NZ =blue}}
</pre>

המדינות דוברות אנגלית
{{GraphMap|US=blue|CA=blue|GB=blue|AU =blue| NZ =blue}}

===מפות עם שינויי היטל===
==== מעצמות עולמיות ====
=====מפה בהיטל albers=====
<pre>
{{GraphMap|US=blue|RU=green|CN=red|projection=albers}}
</pre>
{{GraphMap|US=blue|RU=green|CN=red|projection=albers}}

=====מפה בהיטל mercator=====
<pre>
{{GraphMap|US=Blue|RU=green|CN=red|scale=80|projection=mercator}}
</pre>

{{GraphMap|US=Blue|RU=green|CN=red|scale=80|projection=mercator}}

====מדינות ציי מים כחולים וירוקים====
<pre>
{{GraphMap|US=Navy|GB=Blue|FR=Blue
|CN=SteelBlue|RU=SteelBlue|IT=SteelBlue|IN=SteelBlue|AU=green|BR=green|CA=green
|ES=green|JP=green|KR=green|NL=green|FI=green|TR=green|scale=80|projection=mercator}}
</pre>

{{GraphMap|US=Navy|GB=Blue|FR=Blue
|CN=SteelBlue|RU=SteelBlue|IT=SteelBlue|IN=SteelBlue|AU=green|BR=green|CA=green
|ES=green|JP=green|KR=green|NL=green|FI=green|TR=green|scale=80|projection=mercator}}

===מפה בפורמט מלא===
המפה ממפה את רוב המדינות. כאשר רוצים לבצע השוואה מספרית בין מדינות בעולם.
<div style="max-height:400px; overflow:auto;">
<pre>
{{GraphMap
| basemap = WorldMap-iso2.json
| scale = 100
| projection = conicEqualArea
| colorScale = category10
| domainMin = 1000
| domainMax = 1500000
| defaultValue = red
| scaleType = log
| legend = yes
| AE=8442 | AF=28398 | AL=3150 | AM=2963 | AO=19549 | AR=40374 | AT=8402 | AU=22404 | AZ=9095
| BA=3846 | BD=151125 | BE=10941 | BF=15540 | BG=7389 | BI=9233 | BJ=9510 | BN=401 | BO=10157
| BR=195210 | BS=360 | BT=717 | BW=1969 | BY=9491 | BZ=309 | CA=34126 | CD=62191 | CF=4350
| CG=4112 | CH=7831 | CI=18977 | CL=17151 | CM=20624 | CN=1359821 | CO=46445 | CR=4670
| CU=11282 | CY=1104 | CZ=10554 | DE=83017 | DJ=834 | DK=5551 | DO=10017 | DZ=37063 | EC=15001
| EE=1299 | EG=78076 | EH=515 | ER=5741 | ES=46182 | ET=87095 | FI=5368 | FJ=861 | FK=3
| FR=63231 | GA=1556 | GB=62066 | GE=4389 | GH=24263 | GL=57 | GM=1681 | GN=10876 | GQ=696
| GR=11110 | GT=14342 | GW=1587 | GY=786 | HN=7621 | HR=4338 | HT=9896 | HU=10015 | ID=240676
| IE=4468 | IL=7420 | IN=1205625 | IQ=30962 | IR=74462 | IS=318 | IT=60509 | JM=2741 | JO=6455
| JP=127353 | KE=40909 | KG=5334 | KH=14365 | KP=24501 | KR=48454 | KW=2992 | KZ=15921
| LA=6396 | LB=4341 | LK=20759 | LR=3958 | LS=2009 | LT=3068 | LU=508 | LV=2091 | LY=6041
| MA=31642 | MD=3573 | ME=620 | MG=21080 | MK=2102 | ML=13986 | MM=51931 | MN=2713 | MR=3609
| MW=15014 | MX=117886 | MY=28276 | MZ=23967 | NA=2179 | NC=246 | NE=15894 | NG=159708
| NI=5822 | NL=16615 | NO=4891 | NP=26846 | NZ=4368 | OM=2803 | PA=3678 | PE=29263 | PG=6859
| PH=93444 | PK=173149 | PL=38199 | PR=3710 | PS=4013 | PT=10590 | PY=6460 | QA=1750
| RO=21861 | RS=9647 | RU=143618 | RW=10837 | SA=27258 | SB=526 | SD=35652 | SE=9382 | SI=2054
| SK=5433 | SL=5752 | SN=12951 | SO=9636 | SR=525 | SS=9941 | SV=6218 | SY=21533 | SZ=1193
| TD=11721 | TG=6306 | TH=66402 | TJ=7627 | TL=1079 | TM=5042 | TN=10632 | TR=72138 | TT=1328
| TW=23146 | TZ=44973 | UA=46050 | UG=33987 | US=312247 | UY=3372 | UZ=27769 | VE=29043
| VN=89047 | VU=236 | YE=22763 | ZA=51452 | ZM=13217 | ZW=13077
}}
</pre>
</div>

{{GraphMap
| basemap = WorldMap-iso2.json
| scale = 100
| projection = conicEqualArea
| colorScale = category10
| domainMin = 1000
| domainMax = 1500000
| defaultValue = red
| scaleType = log
| legend = yes
| AE=8442 | AF=28398 | AL=3150 | AM=2963 | AO=19549 | AR=40374 | AT=8402 | AU=22404 | AZ=9095
| BA=3846 | BD=151125 | BE=10941 | BF=15540 | BG=7389 | BI=9233 | BJ=9510 | BN=401 | BO=10157
| BR=195210 | BS=360 | BT=717 | BW=1969 | BY=9491 | BZ=309 | CA=34126 | CD=62191 | CF=4350
| CG=4112 | CH=7831 | CI=18977 | CL=17151 | CM=20624 | CN=1359821 | CO=46445 | CR=4670
| CU=11282 | CY=1104 | CZ=10554 | DE=83017 | DJ=834 | DK=5551 | DO=10017 | DZ=37063 | EC=15001
| EE=1299 | EG=78076 | EH=515 | ER=5741 | ES=46182 | ET=87095 | FI=5368 | FJ=861 | FK=3
| FR=63231 | GA=1556 | GB=62066 | GE=4389 | GH=24263 | GL=57 | GM=1681 | GN=10876 | GQ=696
| GR=11110 | GT=14342 | GW=1587 | GY=786 | HN=7621 | HR=4338 | HT=9896 | HU=10015 | ID=240676
| IE=4468 | IL=7420 | IN=1205625 | IQ=30962 | IR=74462 | IS=318 | IT=60509 | JM=2741 | JO=6455
| JP=127353 | KE=40909 | KG=5334 | KH=14365 | KP=24501 | KR=48454 | KW=2992 | KZ=15921
| LA=6396 | LB=4341 | LK=20759 | LR=3958 | LS=2009 | LT=3068 | LU=508 | LV=2091 | LY=6041
| MA=31642 | MD=3573 | ME=620 | MG=21080 | MK=2102 | ML=13986 | MM=51931 | MN=2713 | MR=3609
| MW=15014 | MX=117886 | MY=28276 | MZ=23967 | NA=2179 | NC=246 | NE=15894 | NG=159708
| NI=5822 | NL=16615 | NO=4891 | NP=26846 | NZ=4368 | OM=2803 | PA=3678 | PE=29263 | PG=6859
| PH=93444 | PK=173149 | PL=38199 | PR=3710 | PS=4013 | PT=10590 | PY=6460 | QA=1750
| RO=21861 | RS=9647 | RU=143618 | RW=10837 | SA=27258 | SB=526 | SD=35652 | SE=9382 | SI=2054
| SK=5433 | SL=5752 | SN=12951 | SO=9636 | SR=525 | SS=9941 | SV=6218 | SY=21533 | SZ=1193
| TD=11721 | TG=6306 | TH=66402 | TJ=7627 | TL=1079 | TM=5042 | TN=10632 | TR=72138 | TT=1328
| TW=23146 | TZ=44973 | UA=46050 | UG=33987 | US=312247 | UY=3372 | UZ=27769 | VE=29043
| VN=89047 | VU=236 | YE=22763 | ZA=51452 | ZM=13217 | ZW=13077
}}

==ראו גם==
* [[יחידה:Graph]]
* [[תבנית:גרף]]