3D Maps

Map3DElement sınıfı

google.maps.maps3d.Map3DElement sınıf

Map3DElement, 3D harita görünümü için bir HTML arayüzüdür. 3D haritanın oluşturulmaya başlaması için mode ayarlanmalıdır.

Özel öğe:
<gmp-map-3d center="lat,lng,altitude" default-ui-hidden description="string" gesture-handling="auto" heading="number" internal-usage-attribution-ids="id1 id2" map-id="string" max-altitude="number" max-heading="number" max-tilt="number" min-altitude="number" min-heading="number" min-tilt="number" mode="hybrid" range="number" roll="number" tilt="number" default-ui-disabled></gmp-map-3d>

Bu sınıf, HTMLElement sınıfını genişletir.

Bu sınıf, Map3DElementOptions'yi uygular.

const {Map3DElement} = await google.maps.importLibrary("maps3d") numarasını arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.

Marka
Map3DElement	Map3DElement([options]) Parametreler:  options:  Map3DElementOptions optional

Özellikler
bounds	Tür:  LatLngBounds|LatLngBoundsLiteral optional Ayarlandığında, kameranın konumunu belirtilen enlem/boylam sınırları içinde kısıtlar. Sınırların dışındaki nesnelerin yine de oluşturulduğunu unutmayın. Sınırlar hem boylamı hem de enlemi kısıtlayabilir veya yalnızca enlemi ya da boylamı kısıtlayabilir. Yalnızca enlem sınırları için sırasıyla -180 ve 180 batı ve doğu boylamlarını kullanın. Yalnızca boylam sınırları için sırasıyla 90 ve -90 kuzey ve güney enlemlerini kullanın.
center	Tür:  LatLngAltitude|LatLngAltitudeLiteral optional Haritanın merkezi, LatLngAltitude olarak verilir. Burada rakım, yer seviyesinden metre cinsinden ölçülür. range alanı kameranın harita merkezine olan mesafesini etkilediğinden, bu konumun kameranın bulunduğu yer olması gerekmez. Ayarlanmazsa varsayılan olarak {lat: 0, lng: 0, altitude: 63170000} kullanılır. 63.170.000 metre, izin verilen maksimum rakımdır (Dünya yarıçapının 10 katı). HTML özelliği: <gmp-map-3d center="lat,lng,altitude"></gmp-map-3d>
defaultUIHidden	Tür:  boolean optional Varsayılan: false true olduğunda tüm varsayılan kullanıcı arayüzü düğmeleri gizlenir. HTML özelliği: <gmp-map-3d default-ui-hidden></gmp-map-3d>
description	Tür:  string optional Sağlanırsa haritaya, sağlanan değerle birlikte bir erişilebilirlik açıklaması (ör. ekran okuyucularla kullanım için) eklenir. HTML özelliği: <gmp-map-3d description="string"></gmp-map-3d>
gestureHandling	Tür:  GestureHandling optional Varsayılan: GestureHandling.GREEDY Ortak hareket işlemeyi kontrol eder. COOPERATIVE olarak ayarlandığında, haritayı kaydırmak için değiştirici tuşlar veya iki parmakla yapılan hareketler gerekir. GREEDY olarak ayarlandığında, harita öğesindeki kullanıcı etkinliklerinden ana sayfada kaydırma yapılamaz. AUTO olarak ayarlandığında hareket işleme, ana sayfanın kaydırılabilirliğine göre belirlenir. HTML özelliği: <gmp-map-3d gesture-handling="auto"></gmp-map-3d> <gmp-map-3d gesture-handling="cooperative"></gmp-map-3d> <gmp-map-3d gesture-handling="greedy"></gmp-map-3d>
heading	Tür:  number optional Haritanın derece cinsinden pusula yönü. Tam kuzey sıfırdır. Eğim olmadığında, herhangi bir yuvarlanma yön olarak yorumlanır. HTML özelliği: <gmp-map-3d heading="number"></gmp-map-3d>
internalUsageAttributionIds	Tür:  Iterable<string> optional Başlatıcıya bir kullanım ilişkilendirme kimliği ekler. Bu kimlik, Google'ın geliştiriciler için hangi kitaplıkların ve örneklerin (ör. işaretçi grupları kitaplığının kullanımı) yararlı olduğunu anlamasına yardımcı olur. Kullanım ilişkilendirme kimliğinin gönderilmesini devre dışı bırakmak için bu özelliği silebilirsiniz. Yalnızca benzersiz değerler gönderilir. Örneklendirmeden sonra bu değerde yapılan değişiklikler yoksayılabilir. HTML özelliği: <gmp-map-3d internal-usage-attribution-ids="id1 id2"></gmp-map-3d>
language	Tür:  string optional Temel haritanın dilinin oluşturulmaya çalışılacağı dil. Maps JavaScript API yüklenirken varsayılan olarak geliştirici tarafından istenen dil kullanılır.
mapId	Tür:  string optional Harita için bulut tabanlı harita stilini getirmek üzere kullanılacak harita kimliğini belirtir. Bu, harita başlatıldıktan sonra ayarlanmamalıdır. Bu nedenle, mapId'nin yalnızca başlatma sırasında ayarlanmasını sağlarız ve bu özelliği herkese açık kanallarda yayınlamayız. HTML özelliği: <gmp-map-3d map-id="string"></gmp-map-3d>
maxAltitude	Tür:  number optional Haritada gösterilecek maksimum yer üstü irtifa. Geçerli değer 0 ile 63170000 metre (Dünya yarıçapının 10 katı) arasındadır. HTML özelliği: <gmp-map-3d max-altitude="number"></gmp-map-3d>
maxHeading	Tür:  number optional Haritanın maksimum yön (döndürme) açısı. Geçerli değer 0 ile 360 derece arasındadır. minHeading ve maxHeading, baş hareketlerine izin verilecek <= 360 derecelik bir aralığı temsil eder. minHeading = 180 ve maxHeading = 90, [0, 90] ve [180, 360] başlıklarına izin verir. minHeading = 90 ve maxHeading = 180, [90, 180] yönünde ilerlemenize olanak tanır. HTML özelliği: <gmp-map-3d max-heading="number"></gmp-map-3d>
maxTilt	Tür:  number optional Haritanın maksimum geliş açısı. Geçerli değer 0 ile 90 derece arasındadır. HTML özelliği: <gmp-map-3d max-tilt="number"></gmp-map-3d>
minAltitude	Tür:  number optional Haritada gösterilecek minimum yer üstü irtifası. Geçerli değer 0 ile 63170000 metre (Dünya yarıçapının 10 katı) arasındadır. HTML özelliği: <gmp-map-3d min-altitude="number"></gmp-map-3d>
minHeading	Tür:  number optional Haritanın minimum yön (döndürme) açısı. Geçerli değer 0 ile 360 derece arasındadır. minHeading ve maxHeading, baş hareketlerine izin verilecek <= 360 derecelik bir aralığı temsil eder. minHeading = 180 ve maxHeading = 90, [0, 90] ve [180, 360] başlıklarına izin verir. minHeading = 90 ve maxHeading = 180, [90, 180] yönünde ilerlemenize olanak tanır. HTML özelliği: <gmp-map-3d min-heading="number"></gmp-map-3d>
minTilt	Tür:  number optional Haritanın minimum geliş açısı. Geçerli değer 0 ile 90 derece arasındadır. HTML özelliği: <gmp-map-3d min-tilt="number"></gmp-map-3d>
mode	Tür:  MapMode optional Haritanın oluşturulması gereken modu belirtir. Ayarlanmazsa harita oluşturulmaz. HTML özelliği: <gmp-map-3d mode="hybrid"></gmp-map-3d> <gmp-map-3d mode="satellite"></gmp-map-3d>
range	Tür:  number optional Kameranın haritanın merkezine olan uzaklığı (metre cinsinden). HTML özelliği: <gmp-map-3d range="number"></gmp-map-3d>
region	Tür:  string optional Temel haritanın ÖY'lerinin oluşturulmaya çalışılacağı bölge. Maps JavaScript API yüklenirken varsayılan olarak geliştirici tarafından istenen bölge kullanılır.
roll	Tür:  number optional Kameranın görüntü vektörü etrafındaki derece cinsinden dönüşü. Belirsizlikleri gidermek için eğim olmadığında tüm dönüşler yön olarak yorumlanır. HTML özelliği: <gmp-map-3d roll="number"></gmp-map-3d>
tilt	Tür:  number optional Kamera görünüm vektörünün derece cinsinden eğimi. Doğrudan dünyaya bakan bir görüntü vektörünün eğimi sıfır derece olur. Dünya'dan uzağı gösteren bir görüntüleme vektörünün eğimi 180 derece olur. HTML özelliği: <gmp-map-3d tilt="number"></gmp-map-3d>
defaultUIDisabled	Desteği sonlandırıldı: Lütfen bunun yerine Map3DElement.defaultUIHidden kullanın. Bu özellik, gelecekteki bir sürümde kaldırılacaktır. Tür:  boolean optional Varsayılan: false true olduğunda tüm varsayılan kullanıcı arayüzü düğmeleri devre dışı bırakılır. Klavye ve hareket kontrollerini devre dışı bırakmaz. HTML özelliği: <gmp-map-3d default-ui-disabled></gmp-map-3d>

