Google Harita

herkese açık son sınıf GoogleMap Nesneyi genişletir

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

Not: View nesnesine benzer şekilde, GoogleMap de yalnızca Android kullanıcı arayüzü iş parçacığından okunabilir ve değiştirilebilir. Başka bir ileti dizisinden GoogleMap yöntemlerinin çağrılması durumunda istisna oluşur.

Bir haritanın bakış açısını, kameranın konumunu değiştirerek (haritayı hareket ettirmek yerine) ayarlayabilirsiniz. Konum, yakınlaştırma düzeyi, yatırma açısı ve yön gibi parametreleri ayarlamak için haritanın kamerasını kullanabilirsiniz. Daha fazla bilgi için Kamera ve Görünüm başlıklı makaleyi inceleyin.

Geliştirici Kılavuzu

Başlamak için Android için Google Haritalar SDK'sı geliştirici kılavuzunu okuyun.

İç İçe geçmiş Sınıf Özeti

arayüz GoogleMap.CancelableCallback Bir görev tamamlandığında veya iptal edildiğinde raporlama için geri çağırma arayüzü. 
arayüz GoogleMap.InfoWindowAdapter Bilgi pencerelerinin özelleştirilmiş bir şekilde oluşturulması için görünümler sağlar. 
arayüz GoogleMap.OnCameraChangeListener 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 işleyicilerdeki yöntemlere göre çağrılma sırası tanımlanmamıştır.  
arayüz GoogleMap.OnCameraIdleListener Kamera hareketi sona erdiğinde geri arama arayüzü. 
arayüz GoogleMap.OnCameraMoveCanceledListener Kameranın hareketi durdurulduğunda veya kamera yeni bir nedenle hareket etmeye başladığında geri çağırma arayüzü. 
arayüz GoogleMap.OnCameraMoveListener Kameranın konumu değiştiğinde kaydedilen geri çağırma arayüzü. 
arayüz GoogleMap.OnCameraMoveStartedListener Kamera hareketinin başladığı anı gösteren geri çağırma arayüzü. 
arayüz GoogleMap.OnCircleClickListener Bir çevre tıklandığında kaydedilen geri çağırma arayüzü. 
arayüz GoogleMap.OnGroundOverlayClickListener Zemin bindirmenin tıklanmasıyla ilişkili geri çağırma arayüzü. 
arayüz GoogleMap.OnIndoorStateChangeListener İç mekan durumu değiştiğinde izleyen bir dinleyici. 
arayüz GoogleMap.OnInfoWindowClickListener Bir işaretçinin bilgi penceresindeki tıklama/dokunma etkinlikleri için geri çağırma arayüzü. 
arayüz GoogleMap.OnInfoWindowCloseListener Bir işaretçinin bilgi penceresindeki kapatma etkinlikleri için geri çağırma arayüzü. 
arayüz GoogleMap.OnInfoWindowLongClickListener Kullanıcı, bir işaretçinin bilgi penceresine uzun bastığında gerçekleşen geri çağırma arayüzü. 
arayüz GoogleMap.OnMapClickListener Kullanıcının haritaya dokunduğunda kaydedilen geri çağırma arayüzü. 
arayüz GoogleMap.OnMapLoadedCallback Haritanın oluşturulması tamamlandığında kullanılan geri çağırma arayüzü. 
arayüz GoogleMap.OnMapLongClickListener Kullanıcının haritaya uzun bastığında gerçekleşen geri çağırma arayüzü. 
arayüz GoogleMap.OnMarkerClickListener Bir işaretçi tıklandığında veya dokunulduğunda çağrılan yöntemler için imzaları tanımlar. 
arayüz GoogleMap.OnMarkerDragListener İşaretçilerde sürükleme etkinlikleri için geri çağırma arayüzü. 
arayüz GoogleMap.OnMyLocationButtonClickListener Konumum düğmesi tıklandığında gerçekleştirilecek geri çağırma arayüzü. 
arayüz GoogleMap.OnMyLocationChangeListener Bu arayüz kullanımdan kaldırılmıştır. Bunun yerine com.google.android.gms.location.FusedLocationProviderApi kullanın. FusedLocationProviderApi, daha iyi konum bulma ve güç kullanımı sağlar ve "Konumum" mavi noktası tarafından kullanılır. FusedLocationProviderApi veya Konum Geliştirici Kılavuzu'nu kullanan Mevcut Yeri Seçme eğiticisine bakın.  
arayüz GoogleMap.OnMyLocationClickListener Konumum noktası (kullanıcının konumunu belirtir) tıklandığında gerçekleşen geri çağırma arayüzü. 
arayüz GoogleMap.OnPoiClickListener ÖY dokunma işlemlerini izleyen bir dinleyici. 
arayüz GoogleMap.OnPolygonClickListener Bir poligon tıklandığında gerçekleşen geri çağırma arayüzü. 
arayüz GoogleMap.OnPolylineClickListener Bir çoklu çizgi tıklandığında uygulanan geri çağırma arayüzü. 
arayüz GoogleMap.SnapshotReadyCallback Anlık görüntü alındığında bildirim almak için kullanılan geri çağırma arayüzü. 

