Google Harita

herkese açık nihai sınıf GoogleMap Nesneyi genişletiyor

Bu, Android için Google Haritalar SDK'sının ana sınıfıdır ve haritayla ilgili tüm yöntemlerin giriş noktasıdır. Doğrudan bir GoogleMap nesnesini örnek alamazsınız. Bunun yerine, uygulamanıza eklediğiniz bir MapFragment veya MapView üzerinde getMapAsync() yönteminden bir nesne edinmeniz gerekir.

Not: View nesnesine benzer şekilde bir GoogleMap yalnızca Android kullanıcı arayüzü ileti dizisinden okunabilir ve değiştirilebilir. Başka bir mesaj dizisinden GoogleMap yöntemi çağırmak istisna oluşturur.

Kameranın konumunu değiştirerek haritayı değiştirebilirsiniz (haritayı değiştirmek yerine). Konumun, yakınlaştırma düzeyinin, yatırma açısının ve rulman gibi parametrelerin ayarlanması için haritanın kamerasını kullanabilirsiniz. Daha fazla bilgi için Kamera ve Görünüm bölümüne bakın.

Geliştirici Kılavuzu

Kullanmaya başlamak üzere Android için Google Haritalar SDK'sı geliştirici kılavuzunu okuyun.

İç içe yerleştirilmiş sınıf özeti

arayüz GoogleMap.CancelableCallback Bir görev tamamlandığında veya iptal edildiğinde raporlama yapmak için geri çağırma arayüzü. 
arayüz GoogleHarita.BilgiPenceresiUyarlanabilir Bilgi pencerelerinin özelleştirilmiş şekilde oluşturulması için görünüm sağlar. 
arayüz GoogleHarita.OnKameraChangeListener Bu arayüz kullanımdan kaldırılmıştır. GoogleMap.OnCameraMoveStartedListener, GoogleMap.OnCameraMoveListener ve GoogleMap.OnCameraIdleListener ile değiştirildi. Kullanımdan kaldırılan onCameraChange yönteminin, yeni kamera değişikliği dinleyicilerindeki yöntemlere göre çağrılacak sırası tanımlanmamıştır.  
arayüz GoogleMap.OnKameraIdleListener Kamera hareketi sona erdiğinde geri çağırma arayüzü. 
arayüz GoogleHarita.OnKameraMoveCanceledListener Kameranın hareketi durduğunda veya kamera yeni bir nedenle hareket etmeye başladığında gösterilecek geri çağırma arayüzü. 
arayüz GoogleMap.OnKameraMoveListener Kameranın konumu değiştirildiği durumlarda geri çağırma arayüzü. 
arayüz GoogleHarita.OnKameraMoveStartedListener Kamera hareketinin başladığı zaman geri çağırma arayüzü. 
arayüz GoogleHarita.OnCircleClickListener Bir dairenin tıklandığı zaman geri çağırma arayüzü. 
arayüz GoogleMap.OnGroundYer Paylaşımlı Tıklama Dinleyici Zemin bölmesi tıklandığında geri çağırma arayüzü. 
arayüz GoogleHarita.OnInororStateChangeListener İç mekan durumunun değiştiği dinleyici. 
arayüz GoogleHarita.OnInfoWindowClickListener İşaretçinin bilgi penceresinde tıklama/dokunma etkinlikleri için geri çağırma arayüzü. 
arayüz GoogleHarita.OnInfoWindowCloseListener İşaretçinin bilgi penceresindeki kapalı etkinliklere ilişkin geri çağırma arayüzü. 
arayüz GoogleHarita.OnInfoWindowLongClickListener Kullanıcı bir işaretçinin bilgi penceresine uzun bastığında geri çağırma arayüzü. 
arayüz GoogleHarita.OnMapClickListener Kullanıcı haritaya dokunduğunda gösterilen geri çağırma arayüzü. 
arayüz GoogleHarita.OnMapLoadedCallback Harita oluşturmayı tamamladığında geri çağırma arayüzü. 
arayüz GoogleHarita.OnMapLongClickListener Kullanıcı haritaya uzun bastığında geri çağırma arayüzü. 
arayüz GoogleHarita.OnMarkerTıklama İşleyici Bir işaretçi tıklandığında veya buna dokunulduğunda çağrılan yöntemlerin imzalarını tanımlar. 
arayüz GoogleHarita.OnMarkerDragListener İşaretçilerdeki sürükleme etkinlikleri için geri çağırma arayüzü. 
arayüz GoogleHarita.OnMyLocationButtonClickListener Konumum düğmesi tıklandığında kullanılacak geri çağırma arayüzü. 
arayüz GoogleHarita.OnMyChangeChangeListener Bu arayüz kullanımdan kaldırılmıştır. Bunun yerine com.google.android.gms.location.FusedLocationProviderApi'yi kullanın. FusedLocationProviderApi, daha iyi konum bulma ve güç kullanımı sağlar ve "Konumum" mavi noktası tarafından kullanılır. FusedLocationProviderApi'yi kullanan Mevcut Yeri Seçin eğitimine veya Konum Geliştirici Kılavuzu'na bakın.  
arayüz GoogleHarita.OnMyClickClickListener Kullanıcının bulunduğu konumu gösteren Konumum noktası tıklandığında kullanılacak geri çağırma arayüzü. 
arayüz GoogleHarita.OnPoiClickListener ÖY'ye dokunma işlevi için bir dinleyici. 
arayüz GoogleMap.OnPolygonClickListener Bir poligon tıklandığında yapılan geri çağırma arayüzü. 
arayüz GoogleMap.OnPolylineClickListener Bir çoklu çizginin tıklandığı zaman geri çağırma arayüzü. 
arayüz GoogleHarita.SnapshotReadyCallback Anlık görüntü alındığında bildirim almak için geri çağırma arayüzü. 

Sabit Özet

int MAP_TYPE_HYBRID Önemli caddelerin şeffaf katmanını içeren uydu haritaları.
int MAP_TYPE_NONE Temel harita karosu yok.
int MAP_TYPE_NORMAL Temel haritalar.
int MAP_TYPE_SATELLITE'yı tıklayın. Etiketsiz uydu haritaları.
int MAP_TYPE_TERRAIN Arazi haritaları.

Herkese Açık Yöntem Özeti

