Alan Bindirme

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

Zemin bindirme, bir haritaya sabitlenmiş bir görüntüdür. Zemin bindirme aşağıdaki özelliklere sahiptir:

Konum
Zemin bindirmenin konumunu belirtmenin iki yolu vardır:
  • Konum kullanma: Zemin bindirmenin bir resmini, sabitin sabitleneceği bir LatLng ve bindirmenin genişliğini (metre cinsinden) sağlamanız gerekir. Sabit değer, varsayılan olarak resmin üst tarafından% 50 ve sol tarafından% 50'dir. Bu ayar değiştirilebilir. İsteğe bağlı olarak yer paylaşımının yüksekliğini (metre cinsinden) sağlayabilirsiniz. Yer paylaşımının yüksekliğini belirtmezseniz resmin oranları korunacak şekilde otomatik olarak hesaplanır.
  • Sınırlar Kullanma: Resmi içeren bir LatLngBounds sağlamanız gerekir.
Haritaya eklenmeden önce, zemin bindirmesinin konumunu belirtmeniz gerekir. Aksi takdirde, zemin bindirmesi haritaya eklendiğinde bir IllegalArgumentException yayınlanır. Bununla birlikte, GroundOverlayOptions nesnesinde konumu yalnızca bu yöntemlerden birini kullanarak belirtmeniz gerekir. Aksi takdirde, ikinci bir yöntem kullanılarak belirtilirken bir IllegalStateException döndürülür.
Resim
Bu yer paylaşımı için kullanılacak resim (BitmapDescriptor olarak). Resim, sağlanan konuma sığacak şekilde ölçeklendirilir. Zemin bindirmesini haritaya eklemeden önce bir görüntü belirtmeniz gerekir. Aksi takdirde, haritaya eklendiğinde IllegalArgumentException atanır.
Rulman
Resmin saat yönünde döndürülmesi gereken miktar. Döndürmenin merkezi, resmin sabiti olur. Bu değer isteğe bağlıdır ve varsayılan değer 0'dır (ör. resim yukarı kuzey olacak şekilde hizalanır.
zIndex
Bu zemin bindirmesinin, diğer bindirmelere göre çizilme sırası (Polyline ve TileOverlay dahil ancak Marker değil). Daha büyük z Endeksine sahip bir bindirme, daha küçük zEndekslerine sahip bindirmelerin üzerine çizilir. Aynı zIndex değerine sahip yer paylaşımlarının sırası isteğe bağlıdır. Bu değer isteğe bağlıdır ve varsayılan zIndex 0'dır.
Şeffaflık
[0..1] aralığındaki zemin bindirmesinin ş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 zemin bindirmesinin ş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
Zemin bindirmesinin görünür olup olmadığını (harita üzerinde çizilip çizilmediğini) belirtir. Görünmeyen bir zemin bindirmesi çizilmez, ancak diğer tüm özelliklerini korur. Bu isteğe bağlıdır ve varsayılan görünürlük (ör. görünür) true şeklindedir.
Tıklanabilirlik
Kullanıcı, yer paylaşımını tıkladığında tetiklenen etkinlikleri yönetmek istiyorsanız bu özelliği true olarak ayarlayın. Bu değeri istediğiniz zaman değiştirebilirsiniz. Varsayılan değer: false. Bu özellik true değerine ayarlanırsa uygulamanız setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener) üzerinden kaydedilen GoogleMap.OnGroundOverlayClickListener için bildirim alır.
Etiket
Zemin bindirmesiyle ilişkili bir Object. Örneğin, Object, zemin bindirmesinin neyi temsil ettiğine dair veriler içerebilir. Bu, ayrı bir Map<GroundOverlay, Object> depolamaktan daha kolaydır. Başka bir örnek olarak, veri kümesindeki kimliğe karşılık gelen bir String kimliğini ilişkilendirebilirsiniz. Android için Google Haritalar SDK'sı bu özelliği okumaz veya yazmaz.

Bu sınıftaki yöntemler Android kullanıcı arayüzü iş parçacığında çağrılmalıdır. Aksi takdirde, çalışma zamanında bir IllegalStateException atılır.

Örnek

GoogleMap map = ...; // get a map.
 BitmapDescriptor imageDescriptor = ...; // get an image.
 LatLngBounds bounds = ...; // get a bounds
 // Adds a ground overlay with 50% transparency.
 GroundOverlay groundOverlay = map.addGroundOverlay(new GroundOverlayOptions()
     .image(imageDescriptor)
     .positionFromBounds(bounds)
     .transparency(0.5));

Herkese Açık Yöntem Özeti

