Zemin Bindirmeleri

Platform seçin: Android iOS JavaScript

Zemin bindirmeleri, enlem/boylam koordinatlarına bağlı görüntü bindirmeleridir, dolayısıyla haritayı sürüklediğinizde veya yakınlaştırdığınızda hareket eder.

Kod örnekleri

GitHub'daki ApiDemos deposu, zemin bindirmelerini gösteren bir örnek içerir:

Giriş

Zemin bindirme, bir haritaya sabitlenmiş bir görüntüdür. İşaretçilerden farklı olarak, yer örtüleri ekrana değil, Dünya yüzeyine yönlendirilir. Bu nedenle, haritayı döndürmek, eğmek veya yakınlaştırmak resmin yönünü değiştirir. Zemin bindirmeleri, harita üzerinde bir alandaki tek bir görüntüyü düzeltmek istediğinizde kullanışlıdır. Haritanın büyük bir bölümünü kaplayan kapsamlı görüntüler eklemek istiyorsanız Karo yer paylaşımı seçeneğini değerlendirmelisiniz.

Yer paylaşımı ekle

GroundOverlay eklemek için hem resim hem de konum tanımlayan bir GroundOverlayOptions nesnesi oluşturun. İsteğe bağlı olarak, resmin haritadaki konumunu etkileyecek ek ayarlar belirtebilirsiniz. Gerekli seçenekleri tanımladıktan sonra, resmi haritaya eklemek için nesneyi GoogleMap.addGroundOverlay() yöntemine iletin. addGroundOverlay() yöntemi bir GroundOverlay nesnesi döndürür. Daha sonra değiştirmek isterseniz bu nesnenin referansını tutmanız gerekir.

Adım adım:

  1. Yeni bir GroundOverlayOptions nesnesini örneklendir
  2. Resmi BitmapDescriptor olarak belirtin.
  3. Mevcut yöntemlerden birini kullanarak resmin konumunu ayarlayın:
    • position(LatLng location, float width, float height)
    • position(LatLng location, float width)
    • positionFromBounds(LatLngBounds bounds)
  4. transparency gibi isteğe bağlı özellikleri istediğiniz gibi ayarlayın.
  5. Resmi haritaya eklemek için GoogleMap.addGroundOverlay() adlı kişiyi arayın.

Aşağıdaki örnekte, mevcut bir GoogleMap nesnesine zemin bindirmesinin nasıl ekleneceği gösterilmektedir.

Kotlin



val newarkLatLng = LatLng(40.714086, -74.228697)
val newarkMap = GroundOverlayOptions()
    .image(BitmapDescriptorFactory.fromResource(R.drawable.newark_nj_1922))
    .position(newarkLatLng, 8600f, 6500f)
map.addGroundOverlay(newarkMap)

Java


LatLng newarkLatLng = new LatLng(40.714086, -74.228697);

GroundOverlayOptions newarkMap = new GroundOverlayOptions()
    .image(BitmapDescriptorFactory.fromResource(R.drawable.newark_nj_1922))
    .position(newarkLatLng, 8600f, 6500f);
map.addGroundOverlay(newarkMap);

Bir zemin bindirmesini haritaya ekledikten sonra değiştirmek veya kaldırmak isterseniz GroundOverlay nesnesini elinizde tuttuğunuzdan emin olun. Daha sonra bu nesnede değişiklik yaparak bindirmeyi değiştirebilirsiniz.

Kotlin



// Add an overlay to the map, retaining a handle to the GroundOverlay object.
val imageOverlay = map.addGroundOverlay(newarkMap)

Java


// Add an overlay to the map, retaining a handle to the GroundOverlay object.
GroundOverlay imageOverlay = map.addGroundOverlay(newarkMap);

Yer paylaşımını kaldırma

Zemin bindirmeyi GroundOverlay.remove() yöntemini kullanarak kaldırabilirsiniz.

Kotlin



imageOverlay?.remove()

Java


imageOverlay.remove();

Yer paylaşımını değiştirme

Zemin bindirme görüntüsünü, haritaya eklendikten sonra GroundOverlay.setImage(BitmapDescriptor) yöntemiyle değiştirebilirsiniz.

Kotlin



// Update the GroundOverlay with a new image of the same dimension

// Update the GroundOverlay with a new image of the same dimension
imageOverlay?.setImage(BitmapDescriptorFactory.fromResource(R.drawable.newark_nj_1922))

Java


// Update the GroundOverlay with a new image of the same dimension
imageOverlay.setImage(BitmapDescriptorFactory.fromResource(R.drawable.newark_nj_1922));

setImage() yöntemi, mevcut resmi aynı boyutlardaki başka bir resimle değiştirir.

Zemin Bindirmesini Konumlandırma

Zemin bindirmenin konumunu belirtmenin iki yolu vardır:

  • Bindirmeyi ortalamak için LatLng ve resmin boyutunu belirtmek için boyutları metre cinsinden kullanma.
  • Resmin kuzeydoğu ve güneybatı köşelerini belirtmek için bir LatLngBounds kullanma.

Zemin bindirmenin haritaya eklenmeden önce konumunu belirtmeniz gerekir.

