WebGL

فئة WebGLOverlayView

google.maps.WebGLOverlayView class

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

من خلال عرض تراكب WebGL، يمكنك إضافة محتوى إلى خرائطك باستخدام WebGL مباشرةً أو باستخدام مكتبات الرسومات الشائعة مثل Three.js أو deck.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 (بما في ذلك الخرائط التي تم ضبطها على RenderingType.VECTOR MapOptions.renderingType واستخدام Map.DEMO_MAP_ID كMapOptions.mapId).

يمتدّ هذا الصف إلى MVCObject.

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

الشركة المصنِّعة
WebGLOverlayView	WebGLOverlayView() المَعلمات:  بدون لإنشاء WebGLOverlayView.

الطُرق
getMap	getMap() المَعلمات:  بدون القيمة المعروضة:  Map|null|undefined
onAdd	onAdd() المَعلمات:  بدون القيمة المعروضة:  لا شيء يمكنك تنفيذ هذه الطريقة لجلب أو إنشاء هياكل بيانات وسيطة قبل رسم التراكب التي لا تتطلّب الوصول الفوري إلى سياق عرض WebGL. يجب تنفيذ هذه الطريقة لعرض المحتوى.
onContextLost	onContextLost() المَعلمات:  بدون القيمة المعروضة:  لا شيء يتمّ استدعاء هذه الطريقة عند فقدان سياق العرض لأيّ سبب، ويجب فيها تنظيف أيّ حالة GL حالية، لأنّها لم تعُد مطلوبة.
onContextRestored	onContextRestored(options) المَعلمات:  options:  WebGLStateOptions التي تسمح للمطوّرين باستعادة سياق GL القيمة المعروضة:  لا شيء يتمّ استدعاء هذه الطريقة بعد توفّر سياق العرض. استخدِم هذه الطريقة لإعداد أي حالة WebGL أو ربطها، مثل shaders أو كائنات التخزين المؤقت.
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 صفيف يحتوي على زاوية دوران Euler بالدرجات، وفقًا لنظام 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