عرض مصدر قالب:Maplink/شرح

{{صفحة توثيق فرعية}}
{{استخدام واسع|{{Maplink/شرح/عداد}}}}
<includeonly>{{اختصار قالب|Mapframe}}</includeonly>
{{Lua|Module:Mapframe}}
{{يستخدم ويكي بيانات|P625}}
{{شقيقة
|image=[[ملف:Openstreetmap logo.svg|40x40px]]
|text=هذا القالب يستخدم وسم [[خريطة الشارع المفتوحة]]
*'''''[https://wiki.openstreetmap.org/wiki/Key:wikidata ويكيداتا]''''' (طالع [https://wiki.openstreetmap.org/wiki/Talk:Key:wikidata النقاش]؛ [https://taginfo.openstreetmap.org/keys/wikidata معلومات])
}}

هذا القالب يضيف رابطًا أو إطارًا يعرض خريطة من OpenStreetMap مع بيانات الخريطة المحددة. يمكن عرض الخريطة والبيانات في نافذة كاملة قابلة للتمرير والتكبير. يمكن أن تأتي بيانات الخريطة من:

- البيانات المخزنة في تنسيق GeoJSON على أرابيكا أو كومنز.
- ملامح الخطوط/المضلعات في OpenStreetMap.
- الإحداثيات، سواء تم توفيرها أو من ويكي بيانات.
- GeoJSON الخام، يُفضل أن يتم تضمينه من صفحة أخرى.

ملاحظات:
- إذا كان لديك خريطة كبيرة جدًا / بطيئة، يجب عليك استخدام وسم الامتداد <code>mapframe</code> مباشرة بدلاً من هذا القالب، كما تم في [[:en:Special:Diff/970846012]]. السبب في ذلك هو أن استخدام القالب لاستدعاء وسم الامتداد سيؤدي إلى احتساب وقت التقديم للخريطة كوقت Lua، مما قد يؤدي إلى أخطاء تجاوز الوقت.

- لا يمكن حاليًا تحميل ملفات GeoJSON مباشرة. بدلاً من ذلك، على كومنز، قم بإنشاء صفحة تكون في مساحة الأسماء <code>Data:</code> وتنتهي بامتداد <code>.map</code> – راجع [[mw:Help:Map Data]] لمزيد من المعلومات.

- لجعل ملامح OpenStreetMap (OSM) متاحة، أضف مفتاح ويكي بيانات إلى العلاقة OSM (وانتظر 1 أو 2 يومًا) – انظر [[mw:Help:Extension:Kartographer#External_data]] و[[mw:Help:Extension:Kartographer/OSM]] للمزيد من المعلومات.

- يمكنك استخدام {{Tlx|Infobox mapframe}} لإنشاء خريطة بتنسيق "مابفريم" تكون مناسبة لصناديق المعلومات، مع إدخال مستخدم أدنى.

== الاستخدام ==
يتم استخدام هذا القالب لعرض النقاط والملامح الخطية أو المضلعة على الخريطة، بما في ذلك (ولكن لا يقتصر على):
* الطرق
* الأنهار
* خطوط القطار أو المترو
* مسارات السفن
* مسارات الرحلات الجوية
* رحلات المستكشفين
* مواقع حيوانية
* البلدان وتقسيماتها
وأكثر...
يمكن أيضًا استخدام هذا القالب لعرض معالم النقاط على الخريطة، أي الإحداثيات.

== الاستخدام ==
الاستخدام الأساسي
* {{Maplink|from=ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map|text=صفحة البيانات}} على كومنز {{صغير|1=(مثل [[c:Data:ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map|Data:ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map]])}}:
* {{Tlx|maplink|<nowiki>from=</nowiki>}} (حدد صفحة البيانات .map في from=، مستثنيًا بادئة Data)

* لعرضها في إطار، قم بإضافة المعامل {{وسيط|frame|yes}}: {{Tlx|maplink|<nowiki>frame=yes|frame-align=left|type=line|id=Q1094308|text=مثال على إطار الخريطة</nowiki>}}.<br />{{Maplink|frame=yes|frame-align=left|type=line|id=Q1094308|text=مثال على إطار الخريطة}}
{{تحديد}}

== أمثلة ==
=== عنصر ويكي بيانات ===
{{#invoke:DemoTemplate3|Maplink
|frame=yes
|type=shape
|id=Q805
|zoom=4
|stroke-color=#CDC9C9
|stroke-width=3
|text=خريطة اليمن
}}

=== احداثيات محلية ===
{{توصيف2
| <nowiki>{{Maplink
|frame=yes
|type=point
|coord={{إحداثيات|15.33|48.1}}
|zoom=4
|stroke-color=#CDC9C9
|stroke-width=3
|text=خريطة 
}}</nowiki>
|{{Maplink
|frame=yes
|type=point
|coord={{إحداثيات|15.33|48.1}}
|zoom=4
|stroke-color=#CDC9C9
|stroke-width=3
|text=خريطة 
}}
}}

=== أخرى ===
يمكن أيضًا عرض الطبقات (Overlays) فوق الخريطة:
{{توصيف2
| <nowiki>{{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}}
}}</nowiki>
|{{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}}
}}
}}