Sabit Özet

int MAP_TYPE_HYBRID Başlıca caddelerin şeffaf katmanına sahip uydu haritaları.
int MAP_TYPE_NONE Temel harita deseni yok.
int MAP_TYPE_NORMAL Temel haritalar.
int MAP_TYPE_SATELLITE Etiketsiz uydu haritaları.
int MAP_TYPE_TERRAIN Arazi haritaları.

Herkese Açık Yöntem Özeti

Çevre
addCircle(CircleOptions seçenekleri)
Bu haritaya daire ekleyin.
GroundOverlay
addGroundOverlay(GroundOverlayOptions seçenekleri)
Bu haritaya resim ekler.
İşaretçi
addMarker(MarkerOptions seçenekleri)
Bu haritaya işaretleyici ekler.
Poligon
addPolygon(PolygonOptions seçenekleri)
Bu haritaya bir poligon ekler.
Çoklu çizgi
addPolyline(PolylineOptions seçenekleri)
Bu haritaya bir çoklu çizgi ekler.
TileOverlay
addTileOverlay(TileOverlayOptions seçenekleri)
Bu haritaya bir karo yer paylaşımı ekler.
void
animateCamera(CameraUpdate güncellemesi)
Kameranın mevcut konumdan güncellemede tanımlanan konuma hareketini canlandırır.
void
animateCamera(CameraUpdate güncellemesi, GoogleMap.CancelableCallback geri çağırma)
Kameranın mevcut konumdan güncellemede tanımlanan konuma hareketini canlandırır ve tamamlandığında isteğe bağlı bir geri çağırma çağrısı yapar.
void
animateCamera(CameraUpdate güncellemesi, intdurationMs, GoogleMap.CancelableCallback geri çağırma)
Haritayı güncellemeye göre, belirtilen bir süre boyunca bir animasyonla hareket ettirir ve tamamlandığında isteğe bağlı bir geri çağırma çağrısı yapar.
void
clear()
Haritadan tüm işaretçileri, çoklu çizgileri, poligonları, yer paylaşımlarını vb. kaldırır.
CameraPosition
getCameraPosition()
Kameranın mevcut konumunu alır.
IndoorBuilding
getFocusedBuilding()
O sırada odaklanılan yapıyı alır.
int
getMapType()
O anda görüntülenen harita türünü getirir.
float
getMaxZoomLevel()
Geçerli kamera konumu için maksimum yakınlaştırma düzeyini döndürür.
float
getMinZoomLevel()
Minimum yakınlaştırma düzeyini döndürür.
Konum
getMyLocation()
Bu yöntem kullanımdan kaldırılmıştır. use com.google.android.gms.location.FusedLocationProviderApi instead. 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 MyLocationDemoActivity bölümüne veya Konum Geliştirici Kılavuzu'na bakın.
Projeksiyon
getProjection()
Ekran koordinatları ile enlem/boylam koordinatları arasında dönüştürme yapmak için kullanabileceğiniz bir Projection nesnesi döndürür.
UiSettings
getUiSettings()
Haritaya ilişkin 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 etkinleştirilmiş olup olmadığını alır.
boolean
isMyLocationEnabled()
Konumum katmanının durumunu alır.
boolean
isTrafficEnabled()
Haritanın trafik verileri çekip çekmediğini kontrol eder.
void
moveCamera(CameraUpdate güncellemesi)
Kamerayı, güncellemede tanımlanan talimatlara göre yeniden konumlandırır.
void
resetMinMaxZoomPreference()
Önceden belirtilen üst ve alt yakınlaştırma sınırlarını kaldırır.
void
setBuildingsEnabled(boole etkin)
3D bina katmanını açar veya kapatır.
void
setContentDescription(Dize açıklaması)
Harita için contentDescription ayarlar.
boolean
setIndoorEnabled(boole etkin)
İç mekan haritalarının etkinleştirilip etkinleştirilmeyeceğini ayarlar.
void
setInfoWindowAdapter(GoogleMap.InfoWindowAdapter adaptörü)
Bilgi pencerelerinin içeriği için özel bir oluşturucu ayarlar.
void
setLatLngBoundsForCameraTarget(LatLngBounds sınırları)
Kamera hedefini sınırlandırmak için bir LatLngBounds belirler. Böylece, kullanıcılar haritayı kaydırdığında ve kaydırdığında kamera hedefi bu sınırların dışına çıkmaz.
void
setLocationSource(LocationSource kaynağı)
Konumum katmanının konum kaynağını değiştirir.
boolean
setMapStyle(MapStyleOptions stili)
Temel haritanın stilini ayarlar.
void
setMapType(int türü)
Görüntülenmesi gereken harita karolarının türünü ayarlar.
void
setMaxZoomPreference(kayan maxZoomPreference)
Kamera yakınlaştırması için tercih edilen üst sınırı ayarlar.
void
setMinZoomPreference(kayan minZoomPreference)
Kamera yakınlaştırması için tercih edilen bir alt sınır ayarlar.
void
setMyLocationEnabled(boole etkin)
Konumum katmanını etkinleştirir veya devre dışı bırakır.
void
void
setOnCameraIdleListener(GoogleMap.OnCameraIdleListener işleyici)
Kamera hareketi sona erdiğinde çağrılan bir geri çağırma ayarlar.
void
setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener işleyici)
Kamera hareketi yeni bir animasyon türü tarafından durdurulduğunda veya kesildiğinde çağrılan bir geri çağırmayı ayarlar.
void
setOnCameraMoveListener(GoogleMap.OnCameraMoveListener işleyici)
Kamera hareket halindeyken tekrar tekrar çağrılan bir geri çağırmayı ayarlar.
void
setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener işleyicisi)
Kamera hareket etmeye başladığında veya kamera hareketinin nedeni değiştiğinde çağrılan bir geri çağırmayı ayarlar.
void
setOnCircleClickListener(GoogleMap.OnCircleClickListener işleyicisi)
Bir çevre tıklandığında çağrılan bir geri çağırmayı ayarlar.
void
setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener işleyicisi)
Bir zemin bindirmesi tıklandığında çağrılan bir geri çağırma ayarlar.
void
setOnIndoorStateChangeListener(GoogleMap.OnIndoorStateChangeListener işleyicisi)
İç mekan etkinlikleri için işleyiciyi ayarlar veya temizler.
void
setOnInfoWindowClickListener(GoogleMap.OnInfoWindowClickListener işleyicisi)
Bir işaretçi bilgi penceresi tıklandığında çağrılan bir geri çağırmayı ayarlar.
void
setOnInfoWindowCloseListener(GoogleMap.OnInfoWindowCloseListener işleyicisi)
Bir işaretçinin bilgi penceresi kapatıldığında çağrılan bir geri çağırmayı ayarlar.
void
setOnInfoWindowLongClickListener(GoogleMap.OnInfoWindowLongClickListener işleyicisi)
Bir işaretçinin bilgi penceresine uzun basıldığında çağrılacak bir geri çağırmayı ayarlar.
void
setOnMapClickListener(GoogleMap.OnMapClickListener işleyicisi)
Haritaya dokunulduğunda çağrılacak bir geri çağırmayı ayarlar.
void
setOnMapLoadedCallback(GoogleMap.OnMapLoadedCallback geri çağırma)
Bu haritanın oluşturulması tamamlandığında çağrılan bir geri çağırmayı ayarlar.
void
setOnMapLongClickListener(GoogleMap.OnMapLongClickListener işleyicisi)
Haritaya uzun basıldığında çağrılacak bir geri çağırmayı ayarlar.
void
setOnMarkerClickListener(GoogleMap.OnMarkerClickListener işleyicisi)
Bir işaretçi tıklandığında çağrılan bir geri çağırmayı ayarlar.
void
setOnMarkerDragListener(GoogleMap.OnMarkerDragListener işleyici)
Bir işaretçi sürüklendiğinde çağrılan bir geri çağırmayı ayarlar.
void
setOnMyLocationButtonClickListener(GoogleMap.OnMyLocationButtonClickListener işleyicisi)
Konumum düğmesi tıklandığında çağrılan bir geri çağırmayı ayarlar.
void
setOnMyLocationChangeListener(GoogleMap.OnMyLocationChangeListener işleyicisi)
Bu yöntem kullanımdan kaldırılmıştır. use com.google.android.gms.location.FusedLocationProviderApi instead. 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 MyLocationDemoActivity bölümüne veya Konum Geliştirici Kılavuzu'na bakın.
void
setOnMyLocationClickListener(GoogleMap.OnMyLocationClickListener işleyicisi)
Konumum noktası (kullanıcının konumunu belirtir) tıklandığında çağrılan bir geri çağırmayı ayarlar.
void
setOnPoiClickListener(GoogleMap.OnPoiClickListener işleyicisi)
Bir ÖY tıklandığında veya ÖY'ye dokunulduğunda tetiklenecek bir işleyici ayarlar.
void
setOnPolygonClickListener(GoogleMap.OnPolygonClickListener işleyicisi)
Bir poligon tıklandığında çağrılan bir geri çağırmayı ayarlar.
void
setOnPolylineClickListener(GoogleMap.OnPolylineClickListener işleyicisi)
Bir çoklu çizgi tıklandığında çağrılan bir geri çağırmayı ayarlar.
void
setPadding(int sol; int üst; int sağ; int alt)
Haritadaki dolguyu ayarlar.
void
setTrafficEnabled(boole etkin)
Trafik katmanını açar veya kapatır.
void
snapshot(GoogleMap.SnapshotReadyCallback geri araması)
Haritanın anlık görüntüsünü alır.
void
snapshot(GoogleMap.SnapshotReadyCallback geri çağırması, Bit eşlem bit eşlemi)
Haritanın anlık görüntüsünü alır.
void
stopAnimation()
Devam eden bir kamera animasyonunu durdurur.

