قالب:Maplink
توثيق القالبعرضعدّلتاريخمحو الاختزان | صفحة القالب متضمنة في قرابة 150٬000 صفحة ، أو تقريباً 2% إجمالاً. لتجنب التخريبات الكبيرة والتحميل على الخادم، يجب اختبار أي تغييرات في القالب في /الملعب أو /المختبر أو صفحات فرعية، أو عبر صفحة المستخدم الفرعية. يمكن إضافة التغييرات المختبرة إلى هذه الصفحة في تعديل واحد. فكر في مناقشة التغييرات في صفحة نقاش قبل تنفيذها. |
 | هذا القالب يستعمل لوا: |
هذا القالب يضيف رابطًا أو إطارًا يعرض خريطة من OpenStreetMap مع بيانات الخريطة المحددة. يمكن عرض الخريطة والبيانات في نافذة كاملة قابلة للتمرير والتكبير. يمكن أن تأتي بيانات الخريطة من:
- البيانات المخزنة في تنسيق GeoJSON على ويكيبيديا أو كومنز. - ملامح الخطوط/المضلعات في OpenStreetMap. - الإحداثيات، سواء تم توفيرها أو من ويكي بيانات. - GeoJSON الخام، يُفضل أن يتم تضمينه من صفحة أخرى.
ملاحظات:
- إذا كان لديك خريطة كبيرة جدًا / بطيئة، يجب عليك استخدام وسم الامتداد mapframe مباشرة بدلاً من هذا القالب، كما تم في en:Special:Diff/970846012. السبب في ذلك هو أن استخدام القالب لاستدعاء وسم الامتداد سيؤدي إلى احتساب وقت التقديم للخريطة كوقت Lua، مما قد يؤدي إلى أخطاء تجاوز الوقت.
- لا يمكن حاليًا تحميل ملفات GeoJSON مباشرة. بدلاً من ذلك، على كومنز، قم بإنشاء صفحة تكون في مساحة الأسماء Data: وتنتهي بامتداد .map – راجع mw:Help:Map Data لمزيد من المعلومات.
- لجعل ملامح OpenStreetMap (OSM) متاحة، أضف مفتاح ويكي بيانات إلى العلاقة OSM (وانتظر 1 أو 2 يومًا) – انظر mw:Help:Extension:Kartographer#External_data وmw:Help:Extension:Kartographer/OSM للمزيد من المعلومات.
- يمكنك استخدام {{Infobox mapframe}} لإنشاء خريطة بتنسيق "مابفريم" تكون مناسبة لصناديق المعلومات، مع إدخال مستخدم أدنى.
الاستخدام
[عدل المصدر]يتم استخدام هذا القالب لعرض النقاط والملامح الخطية أو المضلعة على الخريطة، بما في ذلك (ولكن لا يقتصر على):
- الطرق
- الأنهار
- خطوط القطار أو المترو
- مسارات السفن
- مسارات الرحلات الجوية
- رحلات المستكشفين
- مواقع حيوانية
- البلدان وتقسيماتها
وأكثر... يمكن أيضًا استخدام هذا القالب لعرض معالم النقاط على الخريطة، أي الإحداثيات.
الاستخدام
[عدل المصدر]الاستخدام الأساسي
- صفحة البيانات على كومنز (مثل Data:ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map):
{{maplink|from=}}(حدد صفحة البيانات .map في from=، مستثنيًا بادئة Data)
- لعرضها في إطار، قم بإضافة المعامل
|frame=yes:{{maplink|frame=yes|frame-align=left|type=line|id=Q1094308|text=مثال على إطار الخريطة}}.
مثال على إطار الخريطة
أمثلة
[عدل المصدر]عنصر ويكي بيانات
[عدل المصدر]| توصيف | يظهر |
|---|---|
<div class='template-markup-wrapper'>{{Maplink| type=shape| text=خريطة اليمن| stroke-width=3| id=Q805| frame=yes| stroke-color=#CDC9C9| zoom=4}}</div> |  |
احداثيات محلية
[عدل المصدر]| توصيف | يظهر |
|---|---|
{{Maplink
|frame=yes
|type=point
|coord={{إحداثيات|15.33|48.1}}
|zoom=4
|stroke-color=#CDC9C9
|stroke-width=3
|text=خريطة
}}
|
 |
أخرى
[عدل المصدر]يمكن أيضًا عرض الطبقات (Overlays) فوق الخريطة:
| توصيف | يظهر |
|---|---|
{{Maplink
|frame=yes
|frame-align=left
|frame-width=400
|frame-height=300
|type=point
|id=Q8688
|marker=airport
|zoom=12
|text=مطار سان فرانسيسكو الدولي
|overlay=
}}
|
 |
تعيين المعاملات - صفحة البيانات
{{Maplink
|display=
|from=
|zoom=
|text=
|icon=
}}
تعيين المعاملات - البيانات الخام
{{Maplink
|display=
|raw= <!-- يُفضل {{Wikipedia:Map data/subpage}} -->
|zoom=
|text=
|icon=
}}
تعيين المعاملات - خط جغرافي/شكل جغرافي
{{Maplink
|display=
|type=
|id=
|title=
|description=
|stroke-color=
|stroke-width=
|zoom=
|text=
|icon=
}}
تعيين المعاملات - معالم النقطة/الإحداثيات
{{Maplink
|display=
|type=point
|id=
|title=
|description=
|coord=
|marker=
|zoom=
|text=
|icon=
}}
تعيين المعاملات - الدوائر
{{Maplink
|display=
|type=circle
|radius= <!-- بالأمتار، تتوفر معاملات بديلة لوحدات أخرى -->
|id=
|title=
|description=
|coord=
|marker=
|zoom=
|text=
|icon=
}}
المعلمات
[عدل المصدر]للعرض الشامل
[عدل المصدر]- display
- كيفية عرض القالب. القيم الصحيحة هي:
inline- يعرض فقط الرابط المضمن (يمكنك تجاهل هذا، لأنه القيمة الافتراضية)title- يعرض فقط رابط العنوانinline,title- يعرض الرابط المضمن ورابط العنوانtitle,inline- نفس السابق
- text
- النص الذي يتم عرضه للرابط (أو التسمية إذا تم استخدام mapframe)؛ القيمة الافتراضية هي "Map"
- icon
- قم بتعيينها إلى "no" لإيقاف الرمز الذي يظهر بجوار الرابط
- zoom
- مستوى التكبير، من
1إلى19(الأرقام الأكبر تكبّر أكثر)؛ القيمة الافتراضية يتم تحديدها تلقائيًا من قبل الخريطة، ما لم يكن الملامح الوحيدة هي نقطة واحدة.
معاملات Mapframe (تعمل فقط مع العرض المضمن)
- frame
- قم بتعيينها إلى "yes" لعرض إطار الخريطة بدلاً من الرابط
- plain
- قم بتعيينها إلى "yes" لعرض الخريطة فقط دون الإطار المحيط وبدون تسمية (سيتم تجاهل معامل text)
- frame-align
- المحاذاة بالنسبة للصفحة:
left،center، أوright؛ القيمة الافتراضية هيright - frame-width
- عرض إطار الخريطة بالبكسل، القيمة الافتراضية هي
300 - frame-height
- ارتفاع إطار الخريطة بالبكسل، القيمة الافتراضية هي
200 - frame-coordinates
- (أو frame-coord)
- اختياري - إحداثيات مركز الخريطة. استخدم القالب {{إحداثيات}} لتحديد الإحداثيات (مثال:
|frame-coordinates={{إحداثيات|12.34|S|56.78|W}}). إذا لم يتم تعيينه، سيتم استرجاع الإحداثيات من ويكي بيانات. - frame-latitude
- (أو frame-lat)
- (يتم تجاهله إذا تم تعيين frame-coordinates أو frame-coord)
- اختياري - إحداثيات العرض الدائري لمركز الخريطة.
- frame-longitude
- (أو frame-long)
- (يتم تجاهله إذا تم تعيين
|frame-coordinates=أو|frame-coord=) - اختياري - إحداثيات الطول لمركز الخريطة.
الملاحظة: إذا لم يتم تعيين إحداثيات العرض والطول للإطار باستخدام المعاملات، فيمكن تحديدها تلقائيًا بناءً على:
- الأشكال والخطوط المحددة (إذا تم تحديدها)
- من معالم النقطة المحددة في
|coord=(إذا تم تعيينها) - استرجاعها من ويكي بيانات (إذا كانت متاحة - سواء للعنصر المحدد في معامل
|id=، أو للصفحة التي يتم وضع القالب فيها)
- overlay
- صورة أو خريطة أخرى لعرضها فوق الخريطة. مثال:
|overlay=أو[[File:Example.svg|140x140px]]|overlay={{Maplink|frame=yes|plain=yes|frame-width=100|frame-height=100|type=shape|id={{GetQID|French submarine Ariane (1914)}}|frame-align=center}}أو|overlay=- (انظر قالب:Maplink/testcases/overlays لعرض أمثلة)
- overlay-horizontal-alignment
- محاذاة الأفقية للغطاء، إما
leftأوright؛ القيمة الافتراضية هيright - overlay-vertical-alignment
- محاذاة العمودية للغطاء، إما
topأوbottom؛ القيمة الافتراضية هيbottom - overlay-horizontal-offset and overlay-vertical-offset
- اختياري - عدد البكسلات لتعويض الغطاء من الحافة الخارجية للخريطة، مثل
10لفجوة بقياس 10 بكسل - overlay-border
- نمط CSS للحدود، مثل
3px solid black؛ القيمة الافتراضية هي1px solid white. يمكن أن يكون لون الحدود أي اسم من ألوان الويب أو رمز هكس.
GeoJSON الخام
[عدل المصدر]- raw
- GeoJSON الخام (مفضلًا أن يكون مدمجًا من صفحة فرعية من ويكيبيديا:بيانات الخرائط) بالإضافة إلى وظائف <maplink> غير متاحة عبر المعاملات الأخرى. انظر أدناه لمزيد من المعلومات.
لكل ملامح
[عدل المصدر]يمكن عرض ملامح متعددة على خريطة واحدة. لكل ملمح إضافي، أضف رقم تسلسلي إلى نهاية اسم المعامل. على سبيل المثال، العمل بالمعاملات الخاصة بالملمح الثاني مثل |type2=، |id2=، وما إلى ذلك، والملمح الثالث |type3=، |id3=، وهكذا. الأرقام الأكبر تُرسم في الجزء العلوي.
- type
- نوع البيانات. القيم الصحيحة هي:
line– ملامح جغرافية خطية من OpenStreetMap (مثل طريق)shape– ملامح جغرافية مضلعة من OpenStreetMap (مثل دولة أو إقليم)shape-inverse– ملامح جغرافية قناعية من OpenStreetMap (عكس ملامح جغرافية - تتيح رؤية غير معوقة للخريطة من تحت)data– صفحة بيانات GeoJSON على كومنز (المعامل اختياري في هذه الحالة)point– ملامح النقطة (إحداثيات)named– جميع الإحداثيات المسماة في صفحة أو قسم (قوالب{{إحداثيات}}مع معامل|name=)circle– دائرة مركزها إحداثيات نقطة
- id
- (أو ids)
- معرف ويكي بيانات (رقم Q) لملامح النقطة، معرف ويكي بيانات الذي تم وسمه على ملامح الخط/الشكل في OpenStreetMap. قم بفصل المعرفات المتعددة بفاصلة. القيمة الافتراضية هي معرف ويكي بيانات للصفحة الحالية (إذا لم يتم تعيين
|from=). - from
- مصدر بيانات الخريطة:
- إذا كان النوع هو
dataأو تم حذفه: ملف JSON (.map) من كومنز لعرضه (مع استثناء البادئةData:) - إذا كان النوع هو
named: اسم الصفحة، أو اسم#القسم، للحصول على الإحداثيات المسماة منها. إذا تم تركه فارغًا، أو تم تحديده كـ #القسم فقط، سيتم استخدام الصفحة الحالية.
- إذا كان النوع هو
- title
- عنوان الملامح (لملامح من OpenStreetMap)، يتم عرضه عند النقر على الملامح؛ القيمة الافتراضية هي عنوان الصفحة
- description
- وصف الملامح (لملامح من OpenStreetMap)، يتم عرضه عند النقر على الملامح؛ اختياري
- stroke-color
- (أو stroke-colour)
- كود اللون للون الذي يُستخدم لرسم الملامح (لملامح من OpenStreetMap)؛ القيمة الافتراضية هي
#ff0000(أحمر) - stroke-width
- عرض الخطوط المستخدمة لرسم الملامح (لملامح من OpenStreetMap)؛ القيمة الافتراضية هي
6 - stroke-opacity
- شفافية الخطوط المستخدمة لرسم الملامح (لملامح من OpenStreetMap) - رقم بين
0(شفاف بالكامل) و1(غير شفاف بالكامل)؛ القيمة الافتراضية هي1 - fill
- كود اللون للتعبئة المستخدمة لملامح (ملامح من OpenStreetMap من النوع shape أو shape-inverse)؛ القيمة الافتراضية هي
#000000(أسود). يُلاحظ أن نسخة شبه شفافة من اللون المحدد ستُستخدم افتراضيًا، مما يتيح لرؤية الخريطة أدناه. - fill-opacity
- شفافية لون التعبئة للملامح (ملامح من OpenStreetMap من النوع shape أو shape-inverse) - رقم بين
0(شفاف بالكامل) و1(غير شفاف بالكامل)؛ القيمة الافتراضية هي0.5 - coord
- الإحداثيات التي يتم عرضها لملامح النقطة. استخدم القالب {{إحداثيات}} لتحديد الإحداثيات (مثال:
|coord={{إحداثيات|12.34|S|56.78|W}}). إذا لم يتم تعيينه، سيتم استرجاع الإحداثيات من ويكي بيانات. - marker
- اسم صورة العلامة Maki لعرضها على ملامح النقطة. انظر إلى mw:Maps/Icons للخيارات المتاحة. إذا لم يتم تعيينه، سيتم عرض علامة عادية دون صورة.
- marker-color
- (أو marker-colour)
- كود اللون (ثلاثي هكس) الذي يُحدد لون خلفية العلامة. القيمة الافتراضية هي
5E74F3( ) - marker-size
- حجم العلامة. يمكن أن يكون
small،medium(القيمة الافتراضية)، أوlarge. - radius
- (أو radius_m)، أو معاملات بديلة radius_km، أو radius_mi، أو radius_ft
- نصف القطر للدائرة. بالأمتار افتراضيًا، أو بالكيلومترات أو الميل أو القدم إذا تم استخدام المعاملات البديلة.
- edges
- عدد الأضلاع المستخدمة لبناء الدائرة. القيمة الافتراضية هي
32. الأعداد الأكبر ستؤدي إلى دائرة أكثر نعومة ولكنها ستستخدم مزيدًا من موارد معالجة Lua.
بيانات القالب
[عدل المصدر]يضيف رابطًا أو إطارًا يعرض بيانات الخريطة
| وسيط | وصف | نوع | حالة | |
|---|---|---|---|---|
| display | display | كيفية عرض القالب
| غير معروف | اختياري |
| text | text | النص الذي يتم عرضه للرابط (أو التسمية إذا تم استخدام إطار الخريطة)
| سطر | اختياري |
| icon | icon | اضبطه على "no" لإيقاف الرمز الذي يظهر بجوار الرابط | بولياني | اختياري |
| zoom | zoom | مستوى التكبير، من 1 إلى 19 (الأرقام الأكبر تكبّر أكثر); القيمة الافتراضية يتم تحديدها تلقائيًا من قبل الخريطة، ما لم يكن الميزة الوحيدة نقطة واحدة فقط. | رقم | اختياري |
مفتاح الخريطة المتعددة
[عدل المصدر]خيار لتبديل الخرائط المتعددة بنمط مفتاح التبديل مثل قالب:Switcher، حيث يتم تبديل المعاملات المحددة مثل التكبير، أو إحداثيات الإطار، أو معرف العنصر للشكل بين قيم مختلفة. عند استخدامه، تأكد من أن عدد القيم في كل قائمة هو نفسه.
التعليمات:
- أضف المعامل switch لتحديد تسميات الخيارات المختلفة: قائمة مفصولة بواسطة
,، أو;إذا كانت التسميات تحتوي على فواصل، أو###إذا كانت التسميات تحتوي على فاصلات نصفية. ستتم عرض كل تسمية مع بادئة "عرض ".- مثال:
|switch=zoomed out, zoomed mid, zoomed in
- مثال:
- بالنسبة لكل معامل يجب أن يتم تبديله، ضع قيمته على SWITCH: تليها قائمة من القيم التي يتم التبديل بينها مرة أخرى مفصولة بواسطة
,أو;أو###- مثال:
|zoom=SWITCH:4,9,14 - لا يجب تبديل المعاملات frame, plain, و text
- مثال:
- تأكد من أن كل قائمة لديها نفس عدد الإدخالات. موقع القيمة في قائمة SWITCH: يتوافق مع نفس الموقع في قائمة التسميات المعينة في
|switch=.
{{Maplink|frame=yes|type=point|id=Q100|text=بوسطن|zoom=SWITCH:4,9,14|switch=تصغير, تكبير متوسط, تكبير أكثر}}
أمثلة ونصائح
[عدل المصدر]ملامح متعددة
[عدل المصدر]تتيح لك الملامح المتعددة:
- استخدام البيانات الخارجية من Wikimedia Commons و OpenStreetMap معًا
- تطبيق أنماط مختلفة على ملامح البيانات الخارجية المختلفة من OpenStreetMap
- تضمين روابط متعددة إلى البيانات الخارجية من Wikimedia Commons
{{Maplink|frame=yes
|type=shape|id=Q3495894|title=Shape|description=Description of shape
|type2=line|id2=Q1318331|title2=Line|description2=Description of line
|type3=point|coord3={{إحداثيات|32|S|116|E}}|title3=Point|description3=Description of point
}}
{{Maplink|frame=yes|plain=yes|frame-width=250|frame-height=280|zoom=6|frame-lat=29.185|frame-long=76.225
|type=shape-inverse|id=Q1174|title=Haryana
|type2=point|id2=Q200663|stroke-width=3|title2=Faridabad
}}
صناديق المعلومات
[عدل المصدر]يمكن تضمين إطارات الخريطة في صناديق المعلومات. يُفضل استخدام |plain=yes لإزالة الإطار الخارجي.
بالنسبة للحالات البسيطة التي تحتوي على ملمح واحد، يمكن استخدام {{infobox mapframe}} بدلاً من ذلك (انظر إلى وثائق هذا القالب لمزيد من التفاصيل).
قالب:Infobox Australian road
{{Infobox Australian road
| location = {{Maplink|type=line |frame=yes |plain=yes |frame-align=center |frame-lat=-31.8262 |frame-long=115.7877 |zoom=9}}
... (other parameters omitted) ...
}}
وسيط raw
[عدل المصدر]وسيط "raw" يسمح بنفس المدخلات المسموح بها في الدالة الكاملة <maplink>. يتيح لك استخدام بيانات GeoJSON مباشرة واستخدام استعلامات Wikidata للحصول على معلومات للخريطة واستخدام القوالب - إذا كانت الخريطة تتضمن GeoJSON مباشرة أو العديد من المكونات، فإن وضع البيانات في قالب سيجنب فوضى نص المقالة. انظر mw:Help:Extension:Kartographer للتعليمات.
مثال Raw GeoJSON
[عدل المصدر]{{Maplink|raw={{Wikipedia:Map data/Main Roads Western Australia/Forrest Highway}}|text=Route map}}
(Link to GeoJSON data subpage: ويكيبيديا:Map data/Main Roads Western Australia/Forrest Highway)
مثال على استعلام ويكي wikidata raw:
[عدل المصدر]| توصيف | يظهر |
|---|---|
<div class='template-markup-wrapper'>{{Maplink| raw={
"type": "ExternalData",
"service": "geoshape",
"query": "
SELECT * WHERE {
?id wdt:P463 wd:Q1065 .
?id wdt:P37 wd:Q13955.
} LIMIT 50
"}| frame-lat=30| zoom=2| frame=yes| frame-height=300| text=دول لغتها الرسمية اللغة العربية| frame-long=15| frame-width=550}}</div> |  |
مثال 2
[عدل المصدر]| توصيف | يظهر |
|---|---|
<div class='template-markup-wrapper'>{{Maplink| frame-height=300| frame-lat=52| zoom=2| raw={
"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('[[', substr(str(?link),31,500),
'|', ?headLabel, ']]') as ?title)
(concat(?stateLabel, '\\n', '[[ملف:', substr(str(?img_), 52, 500), '|200px]]') 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 <https://en.wikipedia.org/> .
} GROUP BY ?id ?head ?headLabel ?link ?stateLabel
"}| frame=yes| frame-long=-110| frame-width=400}}</div> |  |
الأمور المحيرة
[عدل المصدر]- عند استخدام استرداد الخطوط أو الأشكال من OpenStreetMap، لا يمكنك تنسيق لون التعبئة أو مستوى الشفافية للتعبئة أو الحدود (ما لم تستخدم المعامل
|raw=). - الشيفرة التالية التي تستخدم المعامل
|raw=لن تعمل لأن القوس المنحني لإغلاق GeoJSON ملاصق للقوسين المنحنيين لإغلاق القالب:
{{Maplink|raw= {"type": "ExternalData","service": "geoshape","ids": "Q13518258"}}}
- لإصلاحه، ضع مسافة قبل القوسين المنحنيين للقالب أو قم بنقلهما إلى سطر منفصل.
دروس تعليمية
[عدل المصدر]Redirects
[عدل المصدر]- {{Maplink}}
- {{Maplink}}
انظر أيضًا
[عدل المصدر]- en:Wikipedia:Maps for Wikipedia، قائمة بأدوات الخرائط المتاحة على ويكيبيديا
- en:Wikipedia:Maplink، صفحة معلومات حول هذا القالب والقوالب المماثلة
- قالب:Mapbox – نسخة مشتقة من هذا القالب تضع الرابط داخل صندوق محاذاة اليمين
- قالب:Attached KML
- en:Template:Rapid transit OSM map