Maps

MapElement class

google.maps.MapElement sınıf

MapElement, HTMLElement harita oluşturma için bir alt sınıftır. maps kitaplığı yüklendikten sonra HTML'de harita oluşturulabilir. Örneğin:

<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID">
  <button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>

Dahili olarak Map kullanılır. Bu öğeye MapElement.innerMap özelliğiyle erişilebilir.

Özel öğe:
<gmp-map center="lat,lng" heading-interaction-disabled internal-usage-attribution-ids="id1 id2" map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>

Bu sınıfın süresi HTMLElement tarihinde sona eriyor.

Bu sınıf MapElementOptions öğesini uygular.

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

MapElement
MapElement([options])
Parametreler: 
center
Tür:  LatLng|LatLngLiteral optional
Haritanın merkez enlemi/boylamı.
HTML özelliği:
  • <gmp-map center="lat,lng"></gmp-map>
headingInteractionDisabled
Tür:  boolean optional
Varsayılan: false
Haritanın, kullanıcının kamera yönünü (dönüş) kontrol etmesine izin verip vermeyeceği. Bu seçenek yalnızca harita bir vektör harita olduğunda geçerlidir. Kodda ayarlanmamışsa harita kimliği için bulut yapılandırması kullanılır (varsa).
HTML özelliği:
  • <gmp-map heading-interaction-disabled></gmp-map>
innerMap
Tür:  Map
MapElement'in dahili olarak kullandığı Map öğesine yapılan referans.
internalUsageAttributionIds
Tür:  Iterable<string> optional
Varsayılan: null
Başlatıcıya bir kullanım ilişkilendirme kimliği ekler. Bu kimlik, Google'ın hangi kitaplıkların ve örneklerin geliştiriciler için faydalı olduğunu anlamasına yardımcı olur (ör. işaretçi kümeleme kitaplığının kullanımı). Kullanım ilişkilendirme kimliğini göndermeyi devre dışı bırakmak için bu özelliği silebilir veya değeri boş bir dizeyle değiştirebilirsiniz. Yalnızca benzersiz değerler gönderilir. Bu değerde örnek oluşturulduktan sonra yapılan değişiklikler yoksayılabilir.
HTML özelliği:
  • <gmp-map internal-usage-attribution-ids="id1 id2"></gmp-map>
mapId
Tür:  string optional
Haritanın harita kimliği. Bu parametre, bir harita örneği oluşturulduktan sonra ayarlanamaz veya değiştirilemez. Map.DEMO_MAP_ID, harita kimliği gerektiren ancak bulut etkinleştirme gerektirmeyen özellikleri denemek için kullanılabilir.
HTML özelliği:
  • <gmp-map map-id="string"></gmp-map>
renderingType
Tür:  RenderingType optional
Haritanın raster veya vektör harita olup olmayacağı. Bu parametre, bir harita örneği oluşturulduktan sonra ayarlanamaz veya değiştirilemez. Ayarlanmazsa harita kimliğinin bulut yapılandırması, oluşturma türünü (varsa) belirler. Vektör haritaların tüm cihazlarda ve tarayıcılarda kullanılamayabileceğini, haritanın gerektiğinde raster haritaya geri döneceğini lütfen unutmayın.
HTML özelliği:
  • <gmp-map rendering-type="vector"></gmp-map>
  • <gmp-map rendering-type="raster"></gmp-map>
tiltInteractionDisabled
Tür:  boolean optional
Varsayılan: false
Haritanın, kullanıcının kamera eğimini kontrol etmesine izin verip vermeyeceği. Bu seçenek yalnızca harita bir vektör harita olduğunda geçerlidir. Kodda ayarlanmamışsa harita kimliği için bulut yapılandırması kullanılır (varsa).
HTML özelliği:
  • <gmp-map tilt-interaction-disabled></gmp-map>
zoom
Tür:  number optional
Haritanın yakınlaştırma düzeyi. Geçerli yakınlaştırma değerleri, sıfırdan desteklenen maksimum yakınlaştırma düzeyine kadar olan sayılardır. Daha büyük yakınlaştırma değerleri daha yüksek çözünürlüğe karşılık gelir.
HTML özelliği:
  • <gmp-map zoom="number"></gmp-map>
