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

الاستخدام

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

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

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

الاستخدام

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

• صفحة البيانات على كومنز (مثل 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، حيث يتم تبديل المعاملات المحددة مثل التكبير، أو إحداثيات الإطار، أو معرف العنصر للشكل بين قيم مختلفة. عند استخدامه، تأكد من أن عدد القيم في كل قائمة هو نفسه.

التعليمات:

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.wiki.x.io/> . } 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"}}}

لإصلاحه، ضع مسافة قبل القوسين المنحنيين للقالب أو قم بنقلهما إلى سطر منفصل.

دروس تعليمية

• ويكيبيديا:إنشاء خرائط المسارات باستخدام بيانات OpenStreetMap
• ويكيبيديا:إنشاء خرائط الأشكال باستخدام بيانات OpenStreetMap

Redirects

• {{Maplink}}
• {{Maplink}}

انظر أيضًا

• en:Wikipedia:Maps for Wikipedia، قائمة بأدوات الخرائط المتاحة على ويكيبيديا
• en:Wikipedia:Maplink، صفحة معلومات حول هذا القالب والقوالب المماثلة
• قالب:Mapbox – نسخة مشتقة من هذا القالب تضع الرابط داخل صندوق محاذاة اليمين
• قالب:Attached KML
• en:Template:Rapid transit OSM map

التوثيق في الأعلى مضمن من قالب:Maplink/شرح. (عدّل | تاريخ)
يمكن للمحررين تجريب تعديلاتهم على القالب في صفحات ملعب (عدّل | فرق) ومختبر (عدل).
من فضلك أضف التصنيفات في الصفحة الفرعية للقالب /شرح. الصفحات الفرعية لـ قالب.