WebGL

WebGLOverlayView sınıfı

google.maps.WebGLOverlayView sınıf

WebGL Yer Paylaşımı Görünümü, Google Haritalar Platformu'nun vektör temel haritasını oluşturmak için kullandığı WebGL oluşturma bağlamına doğrudan erişim sağlar. Paylaşılan bir oluşturma bağlamının kullanılması, 3B bina geometrisiyle derinlik doluluğu ve 2D/3D içeriği temel harita oluşturma ile senkronize etme gibi avantajlar sağlar.

Web WebGL Yer Paylaşımı Görünümü sayesinde, doğrudan WebGL'yi veya Three.js ya da veranda.gl gibi popüler Grafik kitaplıklarını kullanarak haritalarınıza içerik ekleyebilirsiniz. Yer paylaşımını kullanmak için google.maps.WebGLOverlayView öğesini genişletebilir ve şu yaşam döngüsü kancalarının her biri için bir uygulama sağlayabilirsiniz: WebGLOverlayView.onAdd, WebGLOverlayView.onContextRestored, WebGLOverlayView.onDraw, WebGLOverlayView.onContextLost ve WebGLOverlayView.onRemove.

onAdd() yöntemini tetiklemek için WebGLOverlayView.setMap geçerli bir Map nesnesiyle, onRemove() yöntemini tetiklemek için setMap(null) ile çağırmanız gerekir. setMap() yöntemi, oluşturma sırasında veya kaldırma işleminden sonra yer paylaşımının yeniden gösterilmesi gereken herhangi bir zamanda çağrılabilir. Daha sonra, harita özelliği değiştiğinde öğenin konumunu değiştirebilecek yakınlaştırma, ortala veya harita türü gibi onDraw() yöntemi çağrılır. WebGLOverlayView yalnızca MapOptions.mapId içeren bir vektör haritasına eklenebilir.

Bu ders MVCObject tarihine kadar geçerlidir.

const {WebGLOverlayView} = await google.maps.importLibrary("maps") numaralı telefonu arayarak erişin. Maps JavaScript API'deki kitaplıklar konusuna bakın.

WebGLOverlayView
WebGLOverlayView()
Parametreler: Yok
WebGLOverlayView oluşturur.
getMap
getMap()
Parametreler: Yok
İade Değeri:  Map|null|undefined
onAdd
onAdd()
Parametreler: Yok
Return Değeri: Yok
Yer paylaşımı çizilmeden önce, WebGL oluşturma bağlamına hemen erişilmesini gerektirmeyen ara veri yapıları getirmek veya oluşturmak için bu yöntemi uygulayın. Bu yöntemin oluşturulması için uygulanması gerekir.
onContextLost
onContextLost()
Parametreler: Yok
Return Değeri: Yok
Bu yöntem, herhangi bir nedenle oluşturma bağlamı kaybolduğunda çağrılır ve artık gerekli olmadığı için önceden var olan GL durumunu temizlemeniz gerekir.
onContextRestored
onContextRestored(options)
Parametreler: 
  • options:  Geliştiricilerin GL bağlamını geri yüklemelerine olanak tanıyan WebGLStateOptions.
Return Değeri: Yok
Bu yöntem, oluşturma bağlamı kullanılabilir olduğunda çağrılır. Bu aracı gölgelendiriciler veya arabellek nesneleri gibi herhangi bir WebGL durumunu başlatmak veya bağlamak için kullanın.
onDraw
onDraw(options)
Parametreler: 
  • options:  Geliştiricilerin ilişkili bir Google temel haritasında içerik oluşturmasına olanak tanıyan WebGLDrawOptions.
Return Değeri: Yok
WebGL içeriğini doğrudan harita üzerinde çizmek için bu yöntemi uygulayın. Yer paylaşımının yeni bir kare çekmesi gerekiyorsa WebGLOverlayView.requestRedraw ifadesini çağırın.
onRemove
onRemove()
Parametreler: Yok
Return Değeri: Yok
Bu yöntem, yer paylaşımı WebGLOverlayView.setMap(null) ile haritadan kaldırıldığında çağrılır ve tüm ara nesneleri kaldırmanız gerekir. Bu yöntemin oluşturulması için uygulanması gerekir.
onStateUpdate
onStateUpdate(options)
Parametreler: 
  • options:  Geliştiricilerin GL bağlamını geri yüklemelerine olanak tanıyan WebGLStateOptions.
Return Değeri: Yok
Oluşturma animasyon çerçevesinin dışındaki GL durumu güncellemelerini işlemek için bu yöntemi uygulayın.
requestRedraw
requestRedraw()
Parametreler: Yok
Return Değeri: Yok
Haritayı bir çerçeveyi yeniden çizmesi için tetikler.
requestStateUpdate
requestStateUpdate()
Parametreler: Yok
Return Değeri: Yok
GL durumunu güncellemek için haritayı tetikler.
setMap
setMap([map])
Parametreler: 
  • mapMap optional Div, model ve görünüm durumuna erişim gösteren harita.
Return Değeri: Yok
Bindirmeyi haritaya ekler.
Devralınan: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

WebGLDrawOptions arayüzü

google.maps.WebGLDrawOptions arayüz

Çizim seçenekleri.

gl
WebGL WebGLView'un oluşturulacağı WebGLWebContext.
transformer
Kamera alanından boylam/boylam koordinatlarına geçiş yapan matris.

WebGLStateOptions arayüzü

google.maps.WebGLStateOptions arayüz

GL durumu seçenekleri.

gl
WebGL WebGLView'un oluşturulacağı WebGLWebContext.

Koordinatör arayüzü

google.maps.CoordinateTransformer arayüz

Bu arayüz, Google temel haritasının yanı sıra WebGL sahnelerini oluşturmak için kullanılacak matris oluşturma yöntemleri sunar.

Not: Bu nesneye referans, kapsayıcı WebGLOverlayView.onDraw çağrısının kapsamı dışında olmamalıdır.

fromLatLngAltitude
fromLatLngAltitude(latLngAltitude[, rotations, scale])
Parametreler: 
Dönüş Değeri: WebGL ile kullanılacak Float64Array MVP matrisi.
getCameraParams
getCameraParams()
Parametreler: Yok
Dönüş Değeri:  CameraParams kamera parametresi

KameraParams arayüzü

google.maps.CameraParams arayüz

WebGLOverlayView için kullanılan GL kamera gibi kamera parametrelerini almak amacıyla kullanılır.

Bu arayüz CameraOptions tarihine kadar geçerlidir.

center
Tür:  LatLng
heading
Tür:  number
tilt
Tür:  number
zoom
Tür:  number