control-block-end-inline-center
Yuvalı öğeyi ControlPosition.BLOCK_END_INLINE_CENTER konumuna yerleştirir.
control-block-end-inline-end
Yuvalı öğeyi ControlPosition.BLOCK_END_INLINE_END konumuna yerleştirir.
control-block-end-inline-start
Yuvalı öğeyi ControlPosition.BLOCK_END_INLINE_START konumuna yerleştirir.
control-block-start-inline-center
Yuvalı öğeyi ControlPosition.BLOCK_START_INLINE_CENTER konumuna yerleştirir.
control-block-start-inline-end
Yuvalı öğeyi ControlPosition.BLOCK_START_INLINE_END konumuna yerleştirir.
control-block-start-inline-start
Yuvalı öğeyi ControlPosition.BLOCK_START_INLINE_START konumuna yerleştirir.
control-inline-end-block-center
Yuvalı öğeyi ControlPosition.INLINE_END_BLOCK_CENTER konumuna yerleştirir.
control-inline-end-block-end
Yuvalı öğeyi ControlPosition.INLINE_END_BLOCK_END konumuna yerleştirir.
control-inline-end-block-start
Yuvalı öğeyi ControlPosition.INLINE_END_BLOCK_START konumuna yerleştirir.
control-inline-start-block-center
Yuvalı öğeyi ControlPosition.INLINE_START_BLOCK_CENTER konumuna yerleştirir.
control-inline-start-block-end
Yuvalı öğeyi ControlPosition.INLINE_START_BLOCK_END konumuna yerleştirir.
control-inline-start-block-start
Yuvalı öğeyi ControlPosition.INLINE_START_BLOCK_START konumuna yerleştirir.
default
Özel öğeler kullanarak Maps JavaScript Web Components (ör. AdvancedMarkerElement) etrafında yeniden kullanılabilir bileşenler oluşturabilirsiniz. Doğrudan MapElement öğesine eklenen tüm özel öğeler varsayılan olarak MapPanes.overlayMouseTarget öğesine yerleştirilir ve bu öğede oluşturulur. Ancak Maps JavaScript API Web Components, MapElement'nın dahili yuvalarına yeniden yerleştirilebilir.
addEventListener
addEventListener(type, listener[, options])
Parametreler: 
  • typestring Dinlenecek etkinlik türünü temsil eden, büyük/küçük harfe duyarlı bir dize.
  • listenerEventListener|EventListenerObject Bildirim alan nesne. Bu, handleEvent yöntemine sahip bir işlev veya nesne olmalıdır.
  • optionsboolean|AddEventListenerOptions optional Seçeneklere bakın. Özel etkinlikler yalnızca capture ve passive'yi destekler.
İade Değeri:  void
Belirtilen etkinlik hedefe her teslim edildiğinde çağrılacak bir işlev ayarlar. addEventListener bölümünü inceleyin.
removeEventListener
removeEventListener(type, listener[, options])
Parametreler: 
İade Değeri:  void
Daha önce addEventListener ile kaydedilmiş bir etkinlik işleyiciyi hedeften kaldırır. removeEventListener başlıklı makaleyi inceleyin.
gmp-zoomchange
function(event)
Bağımsız değişkenler: 
Bu etkinlik, harita yakınlaştırma özelliği değiştiğinde tetiklenir.

MapElementOptions arayüzü

google.maps.MapElementOptions arayüz

MapElement üzerinde ayarlanabilecek özellikleri tanımlamak için kullanılan MapElementOptions nesnesi.

center optional
Tür:  LatLng|LatLngLiteral optional
Şu sayfaya göz atın: MapElement.center.
headingInteractionDisabled optional
Tür:  boolean optional
Şu sayfaya göz atın: MapElement.headingInteractionDisabled.
internalUsageAttributionIds optional
Tür:  Iterable<string> optional
mapId optional
Tür:  string optional
Şu sayfaya göz atın: MapElement.mapId.
renderingType optional
Tür:  RenderingType optional
Şu sayfaya göz atın: MapElement.renderingType.
tiltInteractionDisabled optional
Tür:  boolean optional
Şu sayfaya göz atın: MapElement.tiltInteractionDisabled.
zoom optional
Tür:  number optional
Şu sayfaya göz atın: MapElement.zoom.

ZoomChangeEvent class

google.maps.ZoomChangeEvent sınıf

Bu etkinlik, yakınlaştırma değişikliğinin izlenmesiyle oluşturulur.

Bu sınıfın süresi Event tarihinde sona eriyor.

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

Harita sınıfı

google.maps.Map sınıf

Bu sınıfın süresi MVCObject tarihinde sona eriyor.

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

Map
Map(mapDiv[, opts])
Parametreler: 
  • mapDivHTMLElement Harita, bu öğeyi dolduracak şekilde oluşturulur.
  • optsMapOptions optional Seçenekler