Daire
addCircle(CircleOptions seçenekleri)
Bu haritaya bir daire ekleyin.
Zemin Yer Paylaşımı
addGroundground (GroundgroundOptions seçenekleri)
Bu haritaya resim ekler.
İşaretçi
addMarker(MarkerOptions seçenekleri)
Bu haritaya işaretçi ekler.
Poligon
addPolygon(PolygonOptions seçenekleri)
Bu haritaya poligon ekler.
Çoklu çizgi
addPolyline(PolylineOptions seçenekleri)
Bu haritaya çoklu çizgi ekler.
Döşeme Yer Paylaşımı
addTileYer paylaşımı(TileFRAMEOptions seçenekleri)
Bu haritaya karo yer paylaşımı ekler.
geçersiz
animate Camera (KameraGüncelleme güncellemesi)
Kameranın mevcut konumdan güncellemede tanımlanan konuma hareketini animasyonla sunar.
geçersiz
animateKamera(KameraGüncelleme güncellemesi, GoogleMap.CancelableCallback geri çağırması)
Kameranın mevcut konumundan güncellemede tanımlanan konuma hareketini animasyon haline getirir ve tamamlandığında isteğe bağlı bir geri çağırma çağırır.
geçersiz
animateKamera(KameraGüncelleme güncellemesi, süre uzatmaları, GoogleMap.CancelableCallback geri çağırması)
Haritayı, güncellemeye göre belirtilen bir animasyonla oynatır ve tamamlandığında isteğe bağlı bir geri çağırma çağırır.
geçersiz
clear()
Tüm işaretçileri, poligonları, poligonları, bindirmeleri vb. haritadan kaldırır.
KameraKonumu
getKameraPosition()
Kameranın mevcut konumunu alır.
İç Mekanda İnşaat
getodedBuilding()
Şu anda odaklı binayı alır.
int
getMapType()
Görüntülenmekte olan harita türünü alır.
kayan noktalı
getMaxZoomLevel()
Geçerli kamera konumu için maksimum yakınlaştırma düzeyini döndürür.
kayan noktalı
getMinZoomLevel()
Minimum yakınlaştırma düzeyini döndürür.
Konum
getMyLocation()
Bu yöntem kullanımdan kaldırılmıştır. com.google.android.gms.location.FusedLocationProviderApi'yi kullanın. FusedLocationProviderApi, daha iyi konum bulma ve güç kullanımı sağlar ve "Konumum" mavi noktası tarafından kullanılır. Örnek kod için örnek uygulamalar klasöründeki MyLocationDemoEtkinliği veya Konum Geliştirici Kılavuzu'nu inceleyin.
Projeksiyon
getProjection()
Ekran koordinatlarıyla enlem/boylam koordinatları arasında dönüşüm yapmak için kullanabileceğiniz bir Projection nesnesi döndürür.
Kullanıcı Ayarları
getUiSettings()
Haritaya ait kullanıcı arayüzü ayarlarını alır.
boolean
isBuildingsEnabled()
3D bina katmanının etkin olup olmadığını döndürür.
boolean
isIndoorEnabled()
İç mekan haritalarının şu anda etkin olup olmadığını gösterir.
boolean
isMyLocationEnabled()
Konumum katmanının durumunu alır.
boolean
istrafficEnabled()
Haritanın trafik verileri çekip çekmediğini kontrol eder.
geçersiz
moveKamera(KameraGüncelleme güncellemesi)
Kamerayı güncellemede tanımlanan talimatlara göre yeniden konumlandırır.
geçersiz
resetMinMaxZoomPreference()
Önceden belirtilen üst ve alt yakınlaştırma sınırlarını kaldırır.
geçersiz
setBuildingsEnabled (boole etkin)
3D binalar katmanını açar veya kapatır.
geçersiz
setContentDescription(Dize açıklaması)
Harita için contentDescription belirler.
boolean
setIndoorEnabled (boole etkin)
İç mekan haritalarının etkinleştirilip etkinleştirilmeyeceğini ayarlar.
geçersiz
setInfoWindowAdapter(GoogleMap.InfoWindowAdapter adaptörü)
Bilgi pencerelerinin içerikleri için özel bir oluşturucu ayarlar.
geçersiz
setLatLngBoundsForKameraTarget(LatLngBounds sınırları)
Kamera hedefini sınırlandırmak için LatLngBounds belirtin. Böylece kullanıcılar, haritayı kaydırıp kaydırdığında kamera hedefi bu sınırların dışına çıkmaz.
geçersiz
setLocationSource(LocationSource kaynağı)
Konumum katmanının konum kaynağını değiştirir.
boolean
setMapStyle(MapStyleOptions stili)
Esas haritanın stilini ayarlar.
geçersiz
setMapType(bilgi türü)
Gösterilmesi gereken harita bloklarının türünü ayarlar.
geçersiz
setMaxZoomTercih(kayan maxZoomTercih)
Kamera yakınlaştırması için tercih edilen bir üst sınır belirler.
geçersiz
setMinZoomPreference (kayan minZoomPreference)
Kamera yakınlaştırması için tercih edilen bir alt sınırı belirler.
geçersiz
setMyLocationEnabled (Boole etkin)
Konumum katmanını etkinleştirir veya devre dışı bırakır.
geçersiz
geçersiz
setOnKameraIdleListener(GoogleMap.OnKameraIdleListener dinleyicisi)
Kamera hareketi sona erdiğinde çağrılacak bir geri çağırma ayarlar.
geçersiz
setOnKameraMoveCanceledListener(GoogleMap.OnKameraMoveCanceledListener dinleyicisi)
Kamera hareketi yeni bir animasyon türü tarafından durdurulduğunda veya kesildiğinde çağrılacak bir geri çağırma ayarlar.
geçersiz
setOnKameraMoveListener(GoogleMap.OnKameraMoveListener işleyici)
Kamera hareket halindeyken sürekli olarak geri çağrılan bir geri çağırma belirler.
geçersiz
setOnKameraMoveStartedListener(GoogleMap.OnKameraMoveStartedListener dinleyicisi)
Kamera hareket etmeye başladığında veya kamera hareketinin nedeni değiştiğinde çağrılacak bir geri çağırma ayarlar.
geçersiz
setOnCircleClickListener(GoogleMap.OnCircleClickListener işleyici)
Bir daire tıklandığında çağrılan geri çağırmayı ayarlar.
geçersiz
setOnGroundgroundClickListener(GoogleMap.OnGroundgroundClickClicker dinleyicisi)
Bir zemin bölmesi tıklandığında çağrılan bir geri çağırma ayarlar.
geçersiz
setOnIndoorStateChangeListener(GoogleMap.OnIndoorStateChangeListener dinleyici)
Dinleyiciyi iç mekan etkinlikleri için ayarlar veya temizler.
geçersiz
setOnInfoWindowClickListener(GoogleMap.OnInfoWindowClickListener işleyici)
İşaretçi bilgi penceresi tıklandığında çağrılacak bir geri çağırma ayarlar.
geçersiz
setOnInfoWindowCloseListener(GoogleMap.OnInfoWindowCloseListener dinleyicisi)
Bir işaretçinin bilgi penceresi kapatıldığında çağrılan bir geri çağırma ayarlar.
geçersiz
setOnInfoWindowLongClickListener(GoogleMap.OnInfoWindowLongClickListener işleyici)
Bir işaretçinin bilgi penceresine uzun basıldığında çağrılan bir geri çağırma ayarlar.
geçersiz
setOnMapClickListener(GoogleMap.OnMapClickListener işleyici)
Haritaya dokunulduğunda tetiklenen bir geri çağırma belirler.
geçersiz
setOnMapLoadedCallback(GoogleMap.OnMapLoadedCallback geri çağırması)
Bu harita oluşturmayı tamamladığında çağrılan bir geri çağırma belirler.
geçersiz
setOnMapLongClickListener(GoogleMap.OnMapLongClickListener işleyici)
Haritaya uzun basıldığında çağrılacak bir geri çağırma belirler.
geçersiz
setOnMarkerClickListener(GoogleMap.OnMarkerClickListener işleyici)
İşaretçi tıklandığında belirtilen geri çağırmayı ayarlar.
geçersiz
setOnMarkerDragListener(GoogleMap.OnMarkerDragListener dinleyicisi)
İşaretçi sürüklendiğinde çağrılan bir geri çağırma belirler.
geçersiz
setOnMyLocationButtonClickListener(GoogleMap.OnMyLocationButtonClickListener işleyici)
Konumum düğmesi tıklandığında çağrılan bir geri çağırma ayarlar.
geçersiz
setOnMyLocationChangeListener(GoogleMap.OnMyLocationChangeListener işleyici)
Bu yöntem kullanımdan kaldırılmıştır. com.google.android.gms.location.FusedLocationProviderApi'yi kullanın. FusedLocationProviderApi, daha iyi konum bulma ve güç kullanımı sağlar ve "Konumum" mavi noktası tarafından kullanılır. Örnek kod için örnek uygulamalar klasöründeki MyLocationDemoEtkinliği veya Konum Geliştirici Kılavuzu'nu inceleyin.
geçersiz
setOnMyLocationClickListener(GoogleMap.OnMyLocationClickListener işleyici)
Konumum noktası (kullanıcının konumunu belirtir) tıklandığında çağrılacak bir geri çağırma ayarlar.
geçersiz
setOnPoiClickListener(GoogleMap.OnPoiClickListener işleyici)
Bir ÖY tıklandığında veya dokunulduğunda tetiklenecek bir dinleyici ayarlar.
geçersiz
setOnPolygonClickListener(GoogleMap.OnPolygonClickListener işleyici)
Bir poligon tıklandığında çağrılan bir geri çağırma ayarlar.
geçersiz
setOnPolylineClickListener(GoogleMap.OnPolylineClickListener işleyici)
Bir çoklu tık tıklandığında çağrılan bir geri çağırma ayarlar.
geçersiz
setPusercontent(int sola, int top, int right, int bottom)
Haritada dolgu belirler.
geçersiz
setTrafikEnabled (boole etkin)
Trafik katmanını açar veya kapatır.
geçersiz
anlık görüntü(GoogleMap.SnapshotReadyCallback)
Haritanın anlık görüntüsünü alır.
geçersiz
snapshot(GoogleMap.SnapshotReadyCallback geri çağırması, Bit Haritası bit eşlemi)
Haritanın anlık görüntüsünü alır.
geçersiz
stopAnimation()
Devam eden bir animasyon varsa kamera animasyonunu durdurur.

