WebGL

فئة WebGLOverlayView

صف واحد (google.maps.WebGLOverlayView)

توفر طريقة عرض تراكب WebGL الدخول المباشر إلى نفس سياق عرض WebGL الذي تستخدمه منصة خرائط Google لعرض الخريطة الأساسية للمتجهات. ويوفّر استخدام سياق العرض المشترَك هذا مزايا مثل التظليل في العمق مع هندسة المباني الثلاثية الأبعاد وإمكانية مزامنة المحتوى الثنائي الأبعاد والثلاثي الأبعاد مع عرض الخريطة الأساسية.

باستخدام طريقة عرض تراكب WebGL، يمكنك إضافة محتوى إلى خرائطك باستخدام WebGL مباشرةً، أو باستخدام مكتبات الرسومات الشائعة مثل Three.js أو schedule.gl. لاستخدام التراكب، يمكنك تمديد google.maps.WebGLOverlayView وتوفير عملية تنفيذ لكل من عناصر الجذب التالية في مراحل النشاط: WebGLOverlayView.onAdd وWebGLOverlayView.onContextRestored وWebGLOverlayView.onDraw وWebGLOverlayView.onContextLost وWebGLOverlayView.onRemove.

يجب استدعاء WebGLOverlayView.setMap باستخدام كائن Map صالح للاستجابة إلى طريقة onAdd() وsetMap(null) لتشغيل طريقة onRemove(). يمكن استدعاء طريقة setMap() في وقت الإنشاء أو في أي وقت بعد ذلك عندما يجب إعادة عرض التراكب بعد إزالته. وبعد ذلك، سيتم استدعاء طريقة onDraw() كلما تغيّرت خاصية الخريطة، ما قد يؤدي إلى تغيير موضع العنصر، مثل التكبير أو التصغير أو المركز أو نوع الخريطة. لا يمكن إضافة WebGLOverlayView إلا إلى خريطة متّجه بها MapOptions.mapId (بما في ذلك الخرائط التي تم ضبطها على MapOptions.renderingType RenderingType.VECTOR واستخدام Map.DEMO_MAP_ID باعتباره MapOptions.mapId).

تمتد هذه الفئة إلى MVCObject.

يمكنك الوصول من خلال الاتصال على الرقم const {WebGLOverlayView} = await google.maps.importLibrary("maps"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.

الشركة المصنِّعة
WebGLOverlayView	WebGLOverlayView() المَعلمات: لا شيء تنشئ WebGLOverlayView.

الطُرق
getMap	getMap() المَعلمات: لا شيء قيمة الإرجاع:  Map|null|undefined
onAdd	onAdd() المَعلمات: لا شيء قيمة الإرجاع: لا شيء يمكنك تنفيذ هذه الطريقة لجلب أو إنشاء بُنى بيانات وسيطة قبل رسم التراكب والتي لا تتطلب الدخول الفوري إلى سياق عرض WebGL. يجب تطبيق هذه الطريقة للعرض.
onContextLost	onContextLost() المَعلمات: لا شيء قيمة الإرجاع: لا شيء يتم استدعاء هذه الطريقة عند فقدان سياق العرض لأي سبب، وهي المكان الذي يجب عليك فيه إزالة أي حالة GL موجودة مسبقًا، لأنها لم تعد مطلوبة.
onContextRestored	onContextRestored(options) المَعلمات:  options:  WebGLStateOptions التي تسمح للمطوّرين باستعادة سياق GL. قيمة الإرجاع: لا شيء ويتم استدعاء هذه الطريقة بعد توفّر سياق العرض. ويمكنك استخدامها لتهيئة أي حالة WebGL أو اربطها، مثل أدوات التظليل أو الكائنات العازلة.
onDraw	onDraw(options) المَعلمات:  options:  WebGLDrawOptions التي تسمح للمطوّرين بعرض المحتوى على خريطة أساسية مرتبطة على Google قيمة الإرجاع: لا شيء يمكنك تنفيذ هذه الطريقة لرسم محتوى WebGL مباشرةً على الخريطة. لاحظ أنه إذا كان التراكب يحتاج إلى رسم إطار جديد، فعليك الاتصال بـ WebGLOverlayView.requestRedraw.
onRemove	onRemove() المَعلمات: لا شيء قيمة الإرجاع: لا شيء يتم استدعاء هذه الطريقة عند إزالة التراكب من الخريطة باستخدام WebGLOverlayView.setMap(null)، حيث يجب إزالة جميع العناصر الوسيطة. يجب تطبيق هذه الطريقة للعرض.
onStateUpdate	onStateUpdate(options) المَعلمات:  options:  WebGLStateOptions التي تسمح للمطوّرين باستعادة سياق GL قيمة الإرجاع: لا شيء نفذ هذه الطريقة للتعامل مع أي تحديثات لحالة GL خارج إطار العرض المتحرك.
requestRedraw	requestRedraw() المَعلمات: لا شيء قيمة الإرجاع: لا شيء يؤدي هذا الإجراء إلى تشغيل الخريطة لإعادة رسم الإطار.
requestStateUpdate	requestStateUpdate() المَعلمات: لا شيء قيمة الإرجاع: لا شيء يؤدي إلى تشغيل الخريطة لتعديل حالة GL.
setMap	setMap([map]) المَعلمات:  map:  Map 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

توفر هذه الواجهة طرقًا ملائمة لإنشاء مصفوفات لاستخدامها في عرض مشاهد WebGL أعلى خريطة Google الأساسية.

ملاحظة: لا يتم الاحتفاظ بالإشارة إلى هذا الكائن خارج نطاق طلب WebGLOverlayView.onDraw الذي يتضمّن تغليفًا.

الطُرق
fromLatLngAltitude	fromLatLngAltitude(latLngAltitude[, rotations, scale]) المَعلمات:  latLngAltitude:  LatLngAltitude|LatLngAltitudeLiteral خط العرض وخط الطول والارتفاع rotations:  Float32Array optional مصفوفة تحتوي على زاوية دوران أويلر بالدرجات، وفقًا للاصطلاح XYZ. scale:  Float32Array optional مصفوفة تتضمّن مصفوفة عددية XYZ لتطبيقها على المحور الأساسي. قيمة العرض:  Float64Array مصفوفة MVP (منتج الحد الأدنى القابل للتطبيق) لاستخدامها مع WebGL.
getCameraParams	getCameraParams() المَعلمات: لا شيء قيمة الإرجاع: مَعلمة الكاميرا CameraParams

واجهة CameraParams

واجهة google.maps.CameraParams

يُستخدَم لاسترداد معلَمات الكاميرا، مثل كاميرا GL المستخدمة في WebGLOverlayView.

تمد هذه الواجهة CameraOptions.

أماكن إقامة
center	النوع:  LatLng
heading	النوع:  number
tilt	النوع:  number
zoom	النوع:  number