Android için Haritalar SDK'sını kullanarak, yerleşik kullanıcı arayüzü bileşenlerinden hangilerinin harita üzerinde görüneceğini ve hangi hareketlere izin verildiğini belirleyerek kullanıcıların haritanızla etkileşimde bulunma şeklini özelleştirebilirsiniz.
Kod örnekleri
GitHub'daki ApiDemos deposu, kontrol ve hareket seçeneklerinin kullanımını gösteren bir örnek içerir:
- UiSettingsDemoActivity: Java örneği
- UiSettingsDemoActivity: Kotlin örneği
Minimum kullanıcı etkileşimi için basit mod
Minimum düzeyde kullanıcı etkileşimi içeren basit bir harita kullanmak isterseniz basit modu kullanabilirsiniz. Basit mod, bir haritanın belirtilen konum ve yakınlaştırma düzeyinde bit eşlem görüntüsünü sunar. Basit modda kullanıcılar haritayı kaydıramaz veya yakınlaştıramaz ve hareketler çalışmaz. Ayrıntılı bilgi için Basit mod rehberini inceleyin.
Kullanıcı arayüzü kontrolleri
Maps API, Android telefonunuzdaki Google Haritalar uygulamasında bulunanlara benzer yerleşik kullanıcı arayüzü kontrolleri sunar. Bu denetimlerin görünürlüğünü, GoogleMap.getUiSettings yöntemiyle bir GoogleMap ürününden alınabilen UiSettings sınıfını kullanarak değiştirebilirsiniz. Bu sınıfta yapılan değişiklikler haritaya hemen yansıtılır. Bu özelliklerin bir örneğini görmek için örnek uygulamada kullanıcı arayüzü ayarları demo etkinliğine göz atın.
Bu seçeneklerin çoğunu, harita XML özellikleri aracılığıyla veya GoogleMapOptions sınıfı kullanılarak oluşturulduğunda da yapılandırabilirsiniz. Daha fazla bilgi için Başlangıç durumunu yapılandırma başlıklı makaleye bakın.
Her kullanıcı arayüzü kontrolü, haritanın kenarına göre önceden belirlenmiş bir konuma sahiptir.
GoogleMap nesnesine dolgu ekleyerek denetimleri üst, alt, sol veya sağ kenardan uzağa taşıyabilirsiniz.
Yakınlaştırma kontrolleri
Haritalar API'sı, haritanın sağ alt köşesinde görünen yerleşik yakınlaştırma kontrolleri sağlar. Bunlar varsayılan olarak devre dışıdır ancak UiSettings.setZoomControlsEnabled(true) çağırılarak etkinleştirilebilir.
Pusula
Maps API, belirli koşullarda haritanın sol üst köşesinde yer alan pusula grafiğini sunar. Pusula yalnızca kameranın sıfır veya eğimsiz eğimi olacak şekilde yerleştirildiğinde görünür. Kamera pusulayı tıkladığında, kamera pozisyon ve yatağı sıfır olan (varsayılan yön) pozisyona geri döner ve kısa bir süre sonra pusula kaybolur. Pusulanın görünmesini tamamen engellemek için UiSettings.setCompassEnabled(boolean) yöntemini çağırabilirsiniz.
Ancak pusulayı her zaman gösterilmeye zorlayamazsınız.
Konumum düğmesi
Konumum düğmesi, ekranın sağ üst köşesinde yalnızca Konumum katmanı etkinleştirildiğinde görünür. Ayrıntılar için konum verileri kılavuzuna göz atın.
Seviye seçici
Varsayılan olarak, kullanıcı bir iç mekan haritasını görüntülerken ekranın sağ üst köşesinin yanında bir seviye seçici (kat seçici) görünür. İki veya daha fazla iç mekan haritası görünür olduğunda, seviye seçici, şu anda odakta olan ve genellikle ekranın ortasına en yakın binaya uygulanır. Her binanın seçici düzeyi, ilk görüntülendiğinde seçilecek olan bir varsayılan düzeyidir. Kullanıcılar, seçiciden farklı bir seviye seçebilir.
GoogleMap.getUiSettings().setIndoorLevelPickerEnabled(boolean) numaralı telefonu arayarak seviye seçici kontrolünü devre dışı bırakabilir veya etkinleştirebilirsiniz.
Bu, varsayılan seviye seçiciyi kendi düzeyinizle değiştirmek istediğinizde yararlı olur.
Harita araç çubuğu
Varsayılan olarak, bir kullanıcı işaretçiye dokunduğunda haritanın sağ alt köşesinde bir araç çubuğu görünür. Araç çubuğu, kullanıcının Google Haritalar mobil uygulamasına hızlı bir şekilde erişmesini sağlar.
UiSettings.setMapToolbarEnabled(boolean) numaralı telefonu arayarak araç çubuğunu
etkinleştirebilir ve devre dışı bırakabilirsiniz.
Basit mod eşlemelerinde araç çubuğu, kullanıcının eylemlerinden bağımsız olarak varlığını sürdürür. Tamamen etkileşimli haritada, kullanıcı bir işaretçiye dokunduğunda araç çubuğu yukarı kaydırılır ve işaretçi artık odakta olmadığında tekrar dışarı çıkar.
Araç çubuğu, Google Haritalar mobil uygulamasında bir harita görünümüne veya yol tarifi isteğine erişim sağlayan simgeler gösterir. Bir kullanıcı, araç çubuğundaki bir simgeye dokunduğunda API, Google Haritalar mobil uygulamasında ilgili etkinliği başlatmak için bir amaç oluşturur.
Araç çubuğu, yukarıdaki ekran görüntüsünde haritanın sağ alt kısmında görünür. Haritanın amacına bağlı olarak, Google Haritalar mobil uygulamasının ortaya çıkan amacı desteklemesi koşuluyla, amaç simgelerinden biri veya her ikisi birden harita üzerinde görünür.
<queries>
Harita hareketleri
Android için Haritalar SDK'sı ile oluşturulan bir harita, Google Haritalar uygulamasıyla aynı hareketleri destekler. Bununla birlikte, haritanın durumunu korumak için belirli hareketleri devre dışı bırakmak istediğiniz durumlar olabilir. Yakınlaştırma, kaydırma, eğme ve dayanma ayarı programatik olarak da yapılabilir. Daha fazla bilgi için Kamera ve Görünüm bölümüne göz atın. Hareketleri devre dışı bırakmanın kamera konumunu programatik olarak değiştirip değiştiremeyeceğinizi etkilemez.
Kullanıcı arayüzü kontrollerinde olduğu gibi, GoogleMap.getUiSettings çağırarak GoogleMap üzerinden elde edilebilen UiSettings sınıfıyla hareketleri etkinleştirebilir veya devre dışı bırakabilirsiniz. Bu sınıfta yapılan değişiklikler haritaya hemen yansıtılır. Bu özelliklerin bir örneğini görmek için örnek uygulamadaki kullanıcı arayüzü ayarları demo etkinliğine göz atın (uygulamanın nasıl yükleneceğini burada görebilirsiniz).
Bu seçenekleri, harita XML Özellikleri veya GoogleMapOptions sınıfı kullanılarak oluşturulduğunda da yapılandırabilirsiniz.
Daha ayrıntılı bilgi için Haritayı yapılandırma konusuna bakın.
Yakınlaştırma hareketleri
Harita, kameranın yakınlaştırma düzeyini değiştirebilecek çeşitli hareketlere yanıt verir:
- Yakınlaştırma düzeyini 1 artırmak için iki kez dokunun (yakınlaştırın).
- Yakınlaştırma düzeyini 1 azaltmak (uzaklaştırmak) için iki parmağınızla dokunun.
- İki parmağınızı sıkıştırın/esnet
- Bir kez iki kez dokunma, ancak ikinci kez bırakmadan bırakma ve daha sonra, parmağınızı yukarı kaydırarak görüntüyü uzaklaştırabilir, aşağı doğru kaydırarak yakınlaştırabilirsiniz.
UiSettings.setZoomGesturesEnabled(boolean) numarasını arayarak yakınlaştırma hareketlerini devre dışı bırakabilirsiniz. Bu durum, kullanıcının yakınlaştırma ve uzaklaştırma denetimlerini kullanıp kullanamayacağını etkilemez.
Kaydırma (kaydırma) hareketleri
Bir kullanıcı, haritayı parmağınızla sürükleyerek haritayı kaydırabilir (kaydırabilir).
UiSettings.setScrollGesturesEnabled(boolean) numaralı telefonu arayarak kaydırma özelliğini devre dışı bırakabilirsiniz.
Yatırma hareketleri
Bir kullanıcı, eğim açısını artırmak veya azaltmak için iki parmağınızı haritaya koyup aşağı veya yukarı hareket ettirerek haritayı yatırabilir. Eğme hareketlerini UiSettings.setTiltGesturesEnabled(boolean) çağırarak devre dışı bırakabilirsiniz.
Hareketleri döndür
Bir kullanıcı, iki parmağınızı haritaya yerleştirip bir döndürme hareketi uygulayarak haritayı döndürebilir. UiSettings.setRotateGesturesEnabled(boolean) numaralı telefonu arayarak rotasyonu devre dışı bırakabilirsiniz.