3D ম্যাপে রুট দেখুন

ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA)-এর ডেভেলপার

আপনি দুটি উপায়ে <gmp-map-3d> এলিমেন্টে রুট গণনা ও রেন্ডার করতে পারবেন:

  • Route3DElement (<gmp-route-3d>)-এর সাথে ডিক্লেরেটিভভাবে: একটি ওয়েব কম্পোনেন্ট যোগ করুন যা Routes API থেকে দিকনির্দেশের অনুরোধ করে এবং 3D রুট পলিলাইন, উৎস এবং গন্তব্য মার্কার এবং একটি রুট সারাংশ পপওভার রেন্ডার করে।
  • Route সহায়ক পদ্ধতির মাধ্যমে প্রোগ্রাম্যাটিক্যালি: Route.computeRoutes কল করুন এবং create3DPolylines, createWaypointMarkers এবং createPopover-এ রুট পাস করুন, যখন আপনার ইন্টারমিডিয়েট ওয়েপয়েন্ট, কাস্টম ফিল্ড মাস্ক বা কাস্টম পলিলাইন স্টাইল প্রয়োজন হবে।

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

পূর্বশর্ত ও বিলিং

3D রুট দেখানোর আগে, আপনার Google Cloud প্রোজেক্ট সেট-আপ করুন এবং সেই প্রোজেক্টের জন্য Maps JavaScript API এবং Routes API, দুটিই চালু করুন। maps3d এবং routes লাইব্রেরি দুটিই লোড করুন।

<gmp-map-3d> রেন্ডার করার জন্য ডায়নামিক 3D Maps (Immersive Maps Pro)-এর অধীনে বিল করা হয়। <gmp-route-3d> বা Route.computeRoutes-এর মাধ্যমে করা প্রতিটি রুট অনুরোধের জন্য অনুরোধ করা ফিচারের উপর ভিত্তি করে Routes API Compute Routes SKU-এর অধীনে বিল করা হয়:

কনফিগারেশন Routes SKU টিয়ার
ডিফল্ট রুট সংক্রান্ত অনুরোধ (TRAFFIC_UNAWARE, অথবা WALKING, BICYCLING, এবং TRANSIT ট্রাফিক পলিলাইন ছাড়া ট্রাভেল মোড) Compute Routes Essentials
routing-preference-কে traffic-aware বা traffic-aware-optimal-এ সেট করা হয়েছে এবং traffic-polylines-disabled চালু করা হয়েছে Compute Routes Pro
routing-preference traffic-aware-এ সেট করা হয়েছে অথবা traffic-aware-optimal ট্রাফিক-কালারড পলিলাইন সহ চালু করা হয়েছে (ট্রাফিক-অ্যাওয়ার পছন্দ সেট করা থাকলে ডিফল্ট) Compute Routes Enterprise

SKU সংক্রান্ত বিবরণের জন্য, Maps JavaScript API-এর ব্যবহার ও বিলিং দেখুন।

HTML ব্যবহার করে 3D রুট যোগ করুন

ন্যূনতম কোড ব্যবহার করে শুরু থেকে গন্তব্য পর্যন্ত রুট দেখাতে, <gmp-route-3d>-কে <gmp-map-3d>-এর মধ্যে নেস্ট করুন এবং autofits-camera যোগ করুন যাতে ম্যাপ অটোমেটিক রুট ফ্রেম করে:

<gmp-map-3d
  style="height: 400px; width: 100%;"
  mode="hybrid">
  <gmp-route-3d
    origin="Space Needle, Seattle, WA"
    destination="Tacoma Dome, Tacoma, WA"
    travel-mode="driving"
    routing-preference="traffic-aware"
    autofits-camera>
  </gmp-route-3d>
</gmp-map-3d>

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

YOUR_API_KEY-এর জায়গায় আপনার Google Maps Platform API কী লিখুন।

Route3DElement অটোমেটিক এর পলিলাইন এবং সারাংশ পপওভারের রঙ প্যারেন্ট <gmp-map-3d>-এর হালকা বা গাঢ় রঙের স্কিমের সাথে ম্যাচ করে এবং নিম্নলিখিত অ্যাট্রিবিউট এবং প্রপার্টি সাপোর্ট করে:

  • origin এবং destination: একটি "lat,lng" কোঅর্ডিনেট স্ট্রিং, একটি জায়গার রিসোর্স নাম যেমন "places/ChIJ-bfVTh8VkFQRDZLQnmioK9s", অথবা একটি ঠিকানা স্ট্রিং গ্রহণ করে। JavaScript-এ, এইসব প্রপার্টি LatLng, LatLngLiteral, LatLngAltitude, LatLngAltitudeLiteral ও Place অবজেক্টও গ্রহণ করে।
  • travel-mode (travelMode): driving (ডিফল্ট), walking, bicycling অথবা transit (মাল্টিমোডাল হাঁটা এবং ট্রানজিট লাইন সেগমেন্ট রেন্ডার করে) গ্রহণ করে।
  • routing-preference (routingPreference): traffic-unaware, traffic-aware বা traffic-aware-optimal গ্রহণ করে।
  • traffic-polylines-disabled (trafficPolylinesDisabled): ট্রাফিক-সচেতন রুটে ট্রাফিক-স্পিড পলিলাইন কালারিং বন্ধ করে দেয়, যাতে অনুরোধটি Compute Routes Enterprise-এর পরিবর্তে Compute Routes Pro-এর অধীনে বিল করা হয়।
  • departure-time (departureTime): HTML-এ ISO 8601 টাইমস্ট্যাম্প স্ট্রিং যেমন "2027-03-15T16:00:00Z" বা JavaScript-এ Date অবজেক্ট গ্রহণ করে।
  • autofits-camera (autofitsCamera): <gmp-map-3d> ভিউপোর্টের মধ্যে লোড করা রুট ফ্রেম করে।

