<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'भी) का अनुरोध करें.