{{تحديد}}
تعيين المعاملات - صفحة البيانات
<syntaxhighlight lang="wikitext">
{{Maplink
|display=
|from=
|zoom=
|text=
|icon=
}}
</syntaxhighlight>

تعيين المعاملات - البيانات الخام
<syntaxhighlight lang="wikitext">
{{Maplink
|display=
|raw= <!-- يُفضل {{Wikipedia:Map data/subpage}} -->
|zoom=
|text=
|icon=
}}
</syntaxhighlight>

تعيين المعاملات - خط جغرافي/شكل جغرافي
<syntaxhighlight lang="wikitext">
{{Maplink
|display=
|type=
|id=
|title=
|description=
|stroke-color=
|stroke-width=
|zoom=
|text=
|icon=
}}
</syntaxhighlight>

تعيين المعاملات - معالم النقطة/الإحداثيات
<syntaxhighlight lang="wikitext">
{{Maplink
|display=
|type=point
|id=
|title=
|description=
|coord=
|marker=
|zoom=
|text=
|icon=
}}
</syntaxhighlight>

تعيين المعاملات - الدوائر
<syntaxhighlight lang="wikitext">
{{Maplink
|display=
|type=circle
|radius= <!-- بالأمتار، تتوفر معاملات بديلة لوحدات أخرى -->
|id=
|title=
|description=
|coord=
|marker=
|zoom=
|text=
|icon=
}}
</syntaxhighlight>

