WebGL

WebGLOverlayView sınıfı

class google.maps.WebGLOverlayView extends MVCObject
library "maps"

WebGL yer paylaşımlı görünüm, Google Haritalar Platformu'nun vektör temel haritayı oluşturmak için kullandığı WebGL oluşturma bağlamına doğrudan erişim sağlar. Paylaşılan oluşturma bağlamının bu şekilde kullanılması, 3D bina geometrisiyle derinlik oklüzyonu ve 2D/3D içeriği temel harita oluşturma ile senkronize etme gibi avantajlar sağlar.

WebGL yer paylaşımlı görünüm sayesinde, doğrudan WebGL'yi veya Three.js ya da deck.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öntemine çağrıyı tetiklemek için geçerli bir Map nesnesiyle WebGLOverlayView.setMap yöntemini, onRemove() yöntemini tetiklemek için ise setMap(null) yöntemini çağırmanız gerekir. setMap() yöntemi, oluşturma sırasında veya daha sonra, yer paylaşımının kaldırıldıktan sonra yeniden gösterilmesi gerektiğinde çağrılabilir. Ardından, öğenin konumunu değiştirebilecek bir harita özelliği (ör. yakınlaştırma, merkez veya harita türü) her değiştiğinde onDraw() yöntemi çağrılır. WebGLOverlayView yalnızca MapOptions.mapId içeren bir vektör haritaya eklenebilir (RenderingType.VECTOR MapOptions.renderingType olarak ayarlanan ve MapOptions.mapId olarak Map.DEMO_MAP_ID kullanan haritalar dahil).

const {WebGLOverlayView} = await google.maps.importLibrary("maps");
WebGLOverlayView
WebGLOverlayView()
Parametreler: Yok
WebGLOverlayView oluşturur.
getMap
getMap()
Parametreler: Yok
Dönüş Değeri: Map|null|undefined
onAdd
onAdd()
Parametreler: Yok
Döndürülen değer: Yok
Yer paylaşımı çizilmeden önce WebGL oluşturma bağlamına anında erişim gerektirmeyen ara veri yapılarını getirmek veya oluşturmak için bu yöntemi uygulayın. Oluşturma için bu yöntemin uygulanması gerekir.
onContextLost
onContextLost()
Parametreler: Yok
Döndürülen değer: Yok
Bu yöntem, oluşturma bağlamı herhangi bir nedenle kaybolduğunda çağrılır. Artık ihtiyaç duyulmadığı için önceden mevcut olan tüm GL durumlarını temizlemeniz gereken yer burasıdır.
onContextRestored
onContextRestored(options)
Parametreler:
  • options: WebGLStateOptions, geliştiricilerin GL bağlamını geri yüklemesine olanak tanır.
Döndürülen değer: Yok
Bu yöntem, oluşturma bağlamı kullanılabilir olduğunda çağrılır. Gölgelendiriciler veya arabellek nesneleri gibi WebGL durumlarını ilk kullanıma hazırlamak ya da bağlamak için bu yöntemi kullanın.
onDraw
onDraw(options)
Parametreler:
  • options: WebGLDrawOptions, geliştiricilerin ilişkili bir Google temel haritasında içerik oluşturmasına olanak tanır.
Döndürülen değer: 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 çizmesi gerekiyorsa WebGLOverlayView.requestRedraw yöntemini çağırın.
onRemove
onRemove()
Parametreler: Yok
Döndürülen değer: 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 gereken yerdir. Oluşturma için bu yöntemin uygulanması gerekir.
onStateUpdate
onStateUpdate(options)
Parametreler:
  • Geliştiricilerin GL bağlamını geri yüklemesine olanak tanıyan options: WebGLStateOptions.
Döndürülen değer: Yok
Oluşturma animasyonu karesi dışındaki tüm GL durumu güncellemelerini işlemek için bu yöntemi uygulayın.
requestRedraw
requestRedraw()
Parametreler: Yok
Döndürülen değer: Yok
Haritayı bir kareyi yeniden çizmesi için tetikler.
requestStateUpdate
requestStateUpdate()
Parametreler: Yok
Döndürülen değer: Yok
Haritanın GL durumunu güncellemesini tetikler.
setMap
setMap([map])
Parametreler:
  • map: Map optional Div, model ve görünüm durumuna erişmek için kullanılan harita.
Döndürülen değer: Yok
Yer paylaşımını haritaya ekler.
Devralınan: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

WebGLDrawOptions arayüzü

arayüz google.maps.WebGLDrawOptions

Çizim seçenekleri.
gl
Bu WebGLOverlayView'un oluşturulacağı WebGLRenderingContext.
transformer
Kamera alanından enlem/boylam koordinatlarına matris dönüşümü.

WebGLStateOptions arayüzü

arayüz google.maps.WebGLStateOptions

GL eyalet seçenekleri.
gl
Bu WebGLOverlayView'un oluşturulacağı WebGLRenderingContext.

CoordinateTransformer arayüzü

arayüz google.maps.CoordinateTransformer

Bu arayüz, Google temel haritasının üzerinde WebGL sahneleri oluşturmak için kullanılacak matrisler oluşturmaya yönelik kolaylık yöntemleri sağlar.

Not: Bu nesneye yapılan bir referans, kapsayıcı WebGLOverlayView.onDraw çağrısının kapsamı dışında tutulmamalıdır.
fromLatLngAltitude
fromLatLngAltitude(latLngAltitude[, rotations, scale])
Parametreler:
Döndürülen değer: WebGL ile kullanılacak Float64Array MVP matrisi.
getCameraParams
getCameraParams()
Parametreler: Yok
Döndürülen değer: CameraParams kamera parametresi

CameraParams arayüzü

interface google.maps.CameraParams extends CameraOptions

WebGLOverlayView için kullanılan GL kameranın parametreleri gibi kamera parametrelerini almak için kullanılır.
center
Tür: LatLng
heading
Tür: number
tilt
Tür: number
zoom
Tür: number