3D Maps

Map3DElement क्लास

google.maps.maps3d.Map3DElement क्लास

Map3DElement, 3D मैप व्यू के लिए एक एचटीएमएल इंटरफ़ेस है. ध्यान दें कि 3D मैप को रेंडर करने के लिए, mode सेट करना ज़रूरी है.

कस्टम एलिमेंट:
<gmp-map-3d center="lat,lng,altitude" default-ui-disabled heading="number" max-altitude="number" max-heading="number" max-tilt="number" min-altitude="number" min-heading="number" min-tilt="number" mode="hybrid" range="number" roll="number" tilt="number"></gmp-map-3d>

यह क्लास HTMLElement तक चलेगी.

यह क्लास Map3DElementOptions को लागू करती है.

const {Map3DElement} = await google.maps.importLibrary("maps3d") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.
Map3DElement
Map3DElement([options])
पैरामीटर: 
bounds
टाइप:  LatLngBounds|LatLngBoundsLiteral optional
इस विकल्प को सेट करने पर, कैमरे की पोज़िशन को तय किए गए अक्षांश/देशांतर की सीमाओं के अंदर ही रखा जाता है. ध्यान दें कि सीमा से बाहर के ऑब्जेक्ट अब भी रेंडर किए जाते हैं. सीमाएं, अक्षांश और देशांतर, दोनों को सीमित कर सकती हैं. इसके अलावा, सिर्फ़ अक्षांश या देशांतर को भी सीमित कर सकती हैं. सिर्फ़ अक्षांश की सीमाओं के लिए, -180 और 180 के पश्चिम और पूर्व देशांतर का इस्तेमाल करें. सिर्फ़ देशांतर की सीमाओं के लिए, उत्तर और दक्षिण अक्षांशों के लिए 90 और -90 का इस्तेमाल करें.
center
टाइप:  LatLngAltitude|LatLngAltitudeLiteral optional
मैप का सेंटर, LatLngAltitude के तौर पर दिया गया है. इसमें ऊंचाई को ज़मीन के लेवल से मीटर में दिखाया गया है. ध्यान दें कि यह ज़रूरी नहीं है कि कैमरा इसी जगह पर हो, क्योंकि range फ़ील्ड से, कैमरे की दूरी पर असर पड़ता है. अगर यह सेट नहीं है, तो डिफ़ॉल्ट रूप से {lat: 0, lng: 0, altitude: 63170000} लागू हो जाती है. ज़्यादा से ज़्यादा 63170000 मीटर की ऊंचाई पर जाने की अनुमति है. यह पृथ्वी की त्रिज्या को 10 से गुणा करने पर मिलता है.
एचटीएमएल एट्रिब्यूट:
  • <gmp-map-3d center="lat,lng,altitude"></gmp-map-3d>
defaultUIDisabled
टाइप:  boolean optional
डिफ़ॉल्ट: false
true होने पर, यूज़र इंटरफ़ेस (यूआई) के सभी डिफ़ॉल्ट बटन बंद हो जाते हैं. इससे कीबोर्ड और जेस्चर कंट्रोल बंद नहीं होते.
एचटीएमएल एट्रिब्यूट:
  • <gmp-map-3d default-ui-disabled></gmp-map-3d>
heading
टाइप:  number optional
यह मैप की कंपास हेडिंग है. इसे डिग्री में दिखाया जाता है. उत्तर दिशा को शून्य डिग्री माना जाता है. जब कोई झुकाव नहीं होता है, तो किसी भी रोल को हेडिंग के तौर पर माना जाएगा.
एचटीएमएल एट्रिब्यूट:
  • <gmp-map-3d heading="number"></gmp-map-3d>
maxAltitude
टाइप:  number optional
ज़मीन से ज़्यादा से ज़्यादा ऊंचाई, जिसे मैप पर दिखाया जाएगा. मान्य वैल्यू, 0 और 63170000 मीटर के बीच होनी चाहिए. यह पृथ्वी की त्रिज्या को 10 से गुणा करने पर मिलती है.
एचटीएमएल एट्रिब्यूट:
  • <gmp-map-3d max-altitude="number"></gmp-map-3d>