Devralınan Yöntem Özeti

Sabitler

herkese açık statik nihai giriş MAP_TYPE_HYBRID

Önemli caddelerin şeffaf katmanını içeren uydu haritaları.

Sabit Değer: 4

herkese açık statik nihai giriş MAP_TYPE_NONE

Temel harita karosu yok.

Sabit Değer: 0

herkese açık statik nihai giriş MAP_TYPE_NORMAL

Temel haritalar.

Sabit Değer: 1

herkese açık statik nihai giriş MAP_TYPE_SATELLITE

Etiketsiz uydu haritaları.

Sabit Değer: 2

herkese açık statik nihai giriş MAP_TYPE_TERRAIN

Arazi haritaları.

Sabit Değer: 3

Herkese Açık Yöntemler

herkese açık Circle addCircle (CircleOptions seçenekleri)

Bu haritaya bir daire ekleyin.

Parametreler
seçenekler Dairenin nasıl oluşturulacağını tanımlayan daire seçenekleri nesnesi
İadeler
  • Haritaya eklenen Circle nesnesi

herkese açık Groundground addGroundground (GroundgroundOptions seçenekleri)

Bu haritaya resim ekler.

Parametreler
seçenekler Yer paylaşımının nasıl oluşturulacağını tanımlayan bir yer paylaşımı seçenek nesnesi. Seçeneklerde bir resim (AnchoredBitmap) ve konum belirtilmelidir.
İadeler
Dekoratif yastıklar
Yasa DışıArgumentİstisna Seçeneklerde resim veya konum belirtilmemişse.

genel İşaretçi addMarker (MarkerOptions seçenekleri)

Bu haritaya işaretçi ekler.

İşaretçinin simgesi harita üzerinde Marker.position konumunda görüntülenir. İşaretçiyi tıkladığınızda kamera, işaretçiye odaklanır. Marker.title tanımlandıysa harita, işaretçinin başlığını ve snippet'ini içeren bir bilgi kutusu gösterir. İşaretçi sürüklenebiliyorsa uzun tıklayıp işaretçiyi sürükleyebilir.