boolean
eşittir(Diğer nesne)
Bu GroundOverlay öğesinin başka bir değere eşit olup olmadığını test eder.
float
getBearing()
Kuzeyden saat yönünde derece cinsinden zemin bindirmenin yönünü alır.
LatLngBounds
getBounds()
Zemin bindirmesinin sınırlarını alır.
float
getHeight()
Zemin bindirmenin yüksekliğini alır.
Dize
getId()
Bu zemin bindirmesinin kimliğini alır.
LatLng
getPosition()
Sabitleme noktasının konumunu alır.
Nesne
getTag()
Çevrenin etiketini alır.
float
getTransparency()
Bu zemin bindirmesinin şeffaflığını elde eder.
float
getWidth()
Zemin bindirmenin genişliğini alır.
float
getZIndex()
Bu zemin bindirmesinin z-endeksini alır.
int
hashCode()
boolean
isClickable()
Zemin bindirmenin tıklanabilirliğini sağlar.
boolean
isVisible()
Bu zemin bindirmenin görünürlüğünü sağlar.
void
remove()
Bu zemin bindirmesini haritadan kaldırır.
void
setBearing(kayan yatağın)
Zemin bindirmenin yönünü (zemin bindirmenin dikey ekseninin işaret ettiği yön) kuzeyden saat yönünde derece olarak ayarlar.
void
setClickable(tıklanabilir boole)
Zemin bindirmesinin tıklanabilirliğini ayarlar.
void
setDimensions(kayan genişlik, kayan yükseklik)
Zemin bindirmesinin boyutlarını ayarlar.
void
setDimensions(kayan genişlik)
Zemin bindirmenin genişliğini ayarlar.
void
setImage(BitmapDescriptor imageDescriptor)
Zemin Bindirme için resmi ayarlar.
void
setPosition(LatLng latLng)
Sabitleme noktasının konumunu değiştirerek zemin bindirmenin konumunu ayarlar.
void
setPositionFromBounds(LatLngBounds sınırları)
Zemin bindirmenin konumunu, verilen LatLngBounds öğesine sığdırarak ayarlar.
void
setTag(Nesne etiketi)
Zemin bindirme için etiketi ayarlar.
void
setTransparency(kayan şeffaflığı)
Bu zemin bindirmesinin şeffaflığını ayarlar.
void
setVisible(boole görülebilir)
Bu zemin bindirmesinin görünürlüğünü ayarlar.
void
setZIndex(kayan zIndex)
Bu zemin bindirmesinin z Endeksi'ni ayarlar.

Devralınan Yöntem Özeti

Herkese Açık Yöntemler

genel boole eşittir (Nesne diğer)

Bu GroundOverlay öğ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 kayan reklam getBearing ()

Kuzeyden saat yönünde derece cinsinden zemin bindirmenin yönünü alır.

İlerlemeler
  • zemin bindirmesinin yönü vardır.

herkese açık LatLngBounds getBounds ()

Zemin bindirmesinin sınırlarını alır. Bu işlem, zemin bindirmenin dönüşünü göz ardı eder.

İlerlemeler
  • Döndürmeyi göz ardı ederek zemin bindirmesini içeren bir LatLngBounds.

herkese açık float getHeight ()

Zemin bindirmenin yüksekliğini alır.

İlerlemeler
  • zemin bindirmesinin metre cinsinden yüksekliğini gösterir.

herkese açık Dize getId ()

Bu zemin bindirmesinin kimliğini alır. Kimlik, haritadaki tüm GroundOverlays arasında benzersiz olacaktır.

İlerlemeler
  • kimliğini öğrenebilirsiniz.

herkese açık LatLng getPosition ()

Sabitleme noktasının konumunu alır.

İlerlemeler

herkese açık Nesne getTag ()

Çevrenin etiketini alır.

İlerlemeler
  • bir etiket setTag ile ayarlandıysa etiket; hiçbir etiket ayarlanmamışsa null.

Public float getTransparency ()

Bu zemin bindirmesinin şeffaflığını elde eder.

İlerlemeler
  • şeffaflığını artırır.

herkese açık float getWidth ()

Zemin bindirmenin genişliğini alır.

İlerlemeler
  • zemin bindirmenin genişliğini görebilirsiniz.

herkese açık float getZIndex ()

Bu zemin bindirmesinin z-endeksini alır.

İlerlemeler
  • zemin bindirmesinin z Endeksi.

genel int hashCode ()

herkese açık boole isClickable ()

Zemin bindirmenin tıklanabilirliğini sağlar. Yer paylaşımı tıklanabilir durumdaysa kullanıcı zemin bindirmesini tıkladığında uygulamanız GoogleMap.OnGroundOverlayClickListener cihazına bildirim gönderir. Etkinlik işleyici setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener) aracılığıyla kaydedildi.

İlerlemeler
  • Zemin yer paylaşımı tıklanabilirse true; aksi takdirde false değerini döndürür.

