تتيح لك عناوين URL في "خرائط Google" إنشاء عنوان URL عام يعمل من عدّة منصات ويشغّل "خرائط Google" لإجراء عمليات البحث أو الحصول على الاتجاهات والتنقّل أو عرض الخرائط أو إنشاء قائمة مختصرة بالأماكن أو عرض صور بانوراما في "التجوّل الافتراضي". بنية عنوان URL هي نفسها على كل نظام أساسي، ولا يلزم توفّر مفتاح واجهة برمجة التطبيقات.
عناوين URL لـ "خرائط Google": حقائق رئيسية
- المنتج: عناوين URL لـ "خرائط Google"
- تُعرف أيضًا باسم: عناوين URL في "خرائط Google"
- الفئة: خرائط Google
- المنصة: مخطّط URL
- مرحلة الإطلاق: GA
- Lifecycle: نشط
- نظرة عامة: نظرة عامة على عناوين URL في "خرائط Google"
عناوين URL في "خرائط Google": حالات الاستخدام
استخدِم عناوين URL لخدمة "خرائط Google" في الحالات التالية:
- تحتاج إلى رابط من تطبيق Android أو تطبيق iOS أو موقع إلكتروني يفتح "خرائط Google" للبحث عن مكان أو عرض نتائج البحث.
- عليك فتح "خرائط Google" مع الاتجاهات بين النقاط، ويمكنك اختياريًا إضافة نقاط على المسار أو وسيلة النقل أو الاتجاهات المفصّلة.
- عليك فتح "خرائط Google" على عرض خريطة أو قائمة مختصرة بالأماكن أو بانوراما في "التجوّل الافتراضي" بدون استخدام مفتاح واجهة برمجة التطبيقات.
- تحتاج إلى بنية عنوان URL واحدة تعمل بالطريقة نفسها على Android وiOS والمتصفّحات المتوافقة مع أجهزة الكمبيوتر المكتبي.
لا تستخدِم عناوين URL من "خرائط Google" في الحالات التالية:
- إذا كنت تطلب حاليًا تفاصيل المكان وتريد روابط منسَّقة مسبقًا إلى "خرائط Google" لمكان معيّن (الحقلان
googleMapsUriأوgoogleMapsLinks) استخدِم Places API (جديدة) بدلاً من ذلك. - تحتاج إلى ميزات مخصّصة للأجهزة الجوّالة فقط عند تشغيل تطبيق "خرائط Google". استخدِم Google Maps Intents لنظام التشغيل Android أو مخطّط عنوان URL في "خرائط Google" لنظام التشغيل iOS.
عناوين URL لـ "خرائط Google": الإعداد
- تحديد مصدر الاستخدام: أضِف مَعلمتَي طلب البحث الاختياريتَين
utm_source(اسم تطبيقك) وutm_campaign(الإجراء الذي ينوي المستخدم اتّخاذه، مثلplace_details_search) إلى عناوين URL في "خرائط Google". - البدء: إعداد عناوين URL في "خرائط Google"
عناوين URL لـ "خرائط Google": المنتجات ذات الصلة
- تُستخدم غالبًا مع: Places API (جديدة)
عناوين URL لـ "خرائط Google": الأخطاء الشائعة
- المشكلة: يعرض عنوان URL للبحث الذي يحتوي على خط العرض/خط الطول فقط في
queryدبوسًا ولكن لا يعرض تفاصيل المكان في الخريطة أو اللوحة الجانبية. الحلّ: استخدِمquery=PLACE_NAME,ADDRESSأو أضِفquery_place_idإلى جانبqueryلعرض تفاصيل المكان المحدّد. يُرجى الاطّلاع على /maps/documentation/urls/get-started. - المشكلة: لا تعمل مَعلمات رقم تعريف المكان (
query_place_idوorigin_place_idوdestination_place_idوwaypoint_place_ids) بمفردها. الحلّ: يجب دائمًا تضمين مَعلمة الأساس المطابقة (queryأوoriginأوdestinationأوwaypoints) عند تمرير مَعلمة رقم تعريف المكان. يُرجى الاطّلاع على /maps/documentation/urls/get-started. - المشكلة: يتم تجاهل المَعلمة
waypointsفي منتجات "خرائط Google" التي لا تتيح استخدام النقاط على المسار، وتتضمّن حدودًا لعدد النقاط على المسار حسب النظام الأساسي، ويتم تجاهل المَعلمةdir_action=navigateفي حال عدم توفّر ميزة التنقّل. الحلّ: لا تستخدِم أكثر من ثلاث نقاط على المسار للروابط التي تفتح في متصفّحات الأجهزة الجوّالة (تسع نقاط في الحالات الأخرى)، ولا تعتمد على عملwaypointsأوdir_action=navigateفي كل منتج أو مسار على "خرائط Google". يُرجى الاطّلاع على /maps/documentation/urls/get-started#directions-action. - المشكلة: تشترك "خرائط Google" و"التجوّل الافتراضي" في نقطة النهاية
@نفسها، لذا قد لا يعرض عنوان URL للخريطة بدون الإجراء الصحيح خريطة. الحلّ: اضبط السمةmap_action=mapلعروض الخريطة والسمةmap_action=panoلصور بانوراما في "التجوّل الافتراضي". يُرجى الاطّلاع على /maps/documentation/urls/get-started. - المشكلة: في حال عدم توفّر
api=1في عنوان URL لـ "خرائط Google"، يتم تجاهل جميع المَعلمات ويفتح تطبيق "خرائط Google" العرض التلقائي. الحلّ: يجب تضمينapi=1في كل عنوان URL لخدمة "خرائط Google" (1هي القيمة الصالحة الوحيدة). يُرجى الاطّلاع على /maps/documentation/urls/get-started#forming-the-url.