Devralınan Yöntem Özeti

Sabitler

herkese açık statik nihai int MAP_TYPE_HYBRID

Başlıca caddelerin şeffaf katmanına sahip uydu haritaları.

Sabit Değer: 4

herkese açık statik nihai int MAP_TYPE_NONE

Temel harita deseni yok.

Sabit Değer: 0

herkese açık statik nihai int MAP_TYPE_NORMAL

Temel haritalar.

Sabit Değer: 1

herkese açık statik nihai int MAP_TYPE_SATELLITE

Etiketsiz uydu haritaları.

Sabit Değer: 2

herkese açık statik nihai int MAP_TYPE_TERRAIN

Arazi haritaları.

Sabit Değer: 3

Herkese Açık Yöntemler

herkese açık Çevre addCircle (CircleOptions seçenekleri)

Bu haritaya daire ekleyin.

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

herkese açık GroundOverlay addGroundOverlay (GroundOverlayOptions seçenekler)

Bu haritaya resim ekler.

Parametreler
seçenekler Bindirmenin nasıl oluşturulacağını tanımlayan bir zemin bindirmesi seçenekleri nesnesi. Seçeneklerde bir resim (AnchoredBitmap) ve konum belirtilmelidir.
İlerlemeler
Dekoratif yastıklar
IllegalArgumentException resim veya konum belirtilmediyse