Parametreler
seçenekler İşaretçinin nasıl oluşturulacağını tanımlayan bir işaretçi seçenekleri nesnesi.
İadeler

herkese açık Poligon ekle Poligon (PolygonOptions seçenekleri)

Bu haritaya poligon ekler.

Parametreler
seçenekler Poligonun nasıl oluşturulacağını tanımlayan bir poligon seçenekleri nesnesi.
İadeler
  • Haritaya eklenen Polygon nesnesi.

genel Polyline eklePolyline (PolylineOptions seçenekleri)

Bu haritaya çoklu çizgi ekler.

Parametreler
seçenekler Çoklu çizginin nasıl oluşturulacağını tanımlayan bir polyline seçenekleri nesnesi.
İadeler
  • Haritaya eklenen Polyline nesnesi.

herkese açık TileYer paylaşımı addTile Yer Paylaşımı (Tile Yer Paylaşımı Seçenekleri seçenekleri)

Bu haritaya karo yer paylaşımı ekler. Daha fazla bilgi için TileOverlay sayfasına bakın.

Diğer bindirmelerin aksine, harita yeniden oluşturulursa karo yer paylaşımlarının otomatik olarak geri yüklenmediğini ve manuel olarak yeniden eklenmesi gerektiğini unutmayın.

Parametreler
seçenekler Yer paylaşımının nasıl oluşturulacağını tanımlayan karo yer paylaşımı seçenekleri nesnesi. Seçeneklerde TileProvider öğesi belirtilmelidir. Aksi takdirde IllegalArgumentException işareti atılır.
İadeler
Dekoratif yastıklar
Yasa DışıArgumentİstisna seçeneklerde TileProvider belirtilmemişse.

herkese açık geçersiz animasyon kamerası (KameraUpdate güncellemesi)

Kameranın mevcut konumdan güncellemede tanımlanan konuma hareketini animasyonla sunar. Animasyon sırasında getCameraPosition() çağrısı, kameranın ara konumunu döndürür.

Güncellemeler için CameraUpdateFactory adresini inceleyin.

Parametreler
update Kameraya uygulanması gereken değişiklik.

herkese açık geçersiz animasyon Camera (KameraUpdate güncellemesi, GoogleMap.CancelableCallback geri çağırması)

Kameranın mevcut konumundan güncellemede tanımlanan konuma hareketini animasyon haline getirir ve tamamlandığında isteğe bağlı bir geri çağırma çağırır. Güncellemeleri görmek için CameraUpdateFactory sayfasına bakın.

Animasyon sırasında getCameraPosition() çağrısı, kameranın ara konumunu döndürür.

Parametreler
update Kameraya uygulanması gereken değişiklik.
geri çağırma Animasyon durduğunda Android kullanıcı arayüzü ileti dizisinden çağrılacak geri çağırma. Animasyon normal şekilde tamamlanırsa onFinish(), aksi takdirde onCancel() çağrılır. onCancel() cihazı içinden kamerayı güncellemeyin veya animasyon kullanmayın.

herkese açık geçersiz animasyon kamerası (KameraUpdate güncellemesi, tam süre mM, GoogleMap.CancelableCallback geri çağırma)

Haritayı, güncellemeye göre belirtilen bir animasyonla oynatır ve tamamlandığında isteğe bağlı bir geri çağırma çağırır. Güncellemeler için CameraUpdateFactory adresini inceleyin.

Animasyon sırasında getCameraPosition() çağrılırsa uçuş sırasında kameranın mevcut konumunu döndürür.

Parametreler
update
süreMs Milisaniye cinsinden animasyonun süresi. Bu kesinlikle pozitif bir değer olmalıdır. Aksi halde IllegalArgumentException atılır.
geri çağırma Animasyon durduğunda Android kullanıcı arayüzü mesaj dizisinden bildirim almak için kullanılan isteğe bağlı bir geri çağırma. Animasyon, doğal tamamlanma nedeniyle durursa geri çağırma, onFinish() ile bildirilir. Animasyon, daha sonraki bir kamera hareketi ya da bir kullanıcı hareketi nedeniyle kesintiye uğrarsa onCancel() çağrılır. Geri çağırma, kamerayı iptal yönteminde hareket ettirmeye veya animasyonlu hale getirmeye çalışmamalıdır. Geri çağırma gerekmiyorsa null olarak bırakın.

herkese açık geçersiz açık ()

Tüm işaretçileri, poligonları, poligonları, bindirmeleri vb. haritadan kaldırır.

genel KameraKonumu getKameraPosition ()

Kameranın mevcut konumunu alır.

Döndürülen CameraPosition, geçerli konumun anlık görüntüsüdür ve kamera hareket ettiğinde otomatik olarak güncellenmez.

Kameranın konumunu değiştirme hakkında daha fazla bilgi edinmek için Kamera ve Görünüm başlıklı makaleye bakın.

İadeler
  • Kameranın mevcut konumu.

herkese açık IndoorBuilding getOdaklıDerleme ()

Şu anda odaklı binayı alır.

İadeler
  • Odaklanılan mevcut bina veya odaklı olmayan null.

public int getMapType ()

Görüntülenmekte olan harita türünü alır. Olası değerler için MAP_TYPE_NORMAL, MAP_TYPE_SATELLITE, MAP_TYPE_TERRAIN hükümlerine bakın.

İadeler
  • Harita türü.

herkese açık kayma getMaxZoomLevel ()

Geçerli kamera konumu için maksimum yakınlaştırma düzeyini döndürür. Bu işlem, şu anda hangi harita türünün kullanıldığını dikkate alır. Örneğin, uydu veya arazinin temel harita parçalarından daha düşük bir maksimum yakınlaştırma düzeyi olabilir.

Kameranın yakınlaştırma düzeyini değiştirme hakkında daha fazla bilgi edinmek için Kamera ve Görünüm konusuna bakın.

İadeler
  • Geçerli kamera konumunda bulunan maksimum yakınlaştırma düzeyi.

herkese açık kayma getMinZoomLevel ()

