WebGL

המחלקה WebGLOverlayView

google.maps.WebGLOverlayView סיווג

תצוגת שכבת-העל של WebGL מספקת גישה ישירה לאותו הקשר לעיבוד WebGL שבו משתמשת הפלטפורמה של מפות Google כדי לעבד את המפה הבסיסית הווקטורית. השימוש בהקשר משותף של עיבוד מספק יתרונות כמו הסתרה בעומק באמצעות גיאומטריה של בניינים בתלת ממד, ויכולת לסנכרן תוכן דו-ממדי/תלת-ממדי עם עיבוד מפה בסיסית.

תצוגת שכבת-העל של WebGL תאפשר לך להוסיף תוכן למפות שלך ישירות באמצעות WebGL או באמצעות ספריות גרפיקה פופולריות כמו Three.js או deck.gl. כדי להשתמש בשכבת-העל, אפשר להרחיב google.maps.WebGLOverlayView ולספק הטמעה לכל אחד מהחלקים הבאים של מחזור החיים: WebGLOverlayView.onAdd, WebGLOverlayView.onContextRestored, WebGLOverlayView.onDraw, WebGLOverlayView.onContextLost ו-WebGLOverlayView.onRemove.

צריך לקרוא ל-WebGLOverlayView.setMap אובייקט Map חוקי כדי להפעיל את הקריאה ל-method onAdd() ול-setMap(null) כדי להפעיל את השיטה onRemove(). אפשר להפעיל את השיטה setMap() במהלך הבנייה או בכל שלב לאחר מכן, כדי להציג מחדש את שכבת-העל לאחר ההסרה. לאחר מכן, השיטה onDraw() תופעל בכל פעם שמאפיין מפה משתנה שעשוי לשנות את מיקום הרכיב, כמו זום, מרכז או סוג המפה. ניתן להוסיף את WebGLOverlayView רק למפה וקטורית שיש בה 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, כגון תוכנות הצללה (shader) או אובייקטי מאגר נתונים זמני.
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 שבו יש לעבד את ה-WebGLOverlayView הזה.
transformer
טרנספורמציה של המטריצה ממרחב המצלמה לקואורדינטות של קווי אורך/רוחב.

ממשק WebGLStateOptions

ממשק google.maps.WebGLStateOptions

אפשרויות מצב GL.

gl
ה-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