herkese açık İşaretçi addMarker (MarkerOptions seçenekleri)

Bu haritaya işaretleyici ekler.

İşaretçinin simgesi haritada Marker.position konumunda oluşturulur. İşaretçiyi tıkladığınızda kamera, işaretçi üzerinde ortalanır. Marker.title tanımlı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 sürüklediğinizde hareket eder.

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

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

Bu haritaya bir poligon ekler.

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

herkese açık Polyline addPolyline (PolylineOptions seçenekleri)

Bu haritaya bir çoklu çizgi ekler.

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

herkese açık TileOverlay addTileOverlay (TileOverlayOptions seçenekleri)

Bu haritaya bir karo yer paylaşımı ekler. Daha fazla bilgi için TileOverlay sayfasına göz atı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 belirtilmiş olmalıdır, aksi takdirde IllegalArgumentException atılır.
İlerlemeler
Dekoratif yastıklar
IllegalArgumentException seçeneklerde TileProvider belirtilmediyse.

herkese açık void animateCamera (CameraUpdate güncellemesi)

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

Güncellemeler için CameraUpdateFactory sayfasını ziyaret edin.

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

herkese açık void animateCamera (CameraUpdate güncellemesi, GoogleMap.CancelableCallback geri çağırma)

Kameranın mevcut konumdan güncellemede tanımlanan konuma hareketini canlandırır ve tamamlandığında isteğe bağlı bir geri çağırma çağrısı yapar. Güncellemeler için CameraUpdateFactory adresini ziyaret edin.

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ü iş parçacığından çağrılacak geri çağırma. Animasyon normal şekilde tamamlanırsa onFinish(), aksi takdirde onCancel() çağrılır. Kamerayı onCancel() içinden güncellemeyin veya animasyon uygulamayın.

herkese açık void animateCamera (CameraUpdate güncellemesi, intdurationMs, GoogleMap.CancelableCallback geri çağırma)

Haritayı güncellemeye göre, belirtilen bir süre boyunca bir animasyonla hareket ettirir ve tamamlandığında isteğe bağlı bir geri çağırma çağrısı yapar. Güncellemeler için CameraUpdateFactory sayfasını ziyaret edin.

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

Parametreler
update
durationMs Animasyonun milisaniye cinsinden süresi. Bu kesinlikle pozitif bir değer olmalıdır, aksi takdirde IllegalArgumentException atılır.
geri çağırma Animasyon durduğunda Android kullanıcı arayüzü iş parçacığından bildirim almak için isteğe bağlı bir geri çağırma. Animasyon doğal olarak tamamlandığında durursa geri çağırma, onFinish() ile bilgilendirilir. Animasyon, daha sonraki bir kamera hareketi veya kullanıcı hareketi nedeniyle kesintiye uğrarsa durursa onCancel() çağrılır. Geri çağırma, kamerayı iptal yönteminde taşımaya veya canlandırmaya çalışmamalıdır. Geri arama gerekmiyorsa null olarak bırakın.