Minimum yakınlaştırma düzeyini döndürür. Bu konum (maksimum yakınlaştırma düzeyinin aksine) her konum için aynıdır ancak cihazlar ve harita boyutları arasında farklılık gösterebilir.

Kameranın yakınlaştırma düzeyini değiştirme hakkında daha fazla bilgi edinmek için Kamera ve Görünüm konusuna bakın.

İadeler
  • Mevcut minimum yakınlaştırma düzeyi.

herkese açık Konum getMyLocation ()

Bu yöntem kullanımdan kaldırıldı.
yerine com.google.android.gms.location.FusedLocationProviderApi'yi kullanın. FusedLocationProviderApi, daha iyi konum bulma ve güç kullanımı sağlar ve "Konumum" mavi noktası tarafından kullanılır. Örnek kod için örnek uygulamalar klasöründeki MyLocationDemoEtkinliği veya Konum Geliştirici Kılavuzu'nu inceleyin.

O anda gösterilen kullanıcı konumunu veya konum verisi yoksa null özelliğini döndürür.

İadeler
Dekoratif yastıklar
Yasa Dışı DurumÖzelliği konumum etkin değilse.

genel projeksiyon getProjection ()

Ekran koordinatlarıyla enlem/boylam koordinatları arasında dönüşüm yapmak için kullanabileceğiniz bir Projection nesnesi döndürür.

Döndürülen Projection, mevcut projeksiyonun anlık görüntüsüdür ve kamera hareket ettiğinde otomatik olarak güncellenmez. Bu işlem pahalı olduğundan, projeksiyonu her ekran için yalnızca bir kez alırsınız. Google Haritalar, harita verilerini coğrafi verilerden oluşturmak ve haritadaki noktaları coğrafi koordinatlara dönüştürmek için Mercator projeksiyonunu kullanır.

İadeler

herkese açık UiSettings getUiSettings ()

Haritaya ait kullanıcı arayüzü ayarlarını alır.

İadeler

herkese açık boole isBuildingsEnabled ()

3D bina katmanının etkin olup olmadığını döndürür.

İadeler
  • Binalar etkinse true; aksi takdirde false.

genel boole isIndoorEnabled ()

İç mekan haritalarının şu anda etkin olup olmadığını gösterir.

İadeler
  • İç mekan haritaları etkinse true; iç mekan haritaları devre dışı bırakılırsa false;

genel boole isMyLocationEnabled ()

Konumum katmanının durumunu alır.

İadeler
  • Konumum katmanı etkinse true; aksi takdirde false.

herkese açık boole isTrafficEnabled ()

Haritanın trafik verileri çekip çekmediğini kontrol eder. Bu durum, trafik verilerinin kullanılabilirliğine bağlıdır.

İadeler
  • Trafik verileri etkinse true; aksi takdirde false.

herkese açık geçersiz move Camera (KameraUpdate güncellemesi)

Kamerayı güncellemede tanımlanan talimatlara göre yeniden konumlandırır. Taşıma işlemi anında gerçekleşir ve sonrasında getCameraPosition() konumu yeni konumu yansıtır. Güncellemeler için CameraUpdateFactory adresini inceleyin.

Parametreler
update Kameraya uygulanması gereken değişiklik.

genel geçersiz resetMinMaxZoomPreference ()

Önceden belirtilen üst ve alt yakınlaştırma sınırlarını kaldırır.

herkese açık geçersiz setBuildingsEnabled (boole özellikli)

3D binalar katmanını açar veya kapatır.

Parametreler
etkin 3D bina katmanını etkinleştirmek için true; 3D binaları devre dışı bırakmak için false.

genel geçersiz setContentDescription (Dize açıklaması)

Harita için contentDescription belirler.

Erişilebilirlik modunda haritanın sözlü açıklamasını sağlamak için kullanılır. Varsayılan değer "Google Haritası"dır.

Parametreler
açıklama bir dizedir.

herkese açık boole setIndoorEnabled (boole özellikli)

İç mekan haritalarının etkinleştirilip etkinleştirilmeyeceğini ayarlar. Şu anda iç mekan haritaları aynı anda yalnızca bir haritada gösterilebilir ve varsayılan olarak uygulamanıza eklenen ilk haritadır. İç mekan haritalarını başka bir haritada etkinleştirmek için önce orijinal haritadaki iç mekan haritalarını devre dışı bırakmanız gerekir. Başka bir haritada etkinleştirildiğinde, iç mekan haritalarını etkinleştirmeye çalışırsanız hiçbir şey olmaz ve bu işlem false sonucunu döndürür. İç Mekan haritası bir harita için etkinleştirilmediğinde, iç mekanla ilgili tüm yöntemler null veya false değerini döndürür.

Parametreler
etkin İç mekan haritalarını etkinleştirmeye çalışmak için true; iç mekan haritalarını devre dışı bırakmak için false.
İadeler
  • iç mekan haritalarını etkinleştirmenin mümkün olup olmadığı.

public invalid setInfoWindowAdapter (GoogleMap.InfoWindowAdapter adaptör)

Bilgi pencerelerinin içerikleri için özel bir oluşturucu ayarlar.

Haritanın etkinlik dinleyicileri gibi, bu eyalet de harita ile serileştirilmez. Harita yeniden oluşturulursa (ör. bir yapılandırma değişikliği nedeniyle) özelleştirmeyi korumak için bu yöntemi tekrar çağırdığınızdan emin olmanız gerekir.

Parametreler
adaptör Bilgi penceresi içerikleri için kullanılacak adaptör veya bilgi pencerelerinde varsayılan içerik oluşturma işlemini kullanmak için null.

herkese açık geçersiz setLatLngBoundsForKameraTarget (LatLngBounds sınırları)

Kamera hedefini sınırlandırmak için LatLngBounds belirtin. Böylece kullanıcılar, haritayı kaydırıp kaydırdığında kamera hedefi bu sınırların dışına çıkmaz.

Sınırlama kutusunu tamamen temizlemek için boş değere ayarlayın. Yeni sınırlar, daha önce belirtilen sınırlayıcı kutunun yerini alır.

LatLngBounds değiştiğinde SDK, sonraki tüm kamera güncellemelerini mümkünse bu sınırlara uyacak şekilde ayarlar. SDK'nın, kamera hedefini sınırlar dahilinde tutmasını engelleyebilecek teknik hususlar olduğunu unutmayın. Örneğin, kayan nokta hassasiyetinde yuvarlama hataları veya çok düşük bir yakınlaştırma düzeyi.