herkese açık boole isVisible ()

Bu zemin bindirmenin görünürlüğünü sağlar. Bu işlemin, zemin bindirmesinin gerçekten ekranda olup olmadığını döndürmeyeceğini, ancak kameranın görüntü alanında yer alıyorsa çizilip çizilmeyeceğini unutmayın.

İlerlemeler
  • her yönüyle açıklayabiliyoruz.

herkese açık void kaldır ()

Bu zemin bindirmesini haritadan kaldırır. Zemin bindirmesi kaldırıldıktan sonra, tüm yöntemlerinin davranışı tanımsız hale gelir.

herkese açık geçersiz setBearing (şamandıra yatağı)

Zemin bindirmenin yönünü (zemin bindirmenin dikey ekseninin işaret ettiği yön) kuzeyden saat yönünde derece olarak ayarlar. Döndürme, sabitleme noktası hakkında gerçekleştirilir.

Parametreler
dayanmak kuzeyden saat yönünde derece cinsinden yön

herkese açık void setClickable (boole tıklanabilir)

Zemin bindirmesinin tıklanabilirliğini ayarlar. Yer paylaşımı tıklanabilir durumdaysa kullanıcı zemin bindirmesini tıkladığında uygulamanız GoogleMap.OnGroundOverlayClickListener cihazına bildirim gönderir. Etkinlik işleyici setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener) aracılığıyla kaydedildi.

Parametreler
tıklanabilir Zemin bindirme için yeni tıklanabilirlik ayarı.

herkese açık geçersiz setDimensions (kayan genişlik, kayan yükseklik)

Zemin bindirmesinin boyutlarını ayarlar. Resim, boyutlara sığacak şekilde uzatılır.

Parametreler
genişlik metre cinsinden genişlik
yükseklik metre cinsinden yükseklik

herkese açık geçersiz setDimensions (kayan genişlik)

Zemin bindirmenin genişliğini ayarlar. Zemin bindirmenin yüksekliği, en boy oranını korumak için uygun şekilde uyarlanır.

Parametreler
genişlik metre cinsinden genişlik

herkese açık void setImage (BitmapDescriptor imageDescriptor)

Zemin Bindirme için resmi ayarlar. Yeni görüntü, eski görüntüyle aynı sınırları kullanır.

Parametreler
imageDescriptor BitmapDescriptor öğesini seçeceğiz.

herkese açık void setPosition (LatLng latLng)

Sabitleme noktasının konumunu değiştirerek zemin bindirmenin konumunu ayarlar. Resmin diğer tüm özelliklerini korur.

Parametreler
latLng sabitleme noktasını yerleştirecek yeni konum olan bir LatLng.

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

Zemin bindirmenin konumunu, verilen LatLngBounds öğesine sığdırarak ayarlar. Bu yöntem, zemin bindirmenin konumlandırılması sırasında döndürmesini (yatımı) göz ardı eder ancak çizim sırasında yine de yatak kullanılır.

Parametreler
sınırlar zemin bindirmenin yerleştirileceği bir LatLngBounds

herkese açık void setTag (Nesne etiketi)

Zemin bindirme için etiketi ayarlar.

İsteğe bağlı bir Object öğesini bu zemin bindirmesiyle ilişkilendirmek için bu özelliği kullanabilirsiniz. Örneğin, Object, zemin bindirmenin neyi temsil ettiğine dair veriler içerebilir. Bu, ayrı bir Map<GroundOverlay, Object> depolamaktan daha kolaydır. Başka bir örnek olarak, veri kümesindeki kimliğe karşılık gelen bir String kimliğini ilişkilendirebilirsiniz. Android için Google Haritalar SDK'sı bu özelliği okumaz veya yazmaz. Uygulamanızdaki bellek sızıntılarını önlemek amacıyla, artık ihtiyacınız kalmadığında etiketi temizlemek için setTag(null) öğesini çağırmak sizin sorumluluğunuzdadır.

Parametreler
etiket null ise etiket temizlenir.

herkese açık geçersiz setTransparency (kayan şeffaflığı)

Bu zemin bindirmesinin ş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 bir hareketli değer. Burada 0, zemin bindirmenin opak olduğu, 1 ise zemin bindirmenin şeffaf olduğu anlamına gelir.

herkese açık void setVisible (boolean visible)

Bu zemin bindirmesinin görünürlüğünü ayarlar. Görünür olmadığında, zemin bindirmesi çizilmez ancak diğer tüm özelliklerini korur.

Parametreler
görünür true ise zemin bindirmesi görünür, false ise değildir

herkese açık void setZIndex (float zIndex)

Bu zemin bindirmesinin 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 zemin bindirmesinin z Endeksi