قالب:Maplink/شرح

هذه صفحة توثيق قالب:Maplink الفرعية، لشرح القالب وتصنيفه، وهي لا تدخل في استخدامه.

هذا القالب مستخدم في عدد كبير من الصفحات (+140740) .
لتفادي خلق بلبلة على نطاق واسع من الصفحات وزيادة الأعباء على الخوادم، يجب تجربة أي تعديل في هذه الصفحات الفرعية /ملعب أو /تجربة أو في ملعبك. بعدها يمكنك اضافة التعديلات دفعة واحدة، ورجاءً، لا تنسَ مناقشة أمر التعديلات أوّلًا قبل القيام بها.

هذا القالب يستعمل لوا:

Module:Mapframe

هذا القالب يضيف رابطًا أو إطارًا يعرض خريطة من 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=مثال على إطار الخريطة}}.
مثال على إطار الخريطة

أمثلة

عنصر ويكي بيانات

توصيف	يظهر
{{Maplink \|type=shape \|text=خريطة اليمن \|stroke-width=3 \|id=Q805 \|frame=yes \|stroke-color=#CDC9C9 \|zoom=4 }}	خريطة اليمن

احداثيات محلية

توصيف	يظهر
{{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={{Graph:Street map with marks|width=110|height=90|lat=37.8|lon=-121.8|zoom=6|{ "lat": 37.618, "lon": -122.375 }| minimap=false}}
}}

الرسوم البيانية غير متاحةٍ مؤقتًا لأسبابٍ تقنيَّة.

مطار سان فرانسيسكو الدولي

تعيين المعاملات - صفحة البيانات

{{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={{Graph:Street map with marks|width=100|height=100|lat=37.8|lon=-122.4|zoom=6|{ "lat": 37.8, "lon": -122.4 }|minimap=false}}; (انظر قالب: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`	كيفية عرض القالب القيم المقترحة `inline` `title` `inline,title` غيابي inline	غير معروف	اختياري
text	`text`	النص الذي يتم عرضه للرابط (أو التسمية إذا تم استخدام إطار الخريطة) غيابي Map	سطر	اختياري
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>: لم يمكن تحليل JSON: خطأ صياغة

{{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:

توصيف

يظهر

{{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 
}}

دول لغتها الرسمية اللغة العربية

مثال 2

توصيف

يظهر

{{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 
}}

خريطة

الأمور المحيرة

عند استخدام استرداد الخطوط أو الأشكال من 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