Parametreler
sınırlar İçerideki kamera hedefini sınırlandıracak sınırlar.

genel geçersiz setLocationSource (LocationSource kaynağı)

Konumum katmanının konum kaynağını değiştirir.

Parametreler
source Konumum katmanında kullanılacak konum kaynağı. Varsayılan konum kaynağını kullanmak için null olarak ayarlayın.

genel boole setMapStyle (MapStyleOptions stili)

Esas haritanın stilini ayarlar.

Stil seçeneklerini kullanarak haritadaki özelliklere ve öğelere özel stiller uygulayabilirsiniz. Stil tanımıyla ilgili ayrıntılar için MapStyleOptions dokümanına bakın.

Önceki özel stilleri temizlemek için null değerine ayarlayın.

Parametreler
style
İadeler
  • Stil başarıyla ayrıştırıldıysa true; MapStyleOptions ile ilgili sorunlar (ör. ayrıştırılamayan stil JSON, tanınmayan özellik türü, tanınmayan öğe türü veya geçersiz stiler anahtarlar) tespit edilirse false. Dönüş değeri false ise geçerli stil değişmeden kalır.

public invalid setMapType (int type)

Gösterilmesi gereken harita bloklarının türünü ayarlar. İzin verilen değerler şunlardır:

Parametreler
tür Gösterilecek harita türü.

herkese açık geçersiz setMaxZoomPreference (falling maxZoomPreference)

Kamera yakınlaştırması için tercih edilen bir üst sınır belirler.

Maksimum yakınlaştırma değiştiğinde SDK, sonraki tüm kamera güncellemelerini mümkünse bu maksimum değeri karşılayacak şekilde ayarlar. SDK'nın, kullanıcıların haritayı derinlemesine yakınlaştırmasına engel olabilecek teknik hususlar olduğunu unutmayın. Örneğin, uydu veya arazide, esas harita karolarından daha düşük bir maksimum yakınlaştırma olabilir.

SDK, minimum ve maksimum değerlerdeki çakışmaları çözer. Minimum yakınlaştırma değerini geçerli maksimum değerden daha yüksek bir yakınlaştırma düzeyine ayarlarsanız SDK hem minimum hem de maksimum değer için yeni minimum değeri kullanır. Maksimum yakınlaştırmayı minimum değerden daha düşük bir yakınlaştırma düzeyine ayarlarsanız SDK hem minimum hem de maksimum değerler için yeni maksimum değeri kullanır. Örneğin, geçerli minimum yakınlaştırmanın 8 ve maksimum değerin 14 olduğunu varsayalım. Ardından maksimum yakınlaştırma düzeyini 6 olarak ayarlarsınız. SDK, minimum 6 yakınlaştırma ve en fazla 6 yakınlaştırma kullanır.

Parametreler
maxZoomTercih Tercih edilen üst sınır.

herkese açık geçersiz setMinZoomPreference (kayan minZoomPreference)

Kamera yakınlaştırması için tercih edilen bir alt sınırı belirler.

Minimum yakınlaştırma değiştiğinde SDK, sonraki tüm kamera güncellemelerini mümkünse bu minimum değere uyacak şekilde ayarlar. SDK'nın, kullanıcıların çok az yakınlaştırma yapmasına izin vermemesini sağlayacak teknik hususlar olduğunu unutmayın.

SDK, minimum ve maksimum değerlerdeki çakışmaları çözer. Minimum yakınlaştırma değerini geçerli maksimum değerden daha yüksek bir yakınlaştırma düzeyine ayarlarsanız SDK hem minimum hem de maksimum değer için yeni minimum değeri kullanır. Maksimum yakınlaştırmayı minimum değerden daha düşük bir yakınlaştırma düzeyine ayarlarsanız SDK hem minimum hem de maksimum değerler için yeni maksimum değeri kullanır. Örneğin, geçerli minimum yakınlaştırmanın 8 ve maksimum değerin 14 olduğunu varsayalım. Ardından minimum yakınlaştırma değerini 16 olarak ayarlarsınız. SDK minimum 16 yakınlaştırma ve 16 maksimum yakınlaştırma kullanır.

Parametreler
minZoomPreference Tercih edilen alt sınır.

herkese açık geçersiz setMyLocationEnabled (boole özellikli)

Konumum katmanını etkinleştirir veya devre dışı bırakır.

Bu özellik etkinleştirildiğinde ve konum kullanılabilir olduğunda, konumum katmanı sürekli olarak bir kullanıcının mevcut konumunu ve konumunu gösterir ve kullanıcının konumuyla etkileşime geçmesini sağlayan kullanıcı arayüzü kontrolleri görüntüler (örneğin, kullanıcının konumunu ve konumunu algılamayı etkinleştirmek veya devre dışı bırakmak gibi).

Konum katmanım özelliğini kullanmak için bir özel konum kaynağı belirlemediğiniz sürece ACCESS_COARSE_LOCATION veya ACCESS_FINE_LOCATION için izin istemeniz gerekir.

setLocationSource(LocationSource) üzerinden bir özel konum kaynağı belirlediyseniz Android için Google Haritalar SDK'sı, yukarıdaki izinlerin verilip verilmediğini kontrol etmez. Ancak yine de kullanıcının özel konum kaynağınız için gereken tüm izinleri verdiğinden emin olmanız gerekir.

Parametreler
etkin Etkinleştirmek için true; devre dışı bırakmak için false.
Dekoratif yastıklar
Güvenlik İstisnası konum izni verilmezse

genel geçersiz setOnKameraChangeListener (GoogleMap.OnKameraChangeListener dinleyici)

Bu yöntem kullanımdan kaldırılmıştır.
setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener), setOnCameraMoveListener(GoogleMap.OnCameraMoveListener), setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener) ve setOnCameraIdleListener(GoogleMap.OnCameraIdleListener) ile değiştirildi.

Kamera değiştiğinde çağrılacak bir geri çağırma ayarlar.

Parametreler
işleyici Kamera değiştiğinde çağrılan geri çağırma. Geri çağırmayı kaldırmak için null kullanın.