maxHeading
टाइप:  number optional
मैप के हेडिंग (रोटेशन) का ज़्यादा से ज़्यादा कोण. मान्य वैल्यू, 0 और 360 डिग्री के बीच होनी चाहिए. minHeading और maxHeading, <= 360 डिग्री के इंटरवल को दिखाते हैं. इस इंटरवल में हेडिंग के लिए जेस्चर इस्तेमाल किए जा सकते हैं. minHeading = 180 और maxHeading = 90 की मदद से, [0, 90] और [180, 360] में हेडिंग जोड़ी जा सकेंगी. minHeading = 90 और maxHeading = 180 की मदद से, [90, 180] में हेडिंग इस्तेमाल की जा सकेंगी.
एचटीएमएल एट्रिब्यूट:
  • <gmp-map-3d max-heading="number"></gmp-map-3d>
maxTilt
टाइप:  number optional
मैप के झुकाव का ज़्यादा से ज़्यादा कोण. मान्य वैल्यू, 0 और 90 डिग्री के बीच होनी चाहिए.
एचटीएमएल एट्रिब्यूट:
  • <gmp-map-3d max-tilt="number"></gmp-map-3d>
minAltitude
टाइप:  number optional
ज़मीन से कम से कम ऊंचाई, जिसे मैप पर दिखाया जाएगा. मान्य वैल्यू, 0 और 63170000 मीटर के बीच होनी चाहिए. यह पृथ्वी की त्रिज्या को 10 से गुणा करने पर मिलती है.
एचटीएमएल एट्रिब्यूट:
  • <gmp-map-3d min-altitude="number"></gmp-map-3d>
minHeading
टाइप:  number optional
मैप के हेडिंग (रोटेशन) का कम से कम कोण. मान्य वैल्यू, 0 और 360 डिग्री के बीच होनी चाहिए. minHeading और maxHeading, <= 360 डिग्री के इंटरवल को दिखाते हैं. इस इंटरवल में हेडिंग के लिए जेस्चर इस्तेमाल किए जा सकते हैं. minHeading = 180 और maxHeading = 90 की मदद से, [0, 90] और [180, 360] में हेडिंग जोड़ी जा सकेंगी. minHeading = 90 और maxHeading = 180 की मदद से, [90, 180] में हेडिंग इस्तेमाल की जा सकेंगी.
एचटीएमएल एट्रिब्यूट:
  • <gmp-map-3d min-heading="number"></gmp-map-3d>
minTilt
टाइप:  number optional
मैप के लिए, रोशनी के आने का कम से कम कोण. मान्य वैल्यू, 0 और 90 डिग्री के बीच होनी चाहिए.
एचटीएमएल एट्रिब्यूट:
  • <gmp-map-3d min-tilt="number"></gmp-map-3d>
mode
टाइप:  MapMode optional
यह तय करता है कि मैप किस मोड में रेंडर होना चाहिए. अगर इसे सेट नहीं किया जाता है, तो मैप रेंडर नहीं होगा.
एचटीएमएल एट्रिब्यूट:
  • <gmp-map-3d mode="hybrid"></gmp-map-3d>
  • <gmp-map-3d mode="satellite"></gmp-map-3d>
range
टाइप:  number optional
कैमरे से मैप के बीच की दूरी, मीटर में.
एचटीएमएल एट्रिब्यूट:
  • <gmp-map-3d range="number"></gmp-map-3d>
roll
टाइप:  number optional
व्यू वेक्टर के चारों ओर कैमरे का रोल, डिग्री में. झुकाव न होने पर, किसी भी रोल को हेडिंग के तौर पर माना जाएगा, ताकि अस्पष्टता को दूर किया जा सके.
एचटीएमएल एट्रिब्यूट:
  • <gmp-map-3d roll="number"></gmp-map-3d>
tilt
टाइप:  number optional
कैमरे के व्यू वेक्टर का झुकाव, डिग्री में. पृथ्वी को सीधे तौर पर देखने वाले व्यू वेक्टर का झुकाव शून्य डिग्री होगा. पृथ्वी से दूर की ओर इशारा करने वाले व्यू वेक्टर का झुकाव 180 डिग्री होगा.
एचटीएमएल एट्रिब्यूट:
  • <gmp-map-3d tilt="number"></gmp-map-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
पैरामीटर: 
  • type:  string केस-सेंसिटिव स्ट्रिंग, जो सुनने के लिए इवेंट टाइप को दिखाती है.
  • listener:  EventListener|EventListenerObject वह ऑब्जेक्ट जिसे सूचना मिलती है. यह एक फ़ंक्शन या handleEvent तरीके वाला ऑब्जेक्ट होना चाहिए
  • options:  boolean|AddEventListenerOptions optional विकल्प देखें. कस्टम इवेंट, सिर्फ़ capture और passive के साथ काम करते हैं.
