فئة WebGLOverlayView
google.maps.WebGLOverlayView
الصف الدراسي
يوفر عرض تراكب WebGL وصولاً مباشرًا إلى نفس سياق عرض WebGL الذي يستخدمه نظام Google Maps Platform لعرض الخريطة الأساسية للمتّجه. ويوفر هذا الاستخدام لسياق العرض المشترك فوائد مثل انسداد العمق باستخدام هندسة المباني ثلاثية الأبعاد والقدرة على مزامنة المحتوى ثنائي الأبعاد/ثلاثي الأبعاد مع عرض الخريطة الأساسية.
باستخدام طريقة عرض "تراكب WebGL"، يمكنك إضافة محتوى إلى خرائطك باستخدام WebGL مباشرةً أو مكتبات الرسومات الرائجة، مثل Three.js أو السطح.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
.
يمتد هذا الصف
MVCObject
.
عند استخدام v=beta
، يمكن الوصول إليه من خلال الاتصال بـ const {WebGLOverlayView} = await google.map.importLibrary("maps")
. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
الشركة المصنِّعة | |
---|---|
WebGLOverlayView |
WebGLOverlayView() المعلّمات: بدون
لإنشاء WebGLOverlayView . |
الطُرق | |
---|---|
getMap |
getMap() المعلّمات: بدون
قيمة الإرجاع:
Map|null|undefined |
onAdd |
onAdd() المعلّمات: بدون
قيمة الإرجاع: بدون
يمكنك تطبيق هذه الطريقة لجلب أو إنشاء بنى متوسطة للبيانات قبل أن يتم رسم التراكب الذي لا يتطلب وصول فوري إلى سياق عرض WebGL. يجب تنفيذ هذه الطريقة ليتم عرضها. |
onContextLost |
onContextLost() المعلّمات: بدون
قيمة الإرجاع: بدون
يتم استدعاء هذه الطريقة عند فقد سياق العرض لأي سبب، وفي هذه الحالة يجب إزالة أية حالة GL موجودة مسبقًا، نظرًا لأنها لم تعد هناك حاجة إليها. |
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 The WebGLRenderingContext ليتم عرض WebGLتراكبView هذا. |
transformer |
النوع:
CoordinateTransformer تحويل المصفوفة من مساحة الكاميرا إلى إحداثيات خطوط الطول/العرض. |
WebGLStateOptions واجهة
واجهة
google.maps.WebGLStateOptions
خيارات حالة GL.
أماكن إقامة | |
---|---|
gl |
النوع:
WebGLRenderingContext The WebGLRenderingContext ليتم عرض WebGLتراكبView هذا. |
واجهة CoordinateTransformer
واجهة
google.maps.CoordinateTransformer
توفر هذه الواجهة طرقًا ملائمة لإنشاء مصفوفات لاستخدامها في عرض مشاهد WebGL فوق خريطة Google الأساسية.
ملاحظة: يجب ألا يتم وضع إشارة إلى هذا الكائن خارج نطاق استدعاء WebGLOverlayView.onDraw
الذي يتضمّنه.
الطُرق | |
---|---|
fromLatLngAltitude |
fromLatLngAltitude(latLngAltitude[, rotations, scale]) المعلّمات:
قيمة العرض:
Float64Array مصفوفة MVP للاستخدام مع WebGL. |
getCameraParams |
getCameraParams() المعلّمات: بدون
قيمة الإرجاع:
CameraParams معلمة كاميرا |
واجهة CameraParams
واجهة
google.maps.CameraParams
يتم استخدامه لاسترداد معلمات الكاميرا، مثل معلمة كاميرا GL المستخدمة في WebGLOverlayView
.
تمتد هذه الواجهة
CameraOptions
.
أماكن إقامة | |
---|---|
center |
النوع:
LatLng |
heading |
النوع:
number |
tilt |
النوع:
number |
zoom |
النوع:
number |