Yöntemler
addEventListener	addEventListener(type, listener[, options]) Parametreler:  type:  string Dinlenecek etkinlik türünü temsil eden, büyük/küçük harfe duyarlı bir dize. listener:  EventListener|EventListenerObject Bildirim alan nesne. Bu, handleEvent yöntemini içeren bir işlev veya nesne olmalıdır. options:  boolean|AddEventListenerOptions optional Seçenekleri inceleyin. Özel etkinlikler yalnızca capture ve passive dillerini destekler. Dönüş Değeri:  void Belirtilen etkinlik hedefe her iletildiğinde çağrılacak bir işlev ayarlar. addEventListener bölümüne bakın.
flyCameraAround	flyCameraAround(options) Parametreler:  options:  FlyAroundAnimationOptions Döndürülen değer:  Yok Bu yöntem, kamerayı belirli bir süre boyunca belirli bir konumun etrafında döndürür. Animasyon, belirtilen sayıda (FlyAroundAnimationOptions.repeatCount) tekrarlanabilir. Kamera saat yönünde hareket eder. Animasyonlar yalnızca harita minimum düzeyde yüklendikten sonra başlayabildiğinden yöntem eşzamansızdır. Yöntem, animasyon başlatıldıktan sonra döndürülür. FlyAroundAnimationOptions.repeatCount sayısı sıfırsa döndürme gerçekleşmez ve animasyon başladıktan hemen sonra tamamlanır.
flyCameraTo	flyCameraTo(options) Parametreler:  options:  FlyToAnimationOptions Döndürülen değer:  Yok Bu yöntem, kamerayı belirli bir süre boyunca mevcut konumdan belirli bir bitiş konumuna parabolik olarak taşır. Animasyonlar yalnızca harita minimum düzeyde yüklendikten sonra başlayabildiğinden yöntem eşzamansızdır. Yöntem, animasyon başlatıldıktan sonra döndürülür.
removeEventListener	removeEventListener(type, listener[, options]) Parametreler:  type:  string Bir etkinlik işleyicinin kaldırılacağı etkinlik türünü belirten dize. listener:  EventListener|EventListenerObject Etkinlik hedefinden kaldırılacak etkinlik işleyicinin etkinlik işleyicisi. options:  boolean|EventListenerOptions optional Seçenekleri inceleyin. Dönüş Değeri:  void Daha önce addEventListener ile kaydedilmiş bir etkinlik işleyiciyi hedeften kaldırır. removeEventListener bölümüne bakın.
stopCameraAnimation	stopCameraAnimation() Parametreler:  Yok Döndürülen değer:  Yok Bu yöntem, çalışmakta olan tüm uçuş animasyonlarını durdurur. Kamera, animasyonun ortasında olduğu yerde kalır, bitiş noktasına hızlı geçiş yapmaz. Animasyonlar yalnızca harita minimum düzeyde yüklendikten sonra başlayabildiği veya durabildiği için yöntem eşzamansızdır. Animasyon durduğunda yöntem döndürülür.

