3D मैप पर रास्ते दिखाना

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

<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 मैप (Immersive Maps Pro) के तहत बिल किया जाता है. <gmp-route-3d> या Route.computeRoutes से किए गए हर रूट के अनुरोध के लिए, Routes API Compute Routes के एसकेयू के तहत बिल भेजा जाता है. यह बिल, अनुरोध की गई सुविधाओं के आधार पर तय होता है:

कॉन्फ़िगरेशन Routes एसकेयू टियर
डिफ़ॉल्ट रूट के अनुरोध (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

एसकेयू की जानकारी के लिए, Maps JavaScript API का इस्तेमाल और बिलिंग देखें.

एचटीएमएल का इस्तेमाल करके 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): यह एचटीएमएल में आईएसओ 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 हेल्पर के तरीकों का इस्तेमाल करके, मिले Route इंस्टेंस को <gmp-map-3d> पर रेंडर करें:

<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' का अनुरोध करें. इसके अलावा, ट्रैफ़िक के रंग वाली पॉलीलाइन के लिए, 'speedPaths' के साथ extraComputations: ['TRAFFIC_ON_POLYLINE'] का अनुरोध करें. polylineOptions को पसंद के मुताबिक बनाने या trafficPolylinesDisabled को सेट करने के लिए, RoutePolyline3DOptions पास करें.
  • createWaypointMarkers: fields में 'path' का अनुरोध करें. यह तरीका, यात्रा शुरू होने और खत्म होने की जगह के मार्कर बनाता है. डिफ़ॉल्ट रूप से, Marker3DElement या MarkerElement, MarkerInteractiveElement या Marker3DInteractiveElement मार्कर बनाए जाते हैं. हालांकि, CreateWaypointMarkersOptions में markerClass के साथ बताए जाने पर, अन्य मार्कर भी बनाए जा सकते हैं. इस तरीके से, यात्रा के दौरान पड़ने वाले वेपॉइंट जनरेट नहीं होते.
  • createPopover: रास्ते के बीच में खास जानकारी PopoverElement को ऐंकर करने के लिए, 'path' और 'localizedValues' (बस, मेट्रो वगैरह के रास्तों के लिए 'legs' भी) का अनुरोध करें.

अगले चरण