ম্যাপের এলিমেন্টে ক্যামেরা অটোমেটিক ফিট করুন

আপনি কাজ করে এমন চাইল্ড এলিমেন্টে autofits-camera HTML অ্যাট্রিবিউট বা autofitsCamera প্রপার্টি সেট করে, <gmp-map-3d> ভিউপোর্টের মধ্যে অটোমেটিক মার্কার, পলিলাইন, পলিগন ও 3D রুট ফ্রেম করতে পারবেন। এক বা একাধিক চাইল্ড এলিমেন্ট অপ্ট-ইন করলে, ম্যাপ ক্যামেরার এমন একটি পজিশন গণনা করে যা সব অপ্ট-ইন করা এলিমেন্টকে ভিউতে রাখে।

Maps JavaScript API-এর v=beta চ্যানেলে অটোমেটিক ক্যামেরা ফিটিং উপলভ্য। বিটা চ্যানেল লোড করার নির্দেশাবলীর জন্য, ভার্সনিং দেখুন।

যেসব এলিমেন্ট কাজ করে

নিম্নলিখিত টেবিলে 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-এ কাজ করে না। এইসব এলিমেন্ট ফ্রেম করতে, <gmp-map-3d>-এ center এবং range সেট করুন অথবা flyCameraTo-এ কল করুন।

প্রাথমিক লোডে ক্যামেরা ফিট করুন

ম্যাপ লোড হওয়ার সময় এলিমেন্ট ফ্রেম করতে, প্রাথমিক ভিউপোর্টের মধ্যে আপনি যে চাইল্ড এলিমেন্ট চান তার প্রতিটিতে autofits-camera অ্যাট্রিবিউট যোগ করুন। আপনাকে <gmp-map-3d>-এ center বা range গণনা করতে হবে না:

<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 API কী লিখুন।

ডায়নামিক আপডেট ফিট ও অ্যানিমেট করা

প্রাথমিক লোডের পরে আপনি কোনও অপ্ট-ইন করা এলিমেন্ট যোগ করলে, এর কোঅর্ডিনেট বা রুটের এন্ডপয়েন্ট আপডেট করলে অথবা autofitsCamera-কে true-এ সেট করলে, ম্যাপ সব অপ্ট-ইন করা এলিমেন্ট ফ্রেম করার জন্য ক্যামেরা আবার গণনা করে। কোনও এলিমেন্ট সরিয়ে দিলে বা autofitsCamera-কে false-এ সেট করলে, ক্যামেরা তার পজিশনেই থাকে এবং ভবিষ্যতের আপডেট থেকে সেই এলিমেন্ট বাদ দেওয়া হয়।

ডায়নামিক আপডেট স্ন্যাপ বা অ্যানিমেট করবে কিনা তা নিয়ন্ত্রণ করতে, Map3DElement-এ autofitsCameraAnimation (autofits-camera-animation) 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 API কী লিখুন।

ক্যামেরার প্রপার্টি ও বিধিনিষেধ কীভাবে ইন্টার‍্যাক্ট করে

অন্তত একটি চাইল্ড এলিমেন্ট autofits-camera-এর সাথে অপ্ট-ইন করলে, Map3DElement নিম্নলিখিত নিয়ম অনুযায়ী আপনার ম্যাপ কনফিগারেশনকে গণনা করা বাউন্ডের সাথে একত্রিত করে:

  • center এবং range: গণনা করা ফ্রেমিং দ্বারা ওভাররাইড করা হয়েছে, যা ২০% রেঞ্জ প্যাডিং যোগ করে এবং ৮০ মিটার ন্যূনতম রেঞ্জ প্রয়োগ করে। যদি কোনও অপ্ট-ইন করা চাইল্ড এলিমেন্ট কোঅর্ডিনেট প্রদান না করে, তাহলে ম্যাপ তার কনফিগার করা center এবং range ফলব্যাক হিসেবে ব্যবহার করে।
  • tilt এবং heading: ফ্রেমিংয়ের সময় সাজেস্ট করা ভ্যালু হিসেবে বিবেচনা করা হয়। বাদ দেওয়া হলে, উপর থেকে নিচে, উত্তর-দিক উপরে ভিউয়ের জন্য দুটিই ডিফল্ট হিসেবে 0°-এ সেট করা হয়।
  • roll এবং fov: Map3DElement-এ কনফিগার করা হিসেবে বজায় রাখা হয়েছে।
  • অ্যাসিঙ্ক্রোনাস চাইল্ড এলিমেন্ট: প্রাথমিক ভিউ রেন্ডার করার আগে, Map3DElement রুট জিওমেট্রি লোড করা শেষ করতে <gmp-route-3d>-এর মতো অপ্ট-ইন করা অ্যাসিঙ্ক্রোনাস চাইল্ডের জন্য অপেক্ষা করে।
  • ম্যাপ ও ক্যামেরা সংক্রান্ত বিধিনিষেধ: ভৌগোলিক bounds ও ক্যামেরা সংক্রান্ত সীমা (minAltitude, maxAltitude, minTilt, maxTilt, minHeading এবং maxHeading) এখনও অটোফিট করা ভিউকে সীমাবদ্ধ করে। আরও তথ্যের জন্য, ক্যামেরা ভিউ ও বাউন্ড সীমাবদ্ধ করা দেখুন।

পরবর্তী ধাপ