Etkinlikler
gmp-animationend	function(animationEndEvent) Bağımsız değişkenler:  animationEndEvent:  Event Bu etkinlik, uçma animasyonu sona erdiğinde tetiklenir. Bu etkinlik, DOM ağacında yukarı doğru yayılır.
gmp-centerchange	function(centerChangeEvent) Bağımsız değişkenler:  centerChangeEvent:  Event Bu etkinlik, Map3DElement'in merkez özelliği değiştiğinde tetiklenir.
gmp-click	function(clickEvent) Bağımsız değişkenler:  clickEvent:  LocationClickEvent|PlaceClickEvent Bu etkinlik, Map3DElement öğesi tıklandığında tetiklenir.
gmp-error	function(mapInitializationErrorEvent) Bağımsız değişkenler:  mapInitializationErrorEvent:  Event Bu etkinlik, harita başlatılamadığında tetiklenir.
gmp-headingchange	function(headingChangeEvent) Bağımsız değişkenler:  headingChangeEvent:  Event Bu etkinlik, Map3DElement'in yön özelliği değiştiğinde tetiklenir.
gmp-map-id-error	function(mapIdErrorEvent) Bağımsız değişkenler:  mapIdErrorEvent:  Event Bu etkinlik, Map3DElement'in mapId özelliği geçersiz olduğunda tetiklenir.
gmp-rangechange	function(rangeChangeEvent) Bağımsız değişkenler:  rangeChangeEvent:  Event Bu etkinlik, Map3DElement'in menzil özelliği değiştiğinde tetiklenir.
gmp-rollchange	function(rollChangeEvent) Bağımsız değişkenler:  rollChangeEvent:  Event Bu etkinlik, Map3DElement'in roll özelliği değiştiğinde tetiklenir.
gmp-steadychange	function(steadyChangeEvent) Bağımsız değişkenler:  steadyChangeEvent:  SteadyChangeEvent Bu etkinlik, Map3DElement öğesinin sabit durumu değiştiğinde tetiklenir.
gmp-tiltchange	function(tiltChangeEvent) Bağımsız değişkenler:  tiltChangeEvent:  Event Bu etkinlik, Map3DElement'in eğim özelliği değiştiğinde tetiklenir.

