ملاءمة الكاميرا تلقائيًا مع عناصر الخريطة

يمكنك تلقائيًا تأطير العلامات والخطوط المتعدّدة والمضلّعات والمسارات الثلاثية الأبعاد ضمن إطار عرض <gmp-map-3d> من خلال ضبط سمة HTML‏ autofits-camera أو السمة autofitsCamera على العناصر الفرعية المتوافقة. عندما يوافق عنصر فرعي واحد أو أكثر، تحسب الخريطة موضع الكاميرا الذي يحافظ على جميع العناصر التي تمت الموافقة عليها في العرض.

تتوفّر ميزة "ضبط الكاميرا تلقائيًا" في قناة v=beta من "واجهة برمجة تطبيقات JavaScript للخرائط". للحصول على تعليمات حول تحميل القناة التجريبية، يُرجى الاطّلاع على تحديد الإصدارات.

العناصر المتوافقة

يسرد الجدول التالي العناصر الثانوية لـ Map3DElement التي تتيح استخدام autofits-camera (autofitsCamera):

عنصر HTML فئة JavaScript المكتبة ملاحظات
‫<gmp-marker-3d>، <gmp-marker-3d-interactive> Marker3DElement، Marker3DInteractiveElement maps3d يؤطّر position العلامة.
‫<gmp-marker>، <gmp-marker-interactive> MarkerElement، MarkerInteractiveElement maps3d يؤطّر position العلامة.
‫<gmp-polyline-3d>، <gmp-polyline-3d-interactive> Polyline3DElement، Polyline3DInteractiveElement maps3d يؤطّر جميع الإحداثيات في path الخطوط المتعدّدة.
‫<gmp-polygon-3d>، <gmp-polygon-3d-interactive> Polygon3DElement، Polygon3DInteractiveElement maps3d يؤطّر جميع الإحداثيات في path المضلّع.
<gmp-route-3d> Route3DElement routes ينتظر حلّ طلب المسار، ثم يضع إطارًا لمسار المسار.

العناصر غير المتوافقة

لا تتوافق Model3DElement وPopoverElement وFlattenerElement مع autofitsCamera. لتأطير هذه العناصر، اضبط center وrange على <gmp-map-3d> أو استخدِم flyCameraTo.

ملاءمة الكاميرا عند التحميل الأولي

لتحديد العناصر عند تحميل الخريطة، أضِف السمة autofits-camera إلى كل عنصر فرعي تريده داخل إطار العرض الأولي. ليس عليك احتساب center أو range في <gmp-map-3d>:

<gmp-map-3d
  style="height: 400px; width: 100%;"
  mode="hybrid">
  <gmp-marker-3d
    position="47.6205,-122.3493"
    title="Space Needle"
    autofits-camera>
  </gmp-marker-3d>
  <gmp-marker-3d
    position="47.6097,-122.3425"
    title="Pike Place Market"
    autofits-camera>
  </gmp-marker-3d>
  <gmp-polyline-3d
    path="47.6205,-122.3493,0 47.6097,-122.3425,0"
    stroke-color="#4285F4"
    stroke-width="8"
    altitude-mode="clamp-to-ground"
    autofits-camera>
  </gmp-polyline-3d>
</gmp-map-3d>

<script async
  src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&v=beta&libraries=maps3d">
</script>

استبدِل YOUR_API_KEY بمفتاح واجهة برمجة التطبيقات في "منصة خرائط Google".

ملاءمة التحديثات الديناميكية وتحريكها

عند إضافة عنصر تم تفعيله بعد التحميل الأولي، أو تعديل إحداثياته أو نقاط نهاية المسار، أو ضبط autofitsCamera على true، تعيد الخريطة احتساب الكاميرا لتأطير جميع العناصر التي تم تفعيلها. تؤدي إزالة عنصر أو ضبط autofitsCamera على false إلى ترك الكاميرا في موضعها واستبعاد هذا العنصر من التحديثات المستقبلية.

للتحكّم في ما إذا كانت التعديلات الديناميكية تظهر فجأة أو بشكل متحرك، اضبط autofitsCameraAnimation (autofits-camera-animation) على Map3DElement على قيمة AutofitsCameraAnimation:

  • ‫AutofitsCameraAnimation.NONE ("none"، تلقائي): يتم الانتقال إلى الموضع المعدَّل بدون تأثيرات متحركة.
  • ‫AutofitsCameraAnimation.FLY_TO ("fly-to"): يتم الانتقال بسلاسة إلى الموقع الجغرافي المعدَّل. يتم تحميل الخريطة الأولية بدون تأثيرات متحركة، ويعود FLY_TO إلى وضعية الانطباق عندما يطلب نظام تشغيل المستخدم تقليل الحركة.

لضبط autofitsCamera وAutofitsCameraAnimation.FLY_TO برمجيًا، يمكنك الاطّلاع على المثال التالي:

<div id="map-container" style="height: 400px; width: 100%;"></div>

<script>
  async function initMap() {
    const {
      AutofitsCameraAnimation,
      Map3DElement,
      Marker3DElement,
      MapMode,
    } = await google.maps.importLibrary('maps3d');

    const map = new Map3DElement({
      mode: MapMode.HYBRID,
      autofitsCameraAnimation: AutofitsCameraAnimation.FLY_TO,
    });
    document.getElementById('map-container').append(map);

    const originMarker = new Marker3DElement({
      position: { lat: 37.7955, lng: -122.3937 },
      autofitsCamera: true,
    });
    map.append(originMarker);

    /* Adding a second opted-in marker flies the camera to frame both. */
    const destinationMarker = new Marker3DElement({
      position: { lat: 37.8080, lng: -122.4177 },
      autofitsCamera: true,
    });
    map.append(destinationMarker);
  }
</script>
<script async
  src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&v=beta&loading=async&callback=initMap">
</script>

استبدِل YOUR_API_KEY بمفتاح واجهة برمجة التطبيقات في "منصة خرائط Google".

كيفية تفاعل خصائص الكاميرا والقيود

عندما يوافق عنصر فرعي واحد على الأقل على استخدام autofits-camera، يدمج Map3DElement إعدادات الخريطة مع الحدود المحسوبة وفقًا للقواعد التالية:

  • center وrange: يتم تجاوزهما من خلال الإطار المحسوب الذي يضيف هامشًا بنسبة %20 إلى النطاق ويفرض حدًا أدنى للنطاق يبلغ 80 مترًا. إذا لم توفّر أي عناصر فرعية تم تفعيلها إحداثيات، تستخدم الخريطة center وrange اللذين تم ضبطهما كبديلَين.
  • tilt وheading: يتم التعامل معهما كقيم مقترَحة أثناء التأطير. وعند حذفها، يتم ضبط كليهما تلقائيًا على 0° للحصول على عرض من الأعلى إلى الأسفل ومن الشمال إلى الأعلى.
  • ‫roll وfov: يتم الاحتفاظ بهما كما تم ضبطهما في Map3DElement.
  • العناصر الفرعية غير المتزامنة: قبل عرض العرض الأولي، Map3DElement ينتظر العناصر الفرعية غير المتزامنة التي تم تفعيلها مثل <gmp-route-3d> لإنهاء تحميل هندسة المسار.
  • القيود المفروضة على الخريطة والكاميرا: تظلّ القيود الجغرافية bounds والقيود المفروضة على الكاميرا (minAltitude وmaxAltitude وminTilt وmaxTilt وminHeading وmaxHeading) تفرض قيودًا على العرض الذي تمّت ملاءمته تلقائيًا. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تقييد عرض الكاميرا وحدودها.

الخطوات التالية