Resmi konumlandırmak için konumu kullan

Resmi eklerken, sabitin sabitleneceği enlBoy değeri ve bindirmenin genişliğini (metre cinsinden) belirtirsiniz. anchor varsayılan olarak resmin ortasına ayarlanır. İsteğe bağlı olarak yer paylaşımının yüksekliğini (metre cinsinden) girebilirsiniz. Yer paylaşımının yüksekliğini belirtmezseniz resmin oranları korunacak şekilde otomatik olarak hesaplanır.

Aşağıdaki kod, 8,6 km genişliğinde ve 6,5 km yüksekliğindeki bir resmi 40.714086, -74.228697 konumuna yerleştirir. Resim, sol alta sabitlenir.

Kotlin



val newarkMap = GroundOverlayOptions()
    .image(BitmapDescriptorFactory.fromResource(R.drawable.newark_nj_1922))
    .anchor(0f, 1f)
    .position(LatLng(40.714086, -74.228697), 8600f, 6500f)

Java


GroundOverlayOptions newarkMap = new GroundOverlayOptions()
    .image(BitmapDescriptorFactory.fromResource(R.drawable.newark_nj_1922))
    .anchor(0, 1)
    .position(new LatLng(40.714086, -74.228697), 8600f, 6500f);

Bir resmi konumlandırmak için EnlLngBounds'u kullanma

Resmin bulunduğu bir LatLngBounds sağlarsınız. LatLngBounds, resmin kuzeydoğu ve güneybatı köşelerini belirler. Resim, harita üzerinde çizildiğinde sınırlara uyacak şekilde döndürülür. Sınırlar orijinal en boy oranıyla eşleşmezse resim eğilir.

Aşağıdaki kod, Güneybatı köşesi 40.712216,-74.22655 ve Kuzey Doğu köşesi 40.773941, -74.12544'e bağlı olacak şekilde haritaya bir resim yerleştirir.

Kotlin



val newarkBounds = LatLngBounds(
    LatLng(40.712216, -74.22655),  // South west corner
    LatLng(40.773941, -74.12544)   // North east corner
)
val newarkMap = GroundOverlayOptions()
    .image(BitmapDescriptorFactory.fromResource(R.drawable.newark_nj_1922))
    .positionFromBounds(newarkBounds)

Java


LatLngBounds newarkBounds = new LatLngBounds(
    new LatLng(40.712216, -74.22655),       // South west corner
    new LatLng(40.773941, -74.12544));      // North east corner
GroundOverlayOptions newarkMap = new GroundOverlayOptions()
    .image(BitmapDescriptorFactory.fromResource(R.drawable.newark_nj_1922))
    .positionFromBounds(newarkBounds);

Verileri bir zemin bindirmesiyle ilişkilendirin

Zemin bindirmeli rastgele bir veri nesnesini depolamak ve GroundOverlay.getTag() aracılığıyla veri nesnesini almak için GroundOverlay.setTag() yöntemini çağırabilirsiniz.

Aşağıdaki kod örneğinde, zemin yer paylaşımı içeren bir dize açıklaması depolanır:

Kotlin



val sydneyGroundOverlay = map.addGroundOverlay(
    GroundOverlayOptions()
        .image(BitmapDescriptorFactory.fromResource(R.drawable.harbour_bridge))
        .position(LatLng(-33.873, 151.206), 100f)
        .clickable(true)
)
sydneyGroundOverlay?.tag = "Sydney"

Java


GroundOverlay sydneyGroundOverlay = map.addGroundOverlay(new GroundOverlayOptions()
    .image(BitmapDescriptorFactory.fromResource(R.drawable.harbour_bridge))
    .position(new LatLng(-33.873, 151.206), 100)
    .clickable(true));

sydneyGroundOverlay.setTag("Sydney");

Aşağıda, zemin bindirmeleri yardımıyla veri depolamanın ve almanın yararlı olduğu senaryolara dair bazı örnekler verilmiştir:

  • Uygulamanız farklı zemin bindirmelerine yönelik olabilir ve kullanıcı bunları tıkladığında farklı şekilde ele almak istersiniz.
  • Benzersiz kayıt tanımlayıcıları olan bir sistemle çalışıyor olabilirsiniz. Yer paylaşımları, sistemdeki belirli kayıtları temsil eder.
  • Yer paylaşımlı verileri, yer paylaşımı için Z-endeksini belirleme önceliğini gösterebilir.

Zemin bindirme etkinliklerini işleme

Varsayılan olarak, zemin bindirmeleri tıklanamaz. GroundOverlay.setClickable(boolean) yöntemini çağırarak tıklanabilirliği etkinleştirebilir ve devre dışı bırakabilirsiniz.

Tıklanabilir zemin bindirmesi üzerinde tıklama etkinliklerini dinlemek için OnGroundOverlayClickListener kullanın. Bu işleyiciyi haritada ayarlamak için GoogleMap.setOnGroundOverlayClickListener(OnGroundOverlayClickListener) numaralı telefonu arayın. Bir kullanıcı zemin bindirmesini tıkladığında onGroundOverlayClick(GroundOverlay) geri arama alırsınız.