Map3DElementOptions arayüzü

google.maps.maps3d.Map3DElementOptions arayüz

Map3DElement'te ayarlanabilecek özellikleri tanımlamak için kullanılan Map3DElementOptions nesnesi.

Özellikler
bounds optional	Tür:  LatLngBounds|LatLngBoundsLiteral optional Şu sayfaya göz atın: Map3DElement.bounds.
center optional	Tür:  LatLngAltitude|LatLngAltitudeLiteral optional Şu sayfaya göz atın: Map3DElement.center.
defaultUIDisabled optional	Desteği sonlandırıldı: Lütfen bunun yerine Map3DElement.defaultUIHidden kullanın. Bu özellik, gelecekteki bir sürümde kaldırılacaktır. Tür:  boolean optional Şu sayfaya göz atın: Map3DElement.defaultUIDisabled.
defaultUIHidden optional	Tür:  boolean optional Şu sayfaya göz atın: Map3DElement.defaultUIHidden.
description optional	Tür:  string optional Şu sayfaya göz atın: Map3DElement.description.
gestureHandling optional	Tür:  GestureHandling optional Şu sayfaya göz atın: Map3DElement.gestureHandling.
heading optional	Tür:  number optional Şu sayfaya göz atın: Map3DElement.heading.
internalUsageAttributionIds optional	Tür:  Iterable<string> optional Şu sayfaya göz atın: Map3DElement.internalUsageAttributionIds.
language optional	Tür:  string optional Şu sayfaya göz atın: Map3DElement.language.
mapId optional	Tür:  string optional Şu sayfaya göz atın: Map3DElement.mapId.
maxAltitude optional	Tür:  number optional Şu sayfaya göz atın: Map3DElement.maxAltitude.
maxHeading optional	Tür:  number optional Şu sayfaya göz atın: Map3DElement.maxHeading.
maxTilt optional	Tür:  number optional Şu sayfaya göz atın: Map3DElement.maxTilt.
minAltitude optional	Tür:  number optional Şu sayfaya göz atın: Map3DElement.minAltitude.
minHeading optional	Tür:  number optional Şu sayfaya göz atın: Map3DElement.minHeading.
minTilt optional	Tür:  number optional Şu sayfaya göz atın: Map3DElement.minTilt.
mode optional	Tür:  MapMode optional Şu sayfaya göz atın: Map3DElement.mode.
range optional	Tür:  number optional Şu sayfaya göz atın: Map3DElement.range.
region optional	Tür:  string optional Şu sayfaya göz atın: Map3DElement.region.
roll optional	Tür:  number optional Şu sayfaya göz atın: Map3DElement.roll.
tilt optional	Tür:  number optional Şu sayfaya göz atın: Map3DElement.tilt.