herkese açık geçersiz clear ()

Haritadan tüm işaretçileri, çoklu çizgileri, poligonları, yer paylaşımlarını vb. kaldırır.

genel CameraPosition getCameraPosition ()

Kameranın mevcut konumunu alır.

Döndürülen CameraPosition, mevcut 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 için Kamera ve Görünüm konusuna bakın.

İlerlemeler
  • Kameranın mevcut konumu.

genel IndoorBuilding getFocusedBuilding ()

O sırada odaklanılan yapıyı alır.

İlerlemeler
  • Odaklanılan geçerli bina veya herhangi bir binaya odaklanılmamışsa null.

genel int getMapType ()

O anda görüntülenen harita türünü getirir. Olası değerler için MAP_TYPE_NORMAL, MAP_TYPE_SATELLITE, MAP_TYPE_TERRAIN adresine bakın.

İlerlemeler
  • Harita türü.

herkese açık float getMaxZoomLevel ()

Geçerli kamera konumu için maksimum yakınlaştırma düzeyini döndürür. Bunun için, şu anda hangi harita türünün kullanılmakta olduğu göz önünde bulundurulur. Örneğin, uydu ya da arazi, temel harita parçalarından daha düşük bir maksimum yakınlaştırma düzeyine sahip olabilir.

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

İlerlemeler
  • Geçerli kamera konumunda kullanılabilen maksimum yakınlaştırma düzeyi.

herkese açık float getMinZoomLevel ()

Minimum yakınlaştırma düzeyini döndürür. Bu, her konum için aynıdır (maksimum yakınlaştırma düzeyinden farklı olarak) ancak cihazlar ve harita boyutları arasında değişiklik gösterebilir.

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

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

genel Konum getMyLocation ()

Bu yöntem kullanımdan kaldırıldı.
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. Örnek kod için örnek uygulamalar klasöründeki MyLocationDemoActivity sayfasına veya Konum Geliştirici Kılavuzu'na bakın.

O anda görüntülenen kullanıcı konumunu veya kullanılabilir konum verisi yoksa null değerini döndürür.

İlerlemeler
Dekoratif yastıklar
IllegalStateException etkinleştirilmemişse.

herkese açık Projeksiyon getProjection ()

Ekran koordinatları ile enlem/boylam koordinatları arasında dönüştürme 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 ekran başına yalnızca bir kez alırsınız. Google Haritalar, coğrafi verilerden harita oluşturmak ve haritadaki noktaları coğrafi koordinatlara dönüştürmek için Mercator projeksiyonu kullanır.

İlerlemeler

herkese açık UiSettings getUiSettings ()

Haritaya ilişkin kullanıcı arayüzü ayarlarını alır.

İlerlemeler

herkese açık boole isBuildingsEnabled ()

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

İlerlemeler
  • Binalar etkinse true; aksi takdirde false.

herkese açık boole isIndoorEnabled ()

İç mekan haritalarının şu anda etkinleştirilmiş olup olmadığını alır.

İlerlemeler
  • İç mekan haritaları etkinse true; iç mekan haritaları devre dışıysa false;

herkese açık boole isMyLocationEnabled ()

Konumum katmanının durumunu alır.

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

herkese açık boole isTrafficEnabled ()

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

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

herkese açık void moveCamera (CameraUpdate güncellemesi)

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

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

herkese açık void resetMinMaxZoomPreference ()

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

herkese açık void setBuildingsEnabled (boolean enabled)

3D bina 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.

herkese açık void setContentDescription (Dize açıklaması)

Harita için contentDescription ayarlar.

Bu, erişilebilirlik modunda haritanın sesli açıklamasını sağlamak için kullanılır. Varsayılan değer "Google Haritası"dır

Parametreler
açıklama açıklama olarak kullanılacak bir dize.

herkese açık boole setIndoorEnabled (boolean enabled)

İç mekan haritalarının etkinleştirilip etkinleştirilmeyeceğini ayarlar. İç mekan haritaları şu anda yalnızca bir haritada görüntülenebilir ve varsayılan olarak bu, uygulamanıza eklenen ilk haritadır. İç mekan haritalarını başka bir haritada etkinleştirmek için öncelikle orijinal haritadaki iç mekan haritalarını devre dışı bırakmanız gerekir. Bu özellik başka bir haritada etkinken iç mekan haritalarını etkinleştirmeye çalışırsanız hiçbir şey olmaz ve bu işlem false sonucunu döndürür. İç Mekan, 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ştirmeyi denemek için true; iç mekan haritalarını devre dışı bırakmak için false.
İlerlemeler
  • ve mümkün olup olmadığını değerlendirdik.