রুট ইভেন্ট ম্যানেজ করা এবং রুট ডেটা পড়া

রুট রেন্ডার করা শেষ হলে Route3DElement gmp-load ডিসপ্যাচ করে এবং রুট গণনা ব্যর্থ হলে বা শূন্য রুট রিটার্ন করলে gmp-error ডিসপ্যাচ করে। gmp-load ফায়ার হওয়ার পরে, আপনি গণনা করা routes, fallbackInfo এবং geocodingResults প্রপার্টি পড়তে পারবেন:

const routeElement = document.querySelector('gmp-route-3d');

routeElement.addEventListener('gmp-load', () => {
  const primaryRoute = routeElement.routes?.[0];
  console.log('Distance (m):', primaryRoute?.distanceMeters);
  console.log('Duration:', primaryRoute?.localizedValues?.duration);
});

routeElement.addEventListener('gmp-error', () => {
  console.error('Failed to load the 3D route.');
});

gmp-route-3d-এর পরিবর্তে কখন রুট হেল্পার পদ্ধতি ব্যবহার করতে হবে

<gmp-route-3d> ডিফল্ট মার্কার ও পলিলাইন স্টাইলিং সহ একটি origin ও destination-এর মধ্যে প্রাইমারি রুট রেন্ডার করে। আপনার যখন ইন্টারমিডিয়েট ওয়েপয়েন্ট, বিকল্প রুট বাছাই, কাস্টম রেসপন্স ফিল্ড মাস্ক বা কাস্টম পলিলাইন ও মার্কার স্টাইলের প্রয়োজন হবে তখন 3D হেল্পার মেথডের সাথে Route.computeRoutes ব্যবহার করুন।

Route ক্লাসের মাধ্যমে 3D রুট রেন্ডারিং কাস্টমাইজ করুন

কাস্টম 3D রুট ওয়ার্কফ্লোর জন্য, Route.computeRoutes কল করুন এবং 3D হেল্পার পদ্ধতি ব্যবহার করে <gmp-map-3d>-এ ফেরত আসা Route ইনস্ট্যান্স রেন্ডার করুন:

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

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

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

    const { routes } = await Route.computeRoutes({
      origin: '1800 Amphibious Blvd., Mountain View, CA 94045',
      destination: 'San Francisco Ferry Building, San Francisco, CA',
      travelMode: 'DRIVING',
      routingPreference: 'TRAFFIC_AWARE',
      extraComputations: ['TRAFFIC_ON_POLYLINE'],
      fields: ['path', 'speedPaths', 'localizedValues'],
    });

    const route = routes?.[0];
    if (!route) return;

    const [polylines, markers, popover] = await Promise.all([
      route.create3DPolylines({
        polylineOptions: {
          strokeWidth: 10,
          autofitsCamera: true,
        },
      }),
      route.createWaypointMarkers(),
      route.createPopover(),
    ]);

    map.append(...polylines, ...markers, popover);
  }
</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 কী লিখুন।

আপনার কল করা প্রতিটি হেল্পার মেথডের জন্য ComputeRoutesRequest.fields-এ প্রয়োজনীয় ফিল্ড অন্তর্ভুক্ত করুন:

  • create3DPolylines: স্ট্যান্ডার্ড পলিলাইনের জন্য 'path' বা 'legs', travelMode-এর মান 'TRANSIT' হলে 'path' এবং 'legs', অথবা ট্রাফিক-কালার পলিলাইনের জন্য extraComputations: ['TRAFFIC_ON_POLYLINE'] সহ 'speedPaths' অনুরোধ করুন। কাস্টমাইজ করতে RoutePolyline3DOptions পাস করুন polylineOptions অথবা trafficPolylinesDisabled সেট করুন।
  • createWaypointMarkers: fields-এ 'path'-এর জন্য অনুরোধ করুন। যাত্রা শুরুর জায়গা ও গন্তব্যের মার্কার তৈরি করে (সাধারণত Marker3DElement, অথবা MarkerElement, MarkerInteractiveElement, বা Marker3DInteractiveElement যখন CreateWaypointMarkersOptions-এ markerClass-এর সাথে নির্দিষ্ট করা থাকে)। এই পদ্ধতিতে মধ্যবর্তী ওয়েপয়েন্ট তৈরি করা হয় না।
  • createPopover: রুট পাথের অর্ধেক দূরত্বে PopoverElement সারসংক্ষেপ অ্যাঙ্কর করতে 'path' এবং 'localizedValues' (ট্রানজিট রুটের জন্য 'legs' সহ) অনুরোধ করুন।

পরবর্তী ধাপ