लौटाई गई वैल्यू:  void
यह कुकी एक फ़ंक्शन सेट अप करती है. इस फ़ंक्शन को तब कॉल किया जाता है, जब टारगेट को तय किया गया इवेंट डिलीवर किया जाता है. addEventListener देखें.
flyCameraAround
flyCameraAround(options)
पैरामीटर: 
रिटर्न वैल्यू:  कोई नहीं
इस तरीके में, कैमरे को किसी जगह के चारों ओर एक तय समय तक घुमाया जाता है. इस दौरान, कैमरा तय संख्या में चक्कर लगाता है.

डिफ़ॉल्ट रूप से, कैमरा घड़ी की सुई की दिशा में घूमता है. अगर राउंड के लिए कोई नेगेटिव नंबर दिया जाता है, तो कैमरा घड़ी की सुई की उलटी दिशा में घूमेगा.

यह तरीका एसिंक्रोनस है, क्योंकि मैप के कम से कम हिस्से के लोड होने के बाद ही ऐनिमेशन शुरू हो सकते हैं. ऐनिमेशन शुरू होने के बाद, यह तरीका वापस आ जाता है.

अगर राउंड की संख्या शून्य है, तो कोई स्पिन नहीं होगा. साथ ही, ऐनिमेशन शुरू होने के तुरंत बाद पूरा हो जाएगा.
flyCameraTo
flyCameraTo(options)
पैरामीटर: 
रिटर्न वैल्यू:  कोई नहीं
इस तरीके से, कैमरे को मौजूदा जगह से तय की गई आखिरी जगह तक, तय समय में घुमाया जाता है.

यह तरीका एसिंक्रोनस है, क्योंकि मैप के कम से कम हिस्से के लोड होने के बाद ही ऐनिमेशन शुरू हो सकते हैं. ऐनिमेशन शुरू होने के बाद, यह तरीका वापस आ जाता है.
BetaremoveEventListener
removeEventListener(type, listener[, options])
पैरामीटर: 
  • type:  string यह एक स्ट्रिंग है. इससे उस इवेंट के टाइप के बारे में पता चलता है जिसके लिए इवेंट लिसनर को हटाना है.
  • listener:  EventListener|EventListenerObject इवेंट टारगेट से हटाने के लिए, इवेंट हैंडलर का इवेंट लिसनर.
  • options:  boolean|EventListenerOptions optional विकल्प देखें.
लौटाई गई वैल्यू:  void
यह फ़ंक्शन, टारगेट से उस इवेंट लिसनर को हटाता है जिसे addEventListener के साथ रजिस्टर किया गया था. removeEventListener देखें.
stopCameraAnimation
stopCameraAnimation()
पैरामीटर:  कोई नहीं
रिटर्न वैल्यू:  कोई नहीं
इस तरीके से, फ़्लाइ ऐनिमेशन को रोका जा सकता है. ऐनिमेशन के बीच में कैमरा जहां होता है वहीं रहता है. यह आखिर की जगह पर नहीं पहुंचता.

यह तरीका एसिंक्रोनस है, क्योंकि मैप के कम से कम हिस्से के लोड होने के बाद ही ऐनिमेशन शुरू या बंद किए जा सकते हैं. एनिमेशन रुकने के बाद, यह तरीका काम करना बंद कर देता है.
gmp-animationend
function(animationEndEvent)
आर्ग्युमेंट: 
  • animationEndEvent:  Event
फ़्लाइ ऐनिमेशन खत्म होने पर, यह इवेंट ट्रिगर होता है. यह इवेंट, डीओएम ट्री के ज़रिए बब्ल अप होता है.
gmp-centerchange
function(centerChangeEvent)
आर्ग्युमेंट: 
  • centerChangeEvent:  Event
Map3DElement की सेंटर प्रॉपर्टी में बदलाव होने पर, यह इवेंट ट्रिगर होता है.
gmp-click
function(clickEvent)
आर्ग्युमेंट: 
Map3DElement एलिमेंट पर क्लिक करने पर, यह इवेंट ट्रिगर होता है.
gmp-headingchange
function(headingChangeEvent)
आर्ग्युमेंट: 
  • headingChangeEvent:  Event
