مرجع سريع لعناوين URL في "خرائط Google"

تتيح لك عناوين URL في "خرائط Google" إنشاء عنوان URL عام يعمل من عدّة منصات ويشغّل "خرائط Google" لإجراء عمليات البحث أو الحصول على الاتجاهات والتنقّل أو عرض الخرائط أو إنشاء قائمة مختصرة بالأماكن أو عرض صور بانوراما في "التجوّل الافتراضي". بنية عنوان URL هي نفسها على كل نظام أساسي، ولا يلزم توفّر مفتاح واجهة برمجة التطبيقات.

عناوين 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": الأخطاء الشائعة

  • المشكلة: يعرض عنوان 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.