مخطط روابط خرائط Apple: مرجع شامل للمطورين
الإجابة المختصرة
لخرائط Apple تنسيقان للروابط. تعمل الصيغة القديمة maps.apple.com/?q=…&ll=… في كل مكان، وهي ما تُخرجه معظم الأدوات، ومنها أداتنا. أما روابط الخرائط الموحّدة من Apple (/place و/search و/directions) فتتطلب iOS 18.4 أو macOS 15.4 أو أحدث. حوّل رابطًا من خرائط Google.
التنسيقان
-
القديم يعمل في كل مكان
maps.apple.com/?q=Eiffel+Tower&ll=48.8584,2.2945&z=16
- q: اسم المكان
- ll: خط العرض,خط الطول
- z: التكبير
ما يُخرجه محوّلنا ومعظم الأدوات. يفتح تطبيق الخرائط على أجهزة Apple، وخريطة ويب في غيرها.
-
الموحّد iOS 18.4+ · macOS 15.4+
maps.apple.com/place?coordinate=48.8584,2.2945&name=Eiffel%20Tower
- المسار: الإجراء
- الإحداثيات
- الاسم
التنسيق الأحدث من Apple، ويعمل أيضًا على watchOS 11.4+. مسار واحد لكل إجراء: مكان، وبحث، واتجاهات، وغيرها.
معاملات الصيغة القديمة
أضفها بعد https://maps.apple.com/?، مفصولة بـ &.
| المعامل | الوظيفة | مثال |
|---|---|---|
q | اسم المكان أو نص البحث | q=Eiffel+Tower |
ll | خط العرض وخط الطول للدبوس | ll=48.8584,2.2945 |
z | مستوى التكبير | z=16 |
t | نوع الخريطة: m قياسية، k قمر صناعي، h مختلطة | t=k |
saddr | الاتجاهات: نقطة البداية | saddr=Louvre+Museum |
daddr | الاتجاهات: الوجهة | daddr=Eiffel+Tower |
dirflg | وسيلة التنقل: d القيادة، w المشي، r النقل العام | dirflg=w |
روابط الخرائط الموحّدة
أضف مسارًا ومعاملاته إلى https://maps.apple.com/. وتعيد روابط maps.apple المختصرة التوجيه إلى هذه الروابط. المصدر: توثيق Apple.
| المسار | يعرض | المعاملات |
|---|---|---|
/place | بطاقة مكان | coordinate، name، address، place-id |
/search | نتائج البحث | query، center، span |
/directions | الاتجاهات | source، destination، waypoint، mode (driving، walking، transit، cycling)، avoid (tolls، highways) |
/frame | منطقة من الخريطة | center، span |
/look-around | معاينة (Look Around) | الإحداثيات |
/guides | الأدلة | — |
أمثلة جاهزة للنسخ واللصق
# Legacy: works everywhere https://maps.apple.com/?q=Eiffel+Tower&ll=48.8584,2.2945 https://maps.apple.com/?ll=48.8584,2.2945&t=k&z=17 https://maps.apple.com/?saddr=Louvre+Museum&daddr=Eiffel+Tower&dirflg=w # Unified: iOS 18.4+, macOS 15.4+ https://maps.apple.com/place?coordinate=48.8584,2.2945&name=Eiffel%20Tower https://maps.apple.com/search?query=coffee¢er=48.8584,2.2945 https://maps.apple.com/directions?source=Louvre%20Museum&destination=Eiffel%20Tower&mode=walking
من تطبيق Swift، افتح الرابط. على iPhone وiPad يُفتح تطبيق الخرائط:
import UIKit
if let url = URL(string: "https://maps.apple.com/?q=Eiffel+Tower&ll=48.8584,2.2945") {
UIApplication.shared.open(url)
}
روابط خرائط Google مقابل روابط خرائط Apple
- الإحداثيات: تضعها Google في المسار (
/@48.8584,2.2945,15z)؛ بينما تستخدم Apple معاملًا (ll=48.8584,2.2945، أوcoordinate=في الروابط الموحّدة). - معرّفات الأماكن: تبدو معرّفات Google مثل
ChIJ…؛ بينما تأخذ روابط Apple الموحّدة معرّفplace-idالخاص بها. ولا يمكن تحويل أحدهما إلى الآخر، لذا يعني التحويل نقل الاسم والإحداثيات.
راجع تنسيقات روابط خرائط Google لمعرفة جهة Google.
فتح الخرائط من تطبيق دون رابط
في تطبيقات iOS أو macOS، يمكن لـ MKMapItem في MapKit فتح مكان في الخرائط مباشرةً عبر openInMaps(launchOptions:). أما للمواقع ورسائل البريد الإلكتروني وكل ما يعمل عبر المنصات، فرابط maps.apple.com أبسط.
الأسئلة الشائعة
هل تعمل روابط خرائط Apple على Android؟
نعم. على Android، يفتح رابط maps.apple.com خرائط Apple على الويب في المتصفح — فلا يوجد تطبيق.
هل يمكنني استخدام روابط خرائط Apple في رسائل البريد الإلكتروني؟
نعم. تعمل روابط maps.apple.com في أي برنامج بريد إلكتروني. وعلى أجهزة Apple، تفتح خرائط Apple مباشرةً.
هل أستخدم التنسيق القديم أم الموحّد؟
استخدم الصيغة القديمة ?q=…&ll=… إذا كان قراؤك قد يستخدمون أنظمة أقدم؛ فهي ما تُخرجه معظم الأدوات. واستخدم الروابط الموحّدة مثل /place و/directions حين تضمن وجود iOS 18.4 أو macOS 15.4 أو أحدث.
كيف أحوّل رابط خرائط Google إلى رابط خرائط Apple؟
الصقه في المحوّل في هذه الصفحة. يفك الروابط المختصرة، ويقرأ اسم المكان وإحداثياته، وينشئ رابط maps.apple.com بالصيغة القديمة.