Map3DElement की हेडिंग प्रॉपर्टी में बदलाव होने पर, यह इवेंट ट्रिगर होता है.
gmp-rangechange
function(rangeChangeEvent)
आर्ग्युमेंट: 
  • rangeChangeEvent:  Event
यह इवेंट तब ट्रिगर होता है, जब Map3DElement की रेंज प्रॉपर्टी बदलती है.
gmp-rollchange
function(rollChangeEvent)
आर्ग्युमेंट: 
  • rollChangeEvent:  Event
Map3DElement की रोल प्रॉपर्टी में बदलाव होने पर, यह इवेंट ट्रिगर होता है.
gmp-steadychange
function(steadyChangeEvent)
आर्ग्युमेंट: 
Map3DElement की स्थिर स्थिति में बदलाव होने पर, यह इवेंट ट्रिगर होता है.
gmp-tiltchange
function(tiltChangeEvent)
आर्ग्युमेंट: 
  • tiltChangeEvent:  Event
Map3DElement की टिल्ट प्रॉपर्टी में बदलाव होने पर, यह इवेंट ट्रिगर होता है.

Map3DElementOptions इंटरफ़ेस

google.maps.maps3d.Map3DElementOptions इंटरफ़ेस

Map3DElementOptions ऑब्जेक्ट का इस्तेमाल, उन प्रॉपर्टी को तय करने के लिए किया जाता है जिन्हें Map3DElement पर सेट किया जा सकता है.
bounds optional
टाइप:  LatLngBounds|LatLngBoundsLiteral optional
Map3DElement.bounds देखें.
center optional
टाइप:  LatLngAltitude|LatLngAltitudeLiteral optional
Map3DElement.center देखें.
defaultUIDisabled optional
टाइप:  boolean optional
Map3DElement.defaultUIDisabled देखें.
heading optional
टाइप:  number optional
Map3DElement.heading देखें.
maxAltitude optional
टाइप:  number optional
Map3DElement.maxAltitude देखें.
maxHeading optional
टाइप:  number optional
Map3DElement.maxHeading देखें.
maxTilt optional
टाइप:  number optional
Map3DElement.maxTilt देखें.
minAltitude optional
टाइप:  number optional
Map3DElement.minAltitude देखें.
minHeading optional
टाइप:  number optional
Map3DElement.minHeading देखें.
minTilt optional
टाइप:  number optional
Map3DElement.minTilt देखें.
mode optional
टाइप:  MapMode optional
Map3DElement.mode देखें.
range optional
टाइप:  number optional
Map3DElement.range देखें.
roll optional
टाइप:  number optional
Map3DElement.roll देखें.
tilt optional
टाइप:  number optional
Map3DElement.tilt देखें.

MapMode कॉन्स्टेंट

google.maps.maps3d.MapMode कॉन्स्टेंट

यह तय करता है कि मैप किस मोड में रेंडर होना चाहिए.

const {MapMode} = await google.maps.importLibrary("maps3d") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.
HYBRID इस मैप मोड में, सैटलाइट या फ़ोटो जैसी दिखने वाली इमेज पर मुख्य सड़कों की पारदर्शी लेयर दिखती है.
SATELLITE इस मैप मोड में, सैटलाइट या फ़ोटोरियलिस्टिक इमेज दिखाई जाती हैं. हालांकि, ये इमेज सिर्फ़ उन जगहों के लिए उपलब्ध होती हैं जहां ये उपलब्ध हैं.

FlyAroundAnimationOptions इंटरफ़ेस

google.maps.maps3d.FlyAroundAnimationOptions इंटरफ़ेस

FlyCameraAround ऐनिमेशन को पसंद के मुताबिक बनाने के विकल्प.
camera
टाइप:  CameraOptions
वह सेंट्रल पॉइंट जिस पर ऑर्बिट ऐनिमेशन के दौरान कैमरे को देखना चाहिए. ध्यान दें कि कैमरे के इस सेंटर पॉइंट के चारों ओर घूमने पर, मैप की हेडिंग बदल जाएगी.
durationMillis optional
टाइप:  number optional
ऐनिमेशन की अवधि, मिलीसेकंड में. यह ऐनिमेशन की कुल अवधि होती है, न कि एक बार घूमने की अवधि.
rounds optional
टाइप:  number optional
दी गई अवधि में, सेंटर के चारों ओर घूमने के राउंड की संख्या. इससे रोटेशन की पूरी स्पीड कंट्रोल की जाती है. rounds में कोई नेगेटिव नंबर पास करने पर, कैमरा डिफ़ॉल्ट रूप से घड़ी की सुई की दिशा में घूमने के बजाय, घड़ी की सुई की उलटी दिशा में घूमेगा.

