WebGL

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)
पैरामीटर: 
  • optionsWebGLStateOptions जो डेवलपर को GL कॉन्टेक्स्ट को वापस लाने की अनुमति देते हैं.
रिटर्न वैल्यू:  कोई नहीं
इस तरीके को तब कॉल किया जाता है, जब रेंडरिंग कॉन्टेक्स्ट उपलब्ध हो जाता है. इसका इस्तेमाल, किसी भी WebGL स्थिति को शुरू करने या बाइंड करने के लिए करें. जैसे, शेडर या बफ़र ऑब्जेक्ट.
onDraw
onDraw(options)
पैरामीटर: 
  • optionsWebGLDrawOptions जो डेवलपर को, Google के जुड़े हुए बेस मैप पर कॉन्टेंट रेंडर करने की अनुमति देते हैं.
रिटर्न वैल्यू:  कोई नहीं
WebGL कॉन्टेंट को सीधे मैप पर दिखाने के लिए, इस तरीके का इस्तेमाल करें. ध्यान दें कि अगर ओवरले के लिए नया फ़्रेम बनाना है, तो WebGLOverlayView.requestRedraw को कॉल करें.
onRemove
onRemove()
पैरामीटर:  कोई नहीं
रिटर्न वैल्यू:  कोई नहीं
इस तरीके को तब कॉल किया जाता है, जब WebGLOverlayView.setMap(null) की मदद से मैप से ओवरले हटा दिया जाता है. आपको सभी इंटरमीडिएट ऑब्जेक्ट हटाने चाहिए. रेंडर करने के लिए, इस तरीके को लागू करना ज़रूरी है.
onStateUpdate
onStateUpdate(options)
पैरामीटर: 
  • optionsWebGLStateOptions जो डेवलपर को GL कॉन्टेक्स्ट को वापस लाने की अनुमति देते हैं.
रिटर्न वैल्यू:  कोई नहीं
इस तरीके को लागू करके, रेंडर ऐनिमेशन फ़्रेम के बाहर किसी भी GL स्टेट अपडेट को मैनेज किया जा सकता है.
requestRedraw
requestRedraw()
पैरामीटर:  कोई नहीं
रिटर्न वैल्यू:  कोई नहीं
इस फ़ंक्शन से, मैप को फ़्रेम फिर से ड्रॉ करने का ट्रिगर मिलता है.
requestStateUpdate
requestStateUpdate()
पैरामीटर:  कोई नहीं
रिटर्न वैल्यू:  कोई नहीं
यह कुकी, मैप को GL की स्थिति अपडेट करने के लिए ट्रिगर करती है.
setMap
setMap([map])
पैरामीटर: 
  • mapMap optional यह मैप, div, मॉडल, और व्यू स्टेट को ऐक्सेस करने के लिए होता है.
रिटर्न वैल्यू:  कोई नहीं
यह मैप में ओवरले जोड़ता है.
इनहेरिट किया गया: 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])
पैरामीटर: 
  • latLngAltitudeLatLngAltitude|LatLngAltitudeLiteral अक्षांश, देशांतर, और ऊंचाई.
  • rotationsFloat32Array optional यह एक ऐसा कलेक्शन होता है जिसमें XYZ कन्वेंशन में, डिग्री में ओयलर रोटेशन ऐंगल होता है.
  • scaleFloat32Array optional यह एक ऐसा ऐरे है जिसमें कार्डिनल ऐक्सिस पर लागू करने के लिए, XYZ स्केलर ऐरे होता है.
लौटाई गई वैल्यू:  Float64Array WebGL के साथ इस्तेमाल करने के लिए एमवीपी मैट्रिक्स.
getCameraParams
getCameraParams()
पैरामीटर:  कोई नहीं
रिटर्न वैल्यू:  CameraParams कैमरा पैरामीटर

CameraParams इंटरफ़ेस

google.maps.CameraParams इंटरफ़ेस

इस कुकी का इस्तेमाल, कैमरे के पैरामीटर को वापस पाने के लिए किया जाता है. जैसे, WebGLOverlayView के लिए इस्तेमाल किए गए GL कैमरे के पैरामीटर.

यह इंटरफ़ेस, CameraOptions को बढ़ाता है.

center
टाइप:  LatLng
heading
टाइप:  number
tilt
टाइप:  number
zoom
टाइप:  number