تنظیم خودکار دوربین با عناصر نقشه

می‌توانید با تنظیم کردن مشخصه 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) همچنان نمای خودکار را محدود می‌کنند. برای اطلاعات بیشتر، محدود کردن نما و مرزهای دوربین را ببینید.

مراحل بعدی