FlyToAnimationOptions इंटरफ़ेस

google.maps.maps3d.FlyToAnimationOptions इंटरफ़ेस

FlyCameraTo ऐनिमेशन को पसंद के मुताबिक बनाने के विकल्प.
endCamera
टाइप:  CameraOptions
वह जगह जहां ऐनिमेशन के आखिर में कैमरा पॉइंट करना चाहिए.
durationMillis optional
टाइप:  number optional
ऐनिमेशन की अवधि, मिलीसेकंड में. अवधि को 0 पर सेट करने से, कैमरा सीधे आखिरी पोज़िशन पर पहुंच जाएगा.

CameraOptions इंटरफ़ेस

google.maps.maps3d.CameraOptions इंटरफ़ेस

CameraOptions ऑब्जेक्ट का इस्तेमाल उन प्रॉपर्टी को तय करने के लिए किया जाता है जिन्हें कैमरा ऑब्जेक्ट पर सेट किया जा सकता है. कैमरा ऑब्जेक्ट, कैमरे की पोज़िशन वाली कोई भी चीज़ हो सकती है. जैसे, मैप की मौजूदा स्थिति या आने वाले समय में ऐनिमेशन की अनुरोध की गई स्थिति.
center optional
टाइप:  LatLngAltitude|LatLngAltitudeLiteral optional
Map3DElement.center देखें.
heading optional
टाइप:  number optional
Map3DElement.heading देखें.
range optional
टाइप:  number optional
Map3DElement.range देखें.
roll optional
टाइप:  number optional
Map3DElement.roll देखें.
tilt optional
टाइप:  number optional
Map3DElement.tilt देखें.

SteadyChangeEvent class

google.maps.maps3d.SteadyChangeEvent क्लास

इस इवेंट को Map3DElement की सामान्य स्थिति को मॉनिटर करके बनाया गया है. यह इवेंट, डीओएम ट्री के ज़रिए बब्ल अप होता है.

यह क्लास Event तक चलेगी.

const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.
isSteady
टाइप:  boolean
इससे पता चलता है कि Map3DElement स्थिर है या नहीं. इसका मतलब है कि मौजूदा सीन के लिए सभी रेंडरिंग पूरी हो गई है या नहीं.

LocationClickEvent class

google.maps.maps3d.LocationClickEvent क्लास

यह इवेंट, Map3DElement पर क्लिक करने से बनता है.

यह क्लास Event तक चलेगी.

const {LocationClickEvent} = await google.maps.importLibrary("maps3d") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.
position
टाइप:  LatLngAltitude optional
इवेंट के होने के समय, कर्सर के नीचे मौजूद अक्षांश/देशांतर/ऊंचाई. कृपया ध्यान दें कि कम सटीक लेवल पर, कम सटीक डेटा दिखेगा. इसके अलावा, ज़्यादा ऊंचाई से पानी की सतह पर क्लिक करने पर, ऊंचाई की वैल्यू के लिए समुद्र तल की ऊंचाई दिखाई जा सकती है. यह इवेंट, डीओएम ट्री के ज़रिए बब्ल अप होता है.

PlaceClickEvent क्लास

google.maps.maps3d.PlaceClickEvent क्लास

यह इवेंट, Map3DElement पर मौजूद किसी जगह के आइकॉन पर क्लिक करके बनाया गया है. डिफ़ॉल्ट पॉपओवर को दिखने से रोकने के लिए, इस इवेंट पर preventDefault() तरीके को कॉल करें, ताकि इसे Map3DElement से हैंडल न किया जा सके.

यह क्लास LocationClickEvent तक चलेगी.

const {PlaceClickEvent} = await google.maps.importLibrary("maps3d") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.
placeId
टाइप:  string
मैप की सुविधा का प्लेस आईडी.
इनहेरिट किया गया: position
fetchPlace
fetchPlace()
पैरामीटर:  कोई नहीं
लौटाई गई वैल्यू:  Promise<