Belirtilen HTML kapsayıcısında (genellikle bir DIV öğesi) yeni bir harita oluşturur.
DEMO_MAP_ID Harita kimliği gerektiren kod örneklerinde kullanılabilen harita kimliği. Bu harita kimliği, üretim uygulamalarında kullanılmak üzere tasarlanmamıştır ve bulut yapılandırması gerektiren özellikler (ör. Cloud Styling) için kullanılamaz.
controls
Haritaya eklenecek ek kontroller. Haritaya kontrol eklemek için kontrolün <div> öğesini, oluşturulması gereken ControlPosition öğesine karşılık gelen MVCArray öğesine ekleyin.
data
Tür:  Data
Haritaya bağlı bir Data örneği. Bu Data nesnesine özellikler ekleyerek bu haritada kolayca görüntüleyebilirsiniz.
mapTypes
Dize kimliğine göre MapType örneklerinin kayıt defteri.
overlayMapTypes
Tür:  MVCArray<MapType optional>
Yerleştirilecek ek harita türleri. Yer paylaşımı harita türleri, bağlı oldukları temel haritanın üzerinde, overlayMapTypes dizisinde göründükleri sırayla gösterilir (daha yüksek dizin değerlerine sahip yer paylaşımları, daha düşük dizin değerlerine sahip yer paylaşımlarının önünde gösterilir).
fitBounds
fitBounds(bounds[, padding])
Parametreler: 
  • boundsLatLngBounds|LatLngBoundsLiteral Gösterilecek sınırlar.
  • paddingnumber|Padding optional Piksel cinsinden dolgu. Sınırlar, dolgu kaldırıldıktan sonra haritanın kalan kısmına sığdırılır. Sayı değeri, 4 tarafın tamamında aynı dolguyu oluşturur. getBounds sonucunda fitBounds'un idempotent olmasını sağlamak için buraya 0 değerini girin.
Döndürülen Değer: Yok
Görüntü alanını, belirtilen sınırları içerecek şekilde ayarlar.
Not: Harita display: none olarak ayarlandığında fitBounds işlevi, haritanın boyutunu 0x0 olarak okur ve bu nedenle herhangi bir işlem yapmaz. Harita gizliyken görüntü alanını değiştirmek için haritayı visibility: hidden olarak ayarlayın. Böylece, harita div'inin gerçek bir boyuta sahip olmasını sağlayabilirsiniz. Vektör haritalarda bu yöntem, haritanın eğimini ve yönünü varsayılan sıfır değerlerine ayarlar. Bu yöntemin çağrılması, harita sınırları sığacak şekilde kaydırılıp yakınlaştırılırken sorunsuz bir animasyona neden olabilir. Bu yöntemin animasyon oluşturup oluşturmayacağı, dahili bir sezgisel yönteme bağlıdır.
getBounds
getBounds()
Parametreler: Yok
Döndürülen Değer:  LatLngBounds|undefined Geçerli görüntü alanının enlem/boylam sınırları.
Geçerli görüntü alanının enlem/boylam sınırlarını döndürür. Dünyanın birden fazla kopyası görünüyorsa sınırlar, boylamda -180 ila 180 derece arasında (bu değerler dahil) değişir. Harita henüz başlatılmamışsa veya merkez ve yakınlaştırma ayarlanmamışsa sonuç undefined olur. Eğimi veya başlığı sıfırdan farklı olan vektör haritalar için döndürülen enlem/boylam sınırları, haritanın görünüm alanının görünür bölgesini içeren en küçük sınırlayıcı kutuyu temsil eder. Haritanın görünür alanının tam olarak hangi bölgeyi kapsadığını öğrenmek için MapCanvasProjection.getVisibleRegion bölümüne bakın.
getCenter
getCenter()
Parametreler: Yok
İade Değeri:  LatLng|undefined
Haritanın merkezinde gösterilen konumu döndürür. Bu LatLng nesnenin sarmalanmadığını unutmayın. Daha fazla bilgi için LatLng belgesine göz atın. Merkez veya sınırlar ayarlanmamışsa sonuç undefined olur.
getClickableIcons
getClickableIcons()
Parametreler: Yok
İade Değeri:  boolean|undefined
Harita simgelerinin tıklanabilirliğini döndürür. Harita simgesi, ÖY olarak da bilinen bir önemli yeri temsil eder. Döndürülen değer true ise haritadaki simgeler tıklanabilir.
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
Parametreler: 
  • datasetIdstring