herkese açık void setInfoWindowAdapter (GoogleMap.InfoWindowAdapter adaptörü)

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

Haritanın etkinlik işleyicileri gibi bu durum da haritayla 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 olmalısınız.

Parametreler
adaptör Bilgi penceresi içerikleri için kullanılacak bağdaştırıcı veya bilgi pencerelerinde varsayılan içerik oluşturmayı kullanmak için null.

herkese açık void setLatLngBoundsForCameraTarget (LatLngBounds sınırları)

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

Sınırlayıcı kutuyu tamamen temizlemek için null değerine ayarlayın. Yeni sınırlar, daha önce belirtilen sınırlayıcı kutuların 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 kesinlikle sınırların içinde tutmasını engelleyebilecek teknik hususlar bulunduğunu unutmayın. Örneğin, kayan nokta hassasiyeti yuvarlama hataları veya çok düşük bir yakınlaştırma düzeyi kullanılabilir.

Parametreler
sınırlar Kamera hedefini sınırlayacak sınırlar.

herkese açık void setLocationSource (LocationSource kaynağı)

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

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

genel boole setMapStyle (MapStyleOptions stili)

Temel haritanın stilini ayarlar.

Stil seçeneklerini kullanarak, haritadaki özelliklere ve öğelere özel stiller uygulayabilirsiniz. Stil tanımı ayrıntıları için MapStyleOptions politikasına bakın.

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

Parametreler
style
İlerlemeler
  • Stil başarıyla ayrıştırıldıysa true; MapStyleOptions ile ilgili ayrıştırılamayan JSON, tanınmayan özellik türü, tanınmayan öğe türü veya geçersiz stil anahtarları gibi sorunlar algılandığında false. Döndürülen değer false ise mevcut stil değiştirilmez.

herkese açık void setMapType (int type)

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

Parametreler
tür Görüntülenecek haritanın türü.

herkese açık void setMaxZoomPreference (float maxZoomPreference)

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

Maksimum yakınlaştırma değeri değiştiğinde SDK, sonraki tüm kamera güncellemelerini mümkünse bu maksimum değere uyacak şekilde ayarlar. SDK'nın, kullanıcıların haritayı çok derine yakınlaştırmasına izin vermemesini sağlayabilecek teknik hususların bulunduğunu unutmayın. Örneğin, uydu veya arazi, temel harita parçalarından daha düşük bir maksimum yakınlaştırma değerine sahip olabilir.

SDK, minimum ve maksimum değerlerdeki çakışmaları giderir. Minimum yakınlaştırma değerini mevcut maksimum zumdan daha yüksek bir değere ayarlarsanız SDK, hem minimum hem de maksimum için yeni minimum değeri kullanır. Maksimum yakınlaştırma değerini minimumdan 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, maksimum yakınlaştırmanın ise 14 olduğunu varsayalım. Ardından maksimum yakınlaştırma oranını 6'ya ayarlarsınız. SDK, minimum 6 ve maksimum 6 yakınlaştırma kullanır.

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

herkese açık void setMinZoomPreference (float minZoomPreference)

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

Minimum yakınlaştırma değeri 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 düşük yakınlaştırma yapmasına izin vermelerini engelleyebilecek teknik hususlar bulunduğunu unutmayın.

SDK, minimum ve maksimum değerlerdeki çakışmaları giderir. Minimum yakınlaştırma değerini mevcut maksimum zumdan daha yüksek bir değere ayarlarsanız SDK, hem minimum hem de maksimum için yeni minimum değeri kullanır. Maksimum yakınlaştırma değerini minimumdan 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, maksimum yakınlaştırmanın ise 14 olduğunu varsayalım. Ardından minimum yakınlaştırma oranını 16'ya ayarlarsınız. SDK, minimum 16 ve maksimum 16 yakınlaştırma kullanır.

Parametreler
minZoomPreference Tercih edilen alt sınır.

Public void setMyLocationEnabled (boolean enabled)

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

Etkin durumdayken ve konum kullanılabilir olduğunda, Konumum katmanında sürekli olarak bir kullanıcının mevcut konumu ve konumu hakkında bir gösterge görüntülenir ve kullanıcının konumuyla etkileşimde bulunmasına olanak tanıyan kullanıcı arayüzü kontrolleri görüntülenir (örneğin, kamerayla konum ve yön bilgisini etkinleştirme veya devre dışı bırakma).

"Konum katmanım" özelliğini kullanabilmek üzere, özel bir konum kaynağı ayarlamadıysanız ACCESS_COARSE_LOCATION veya ACCESS_FINE_LOCATION için izin istemeniz gerekir.

