تضامنًا مع حق الشعب الفلسطيني |
قالب:Maplink
هذا القالب مستخدم في عدد كبير من الصفحات (+138802) . لتفادي خلق بلبلة على نطاق واسع من الصفحات وزيادة الأعباء على الخوادم، يجب تجربة أي تعديل في هذه الصفحات الفرعية /ملعب أو /تجربة أو في ملعبك. بعدها يمكنك اضافة التعديلات دفعة واحدة، ورجاءً، لا تنسَ مناقشة أمر التعديلات أوّلًا قبل القيام بها. |
هذا القالب يستعمل لوا: |
هذا القالب يستخدم خاصية ويكي بيانات:
|
هذا القالب يستخدم وسم خريطة الشارع المفتوحة |
هذا القالب يضيف رابطًا أو إطارًا يعرض خريطة من 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}}
لإنشاء خريطة بتنسيق "مابفريم" تكون مناسبة لصناديق المعلومات، مع إدخال مستخدم أدنى.
الاستخدام
يتم استخدام هذا القالب لعرض النقاط والملامح الخطية أو المضلعة على الخريطة، بما في ذلك (ولكن لا يقتصر على):
- الطرق
- الأنهار
- خطوط القطار أو المترو
- مسارات السفن
- مسارات الرحلات الجوية
- رحلات المستكشفين
- مواقع حيوانية
- البلدان وتقسيماتها
وأكثر... يمكن أيضًا استخدام هذا القالب لعرض معالم النقاط على الخريطة، أي الإحداثيات.
الاستخدام
الاستخدام الأساسي
- <maplink>: العنوان "ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map" ليس صفحة بيانات خريطة صحيحةعلى كومنز (مثل 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
|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}}
}}
|
خطأ لوا: يجب تحديد الإحداثيات على ويكي بيانات أو في |coord=. |
تعيين المعاملات - صفحة البيانات
{{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 | كيفية عرض القالب
| غير معروف | اختياري |
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=
.
مثال: خطأ لوا: يجب تحديد الإحداثيات على ويكي بيانات أو في |coord=.
{{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
}}
خطأ لوا: يجب تحديد الإحداثيات على ويكي بيانات أو في |coord=.
{{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:
توصيف | يظهر |
---|---|
مثال 2
توصيف | يظهر |
---|---|
الأمور المحيرة
- عند استخدام استرداد الخطوط أو الأشكال من OpenStreetMap، لا يمكنك تنسيق لون التعبئة أو مستوى الشفافية للتعبئة أو الحدود (ما لم تستخدم المعامل
|raw=
). - الشيفرة التالية التي تستخدم المعامل
|raw=
لن تعمل لأن القوس المنحني لإغلاق GeoJSON ملاصق للقوسين المنحنيين لإغلاق القالب:
{{Maplink|raw= {"type": "ExternalData","service": "geoshape","ids": "Q13518258"}}}
- لإصلاحه، ضع مسافة قبل القوسين المنحنيين للقالب أو قم بنقلهما إلى سطر منفصل.
دروس تعليمية
- أرابيكا:إنشاء خرائط المسارات باستخدام بيانات OpenStreetMap [English]
- أرابيكا:إنشاء خرائط الأشكال باستخدام بيانات OpenStreetMap [English]
Redirects
انظر أيضًا
- en:Wikipedia:Maps for Wikipedia، قائمة بأدوات الخرائط المتاحة على أرابيكا
- en:Wikipedia:Maplink، صفحة معلومات حول هذا القالب والقوالب المماثلة
- قالب:Mapbox – نسخة مشتقة من هذا القالب تضع الرابط داخل صندوق محاذاة اليمين
- قالب:Attached KML
- en:Template:Rapid transit OSM map