میتوانید با تنظیم کردن مشخصه HTML autofits-camera یا ویژگی autofitsCamera در عناصر فرزند پشتیبانیشده، نشانگرها، چندخطیها، چندضلعیها، و مسیرهای سهبعدی را بهطور خودکار در نمای <gmp-map-3d> قاببندی کنید. وقتی یک یا چند عنصر فرزند موافقت میکنند، نقشه موقعیت دوربینی را محاسبه میکند که همه عناصر موافقتکرده را در دید نگه میدارد.
تنظیم خودکار دوربین در کانال v=beta
Maps JavaScript API دردسترس است. برای دستورالعملهای مربوط به بار کردن کانال بتا،
نسخهسازی را ببینید.
عناصر پشتیبانیشده
جدول زیر عناصر فرزند Map3DElement را که از autofits-camera (autofitsCamera) پشتیبانی میکنند فهرست میکند:
| عنصر اچتیامال | کلاس جاوا اسکریپت | کتابخانه | یادداشتها |
|---|---|---|---|
<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 Maps Platform جایگزین کنید.
بهروزرسانیهای پویا را متناسب و پویانمایی کنید
وقتی پساز بار کردن اولیه، عنصر موافقتشدهای را اضافه میکنید، مختصات یا نقاط پایانی مسیر آن را بهروز میکنید، یا 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 Maps Platform جایگزین کنید.
نحوه تعامل ویژگیها و محدودیتهای دوربین
وقتی حداقل یک عنصر فرزند با autofits-camera موافقت میکند، Map3DElement پیکربندی نقشه شما را با مرزهای محاسبهشده طبق قوانین زیر ترکیب میکند:
centerوrange: با قاببندی محاسبهشده لغو میشود، که ۲۰٪ حاشیه به محدوده اضافه میکند و حداقل محدوده ۸۰ متری را اعمال میکند. اگر هیچ عنصر فرزند موافقتکردهای مختصات ارائه نکند، نقشه ازcenterوrangeپیکربندیشده خود بهعنوان جایگزین استفاده میکند.tiltوheading: درطول قاببندی بهعنوان مقادیر پیشنهادی درنظر گرفته میشوند. وقتی حذف شود، هر دو بهطور پیشفرض روی0°برای نمای از بالا به پایین و شمال در بالا تنظیم میشوند.rollوfov: همانطور که درMap3DElementپیکربندی شده است حفظ میشود.- عناصر فرزند ناهمگام: قبلاز رندر کردن نمای اولیه،
Map3DElementمنتظر میماند تا فرزندان ناهمگام موافقتکرده مثل<gmp-route-3d>بار کردن هندسه مسیر را تمام کنند. - محدودیتهای نقشه و دوربین: محدودیتهای جغرافیایی
boundsو دوربین (minAltitude،maxAltitude،minTilt،maxTilt،minHeading، وmaxHeading) همچنان نمای خودکار را محدود میکنند. برای اطلاعات بیشتر، محدود کردن نما و مرزهای دوربین را ببینید.