setLocationSource(LocationSource) aracılığıyla özel konum kaynağı ayarladıysanız 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
SecurityException konum izni verilmez.

herkese açık void setOnCameraChangeListener (GoogleMap.OnCameraChangeListener işleyici)

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ğırmayı ayarlar.

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

herkese açık void setOnCameraIdleListener (GoogleMap.OnCameraIdleListener dinleyici)

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

Parametreler
işleyici Çağrılan geri çağırma. Geri çağırmayı iptal etmek için null işlevini kullanın.

herkese açık void setOnCameraMoveCanceledListener (GoogleMap.OnCameraMoveCanceledListener dinleyicisi)

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

Parametreler
işleyici Çağrılan geri çağırma. Geri çağırmayı iptal etmek için null işlevini kullanın. Kamerayı onCameraMoveCanceled() içinden güncellemeyin veya canlandırmayın.

herkese açık void setOnCameraMoveListener (GoogleMap.OnCameraMoveListener dinleyicisi)

Kamera hareket halindeyken tekrar tekrar çağrılan bir geri çağırmayı ayarlar. Geri çağırma, her karede bir kez çağrılabilir ve pahalı işlemler gerçekleştirmemelidir.

Parametreler
işleyici Çağrılan geri çağırma. Geri çağırmayı iptal etmek için null işlevini kullanın.

herkese açık void setOnCameraMoveStartedListener (GoogleMap.OnCameraMoveStartedListener işleyici)

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

Parametreler
işleyici Çağrılan geri çağırma. Geri çağırmayı iptal etmek için null işlevini kullanın. Kamerayı onCameraMoveStarted() içinden güncellemeyin veya canlandırmayın.

herkese açık void setOnCircleClickListener (GoogleMap.OnCircleClickListener işleyicisi)

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

Parametreler
işleyici Bir çevre tıklandığında çağrılan geri çağırma. Geri çağırmayı ayarlamak için null işlevini kullanın.

herkese açık void setOnGroundOverlayClickListener (GoogleMap.OnGroundOverlayClickListener işleyici)

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

Parametreler
işleyici Zemin bindirmesi tıklandığında çağrılan geri çağırma. Geri çağırmayı ayarlamak için null işlevini kullanın.

herkese açık void setOnIndoorStateChangeListener (GoogleMap.OnIndoorStateChangeListener işleyici)

İç mekan etkinlikleri için işleyiciyi ayarlar veya temizler. Yalnızca bir dinleyici ayarlanabilir. Yeni bir işleyici oluşturulduğunda önceki işleyici kaldırılır.

Parametreler
işleyici null değilse iç mekan etkinlikleri için işleyici; aksi takdirde, işleyiciyi temizler

herkese açık void setOnInfoWindowClickListener (GoogleMap.OnInfoWindowClickListener işleyicisi)

Bir işaretçi bilgi penceresi tıklandığında çağrılan bir geri çağırmayı ayarlar.

Parametreler
işleyici Bir işaretçi bilgi penceresi tıklandığında çağrılan geri çağırma. Geri çağırmayı ayarlamak için null işlevini kullanın.

herkese açık void setOnInfoWindowCloseListener (GoogleMap.OnInfoWindowCloseListener işleyicisi)

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

Parametreler
işleyici Bir işaretçinin bilgi penceresi kapatıldığında çağrılan geri çağırma. Geri çağırmayı ayarlamak için null işlevini kullanın.

herkese açık void setOnInfoWindowLongClickListener (GoogleMap.OnInfoWindowLongClickListener işleyici)

Bir işaretçinin bilgi penceresine uzun basıldığında çağrılacak bir geri çağırmayı 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 işlevini kullanın.

herkese açık void setOnMapClickListener (GoogleMap.OnMapClickListener işleyici)

Haritaya dokunulduğunda çağrılacak bir geri çağırmayı ayarlar.

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

herkese açık void setOnMapLoadedCallback (GoogleMap.OnMapLoadedCallback geri çağırma)

Bu haritanın oluşturulması tamamlandığında çağrılan bir geri çağırmayı ayarlar. Geri çağırma yalnızca bir kez çağrılır.

Bu yöntem, harita tamamen oluşturulduktan sonra çağrılırsa geri çağırma hemen gerçekleştirilir. Bağlantı sorunları nedeniyle harita hiçbir zaman yüklenmiyorsa veya harita sürekli değişiyorsa ve kullanıcı haritayla sürekli etkileşimde bulunduğu için yükleme işlemi hiç tamamlanmıyorsa bu etkinlik tetiklenmez.

Parametreler
geri çağırma Haritanın oluşturulması tamamlandığında çağrılan geri çağırma. Geri çağırmayı ayarlamak için null işlevini kullanın.

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

