WebGLOverlayView क्लास
google.maps.WebGLOverlayView
क्लास
WebGL ओवरले व्यू, उसी WebGL रेंडरिंग कॉन्टेक्स्ट को सीधे तौर पर ऐक्सेस करने की सुविधा देता है जिसका इस्तेमाल Google Maps Platform, वेक्टर बेस मैप को रेंडर करने के लिए करता है. शेयर किए गए रेंडरिंग कॉन्टेक्स्ट का इस्तेमाल करने से कई फ़ायदे मिलते हैं. जैसे, 3D बिल्डिंग की ज्यामिति के साथ डेप्थ ऑक्लूज़न और 2D/3D कॉन्टेंट को बेस मैप रेंडरिंग के साथ सिंक करने की सुविधा.
WebGL ओवरले व्यू की मदद से, WebGL का इस्तेमाल करके सीधे तौर पर अपने मैप में कॉन्टेंट जोड़ा जा सकता है. इसके अलावा, Three.js या deck.gl जैसी लोकप्रिय ग्राफ़िक्स लाइब्रेरी का इस्तेमाल करके भी कॉन्टेंट जोड़ा जा सकता है. ओवरले का इस्तेमाल करने के लिए, google.maps.WebGLOverlayView
को बढ़ाया जा सकता है. साथ ही, यहां दिए गए हर लाइफ़साइकल हुक के लिए, लागू करने की सुविधा दी जा सकती है: WebGLOverlayView.onAdd
, WebGLOverlayView.onContextRestored
, WebGLOverlayView.onDraw
, WebGLOverlayView.onContextLost
, और WebGLOverlayView.onRemove
. onAdd()
तरीके को कॉल करने के लिए, आपको मान्य Map
ऑब्जेक्ट के साथ WebGLOverlayView.setMap
को कॉल करना होगा. साथ ही, onRemove()
तरीके को ट्रिगर करने के लिए, आपको setMap(null)
को कॉल करना होगा. setMap()
तरीके को, कंस्ट्रक्शन के समय या बाद में किसी भी समय कॉल किया जा सकता है. ऐसा तब किया जाता है, जब ओवरले को हटाने के बाद फिर से दिखाना हो. इसके बाद, जब भी मैप की कोई ऐसी प्रॉपर्टी बदलेगी जिससे एलिमेंट की पोज़िशन बदल सकती है, तब onDraw()
तरीके को कॉल किया जाएगा. जैसे, ज़ूम, सेंटर या मैप टाइप. WebGLOverlayView को सिर्फ़ ऐसे वेक्टर मैप में जोड़ा जा सकता है जिसमें MapOptions.mapId
हो. इसमें RenderingType.VECTOR
MapOptions.renderingType
पर सेट किए गए मैप और MapOptions.mapId
के तौर पर Map.DEMO_MAP_ID
का इस्तेमाल करने वाले मैप शामिल हैं.
यह क्लास MVCObject
तक चलेगी.
const {WebGLOverlayView} = await google.maps.importLibrary("maps")
पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.
निर्माता | |
---|---|
WebGLOverlayView |
WebGLOverlayView() पैरामीटर: कोई नहीं
WebGLOverlayView बनाता है. |
तरीके | |
---|---|
getMap |
getMap() पैरामीटर: कोई नहीं
लौटाई गई वैल्यू:
Map|null|undefined |
onAdd |
onAdd() पैरामीटर: कोई नहीं
रिटर्न वैल्यू: कोई नहीं
इस तरीके को लागू करके, ऐसे इंटरमीडिएट डेटा स्ट्रक्चर को फ़ेच या बनाया जा सकता है जिन्हें WebGL रेंडरिंग कॉन्टेक्स्ट को तुरंत ऐक्सेस करने की ज़रूरत नहीं होती. ऐसा ओवरले बनाने से पहले किया जाता है. रेंडर करने के लिए, इस तरीके को लागू करना ज़रूरी है. |
onContextLost |
onContextLost() पैरामीटर: कोई नहीं
रिटर्न वैल्यू: कोई नहीं
इस तरीके को तब कॉल किया जाता है, जब किसी वजह से रेंडरिंग कॉन्टेक्स्ट बंद हो जाता है. आपको यहां पहले से मौजूद किसी भी जीएल स्टेट को हटा देना चाहिए, क्योंकि अब इसकी ज़रूरत नहीं है. |
onContextRestored |
onContextRestored(options) पैरामीटर:
रिटर्न वैल्यू: कोई नहीं
इस तरीके को तब कॉल किया जाता है, जब रेंडरिंग कॉन्टेक्स्ट उपलब्ध हो जाता है. इसका इस्तेमाल, किसी भी WebGL स्थिति को शुरू करने या बाइंड करने के लिए करें. जैसे, शेडर या बफ़र ऑब्जेक्ट. |
onDraw |
onDraw(options) पैरामीटर:
रिटर्न वैल्यू: कोई नहीं
WebGL कॉन्टेंट को सीधे मैप पर दिखाने के लिए, इस तरीके का इस्तेमाल करें. ध्यान दें कि अगर ओवरले के लिए नया फ़्रेम बनाना है, तो WebGLOverlayView.requestRedraw को कॉल करें. |
onRemove |
onRemove() पैरामीटर: कोई नहीं
रिटर्न वैल्यू: कोई नहीं
इस तरीके को तब कॉल किया जाता है, जब WebGLOverlayView.setMap(null) की मदद से मैप से ओवरले हटा दिया जाता है. आपको सभी इंटरमीडिएट ऑब्जेक्ट हटाने चाहिए. रेंडर करने के लिए, इस तरीके को लागू करना ज़रूरी है. |
onStateUpdate |
onStateUpdate(options) पैरामीटर:
रिटर्न वैल्यू: कोई नहीं
इस तरीके को लागू करके, रेंडर ऐनिमेशन फ़्रेम के बाहर किसी भी GL स्टेट अपडेट को मैनेज किया जा सकता है. |
requestRedraw |
requestRedraw() पैरामीटर: कोई नहीं
रिटर्न वैल्यू: कोई नहीं
इस फ़ंक्शन से, मैप को फ़्रेम फिर से ड्रॉ करने का ट्रिगर मिलता है. |
requestStateUpdate |
requestStateUpdate() पैरामीटर: कोई नहीं
रिटर्न वैल्यू: कोई नहीं
यह कुकी, मैप को GL की स्थिति अपडेट करने के लिए ट्रिगर करती है. |
setMap |
setMap([map]) पैरामीटर:
रिटर्न वैल्यू: कोई नहीं
यह मैप में ओवरले जोड़ता है. |
इनहेरिट किया गया:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
WebGLDrawOptions इंटरफ़ेस
google.maps.WebGLDrawOptions
इंटरफ़ेस
ड्रॉइंग के विकल्प.
प्रॉपर्टी | |
---|---|
gl |
टाइप:
WebGLRenderingContext WebGLRenderingContext, जिस पर इस WebGLOverlayView को रेंडर करना है. |
transformer |
टाइप:
CoordinateTransformer कैमरे के स्पेस से अक्षांश/देशांतर निर्देशांकों में मैट्रिक्स ट्रांसफ़ॉर्मेशन. |
WebGLStateOptions इंटरफ़ेस
google.maps.WebGLStateOptions
इंटरफ़ेस
GL के राज्य के विकल्प.
प्रॉपर्टी | |
---|---|
gl |
टाइप:
WebGLRenderingContext WebGLRenderingContext, जिस पर इस WebGLOverlayView को रेंडर करना है. |
CoordinateTransformer इंटरफ़ेस
google.maps.CoordinateTransformer
इंटरफ़ेस
यह इंटरफ़ेस, Google के बेस मैप के ऊपर WebGL सीन रेंडर करने के लिए, मैट्रिक्स जनरेट करने के आसान तरीके उपलब्ध कराता है.
ध्यान दें: इस ऑब्जेक्ट का रेफ़रंस, WebGLOverlayView.onDraw
कॉल के स्कोप से बाहर नहीं रखा जाना चाहिए.
तरीके | |
---|---|
fromLatLngAltitude |
fromLatLngAltitude(latLngAltitude[, rotations, scale]) पैरामीटर:
लौटाई गई वैल्यू:
Float64Array WebGL के साथ इस्तेमाल करने के लिए एमवीपी मैट्रिक्स. |
getCameraParams |
getCameraParams() पैरामीटर: कोई नहीं
रिटर्न वैल्यू:
CameraParams कैमरा पैरामीटर |
CameraParams इंटरफ़ेस
google.maps.CameraParams
इंटरफ़ेस
इस कुकी का इस्तेमाल, कैमरे के पैरामीटर को वापस पाने के लिए किया जाता है. जैसे, WebGLOverlayView
के लिए इस्तेमाल किए गए GL कैमरे के पैरामीटर.
यह इंटरफ़ेस, CameraOptions
को बढ़ाता है.
प्रॉपर्टी | |
---|---|
center |
टाइप:
LatLng |
heading |
टाइप:
number |
tilt |
टाइप:
number |
zoom |
टाइप:
number |