MapMode sabitleri

google.maps.maps3d.MapMode sabitler

Haritanın oluşturulması gereken modu belirtir.

const {MapMode} = await google.maps.importLibrary("maps3d") numarasını arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.

Sabitler
HYBRID	Bu harita modu, uydu veya fotogerçekçi görüntüler üzerinde ana caddelerin şeffaf bir katmanını gösterir.
SATELLITE	Bu harita modunda, varsa uydu veya foto-gerçekçi görüntüler gösterilir.

GestureHandling sabitleri

google.maps.maps3d.GestureHandling sabitler

Hareket etkinliklerinin harita öğesinde nasıl işleneceğini belirtir.

const {GestureHandling} = await google.maps.importLibrary("maps3d") numarasını arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.

Sabitler
AUTO	Bu, haritanın işbirliğine dayalı veya hırslı hareket işlemeyi kullanıp kullanmayacağını seçmesine olanak tanır. Belirtilmediği takdirde varsayılan davranış budur. Bu, haritanın kaydırma üst öğesine (genellikle ana sayfa) hakim olması ve kullanıcının haritadan diğer içeriklere kaydıramaması durumunda haritanın ortak çalışma moduna girmesine neden olur.
COOPERATIVE	Bu, haritayı kaydırmak için değiştirici tuşların veya iki parmakla yapılan hareketlerin gerekli olduğu ortak çalışma modunu zorunlu kılar.
GREEDY	Bu, harita öğesindeki kullanıcı etkinliklerinden ana sayfanın kaydırılamadığı açgözlü modu zorunlu kılar.

FlyAroundAnimationOptions arayüzü

google.maps.maps3d.FlyAroundAnimationOptions arayüz

FlyCameraAround animasyonu için özelleştirme seçenekleri.

Özellikler
camera	Tür:  CameraOptions Yörünge animasyonu sırasında kameranın bakması gereken merkez nokta. Kamera bu merkez noktanın etrafında dönerken harita yönünün değişeceğini unutmayın.
durationMillis optional	Tür:  number optional Milisaniye cinsinden bir animasyon döngüsünün süresi.
repeatCount optional	Tür:  number optional Bir animasyonun kaç kez tekrarlanacağını belirtir. Sayı sıfırsa animasyon başladıktan hemen sonra tamamlanır.
rounds optional	Desteği sonlandırıldı: Lütfen bunun yerine FlyAroundAnimationOptions.repeatCount kullanın. Tür:  number optional Belirtilen süre içinde merkezin etrafında dönülecek tur sayısı. Bu ayar, genel dönüş hızını kontrol eder. Turlara negatif bir sayı iletilmesi, kameranın varsayılan saat yönü yerine saat yönünün tersine dönmesine neden olur.