herkese açık geçersiz setOnKameraIdleListener (GoogleMap.OnKameraIdleListener dinleyici)

Kamera hareketi sona erdiğinde çağrılacak bir geri çağırma ayarlar.

Parametreler
işleyici Hak talebinde bulunulan geri çağırma. Geri çağırmayı kaldırmak için null işlevini kullanın.

genel geçersiz setOnKameraMoveCanceledListener (GoogleMap.OnKameraMoveCanceledListener dinleyici)

Kamera hareketi yeni bir animasyon türü tarafından durdurulduğunda veya kesildiğinde çağrılacak bir geri çağırma ayarlar.

Parametreler
işleyici Hak talebinde bulunulan geri çağırma. Geri çağırmayı kaldırmak için null işlevini kullanın. Kamerayı onCameraMoveCanceled() içinden güncellemeyin veya animasyon kullanmayın.

herkese açık geçersiz setOnKameraMoveListener (GoogleMap.OnKameraMoveListener dinleyici)

Kamera hareket halindeyken sürekli olarak geri çağrılan bir geri çağırma belirler. Geri çağırma, her karede bir kez çağrılabilir ve pahalı işlemler gerçekleştirmemelidir.

Parametreler
işleyici Hak talebinde bulunulan geri çağırma. Geri çağırmayı kaldırmak için null işlevini kullanın.

genel boş setOnKameraMoveStartedListener (GoogleMap.OnKameraMoveStartedListener dinleyici)

Kamera hareket etmeye başladığında veya kamera hareketinin nedeni değiştiğinde çağrılacak bir geri çağırma ayarlar.

Parametreler
işleyici Hak talebinde bulunulan geri çağırma. Geri çağırmayı kaldırmak için null işlevini kullanın. Kamerayı onCameraMoveStarted() içinden güncellemeyin veya animasyon kullanmayın.

herkese açık geçersiz setOnCircleClickListener (GoogleMap.OnCircleClickListener dinleyici)

Bir daire tıklandığında çağrılan geri çağırmayı ayarlar.

Parametreler
işleyici Bir daire tıklandığında çağrılan geri çağırma. Geri çağırmayı kaldırmak için null kullanın.

herkese açık geçersiz setOnGroundgroundClickListener (GoogleMap.OnGroundgroundClickListener işleyici)

Bir zemin bölmesi tıklandığında çağrılan bir geri çağırma ayarlar.

Parametreler
işleyici Bir zemin bindirmesi tıklandığında çağrılan geri çağırma. Geri çağırmayı iptal etmek için null özelliğini kullanın.

herkese açık geçersiz setOnIndoorStateChangeListener (GoogleMap.OnIndoorStateChangeListener dinleyici)

Dinleyiciyi iç mekan etkinlikleri için ayarlar veya temizler. Yalnızca bir dinleyici ayarlanabilir. Yeni bir dinleyici ayarlamak, önceki dinleyiciyi kaldırır.

Parametreler
işleyici boş olmayan etkinliklerde dinleyici için kapalıysa dinleyiciyi temizler

herkese açık geçersiz setOnInfoWindowClickListener (GoogleMap.OnInfoWindowClickListener işleyici)

İşaretçi bilgi penceresi tıklandığında çağrılacak bir geri çağırma ayarlar.

Parametreler
işleyici İşaretçi bilgi penceresi tıklandığında çağrılan geri çağırma. Geri çağırmayı iptal etmek için null özelliğini kullanın.

herkese açık geçersiz setOnInfoWindowCloseListener (GoogleMap.OnInfoWindowCloseListener işleyici)

Bir işaretçinin bilgi penceresi kapatıldığında çağrılan bir geri çağırma ayarlar.

Parametreler
işleyici Bir işaretçinin bilgi penceresi kapatıldığında çağrılan geri çağırma. Geri çağırmayı iptal etmek için null özelliğini kullanın.

genel geçersiz setOnInfoWindowLongClickListener (GoogleMap.OnInfoWindowLongClickListener işleyici)

Bir işaretçinin bilgi penceresine uzun basıldığında çağrılan bir geri çağırma ayarlar.

Parametreler
işleyici Bir işaretçinin bilgi penceresine uzun basıldığında çağrılan geri çağırma. Geri çağırmayı iptal etmek için null özelliğini kullanın.

genel boş geçersiz setOnMapClickListener (GoogleMap.OnMapClickListener dinleyici)

Haritaya dokunulduğunda tetiklenen bir geri çağırma belirler.

Parametreler
işleyici Haritaya dokunulduğunda çağrılan geri çağırma. Geri çağırmayı kaldırmak için null kullanın.

genel geçersiz setOnMapLoadedCallback (GoogleMap.OnMapLoadedCallback geri çağırması)

Bu harita oluşturmayı tamamladığında çağrılan bir geri çağırma belirler. Geri çağırma yalnızca bir kez çağrılır.

Harita tamamen oluşturulduğunda bu yöntem çağrılırsa geri çağırma hemen çağrılır. Bu etkinlik, harita bağlantı sorunları nedeniyle asla yüklenmezse veya sürekli olarak değişiyorsa ve kullanıcı sürekli olarak haritayla etkileşimde bulunması nedeniyle yükleme işlemini tamamlamazsa etkinleşmez.

Parametreler
geri çağırma Harita oluşturmayı tamamladığında geri çağırma yapılır. Geri çağırmayı iptal etmek için null özelliğini kullanın.

herkese açık geçersiz setOnMapLongClickListener (GoogleMap.OnMapLongClickListener işleyici)

Haritaya uzun basıldığında çağrılacak bir geri çağırma belirler.

Parametreler
işleyici Haritaya uzun basıldığında çağrılan geri çağırma. Geri çağırmayı iptal etmek için null özelliğini kullanın.

genel geçersiz setOnMarkerClickListener (GoogleMap.OnMarkerClickListener dinleyici)

İşaretçi tıklandığında belirtilen geri çağırmayı ayarlar.

Parametreler
işleyici İşaretçi tıklandığında çağrılan geri çağırma. Geri çağırmayı kaldırmak için null kullanın.

herkese açık geçersiz setOnMarkerDragListener (GoogleMap.OnMarkerDragListener dinleyici)

İşaretçi sürüklendiğinde çağrılan bir geri çağırma belirler.

