Karo Yer Paylaşımı, temel harita karolarının üzerinde görüntülenen bir dizi resimdir. Bu kutular şeffaf olabilir ve mevcut haritalara özellik eklemenize olanak tanır. Karo yer paylaşımı aşağıdaki özelliklere sahiptir:
- Karo Sağlayıcı
TileProvider
, karo yer paylaşımında kullanılan resimleri sağlar. Haritaya eklenmeden önce karo sağlayıcıyı belirtmeniz gerekir. Parça sağlayıcı, eklendikten sonra değiştirilemez ancak belirli koordinatlar için farklı görüntüler döndürmek amacıyla karo sağlayıcısının davranışını değiştirebilirsiniz. Kart sağlayıcı tarafından sağlanan karolar değişirse önceki karoların artık oluşturulmadığından emin olmak için daha sonraclearTileCache()
yöntemini çağırmanız gerekir.- Z-Endeksi
- Bu karo yer paylaşımının diğer yer paylaşımlarına göre çizilme sırası (
GroundOverlay
,Circle
,Polyline
vePolygon
dahil ancakMarker
değil). Daha büyük Z-endeksine sahip bir bindirme, daha küçük z endekslerine sahip bindirmelerin üzerinde çizilir. Aynı Z-endeksine sahip yer paylaşımlarının sıralaması rastgeledir. Varsayılan zEndeksi 0'dır. - Şeffaflık
[0..1]
aralığındaki karo yer paylaşımının şeffaflığı. Burada0
, yer paylaşımının opak olduğu,1
ise yer paylaşımının tamamen şeffaf olduğu anlamına gelir. Belirtilen bit eşlem zaten kısmen şeffafsa her pikselin şeffaflığı buna göre ölçeklendirilir (örneğin, bit eşlemdeki bir pikselin alfa değeri 200 ise ve karo yer paylaşımının şeffaflığını 0, 25 olarak belirtirseniz piksel, ekranda alfa değeriyle 150 oluşturulur). Bu özelliğin spesifikasyonu isteğe bağlıdır ve varsayılan şeffaflık 0'dır (opak).- Görünürlük
- Karo yer paylaşımının görünür olup olmadığını (harita üzerinde çizilip çizilmediğini) belirtir. Görünmez karo yer paylaşımı çizilmez ancak diğer tüm özellikleri korunur. Varsayılan boyut,
true
(yani görünür) değeridir.
Bu sınıftaki yöntemleri yalnızca ana iş parçacığında çağırmalısınız. Aksi takdirde IllegalStateException
alırsınız.
Karo Koordinatları
Dünyanın projeksiyonu, Merkatör projeksiyonu (Wikipedia'ya bakın) kullanılarak yapılır. Bu projeksiyon, haritanın sol (batı) tarafının -180 dereceye, sağ (doğu) tarafının ise 180 dereceye karşılık gelen boylamına karşılık gelir. Haritayı kare yapmak için, haritanın üst (kuzey) tarafı 85.0511 derece, alt (güney) tarafı ise -85.0511 dereceye karşılık gelir. Bu enlem aralığının dışındaki alanlar oluşturulmaz.
Her yakınlaştırma düzeyinde, harita parçalara ayrılır ve yalnızca ekranla örtüşen parçalar indirilir ve oluşturulur. Her blok kare biçimindedir ve harita aşağıdaki gibi parçalara ayrılır:
- Zum düzeyi 0'da, bir karo tüm dünyayı temsil eder. Bu karenin koordinatları (x, y) = (0, 0) şeklindedir.
- Yakınlaştırma düzeyinde 1, dünya 2 x 2 boyutunda bir düzlemde 4 karoya bölünür.
- ...
- N yakınlaştırma düzeyinde, dünya 2N x 2N boyutunda bir ızgara halinde düzenlenmiş 4N karoya bölünür.
GoogleMap.getMinZoomLevel
, maksimum yakınlaştırma düzeyinin ise GoogleMap.getMaxZoomLevel
olduğunu unutmayın.
Karoların koordinatları haritanın sol üst (kuzeybatı) köşesinden ölçülür. N yakınlaştırma düzeyinde, karo koordinatlarının x
değerleri 0 ile 2N - 1 arasında değişir ve batıdan doğuya doğru artarken y
değerleri 0 ile 2 N - 1 aralığında olur ve kuzeyden güneye artar.
Örnek
GoogleMap map; // ... get a map.
TileProvider tileProvider; // ... create a tile provider.
TileOverlay tileOverlay = map.addTileOverlay(
new TileOverlayOptions().tileProvider(tileProvider));
Herkese Açık Yöntem Özeti
void |
clearTileCache()
Karo önbelleğini temizleyerek tüm kartların
TileProvider öğesinden tekrar istenmesini sağlar. |
boolean |
eşittir(Diğer nesne)
Bu
TileOverlay öğesinin başka bir değere eşit olup olmadığını test eder. |
boolean |
getFadeIn()
Yer paylaşımı karolarının şeffaflaşmasının gerekip gerekmediğini belirtir.
|
Dize |
getId()
Bu karo yer paylaşımının kimliğini alır.
|
float |
getTransparency()
Bu karo yer paylaşımının şeffaflığını alır.
|
float |
getZIndex()
Bu karo yer paylaşımının z Endeksi'ni alır.
|
int |
hashCode()
|
boolean |
isVisible()
Bu karo yer paylaşımının görünürlüğünü sağlar.
|
void |
remove()
Bu karo yer paylaşımını haritadan kaldırır.
|
void |
setFadeIn(boole fadeIn)
Yer paylaşımı karolarının şeffaflaşıp kaybolacağını ayarlar.
|
void |
setTransparency(kayan şeffaflığı)
Bu karo yer paylaşımının şeffaflığını ayarlar.
|
void |
setVisible(boole görülebilir)
Bu karo yer paylaşımının görünürlüğünü ayarlar.
|
void |
setZIndex(kayan zIndex)
Bu karo yer paylaşımının z Endeksi'ni ayarlar.
|
Devralınan Yöntem Özeti
Herkese Açık Yöntemler
herkese açık void clearTileCache ()
Karo önbelleğini temizleyerek tüm kartların TileProvider
öğesinden tekrar istenmesini sağlar.
Bu yöntem çağrıldıktan sonra, bu karo yer paylaşımındaki mevcut karolar da haritadan silinir. API, kartların küçük bir bellek içi önbelleği sağlar. Blokları daha uzun süre önbelleğe almak istiyorsanız disk üzerinde önbellek uygulamanız gerekir.
genel boole eşittir (Nesne diğer)
Bu TileOverlay
öğesinin başka bir değere eşit olup olmadığını test eder.
Parametreler
diğer | bir Object . |
---|
İlerlemeler
- Her iki nesne de aynı nesneyse doğru değerini döndürür, yani bu == diğer.
herkese açık boole getFadeIn ()
Yer paylaşımı karolarının şeffaflaşmasının gerekip gerekmediğini belirtir.
İlerlemeler
- Karolar şeffaflaşıyorsa
true
; şeffaf değilsefalse
.
herkese açık Dize getId ()
Bu karo yer paylaşımının kimliğini alır.
Public float getTransparency ()
Bu karo yer paylaşımının şeffaflığını alır.
İlerlemeler
- bu karo yer paylaşımının şeffaflığı.
herkese açık float getZIndex ()
Bu karo yer paylaşımının z Endeksi'ni alır.
İlerlemeler
- karo yer paylaşımının z Endeksi.
genel int hashCode ()
herkese açık boole isVisible ()
Bu karo yer paylaşımının görünürlüğünü sağlar. Bu işlemin, karo yer paylaşımının gerçekten ekranın görüntü alanı içinde olup olmadığını döndürmeyeceğini, ancak ekranın görüntü alanında bulunduğunda çizilip çizilmeyeceğini unutmayın.
İlerlemeler
- görünürlük sağlar.
herkese açık void kaldır ()
Bu karo yer paylaşımını haritadan kaldırır.
herkese açık void setFadeIn (boolean fadeIn)
Yer paylaşımı karolarının şeffaflaşıp kaybolacağını ayarlar.
Parametreler
fadeIn | Karoların karartılmasını sağlamak için true ; anında oluşturmak için false .
|
---|
herkese açık geçersiz setTransparency (kayan şeffaflığı)
Bu karo yer paylaşımının şeffaflığını ayarlar. Daha fazla bilgi için bu sınıfın üst kısmındaki belgelere göz atın.
Parametreler
şeffaflık | [0..1] aralığındaki kayan nokta, 0 karo yer paylaşımının opak olduğu, 1 ise karo yer paylaşımının şeffaf olduğu anlamına gelir.
|
---|
herkese açık void setVisible (boolean visible)
Bu karo yer paylaşımının görünürlüğünü ayarlar. Görünmez olduğunda, karo yer paylaşımı çizilmez ancak diğer tüm özellikleri korunur. Karo yer paylaşımları varsayılan olarak görünür.
Parametreler
görünür | Bu yer paylaşımını görünür yapmak için true ; görünmez yapmak için false .
|
---|
herkese açık void setZIndex (float zIndex)
Bu karo yer paylaşımının z Endeksi'ni ayarlar. Daha fazla bilgi için bu sınıfın üst kısmındaki dokümanlara göz atın.
Parametreler
zIndex | bu parça yer paylaşımının z Endeksi. |
---|