Karo Yer Paylaşımı

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

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 sonra clearTileCache() 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 ve Polygon dahil ancak Marker 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ığı. Burada 0, 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.
Kameranın desteklediği minimum yakınlaştırma düzeyinin (çeşitli faktörlere bağlı olabilir) 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
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ğilse false.

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.