Parametreler
işleyici İşaretçi sürükleme etkinliklerinde çağrılan geri çağırma. Geri çağırmayı kaldırmak için null kullanın.

genel geçersiz setOnMyLocationButtonClickListener (GoogleMap.OnMyLocationButtonClickListener dinleyici)

Konumum düğmesi tıklandığında çağrılan bir geri çağırma ayarlar.

listener true değerini döndürürse etkinlik kullanılır ve varsayılan davranış gerçekleşmez. false değerini döndürürse varsayılan davranış gerçekleşir (ör. kamera, kullanıcının konumuna ortalanacak şekilde hareket eder).

Parametreler
işleyici Konumum düğmesi tıklandığında çağrılan geri çağırma.

genel boş setOnMyLocationChangeListener (GoogleMap.OnMyLocationChangeListener dinleyici)

Bu yöntem kullanımdan kaldırıldı.
yerine com.google.android.gms.location.FusedLocationProviderApi'yi kullanın. FusedLocationProviderApi, daha iyi konum bulma ve güç kullanımı sağlar ve "Konumum" mavi noktası tarafından kullanılır. Örnek kod için örnek uygulamalar klasöründeki MyLocationDemoEtkinliği veya Konum Geliştirici Kılavuzu'nu inceleyin.

Konumum noktası değiştirildiğinde çağrılan bir geri çağırma ayarlar.

Parametreler
işleyici Konumum noktası değiştiğinde çağrılan geri çağırma.

genel geçersiz setOnMyLocationClickListener (GoogleMap.OnMyLocationClickListener işleyici)

Konumum noktası (kullanıcının konumunu belirtir) tıklandığında çağrılacak bir geri çağırma ayarlar.

Parametreler
işleyici Konumum noktası tıklandığında çağrılan geri çağırma.

herkese açık geçersiz setOnPoiClickListener (GoogleMap.OnPoiClickListener işleyici)

Bir ÖY tıklandığında veya dokunulduğunda tetiklenecek bir dinleyici ayarlar.

Dinleyiciyi temizlemek için null iletin.

Parametreler
işleyici

herkese açık geçersiz setOnPolygonClickListener (GoogleMap.OnPolygonClickListener dinleyici)

Bir poligon tıklandığında çağrılan bir geri çağırma ayarlar.

Parametreler
işleyici Bir poligon tıklandığında çağrılan geri çağırma. Geri çağırmayı kaldırmak için null kullanın.

genel geçersiz setOnPolylineClickListener (GoogleMap.OnPolylineClickListener işleyici)

Bir çoklu tık tıklandığında çağrılan bir geri çağırma ayarlar.

Parametreler
işleyici Bir çoklu çizgi tıklandığında çağrılan geri çağırma. Geri çağırmayı kaldırmak için null kullanın.

herkese açık geçersiz setPDolgu (int sola, int top, int right, int bottom)

Haritada dolgu belirler.

Bu yöntem, haritanın dört bir kenarının her birine dolgu yerleştirerek haritanın sinyalin kesik bölgelerinde belirsizleşebileceğine işaret etmek için haritada görünür bir bölge tanımlamanıza olanak tanır. Harita işlevleri dolguya uyarlanır. Örneğin, yakınlaştırma kontrolleri, pusula, telif hakkı bildirimleri ve Google logosu, tanımlanan bölgeye sığacak şekilde taşınır, kamera hareketleri görünür bölgenin ortasına göre hareket eder vb.

Parametreler
sol haritanın sol tarafına eklenecek dolgu piksellerinin sayısı.
üst sayfanın üstüne eklenecek dolgu piksellerinin sayısı.
sağ ok haritanın sağına eklenecek dolgu piksellerinin sayısı.
alt haritanın alt kısmına eklenecek dolgu piksellerinin sayısı.

herkese açık geçersiz setTrafficEnabled (boole etkin)

Trafik katmanını açar veya kapatır.

Parametreler
etkin

genel geçersiz anlık görüntü (GoogleMap.SnapshotReadyCallback geri çağırması)

Haritanın anlık görüntüsünü alır.

Etkileşimli haritanın kullanılmasının zor veya olanaksız olduğu durumlarda anlık görüntüleri uygulamanızda kullanabilirsiniz. Örneğin, snapshot() yöntemiyle oluşturulan resimler, uygulamanızda haritanın bir küçük resmini veya bildirim merkezinde bir anlık görüntüyü görüntülemek için kullanılabilir.

Not: Harita resimleri sunucularımıza iletilmemeli veya uygulama dışında başka bir şekilde kullanılmamalıdır. Bir haritayı başka bir uygulamaya veya kullanıcıya göndermeniz gerekirse anlık görüntü yerine yeni kullanıcı için haritayı yeniden oluşturmalarına olanak tanıyan veriler gönderin.

Parametreler
geri çağırma Anlık görüntü alındığında çağrılan geri çağırma yöntemi.

genel geçersiz anlık görüntü (GoogleMap.SnapshotReadyCallback geri çağırması, Bit Haritası bit eşlemi)

Haritanın anlık görüntüsünü alır.

Bu yöntem snapshot(SnapshotReadyCallback) ile eşdeğerdir ancak önceden atanmış bir Bitmap sağlamanıza olanak tanır. Bit eşlem haritadaki mevcut boyutlarla eşleşmezse haritanın boyutlarına uyan başka bir bit eşlemi ayrılır.

Çoğu durumda, geri çağırma yöntemiyle iletilen nesne, parametrede bu yönteme verilen nesneyle aynı olsa da, döndürülen nesne farklı olabilir (örneğin, görünümün boyutları anlık görüntünün alındığı zamana göre değiştiyse). Bu nedenle, yalnızca geri çağırma yöntemi tarafından iletilen bit eşlemin içeriğine güvenmeniz gerekir.

Parametreler
geri çağırma Anlık görüntü alındığında çağrılan geri çağırma yöntemi.
bit eşlem Önceden ayrılmış bir bit eşlem. null ise snapshot(SnapshotReadyCallback) gibi davranır.

herkese açık geçersiz stopAnimation ()

Devam eden bir animasyon varsa kamera animasyonunu durdurur. Yöntem çağrıldığında, kamera hemen hareket etmeyi bırakır ve bu konumda kalır.