قالب:Maplink/شرح

أضف وصلات
من ويكيبيديا، الموسوعة الحرة


هذا القالب يضيف رابطًا أو إطارًا يعرض خريطة من 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}} لإنشاء خريطة بتنسيق "مابفريم" تكون مناسبة لصناديق المعلومات، مع إدخال مستخدم أدنى.

الاستخدام[عدل]

يتم استخدام هذا القالب لعرض النقاط والملامح الخطية أو المضلعة على الخريطة، بما في ذلك (ولكن لا يقتصر على):

  • الطرق
  • الأنهار
  • خطوط القطار أو المترو
  • مسارات السفن
  • مسارات الرحلات الجوية
  • رحلات المستكشفين
  • مواقع حيوانية
  • البلدان وتقسيماتها

وأكثر... يمكن أيضًا استخدام هذا القالب لعرض معالم النقاط على الخريطة، أي الإحداثيات.

الاستخدام[عدل]

الاستخدام الأساسي

  • لعرضها في إطار، قم بإضافة المعامل |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.

بيانات القالب[عدل]

يضيف رابطًا أو إطارًا يعرض بيانات الخريطة

وسائط القالب[تحرير بيانات القالب]

وسيطوصفنوعحالة
displaydisplay

كيفية عرض القالب

القيم المقترحة
inline title inline,title
غيابي
inline
غير معروفاختياري
texttext

النص الذي يتم عرضه للرابط (أو التسمية إذا تم استخدام إطار الخريطة)

غيابي
Map
سطراختياري
iconicon

اضبطه على "no" لإيقاف الرمز الذي يظهر بجوار الرابط

بوليانياختياري
zoomzoom

مستوى التكبير، من 1 إلى 19 (الأرقام الأكبر تكبّر أكثر); القيمة الافتراضية يتم تحديدها تلقائيًا من قبل الخريطة، ما لم يكن الميزة الوحيدة نقطة واحدة فقط.

رقماختياري

مفتاح الخريطة المتعددة[عدل]

خيار لتبديل الخرائط المتعددة بنمط مفتاح التبديل مثل قالب:Switcher، حيث يتم تبديل المعاملات المحددة مثل التكبير، أو إحداثيات الإطار، أو معرف العنصر للشكل بين قيم مختلفة. عند استخدامه، تأكد من أن عدد القيم في كل قائمة هو نفسه.

التعليمات:

  1. أضف المعامل switch لتحديد تسميات الخيارات المختلفة: قائمة مفصولة بواسطة ,، أو ; إذا كانت التسميات تحتوي على فواصل، أو ### إذا كانت التسميات تحتوي على فاصلات نصفية. ستتم عرض كل تسمية مع بادئة "عرض ".
    مثال: |switch=zoomed out, zoomed mid, zoomed in
  2. بالنسبة لكل معامل يجب أن يتم تبديله، ضع قيمته على SWITCH: تليها قائمة من القيم التي يتم التبديل بينها مرة أخرى مفصولة بواسطة , أو ; أو ###
    مثال: |zoom=SWITCH:4,9,14
    لا يجب تبديل المعاملات frame, plain, و text
  3. تأكد من أن كل قائمة لديها نفس عدد الإدخالات. موقع القيمة في قائمة 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}}

انظر أيضًا[عدل]


مجلوبة من «https://ar.wikipedia.org/w/index.php?title=قالب:Maplink/شرح&oldid=64782918»