== المعلمات ==
=== للعرض الشامل ===
;display
:كيفية عرض القالب. القيم الصحيحة هي:
::<code>inline</code> - يعرض فقط الرابط المضمن (يمكنك تجاهل هذا، لأنه القيمة الافتراضية)
::<code>title</code> - يعرض فقط رابط العنوان
::<code>inline,title</code> - يعرض الرابط المضمن ورابط العنوان
::<code>title,inline</code> - نفس السابق
;text
:النص الذي يتم عرضه للرابط (أو التسمية إذا تم استخدام mapframe)؛ القيمة الافتراضية هي "Map"
;icon
:قم بتعيينها إلى "no" لإيقاف الرمز الذي يظهر بجوار الرابط
;zoom
:مستوى التكبير، من <code>1</code> إلى <code>19</code> (الأرقام الأكبر تكبّر أكثر)؛ القيمة الافتراضية يتم تحديدها تلقائيًا من قبل الخريطة، ما لم يكن الملامح الوحيدة هي نقطة واحدة.
معاملات Mapframe (تعمل فقط مع العرض المضمن)
;frame
:قم بتعيينها إلى "yes" لعرض إطار الخريطة بدلاً من الرابط
:;plain
::قم بتعيينها إلى "yes" لعرض الخريطة فقط دون الإطار المحيط وبدون تسمية (سيتم تجاهل معامل '''text''')
:;frame-align
::المحاذاة بالنسبة للصفحة: <code>left</code>، <code>center</code>، أو <code>right</code>؛ القيمة الافتراضية هي <code>right</code>
:;frame-width
::عرض إطار الخريطة بالبكسل، القيمة الافتراضية هي <code>300</code>
:;frame-height
::ارتفاع إطار الخريطة بالبكسل، القيمة الافتراضية هي <code>200</code>
:;frame-coordinates
::''(أو '''frame-coord''')''
::اختياري - إحداثيات مركز الخريطة. استخدم القالب {{قا|إحداثيات}} لتحديد الإحداثيات {{صغير|1=(مثال: {{وسيط|frame-coordinates|2=<nowiki>{{إحداثيات|12.34|S|56.78|W}}</nowiki>}})}}. إذا لم يتم تعيينه، سيتم استرجاع الإحداثيات من ويكي بيانات.
:;frame-latitude
::''(أو '''frame-lat''')''
::''(يتم تجاهله إذا تم تعيين '''frame-coordinates''' أو '''frame-coord''')''
::اختياري - إحداثيات العرض الدائري لمركز الخريطة.
:;frame-longitude
::''(أو '''frame-long''')''
::''(يتم تجاهله إذا تم تعيين ''{{وسيط|frame-coordinates}}'' أو ''{{وسيط|frame-coord}}'')''
::اختياري - إحداثيات الطول لمركز الخريطة.
:{{الملاحظة}} إذا لم يتم تعيين إحداثيات العرض والطول للإطار باستخدام المعاملات، فيمكن تحديدها تلقائيًا بناءً على:
:*الأشكال والخطوط المحددة (إذا تم تحديدها)
:*من معالم النقطة المحددة في {{وسيط|[[#coord|coord]]}} (إذا تم تعيينها)
:*استرجاعها من ويكي بيانات (إذا كانت متاحة - سواء للعنصر المحدد في معامل {{وسيط|id}}، أو للصفحة التي يتم وضع القالب فيها)
:;overlay
::صورة أو خريطة أخرى لعرضها فوق الخريطة. مثال:
:::{{وسيط|overlay|{{Elc|File:Example.svg|140x140px}}}} أو
:::{{وسيط|overlay|<nowiki>{{Maplink|frame=yes|plain=yes|frame-width=100|frame-height=100|type=shape|id={{GetQID|French submarine Ariane (1914)}}|frame-align=center}}</nowiki>}} أو
:::{{وسيط|overlay|<nowiki>{{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}}</nowiki>}}
:::(انظر [[قالب:Maplink/testcases/overlays]] لعرض أمثلة)
::;overlay-horizontal-alignment
:::محاذاة الأفقية للغطاء، إما <code>left</code> أو <code>right</code>؛ القيمة الافتراضية هي <code>right</code>
::;overlay-vertical-alignment
:::محاذاة العمودية للغطاء، إما <code>top</code> أو <code>bottom</code>؛ القيمة الافتراضية هي <code>bottom</code>
::;overlay-horizontal-offset {{لاغليظ|and}} overlay-vertical-offset
:::اختياري - عدد البكسلات لتعويض الغطاء من الحافة الخارجية للخريطة، مثل <code>10</code> لفجوة بقياس 10 بكسل
::;overlay-border
:::نمط CSS للحدود، مثل <code>3px solid black</code>؛ القيمة الافتراضية هي <code>1px solid white</code>. يمكن أن يكون لون الحدود أي اسم من [[ألوان الويب]] أو رمز هكس.

=== GeoJSON الخام ===
;raw
:GeoJSON الخام (مفضلًا أن يكون مدمجًا من صفحة فرعية من [[أرابيكا:بيانات الخرائط]]) بالإضافة إلى وظائف <nowiki><maplink></nowiki> غير متاحة عبر المعاملات الأخرى. [[#المعامل الخام|انظر أدناه]] لمزيد من المعلومات.

=== لكل ملامح ===
يمكن عرض ملامح متعددة على خريطة واحدة. لكل ملمح إضافي، أضف رقم تسلسلي إلى نهاية اسم المعامل. على سبيل المثال، العمل بالمعاملات الخاصة بالملمح الثاني مثل {{وسيط|type2}}، {{وسيط|id2}}، وما إلى ذلك، والملمح الثالث {{وسيط|type3}}، {{وسيط|id3}}، وهكذا. الأرقام الأكبر تُرسم في الجزء العلوي.
;type
:نوع البيانات. القيم الصحيحة هي:
::<code>line</code> – ملامح جغرافية خطية من OpenStreetMap (مثل طريق)
::<code>shape</code> – ملامح جغرافية مضلعة من OpenStreetMap (مثل دولة أو إقليم)
::<code>shape-inverse</code> – ملامح جغرافية قناعية من OpenStreetMap (عكس ملامح جغرافية - تتيح رؤية غير معوقة للخريطة من تحت)
::<code>data</code> – صفحة بيانات GeoJSON على كومنز (المعامل اختياري في هذه الحالة)
::<code>point</code> – ملامح النقطة (إحداثيات)
::<code>named</code> – جميع الإحداثيات المسماة في صفحة أو قسم (قوالب {{Tlx|إحداثيات}} مع معامل {{وسيط|name}})
::<code>circle</code> – دائرة مركزها إحداثيات نقطة
;id
:''(أو '''ids''')''
:معرف ويكي بيانات (رقم Q) لملامح النقطة، معرف ويكي بيانات الذي تم وسمه على ملامح الخط/الشكل في OpenStreetMap. قم بفصل المعرفات المتعددة بفاصلة. القيمة الافتراضية هي معرف ويكي بيانات للصفحة الحالية (إذا لم يتم تعيين {{وسيط|from}}).
;from
:مصدر بيانات الخريطة:
:* إذا كان '''النوع''' هو <code>data</code> أو تم حذفه: ملف JSON (.map) من كومنز لعرضه (مع استثناء البادئة <code>Data:</code>)
:* إذا كان '''النوع''' هو <code>named</code>: اسم الصفحة، أو اسم#القسم، للحصول على الإحداثيات المسماة منها. إذا تم تركه فارغًا، أو تم تحديده كـ #القسم فقط، سيتم استخدام الصفحة الحالية.
;title
:عنوان الملامح (لملامح من OpenStreetMap)، يتم عرضه عند النقر على الملامح؛ القيمة الافتراضية هي عنوان الصفحة
;description
:وصف الملامح (لملامح من OpenStreetMap)، يتم عرضه عند النقر على الملامح؛ اختياري
;stroke-color
:''(أو '''stroke-colour''')''
:كود اللون للون الذي يُستخدم لرسم الملامح (لملامح من OpenStreetMap)؛ القيمة الافتراضية هي <code>#ff0000</code> (أحمر)
;stroke-width
:عرض الخطوط المستخدمة لرسم الملامح (لملامح من OpenStreetMap)؛ القيمة الافتراضية هي <code>6</code>
;stroke-opacity
:شفافية الخطوط المستخدمة لرسم الملامح (لملامح من OpenStreetMap) - رقم بين <code>0</code> (شفاف بالكامل) و <code>1</code> (غير شفاف بالكامل)؛ القيمة الافتراضية هي <code>1</code>
;fill
:كود اللون للتعبئة المستخدمة لملامح (ملامح من OpenStreetMap من النوع shape أو shape-inverse)؛ القيمة الافتراضية هي <code>#000000</code> (أسود). يُلاحظ أن نسخة شبه شفافة من اللون المحدد ستُستخدم افتراضيًا، مما يتيح لرؤية الخريطة أدناه.
;fill-opacity
:شفافية لون التعبئة للملامح (ملامح من OpenStreetMap من النوع shape أو shape-inverse) - رقم بين <code>0</code> (شفاف بالكامل) و <code>1</code> (غير شفاف بالكامل)؛ القيمة الافتراضية هي <code>0.5</code>
;{{علامة موقع|coord}} coord
:الإحداثيات التي يتم عرضها لملامح النقطة. استخدم القالب {{قا|إحداثيات}} لتحديد الإحداثيات {{صغير|1=(مثال: {{وسيط|coord|2=<nowiki>{{إحداثيات|12.34|S|56.78|W}}</nowiki>}})}}. إذا لم يتم تعيينه، سيتم استرجاع الإحداثيات من ويكي بيانات.
;marker
:اسم صورة العلامة Maki لعرضها على ملامح النقطة. انظر إلى [[mw:Maps/Icons]] للخيارات المتاحة. إذا لم يتم تعيينه، سيتم عرض علامة عادية دون صورة.
;marker-color
:''(أو '''marker-colour''')''
:كود اللون ([[ألوان الويب|ثلاثي هكس]]) الذي يُحدد لون خلفية العلامة. القيمة الافتراضية هي <code>5E74F3</code> ({{صندوق لون|#5E74F3}})
;marker-size
:حجم العلامة. يمكن أن يكون <code>small</code>، <code>medium</code> (القيمة الافتراضية)، أو <code>large</code>.
;radius
:''(أو '''radius_m''')، أو معاملات بديلة '''radius_km'''، أو '''radius_mi'''، أو '''radius_ft'''
:نصف القطر للدائرة. بالأمتار افتراضيًا، أو بالكيلومترات أو الميل أو القدم إذا تم استخدام المعاملات البديلة.
;edges
:عدد الأضلاع المستخدمة لبناء الدائرة. القيمة الافتراضية هي <code>32</code>. الأعداد الأكبر ستؤدي إلى دائرة أكثر نعومة ولكنها ستستخدم مزيدًا من موارد معالجة Lua.

=== بيانات القالب ===
<templatedata>
{
	"params": {
		"display": {
			"description": "كيفية عرض القالب",
			"suggestedvalues": [
				"inline",
				"title",
				"inline,title"
			],
			"default": "inline"
		},
		"text": {
			"description": "النص الذي يتم عرضه للرابط (أو التسمية إذا تم استخدام إطار الخريطة)",
			"type": "line",
			"default": "Map"
		},
		"icon": {
			"description": "اضبطه على \"no\" لإيقاف الرمز الذي يظهر بجوار الرابط",
			"type": "boolean"
		},
		"zoom": {
			"description": "مستوى التكبير، من 1 إلى 19 (الأرقام الأكبر تكبّر أكثر); القيمة الافتراضية يتم تحديدها تلقائيًا من قبل الخريطة، ما لم يكن الميزة الوحيدة نقطة واحدة فقط.",
			"type": "number"
		}
	},
	"description": "يضيف رابطًا أو إطارًا يعرض بيانات الخريطة"
}
</templatedata>

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

التعليمات:
# أضف المعامل '''switch''' لتحديد تسميات الخيارات المختلفة: قائمة مفصولة بواسطة {{كود|,}}، أو {{كود|;}} إذا كانت التسميات تحتوي على فواصل، أو {{كود|###}} إذا كانت التسميات تحتوي على فاصلات نصفية. ستتم عرض كل تسمية مع بادئة "عرض ".
#: مثال: {{وسيط|switch|zoomed out, zoomed mid, zoomed in}}
# بالنسبة لكل معامل يجب أن يتم تبديله، ضع قيمته على {{Kbd|SWITCH:}} تليها قائمة من القيم التي يتم التبديل بينها مرة أخرى مفصولة بواسطة {{كود|,}} أو {{كود|;}} أو {{كود|###}}
#: مثال: {{وسيط|zoom|SWITCH:4,9,14}}
#: لا يجب تبديل المعاملات '''frame''', '''plain''', و '''text'''
# تأكد من أن كل قائمة لديها نفس عدد الإدخالات. موقع القيمة في قائمة {{Kbd|SWITCH:}} يتوافق مع نفس الموقع في قائمة التسميات المعينة في {{وسيط|switch}}.
مثال: {{Maplink|frame=yes|type=point|id=Q100|text=بوسطن|zoom=SWITCH:4,9,14|switch=تصغير, تكبير متوسط, تكبير أكثر}}
<syntaxhighlight lang="wikitext">{{Maplink|frame=yes|type=point|id=Q100|text=بوسطن|zoom=SWITCH:4,9,14|switch=تصغير, تكبير متوسط, تكبير أكثر}}</syntaxhighlight>
{{تحديد}}

== أمثلة ونصائح ==
=== ملامح متعددة ===
تتيح لك الملامح المتعددة:
*استخدام البيانات الخارجية من 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
}}
<syntaxhighlight lang="wikitext">{{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
}}
</syntaxhighlight>
{{تحديد}}

{{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
}}
<syntaxhighlight lang="wikitext">
{{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
}}
</syntaxhighlight>
{{تحديد}}

=== صناديق المعلومات ===
يمكن تضمين إطارات الخريطة في صناديق المعلومات. يُفضل استخدام {{وسيط|plain|yes}} لإزالة الإطار الخارجي.

بالنسبة للحالات البسيطة التي تحتوي على ملمح واحد، يمكن استخدام {{Tlx|infobox mapframe}} بدلاً من ذلك (انظر إلى وثائق هذا القالب لمزيد من التفاصيل).
{{Infobox Australian road
| road_name    = Mitchell Freeway
| location     = {{Maplink|type=line |frame=yes |plain=yes |frame-align=center |frame-lat=-31.8262 |frame-long=115.7877 |zoom=9 |id=Q1939502}}
| loc_caption  = Map of Perth's northern suburbs with Mitchell Freeway highlighted in red
| type         = freeway
| show_links   = no
}}

<syntaxhighlight lang="wikitext">
{{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)  ...
}}
</syntaxhighlight>
{{تحديد}}
=== وسيط raw ===
وسيط "raw" يسمح بنفس المدخلات المسموح بها في الدالة الكاملة <nowiki><maplink></nowiki>. يتيح لك استخدام بيانات GeoJSON مباشرة واستخدام استعلامات Wikidata للحصول على معلومات للخريطة واستخدام القوالب - إذا كانت الخريطة تتضمن GeoJSON مباشرة أو العديد من المكونات، فإن وضع البيانات في قالب سيجنب فوضى نص المقالة. انظر [[mw:Help:Extension:Kartographer]] للتعليمات.

==== مثال Raw GeoJSON ====
{{Maplink|raw={{Wikipedia:Map data/Main Roads Western Australia/Forrest Highway}}|text=Route map}}
<syntaxhighlight lang="wikitext">
{{Maplink|raw={{Wikipedia:Map data/Main Roads Western Australia/Forrest Highway}}|text=Route map}}
</syntaxhighlight>
(Link to GeoJSON data subpage: [[أرابيكا:Map data/Main Roads Western Australia/Forrest Highway]])

==== مثال على استعلام ويكي wikidata raw: ====
{{#invoke:DemoTemplate3|Maplink|frame=yes
|text=دول لغتها الرسمية اللغة العربية
|raw={
  "type": "ExternalData",
  "service": "geoshape",
  "query": "
SELECT * WHERE {
  ?id wdt:P463 wd:Q1065 .
  ?id wdt:P37 wd:Q13955.
} LIMIT 50
"}
|frame-width=550|frame-height=300|frame-lat=30|frame-long=15|zoom=2
}}
{{تحديد}}

===== مثال 2 =====
{{#invoke:DemoTemplate3|Maplink|frame=yes|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-width=400|frame-height=300|frame-lat=52|frame-long=-110|zoom=2}}
{{تحديد}}

=== الأمور المحيرة ===
*عند استخدام استرداد الخطوط أو الأشكال من OpenStreetMap، لا يمكنك تنسيق لون التعبئة أو مستوى الشفافية للتعبئة أو الحدود (ما لم تستخدم المعامل {{وسيط|raw}}).
*الشيفرة التالية التي تستخدم المعامل {{وسيط|raw}} لن تعمل لأن القوس المنحني لإغلاق GeoJSON ملاصق للقوسين المنحنيين لإغلاق القالب:
<syntaxhighlight lang="wikitext">{{Maplink|raw= {"type": "ExternalData","service": "geoshape","ids": "Q13518258"}}}</syntaxhighlight>
:لإصلاحه، ضع مسافة قبل القوسين المنحنيين للقالب أو قم بنقلهما إلى سطر منفصل.

== دروس تعليمية ==
* {{وإو|أرابيكا:إنشاء خرائط المسارات باستخدام بيانات OpenStreetMap|wikipedia:Creating route maps from OpenStreetMap data}}
* {{وإو|أرابيكا:إنشاء خرائط الأشكال باستخدام بيانات OpenStreetMap|wikipedia:Creating shape maps from OpenStreetMap data}}

== Redirects ==
* {{Tlf|Maplink}}
* {{Tlf|Maplink}}

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

<includeonly>{{ملعب آخر||
<!-- التصانيف هنا، ووصلات الانترويكي في ويكي بيانات  -->
[[تصنيف:قوالب إحداثيات]]
[[تصنيف:قوالب خرائط]]

}}</includeonly>