FlyToAnimationOptions arayüzü

google.maps.maps3d.FlyToAnimationOptions arayüz

FlyCameraTo animasyonu için özelleştirme seçenekleri.

Özellikler
endCamera	Tür:  CameraOptions Animasyonun sonunda kameranın yöneltilmesi gereken konum.
durationMillis optional	Tür:  number optional Animasyonun milisaniye cinsinden süresi. Süre 0 olarak ayarlanırsa kamera doğrudan son konuma geçer.

CameraOptions arayüzü

google.maps.maps3d.CameraOptions arayüz

Kamera nesnesinde ayarlanabilecek özellikleri tanımlamak için kullanılan CameraOptions nesnesi. Kamera nesnesi, kamera konumu olan herhangi bir şey olabilir (ör. mevcut bir harita durumu veya gelecekte istenen bir animasyon durumu).

Özellikler
center optional	Tür:  LatLngAltitude|LatLngAltitudeLiteral optional Şu sayfaya göz atın: Map3DElement.center.
heading optional	Tür:  number optional Şu sayfaya göz atın: Map3DElement.heading.
range optional	Tür:  number optional Şu sayfaya göz atın: Map3DElement.range.
roll optional	Tür:  number optional Şu sayfaya göz atın: Map3DElement.roll.
tilt optional	Tür:  number optional Şu sayfaya göz atın: Map3DElement.tilt.

SteadyChangeEvent sınıfı

google.maps.maps3d.SteadyChangeEvent sınıf

Bu etkinlik, Map3DElement sabit durumunun izlenmesiyle oluşturulur. Bu etkinlik, DOM ağacında yukarı doğru yayılır.

Bu sınıf, Event sınıfını genişletir.

const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d") numarasını arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.

Özellikler
isSteady	Tür:  boolean Map3DElement'in sabit olup olmadığını (yani mevcut sahne için tüm oluşturma işlemlerinin tamamlanıp tamamlanmadığını) gösterir.

LocationClickEvent sınıfı

google.maps.maps3d.LocationClickEvent sınıf

Bu etkinlik, bir Map3DElement tıklandığında oluşturulur.

Bu sınıf, Event sınıfını genişletir.

const {LocationClickEvent} = await google.maps.importLibrary("maps3d") numarasını arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.

Özellikler
position	Tür:  LatLngAltitude optional Etkinlik gerçekleştiğinde imlecin altında bulunan enlem/boylam/rakım. Daha kaba düzeylerde daha az doğru verilerin döndürüleceğini lütfen unutmayın. Ayrıca, daha yüksek kamera konumlarından su yüzeyini tıkladığınızda yükseklik değeri için deniz tabanı yüksekliği döndürülebilir. Bu etkinlik, DOM ağacında yukarı doğru yayılır.

PlaceClickEvent sınıfı

google.maps.maps3d.PlaceClickEvent sınıf

Bu etkinlik, Map3DElement üzerinde bir yer simgesinin tıklanmasıyla oluşturulur. Varsayılan popover'ın gösterilmesini önlemek için bu etkinlikte preventDefault() yöntemini çağırarak Map3DElement tarafından işlenmesini engelleyin.

Bu sınıf, LocationClickEvent sınıfını genişletir.

const {PlaceClickEvent} = await google.maps.importLibrary("maps3d") numarasını arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.

Özellikler
placeId	Tür:  string Harita özelliğinin yer kimliği.
Devralındı: position

Yöntemler
fetchPlace	fetchPlace() Parametreler:  Yok Dönüş Değeri:  Promise<Place> Bu yer kimliği için bir Place getirir. Elde edilen Place nesnesinde id özelliği doldurulur. Ek alanlar daha sonra normal Places API etkinleştirme ve faturalandırma koşullarına tabi olarak Place.fetchFields() üzerinden istenebilir. Place getirilirken hata oluşursa promise reddedilir.