Android için Haritalar SDK'sını kullanarak, yerleşik kullanıcı arayüzü bileşenlerinden hangilerinin haritada görüneceğini ve hangi hareketlere izin verileceğini belirleyerek kullanıcıların haritanızla etkileşim kurma şeklini özelleştirebilirsiniz.
Kod örnekleri
GitHub'daki ApiDemos deposunda, kontrol ve hareket seçeneklerinin kullanımını gösteren bir örnek bulunur:
- UiSettingsDemoActivity: Kotlin örneği
- UiSettingsDemoActivity: Java örneği
Minimum kullanıcı etkileşimi için Basit Mod
Kullanıcı etkileşiminin en aza indirildiği basit bir harita istiyorsanız lite mod harita kullanmayı düşünebilirsiniz. Basit modda, belirli bir konumda ve yakınlaştırma seviyesinde haritanın bit eşlem görüntüsü sunulur. Lite modda kullanıcılar haritayı kaydıramaz veya yakınlaştıramaz ve hareketler çalışmaz. Ayrıntılı bilgi için Lite Modu kılavuzunu inceleyin.
Kullanıcı arayüzü kontrolleri
Haritalar API'si, Android telefonunuzdaki Google Haritalar uygulamasında bulunanlara benzer yerleşik kullanıcı arayüzü kontrolleri sunar. GoogleMap.getUiSettings yöntemiyle GoogleMap öğesinden alınabilen UiSettings sınıfını kullanarak bu kontrollerin görünürlüğünü 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 uygulamadaki kullanıcı arayüzü ayarları demo etkinliğine bakı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 İlk durumu yapılandırma bölümüne bakın.
Her kullanıcı arayüzü kontrolü, haritanın kenarına göre önceden belirlenmiş bir konuma sahiptir.
GoogleMap nesnesine dolgu ekleyerek kontrolleri üst, alt, sol veya sağ kenardan uzaklaştırabilirsiniz.
Yakınlaştırma kontrolleri
Haritalar API'si, haritanın sağ alt köşesinde görünen yerleşik yakınlaştırma kontrolleri sağlar. Bu özellikler varsayılan olarak devre dışıdır ancak UiSettings.setZoomControlsEnabled(true) numaralı telefonu arayarak etkinleştirilebilir.
Pusula
Haritalar API'si, belirli durumlarda haritanın sol üst köşesinde görünen bir pusula grafiği sağlar. Pusula yalnızca kamera, sıfır olmayan bir yatağa veya sıfır olmayan bir eğime sahip olacak şekilde yönlendirildiğinde görünür. Kullanıcı pusulayı tıkladığında kamera, yönü ve eğimi sıfır olan bir konuma (varsayılan yön) geri döner ve pusula kısa süre sonra kaybolur. UiSettings.setCompassEnabled(boolean) numaralı telefonu arayarak pusulanın tamamen görünmesini devre dışı bırakabilirsiniz.
Ancak pusulanın her zaman gösterilmesini zorlayamazsınız.
Konumum düğmesi
Konumum katmanı etkinleştirildiğinde Konumum düğmesi yalnızca ekranın sağ üst köşesinde görünür. Ayrıntılı bilgi için konum verileri kılavuzunu inceleyin.
Seviye seçici
Kullanıcı bir kapalı alan haritasını görüntülerken ekranın sağ tarafının ortasına yakın bir yerde varsayılan olarak kat seçici (zemin seçici) gösterilir. İki veya daha fazla iç mekan haritası görünür olduğunda seviye seçici, şu anda odaklanılan binaya uygulanır. Bu bina genellikle ekranın merkezine en yakın olanıdır. Her binanın varsayılan bir seviyesi vardır. Bu seviye, seçici ilk kez görüntülendiğinde seçilir. Kullanıcılar, seçiciden farklı bir seviye belirleyebilir.
GoogleMap.getUiSettings().setIndoorLevelPickerEnabled(boolean) işlevini çağırarak seviye seçici kontrolünü devre dışı bırakabilir veya etkinleştirebilirsiniz.
Varsayılan seviye seçiciyi kendi seçicinizle değiştirmek istediğinizde bu özellikten yararlanabilirsiniz.
Harita araç çubuğu
Varsayılan olarak, kullanıcı bir işaretçiye dokunduğunda haritanın sağ alt kısmında bir araç çubuğu görünür. Araç çubuğu, kullanıcının Google Haritalar mobil uygulamasına hızlı erişmesini sağlar.
Araç çubuğunu UiSettings.setMapToolbarEnabled(boolean) çağrısı yaparak etkinleştirebilir ve devre dışı bırakabilirsiniz.
Lite modundaki haritalarda araç çubuğu, kullanıcının işlemlerinden bağımsız olarak kalır. Tamamen etkileşimli bir haritada, kullanıcı bir işaretçiye dokunduğunda araç çubuğu kayarak açılır ve işaretçi artık ön planda olmadığında tekrar kayarak kapanır.
Araç çubuğunda, Google Haritalar mobil uygulamasında harita görünümüne veya yol tarifi isteğine erişim sağlayan simgeler gösterilir. 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 içeriğine bağlı olarak ve Google Haritalar mobil uygulaması sonuçtaki amacı desteklediği sürece haritada amaç simgelerinden hiçbiri, biri veya ikisi birden gösterilir.
Harita hareketleri
Android için Haritalar SDK'sı ile oluşturulan bir harita, Google Haritalar uygulamasıyla aynı hareketleri destekler. Ancak, haritanın durumunu korumak için belirli hareketleri devre dışı bırakmak isteyebileceğiniz durumlar olabilir. Yakınlaştırma, kaydırma, yatırma ve yön de programatik olarak ayarlanabilir. Daha fazla bilgi için Kamera ve Görünüm başlıklı makaleyi inceleyin. Hareketleri devre dışı bırakmanın, kamera konumunu programatik olarak değiştirip değiştiremeyeceğinizi etkilemediğini unutmayın.
Kullanıcı arayüzü kontrollerinde olduğu gibi, GoogleMap.getUiSettings işlevini çağırarak GoogleMap öğesinden elde edilebilen UiSettings sınıfıyla hareketleri etkinleştirebilir/devre dışı bırakabilirsiniz. Bu sınıfta yapılan değişiklikler haritaya anında yansıtılır. Bu özelliklerin bir örneğini görmek için örnek uygulamadaki kullanıcı arayüzü ayarları demo etkinliğine bakın (nasıl yükleneceğini öğrenmek için buraya bakın).
Bu seçenekleri, 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 Haritayı yapılandırma bölümüne bakın.
Yakınlaştırma hareketleri
Harita, kameranın yakınlaştırma seviyesini değiştirebilen çeşitli hareketlere yanıt verir:
- Yakınlaştırma seviyesini 1 artırmak için iki kez dokunun (yakınlaştırma).
- Yakınlaştırma seviyesini 1 azaltmak için iki parmağınızla dokunun (uzaklaştırma).
- İki parmakla sıkıştırma/uzatma
- İki kez dokunarak tek parmakla yakınlaştırma. İkinci dokunuşta parmağı bırakmadan uzaklaştırmak için yukarı, yakınlaştırmak için aşağı kaydırın.
UiSettings.setZoomGesturesEnabled(boolean) işlevini çağırarak yakınlaştırma hareketlerini devre dışı bırakabilirsiniz. Bu ayar, kullanıcıların yakınlaştırma ve uzaklaştırma kontrollerini kullanıp kullanamayacağını etkilemez.
Kaydırma hareketleri
Kullanıcılar, haritayı parmaklarıyla sürükleyerek haritada kaydırma (pan) yapabilir.
UiSettings.setScrollGesturesEnabled(boolean) işlevini çağırarak kaydırmayı devre dışı bırakabilirsiniz.
Eğim hareketleri
Kullanıcılar, haritaya iki parmağını yerleştirip eğim açısını artırmak veya azaltmak için parmaklarını birlikte aşağı ya da yukarı hareket ettirerek haritayı eğebilir. UiSettings.setTiltGesturesEnabled(boolean) işlevini çağırarak eğme hareketlerini devre dışı bırakabilirsiniz.
Döndürme hareketleri
Kullanıcılar, haritaya iki parmağını yerleştirip döndürme hareketi yaparak haritayı döndürebilir. UiSettings.setRotateGesturesEnabled(boolean) işlevini çağırarak döndürmeyi devre dışı bırakabilirsiniz.