تحتوي هذه الصفحة على معلومات عن الميزات الرئيسية في "الخرائط الثلاثية الأبعاد ذات المظهر الواقعي" في JavaScript في "خرائط Google"، والتي تتيح لك إنشاء تجارب ثلاثية الأبعاد تفاعلية وغامرّة. تتناول المستندات التالية ما يلي:
- معالجة أحداث واجهة المستخدم لإجراء تفاعل سلس
- بما في ذلك عناصر التحكّم في الاستكشاف للتنقّل في المساحات الثلاثية الأبعاد
- استخدام مسارات الكاميرا المُعدّة مسبقًا للجولات الإرشادية
- تطبيق قيود على الكاميرا للحفاظ على التركيز على منطقة معيّنة
أحداث واجهة المستخدم
يوضّح هذا القسم الأحداث التفاعلية وإشعارات تغيير الحالة التي يمكنك الاستماع إليها ومعالجتها آليًا عند العمل مع الخرائط الثلاثية الأبعاد. إنّ JavaScript داخل المتصفّح مستندة إلى الأحداث، ما يعني أنّها تستجيب لتفاعلات المستخدمين من خلال إنشاء أحداث يمكن لبرنامجك الاستماع إليها وتنفيذ الرمز البرمجي وفقًا لذلك.
هناك نوعان رئيسيان من الأحداث:
- يتم نشر أحداث تفاعل المستخدِم (مثل نقرات الماوس) من مساحة عرض الاطِّلاع على التضاريس المجسمة إلى الرمز البرمجي. تتيح لك هذه الأحداث الاستجابة لأيّ إجراءات مباشرة من جانب المستخدم ضمن بيئة الخريطة الثلاثية الأبعاد. الاطّلاع على عيّنة
- تعكس إشعارات تغيير الحالة التعديلات التي تم إجراؤها على نماذج بيانات الخريطة الثلاثية الأبعاد الأساسية
وحالة العرض، وذلك باستخدام مخطّط تسمية
property_changedتقليدي.
يعرِض كل عنصر من عناصر واجهة برمجة التطبيقات لرسم الخرائط الثلاثية الأبعاد مجموعة من الأحداث المُسمّاة التي يمكن لبرنامجك تسجيل مستمعي الأحداث لها وتنفيذ المنطق عند وقوع هذه الأحداث باستخدام الدالة addEventListener() المضمّنة. يوضِّح المثال التالي
الأحداث الشائعة التي يتم بدء تشغيلها عندما يتفاعل المستخدِم مع خريطة ثلاثية الأبعاد.
يوضِّح المثال التالي الأحداث التي يتم تشغيلها عندما يتفاعل المستخدِم مع الخريطة:
عناصر التحكّم في الاستكشافات
تحتوي الخرائط المعروضة في واجهة برمجة التطبيقات "خرائط Google بتكنولوجيا JavaScript" على عناصر واجهة مستخدم تتيح للمستخدم التفاعل مع الخريطة. وتُعرف هذه العناصر باسم عناصر التحكّم في المستخدم. يتم تضمين عناصر التحكّم في الاستكشاف تلقائيًا، ولكن يمكنك اختيار إخفاء هذه العناصر في تطبيقك.
تعرض الصورة التالية عناصر التحكّم التلقائية التي تعرِضها "الخرائط الثلاثية الأبعاد بالصور الواقعية" في JavaScript في "خرائط Google":
في ما يلي قائمة بالمجموعة الكاملة من عناصر التحكّم في "الخرائط الثلاثية الأبعاد ذات المظهر الواقعي" في JavaScript في "خرائط Google":
- يعرض عنصر التحكّم في التكبير/التصغير الزرَّين "+" و "-" لتغيير مستوى التكبير/التصغير للخريطة.
- يتيح لك التحكّم في الإمالة تغيير إمالة الكاميرا.
- يتيح لك عنصر التحكّم في التدوير تغيير اتجاه الكاميرا.
- يعرض عنصر التحكّم في الانتقال الأزرار "←" و"→" و"↑" و "↓" لتغيير مركز الخريطة.
عناصر التحكّم في الكاميرا والصور المتحركة
مسارات الكاميرا المُعدّة مسبقًا
توفّر "الخرائط الثلاثية الأبعاد التي تبدو مثل الصور" في JavaScript في "خرائط Google" مسارَين مُعدَّين مسبقًا للكاميرا. يمكن تخصيص مسارات الكاميرا من خلال تغيير مدة الرسوم المتحركة (وبالتالي زيادة أو تقليل السرعة)، أو من خلال دمجها لإنشاء تجارب سينمائية أكثر.
تتيح الخرائط الثلاثية الأبعاد التي تبدو مثل الصور الفوتوغرافية في JavaScript في "خرائط Google" مسارات الكاميرا التالية:
- تطير رسوم
FlyCameraToالمتحركة من وسط الخريطة إلى وجهة محدّدة. FlyCameraAroundتدور الصورة المتحركة حول نقطة على الخريطة بعدد المرات التي تحدّدها.
يمكن دمج المسارين المتاحَين للانتقال إلى نقطة اهتمام، ثم الدوران حولها، ثم التوقف عند الضرورة.
القيود المفروضة على الكاميرا
قد يكون من المفيد لك التحكّم في العرض الشامل للكاميرا أو الحد الأقصى للارتفاع أو إنشاء حدود خطوط الطول والعرض التي تحدّ من حركة المستخدم في خريطة معيّنة. يمكنك انجامه باستخدام قيود الكاميرا.
للاطّلاع على مثال على كيفية عمل قيود الكاميرا وتنفيذها، يمكنك الاطّلاع على العرض التجريبي.