Haritaya uzun basıldığında çağrılacak bir geri çağırmayı ayarlar.

Parametreler
işleyici Haritaya uzun basıldığında çağrılan geri çağırma. Geri çağırmayı ayarlamak için null işlevini kullanın.

private void setOnMarkerClickListener (GoogleMap.OnMarkerClickListener işleyici)

Bir işaretçi tıklandığında çağrılan bir geri çağırmayı ayarlar.

Parametreler
işleyici Bir işaretçi tıklandığında çağrılan geri çağırma. Geri çağırmayı ayarlamak için null işlevini kullanın.

herkese açık void setOnMarkerDragListener (GoogleMap.OnMarkerDragListener işleyici)

Bir işaretçi sürüklendiğinde çağrılan bir geri çağırmayı ayarlar.

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

herkese açık void setOnMyLocationButtonClickListener (GoogleMap.OnMyLocationButtonClickListener dinleyicisi)

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

listener, true değerini döndürürse etkinlik tüketilir 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 konumunun merkezinde olacak şekilde hareket eder).

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

herkese açık void setOnMyLocationChangeListener (GoogleMap.OnMyLocationChangeListener dinleyicisi)

Bu yöntem kullanımdan kaldırıldı.
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. Örnek kod için örnek uygulamalar klasöründeki MyLocationDemoActivity sayfasına veya Konum Geliştirici Kılavuzu'na bakın.

Konumum noktası konumu değiştirdiğinde çağrılan bir geri çağırmayı ayarlar.

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

genel void setOnMyLocationClickListener (GoogleMap.OnMyLocationClickListener işleyicisi)

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

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

herkese açık void setOnPoiClickListener (GoogleMap.OnPoiClickListener işleyicisi)

Bir ÖY tıklandığında veya ÖY'ye dokunulduğunda tetiklenecek bir işleyici ayarlar.

İşleyiciyi temizlemek için null öğesini iletin.

Parametreler
işleyici

herkese açık void setOnPolygonClickListener (GoogleMap.OnPolygonClickListener işleyicisi)

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

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

herkese açık void setOnPolylineClickListener (GoogleMap.OnPolylineClickListener işleyicisi)

Bir çoklu çizgi tıklandığında çağrılan bir geri çağırmayı ayarlar.

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

herkese açık void setPadding (int left, int top, int right, int bottom)

Haritadaki dolguyu ayarlar.

Bu yöntem, harita üzerinde görünür bir bölge tanımlamanıza ve haritanın dört kenarının her birine dolgu ayarlayarak kenarların etrafındaki harita bölümlerinin belirsizleştirilebileceğini belirlemenize 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 merkezine göre belirlenir vb.

Parametreler
sol haritanın soluna eklenecek dolgu piksellerinin sayısını gösterir.
ilk yarı haritanın üst kısmına eklenecek dolgu piksellerinin sayısı.
sağ ok haritanın sağına eklenecek dolgu piksellerinin sayısı.
ikinci yarı haritanın alt kısmına eklenecek dolgu piksellerinin sayısı.

herkese açık void setTrafficEnabled (boolean enabled)

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

Parametreler
etkin

herkese açık void anlık görüntü (GoogleMap.SnapshotReadyCallback geri çağırma)

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

Etkileşimli bir haritanın kullanımının zor veya imkansız olduğu durumlarda, uygulamanızda anlık görüntüleri kullanabilirsiniz. Örneğin, snapshot() yöntemiyle üretilen görseller, uygulamanızda haritanın küçük resmini veya bildirim merkezinde anlık görüntüyü göstermek için kullanılabilir.

Not: Harita görüntüleri, sunucularınıza iletilmemeli veya uygulama dışında başka şekilde kullanılmamalıdır. Haritayı başka bir uygulamaya veya kullanıcıya göndermeniz gerekirse, harita sahibinin anlık görüntü yerine haritayı yeni kullanıcı için yeniden oluşturması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.

Public void snapshot (GoogleMap.SnapshotReadyCallback geri çağırma, Bit eşlem 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 ayrılmış bir Bitmap sağlamanıza olanak tanır. Bit eşlem, haritanın mevcut boyutlarıyla eşleşmezse haritanın boyutlarına uygun olan başka bir bit eşlem ayrılır.

Çoğu durumda geri çağırma yöntemiyle geçirilen nesne, bu yönteme parametrede verilen nesneyle aynı olsa da bazı durumlarda döndürülen nesne farklı olabilir (ör. görünümün boyutları, anlık görüntünün gerçekten alındığı sırada görünümün boyutları değiştiyse). Bu nedenle, yalnızca geri çağırma yöntemiyle aktarılan 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ış bit eşlem. null ise snapshot(SnapshotReadyCallback) gibi davranır.

herkese açık void stopAnimation ()

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