Help:Extension:Kartographer/he

הדף הזה מתעד איך להשתמש בהרחבה Kartographer ובתגים  ו־  שהיא מספקת.

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

אפשר להשתמש בפרמטר  כדי לשנות את היישור – left (שמאל), right (ימין) או center (מרכז).

שימוש ב־
 { "type": "Feature", "geometry": { "type": "Point", "coordinates": [-122.3988, 37.8013] }, "properties": { "title": "Exploratorium", "description": "", "marker-symbol": "museum", "marker-size": "large", "marker-color": "0050d0" } }

התג  חייב להיות ריק או להכיל GeoJSON תקין עם סגנון, כפי שמיוצר על־ידי עורך GeoJSON. ההרחבה Kartographer תומכת בתקן simplestyle עם [Maps/Icons סמלי Maki] (ברישיון קריאייטיב קומונס אפס).

Frames
Frameless maps are good for insertion as part of a template, whereas framed maps are good for insertion directly into the page, either by hand or by using the visual editor.


 * To insert a map without a frame, add the "frameless" attribute:
 * To add a caption, use the  attribute.

Note: Adding the text attribute automatically enables a frame, even if there is a  attribute.

== ל־  יוצר קישור למפה בגודל מסך מלא:

מקבל גם את הפרמטר הנוסף "text" כדי לציין את טקסט הקישור במקום נקודות הציון:

התג  יכול להכיל את אותו ה־geojson כמו.

== מייצר קישור שמראה מפה בגודל מסך מלא אחרי לחיצה. אפשר להגדיר את טקסט הקישור עם המאפיין. ללא המאפיין הזה יוצגו הקואורדינטות (דוגמה:  לערך הקסם   או  . במקרה הזה כל   יוחלף במונה עולה   ו־  – בערכי.

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

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

אפשר להרחיב ל־:

המאפיינים,  , ו־  מגדירים את המיקום של המפה הקופצת. יש להשתמש ב־$alt לטקסט הרמז של הקישור. יש להשתמש ב־ לטקסט על הקישור (זה יכול להיות כל קוד ויקי תקין). יש להשתמש ב־ כדי להוסיף את התוכן של התג הזה לקבוצה בעלת השם (ר' להלן).

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

רעיון הקיבוץ (grouping) מאפשר לעורכים לשתף נתונים בין תגי  ו־  מרובים.

אלא אם נאמר אחרת, הנתונים בתג  או   מוצגים רק עבור תג אחד, ולא יוצגו בשום מקום אחר.

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

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

External data
 { "type": "ExternalData", "service": "geoshape", "ids": "Q797" }

In addition to drawing polygons using GeoJSON, you may also get outlines of the well known geographical objects by their Wikidata ID if they are marked as such in the OpenStreetMap database. For example, the Wikidata item for Alaska is Q797, and we can draw it on a map by using the "external data" reference. More than one ID may be specified separated by a comma. To create a mask over the areas of interest, use the "geoshape" service. To invert this and create a mask over everything else, use the "geomask" service.

Note: Wikidata IDs are relatively new to the OSM community. There are only about 40,000 polygons with IDs. To add more, visit https://www.openstreetmap.org/ and add  tag with the   value. The data should become available to Kartographer within 2 days.

GeoShape by Wikidata ID with properties
 { "type": "ExternalData", "service": "geoline", "ids": "Q2108", "properties": { "title": "Highway I-696", "description": "", "stroke": "#ffb100", "stroke-width": 8 } } For external data, you can also add styles and titles, using the properties keyword.

The main style keys are: "stroke" (color), "stroke-width", "stroke-opacity", "fill" (color), "fill-opacity".

Combining multiple data types
 [ {    "type": "ExternalData", "service": "geoshape", "ids": "Q13518258", "properties": { "stroke": "#ffb100", "stroke-width": 6, } },  {    "type": "Feature", "geometry": { "type": "Point", "coordinates": [4.75566, 44.104498] }, "properties": { "title": "Porte de Castellan" } },  {    "type": "Feature", "geometry": { "type": "Point", "coordinates": [4.75829, 44.10258] }, "properties": { "title": "Porte Léon Roche" } } ] You can also combine ExternalData, Feature, and FeatureCollection together in the same &lt;mapframe> or &lt;maplink> element

GeoShapes via Wikidata Query
 { "type": "ExternalData", "service": "geoshape", "query": " SELECT ?id ?head (SAMPLE(?img) as ?img)   (min(?partyId) as ?party)   (if(?party = '0', '#800000', if(?party = '1', '#000080', '#008000')) as ?fill)  (concat(, ?headLabel, ) as ?title)  (concat(?stateLabel, '\\n', '') as ?description) WHERE {    ?id wdt:P31 wd:Q35657 .  ?id wdt:P6 ?head .  ?head wdt:P102 ?party .  BIND(if(?party = wd:Q29468, '0', if(?party = wd:Q29552, '1', '2')) as ?partyId)   SERVICE wikibase:label {    bd:serviceParam wikibase:language 'en' .    ?head rdfs:label ?headLabel .    ?id rdfs:label ?stateLabel .  }  OPTIONAL {    ?head wdt:P18 ?img .  }  ?link schema:about ?head .  ?link schema:isPartOf  . } GROUP BY ?id ?head ?headLabel ?link ?stateLabel "} While this helps with the simple use cases when the Wikidata ID is well known, sometimes you may want to get a list of IDs as a result of a Wikidata query. A SPARQL query gets a list of all US states in the ID column of the result, and geoshapes service adds the geometrical outlines for each state. All other columns in the SPARQL query result become values in the "properties" object. The "fill" column changes the color of the state. The "title" column shows state governor's name, and "description" has wiki markup to show the state name and the governor's picture. To edit this query, copy the query parameter after the "#" symbol at ''' https://query.wikidata.org/#... ''':

Map data from Commons

 * Further information: Help:Map Data

Map data stored on Commons can be drawn on the map. For example, c:Data:Neighbourhoods/New York City.map:  { "type": "ExternalData", "service": "page", "title": "Neighbourhoods/New York City.map" }

Rendering options
The following table shows how a map can be formatted for display on a wiki page. The table contains two columns: the first shows an interactive map via the tag, and the second showing the rendering of an example image with the same options.