استخدام إطار iFrame في Waze

يمكن للمطورين تضمين خريطة Waze المباشرة على موقعهم الإلكتروني. تتيح "الخريطة المباشرة" للزوار البحث عن المواقع وعرض أحوال حركة المرور في الوقت الفعلي بناءً على بيانات خريطة الوقت الفعلي لتطبيق Waze.

يمكنك تضمين خريطة Waze Live في موقعك الإلكتروني باستخدام إطار iframe، بحيث تظهر النتيجة على النحو التالي:

بشكل افتراضي، تشتمل الخريطة المباشرة على رابط إلى خيارات البحث وتوجيه هذه الخريطة في أسفل الجانب الأيسر.

للحصول على أمثلة على خيارات ضبط الخريطة المباشرة، راجع أمثلة.

لتضمين إطار iframe في خريطة Waze Live:

  1. افتح صفحة الويب في محرِّر نصوص.
  2. لإنشاء إطار iframe على صفحة الويب، أضِف رمز إطار iframe إلى صفحة الويب الخاصة بك.
  3. افتح خريطة Waze المباشرة، وابحث عن موقعك الجغرافي إما في شريط البحث أو عن طريق التكبير والنقر على جزء معيّن من الخريطة.
  4. انقر على رمز المشاركة في أسفل يسار الخريطة.
  5. يُفترض أن تظهر نافذة منبثقة تحتوي على رمز تضمين مخصص. انسخ الرمز والصقه في النص الأساسي لصفحة الويب.

مثال

يوضح المثال التالي كيفية تضمين الخريطة المباشرة في موقعك الإلكتروني. حدّث معلمات عنوان URL لحالة الاستخدام.

<iframe src="https://embed.waze.com/iframe?zoom=12&lat=45.6906304&lon=-120.810983"
  width="300" height="400"></iframe>

لتضمين إطار iframe في موقع ويب سريع الاستجابة، ننصحك باستخدام تقنيات CSS الشائعة لضبط حجم إطار IFrame تلقائيًا حسب حجم الشاشة.

معلمات عنوان URL

يوضِّح الجدول التالي معلَمات إطار iframe في Waze:

المَعلمة مطلوب؟ الوصف
desc إجراء اختياري يمكنك ضبط هذه المَعلمة على أي قيمة لعرض مربّع نص وصفي في الخريطة المباشرة. تستخدم جهات البث هذا النص لتوفير معلومات حديثة لمستخدمي Waze، بدون الحاجة إلى إجراء تعديلات يدوية على المواقع الإلكترونية لمحطاتها. يتم إنشاء كل النصوص بواسطة Waze لضمان صحة المحتوى.
lat مطلوب تمثّل هذه السمة خط العرض لنقطة وسط الخريطة.
lon مطلوب تمثّل هذه السمة خط الطول لنقطة وسط الخريطة.
pin إجراء اختياري

اضبط القيمة على 1 لوضع دبوس في وسط الخريطة. مثلاً:

<iframe src="https://embed.waze.com/iframe?
  zoom=12&lat=45.6906304&lon=-120.810983&pin=1"
  width="300" height="400"></iframe>

zoom مطلوب

مستوى تكبير الخريطة عند فتحها.

الحد الأدنى للقيمة هو 3 (أقل تكبير). الحد الأقصى للقيمة هو 17 (معظم التكبير).

ترجمة

رمز اللغة الافتراضي هو الإنجليزية. لمزيد من المعلومات، راجع ترجمة إطار iframe.

يوضح المثال التالي كيفية تغيير لغة العرض:

<iframe src="https://embed.waze.com/fr/iframe?zoom=12&lat=45.6906304&lon=-120.810983"
  width="300" height="400"></iframe>

الإرشادات

لتضمين خريطة Waze Live على موقعك، يجب الالتزام بالإرشادات التالية:

  • لا تربط Waze باستخدام خريطة غير تابعة لـ Waze بأي شكل من الأشكال.

  • لا تستخدِم مواد تحمل علامة Waze التجارية (مثل الشعار أو الرموز أو غير ذلك) مع خرائط غير تابعة لـ Waze.

أمثلة

توضح الأمثلة التالية استخدام مجموعات من المعلمات لإضافة عناصر مرئية مختلفة إلى الخريطة المباشرة:

مثال 1

يظهر دبوس الخريطة في تنفيذ iframe التالي.

مانهاتن، نيويورك (مع الدبوس):

يستخدم iframe الرمز التالي:

<iframe src="https://embed.waze.com/iframe?zoom=13&lat=40.78247&lon=-73.97105&pin=1"
            width="100%" height="520"></iframe>

مثال 2

يظهر دبوس الخريطة في تنفيذ iframe التالي ويتضمن النص الوصفي.

سان باولو (مع رقم التعريف الشخصي والوصف):

يستخدم iframe الرمز التالي:

<iframe src="https://embed.waze.com/iframe?zoom=14&lat=-23.55052&lon=-46.63331&pin=1&desc=1"
            width="100%" height="520"></iframe>

مثال 3

يظهر دبوس الخريطة في تنفيذ iframe التالي.

باريس، فرنسا (مع الدبوس):

يستخدم iframe الرمز التالي:

<iframe src="https://embed.waze.com/iframe?zoom=13&lat=48.85661&lon=2.35222&pin=1"
            width="100%" height="520"></iframe>

تواصل مع منتدى مطوري Waze

لمزيد من المعلومات، انضم إلى المحادثة في منتدى مطوّري Waze.