Kullanıcıların haritanızla etkileşime geçmesine izin verme

Aşağıdaki şablonları kullanırken, kullanıcıların çizdiğiniz haritalarla etkileşime girmesini sağlayabilirsiniz. Örneğin, yakınlaştırma ve kaydırma yaparak haritanın farklı bölümlerini görmelerine izin verebilirsiniz.

Şablon Araba Uygulaması API düzeyi desteği
NavigationTemplate 2

PlaceListNavigationTemplate

(kullanımdan kaldırıldı)

4

RoutePreviewNavigationTemplate

(kullanımdan kaldırıldı)

4

MapTemplate

(kullanımdan kaldırıldı)

5 (şablon kullanıma sunuldu)
MapWithContentTemplate 7 (şablon kullanıma sunuldu)

Etkileşim geri çağırmalarını uygulama

SurfaceCallback arayüzünde, önceki bölümde yer alan şablonlarla oluşturulan haritalara etkileşim eklemek için uygulayabileceğiniz çeşitli geri çağırma yöntemleri bulunur:

Etkileşim Yöntem Araba Uygulaması API düzeyi desteği
Dokunun onClick 5
Yakınlaştırmak için sıkıştırın onScale 2
Tek dokunuşla sürükleme onScroll 2
Tek dokunuşla aktarma onFling 2
İki kez dokunun

onScale

(template host determines scale factor)

2
Kaydırma modunda döndürerek sürükleme

onScroll

(şablonun barındırıldığı yer, mesafe faktörünü belirler)

2

Harita işlem şeridi ekleme

Bu şablonlarda, haritayla ilgili işlemler (ör. yakınlaştırma ve uzaklaştırma, yeniden ortalama, pusula gösterme) için harita işlem şeridi bulunabilir. Ayrıca, göstermeyi seçtiğiniz diğer işlemler de bu şeritte yer alabilir. Harita işlem şeridinde, görev derinliğini etkilemeden yenilenebilen en fazla dört simge içeren düğme bulunabilir. İşlem şeridi, boşta durumdayken gizlenir ve etkin durumdayken yeniden görünür.

Harita etkileşim geri aramaları almak için harita işlem şeridine Action.PAN düğme eklemeniz gerekir. Kullanıcı Kaydırma düğmesine bastığında, Kaydırma modunu anlama başlıklı makalede açıklandığı gibi, sunucu kaydırma moduna girer.

Uygulamanız harita işlem şeridinde Action.PAN düğmesini atlıyorsa SurfaceCallback yöntemlerinden kullanıcı girişi almaz ve ana makine, daha önce etkinleştirilmiş tüm kaydırma modlarını kapatır.

Dokunmatik ekranda Kaydırma düğmesi gösterilmez.

Kaydırma modunu anlama

Kaydırma modunda, şablon ana makinesi, çevirmeli kontrol cihazları ve dokunmatik yüzeyler gibi dokunmatik olmayan giriş cihazlarından gelen kullanıcı girişini uygun SurfaceCallback yöntemlerine çevirir. Kullanıcının kaydırma moduna girme veya kaydırma modundan çıkma işlemine NavigationTemplate.Builder içindeki setPanModeListener yöntemiyle yanıt verin. Kullanıcı pan modundayken düzenleyen, şablondaki diğer kullanıcı arayüzü bileşenlerini gizleyebilir.