WebGL

فئة 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.

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

WebGLOverlayView
WebGLOverlayView()
المعلّمات: بدون
لإنشاء WebGLOverlayView.
getMap
getMap()
المعلّمات: بدون
قيمة الإرجاع:  Map|null|undefined
onAdd
onAdd()
المعلّمات: بدون
قيمة الإرجاع: بدون
يمكنك تطبيق هذه الطريقة لجلب أو إنشاء بنى متوسطة للبيانات قبل أن يتم رسم التراكب الذي لا يتطلب وصول فوري إلى سياق عرض WebGL. يجب تنفيذ هذه الطريقة ليتم عرضها.
onContextLost
onContextLost()
المعلّمات: بدون
قيمة الإرجاع: بدون
يتم استدعاء هذه الطريقة عند فقد سياق العرض لأي سبب، وفي هذه الحالة يجب إزالة أية حالة GL موجودة مسبقًا، نظرًا لأنها لم تعد هناك حاجة إليها.
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
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])
المعلّمات: 
  • latLngAltitudeLatLngAltitude|LatLngAltitudeLiteral خط العرض وخط الطول والارتفاع.
  • rotationsFloat32Array optional مصفوفة تحتوي على زاوية تدوير أويل بالدرجات، في معادلة XYZ.
  • scaleFloat32Array optional المصفوفة التي تحتوي على مصفوفة رقمية XYZ لتطبيقها على المحور الأساسي.
قيمة العرض:  Float64Array مصفوفة MVP للاستخدام مع WebGL.
getCameraParams
getCameraParams()
المعلّمات: بدون
قيمة الإرجاع:  CameraParams معلمة كاميرا

واجهة CameraParams

واجهة google.maps.CameraParams

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

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

center
النوع:  LatLng
heading
النوع:  number
tilt
النوع:  number
zoom
النوع:  number