İade Değeri:  FeatureLayer
Belirtilen datasetId için FeatureLayer değerini döndürür. Veri kümesi kimlikleri Google Cloud Console'da yapılandırılmalıdır. Veri kümesi kimliği haritanın harita stiliyle ilişkilendirilmemişse veya veriye dayalı stil özelliği kullanılamıyorsa (harita kimliği yok, vektör döşemeler yok, harita stilinde yapılandırılmış veriye dayalı stil özellik katmanları veya veri kümeleri yoksa) bu durumda bir hata kaydedilir ve sonuçta elde edilen FeatureLayer.isAvailable değeri yanlış olur.
getDiv
getDiv()
Parametreler: Yok
Dönüş Değeri:  HTMLElement Haritanın mapDiv'i.
getFeatureLayer
getFeatureLayer(featureType)
Parametreler: 
İade Değeri:  FeatureLayer
Belirli bir FeatureType değerinin FeatureLayer değerini döndürür. Google Cloud Console'da FeatureLayer etkinleştirilmelidir. Belirtilen FeatureType öğesinin FeatureLayer bu haritada yoksa veya veriye dayalı stil oluşturma kullanılamıyorsa (harita kimliği yok, vektör döşemeler yok ve harita stilinde FeatureLayer etkin değilse) bu bir hatayı günlüğe kaydeder ve sonuçtaki FeatureLayer.isAvailable yanlış olur.
getHeading
getHeading()
Parametreler: Yok
İade Değeri:  number|undefined
Haritanın pusula istikametini döndürür. Başlık değeri, ana yön olan Kuzey'den itibaren derece cinsinden (saat yönünde) ölçülür. Harita henüz başlatılmamışsa sonuç undefined olur.
getHeadingInteractionEnabled
getHeadingInteractionEnabled()
Parametreler: Yok
İade Değeri:  boolean|null
Başlık etkileşimlerinin etkin olup olmadığını döndürür. Bu seçenek yalnızca harita bir vektör harita olduğunda geçerlidir. Kodda ayarlanmamışsa harita kimliği için bulut yapılandırması kullanılır (varsa).
getInternalUsageAttributionIds
getInternalUsageAttributionIds()
Parametreler: Yok
İade Değeri:  Iterable<string>|null
Google'ın, hangi kitaplıkların ve örneklerin geliştiriciler için faydalı olduğunu anlamasına yardımcı olan kullanım ilişkilendirme kimliklerinin listesini döndürür (ör. işaretçi kümeleme kitaplığının kullanımı).
getMapCapabilities
getMapCapabilities()
Parametreler: Yok
İade Değeri:  MapCapabilities
Arayanı, sağlanan harita kimliğine göre haritada kullanılabilen mevcut özellikler hakkında bilgilendirir.
getMapTypeId
getMapTypeId()
Parametreler: Yok
İade Değeri:  MapTypeId|string|undefined
getProjection
getProjection()
Parametreler: Yok
İade Değeri:  Projection|undefined
Geçerli Projection değerini döndürür. Harita henüz başlatılmamışsa sonuç undefined olur. projection_changed etkinliğini dinleyin ve değerinin undefined olmadığından emin olmak için değerini kontrol edin.
getRenderingType
getRenderingType()
Parametreler: Yok
İade Değeri:  RenderingType
Haritanın geçerli RenderingType'ını döndürür.
getStreetView
getStreetView()
Parametreler: Yok
Döndürülen Değer:  StreetViewPanorama Haritaya bağlı panorama.
Haritaya bağlı varsayılan StreetViewPanorama değerini döndürür. Bu değer, haritaya yerleştirilmiş varsayılan bir panorama veya setStreetView() kullanılarak ayarlanmış panorama olabilir. Haritanın streetViewControl ile ilgili değişiklikler, bu tür bir bağlı panoramanın gösterimine yansıtılır.
getTilt
getTilt()
Parametreler: Yok
İade Değeri:  number|undefined
Haritanın geçerli geliş açısını, görüntü alanı düzleminden harita düzlemine doğru derece cinsinden döndürür. Raster haritalarda, doğrudan yukarıdan çekilen görüntüler için sonuç 0, 45° açıyla çekilen görüntüler için ise 45 olur. Bu yöntem, setTilt tarafından ayarlanan değeri döndürmez. Ayrıntılar için setTilt sayfasına bakın.
getTiltInteractionEnabled
getTiltInteractionEnabled()
Parametreler: Yok
İade Değeri:  boolean|null
Eğme etkileşimlerinin etkin olup olmadığını döndürür. Bu seçenek yalnızca harita bir vektör harita olduğunda geçerlidir. Kodda ayarlanmamışsa harita kimliği için bulut yapılandırması kullanılır (varsa).
getZoom
getZoom()
Parametreler: Yok
İade Değeri:  number|undefined
Haritanın yakınlaştırma düzeyini döndürür. Yakınlaştırma ayarlanmamışsa sonuç undefined olur.
moveCamera
moveCamera(cameraOptions)
Parametreler: 
  • cameraOptions