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)
المَعلمات: 
  • 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

توفر هذه الواجهة طرقًا ملائمة لإنشاء مصفوفات لاستخدامها في عرض مشاهد 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