يمكنك تلقائيًا تأطير العلامات والخطوط المتعدّدة والمضلّعات والمسارات الثلاثية الأبعاد ضمن إطار عرض <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) تفرض قيودًا على العرض الذي تمّت ملاءمته تلقائيًا. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تقييد عرض الكاميرا وحدودها.