Android için Haritalar SDK'sı sayesinde, haritada yerleşik olarak bulunan kullanıcı arayüzü bileşenlerinden hangilerinin görüneceğini ve hangi hareketlere izin verileceğ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: Kotlin örneği
- UiSettingsDemoActivity: Java örneği
Minimum kullanıcı etkileşimi için Basit mod
Minimum kullanıcı etkileşiminin olduğu hafif bir harita istiyorsanız basit modda harita kullanabilirsiniz. Basit mod, bir haritanın belirli bir konum ve yakınlaştırma düzeyinde bit eşlemsel bir görüntüsünü sunar. Basit modda kullanıcılar haritayı kaydıramaz veya yakınlaştıramaz, 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. GoogleMap.getUiSettings yöntemi ile bir GoogleMap öğesinden elde edilebilen UiSettings sınıfını kullanarak bu denetimlerin 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 veya GoogleMapOptions sınıfı aracılığıyla 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ünün, haritanın kenarına göre önceden belirlenmiş bir konumu vardır.
GoogleMap nesnesine dolgu ekleyerek denetimleri üst, alt, sol veya sağ kenardan uzağa taşıyabilirsiniz.
Zum denetimleri
Maps API, 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ısı yapılarak etkinleştirilebilir.
Pusula
Google Maps API, belirli koşullar altında haritanın sol üst köşesinde görünen bir pusula grafiği sağlar. Pusula yalnızca kameranın yönü sıfır veya sıfır olmayan bir yöne sahip olduğunda görünür. Kullanıcı pusulayı tıkladığında, kamera hareket ettirerek yatağın bulunduğu bir konuma (varsayılan yön) döner ve kısa bir süre sonra pusula kaybolur. UiSettings.setCompassEnabled(boolean) numaralı telefonu arayarak pusulanın
görünmesini tamamen devre dışı bırakabilirsiniz.
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 rehberini inceleyin.
Seviye seçici
Varsayılan olarak, kullanıcı bir iç mekan haritasını görüntülerken ekranın sağ orta kenarının yakını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, o anda odakta olan binaya uygulanır. Bu, genellikle ekranın ortasına en yakın olan binadır. Her binanın, seçici ilk kez gösterildiğinde seçilecek varsayılan bir seviye vardır. Kullanıcılar, seçiciden seçerek farklı bir seviye belirleyebilirler.
Seviye seçici denetimini devre dışı bırakmak veya etkinleştirmek için GoogleMap.getUiSettings().setIndoorLevelPickerEnabled(boolean) kodunu çağırabilirsiniz.
Bu, varsayılan düzey seçiciyi kendi düzeyinizle değiştirmek istediğinizde kullanışlıdır.
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.
UiSettings.setMapToolbarEnabled(boolean) işlevini çağırarak araç çubuğunu etkinleştirebilir ve devre dışı bırakabilirsiniz.
Basit mod haritalarında araç çubuğu, kullanıcının işlemlerinden bağımsız olarak kalır. Tam etkileşimli bir haritada, kullanıcı bir işaretçiye dokunduğunda araç çubuğu içeri girer ve işaretçi artık odaklamadığında yeniden dışarı kaydırılı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örüntülenir. Bir kullanıcı araç çubuğundaki bir simgeye dokunduğunda API, ilgili etkinliği Google Haritalar mobil uygulamasında başlatma amacı oluşturur.
Araç çubuğu, yukarıdaki ekran görüntüsünde haritanın sağ alt köşesinde görülebilir. Haritanın içeriğine bağlı olarak ve Google Haritalar mobil uygulamasının sonuçtaki amacı desteklemesi koşuluyla, harita üzerinde sıfır, amaç simgelerinden biri veya her ikisi de görünür.
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 isteyebilirsiniz. Yakınlaştırma, kaydırma, yatırma ve taşıma özellikleri de programatik olarak ayarlanabilir. Daha fazla ayrıntı için Kamera ve Görünüm bölümüne bakın. 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 çağırarak bir GoogleMap öğesinden edinilebilecek 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 buradan öğrenebilirsiniz).
Bu seçenekleri, harita XML Özellikleri veya GoogleMapOptions sınıfını kullanarak 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 (yakınlaştırma) için iki kez dokunun.
- Yakınlaştırma düzeyini 1 azaltmak için (uzaklaştırma) iki parmağınızla dokunun.
- İki parmağınızı sıkıştırma/esneme
- Bir parmakla yakınlaştırma yapılır. Sonra da ikinci vuruşta parmakla dokunulmaz, bıraklanmaz ve uzaklaştırmak için parmağınızı yukarıya, yakınlaştırmak için parmağınızı aşağı kaydırırsınız.
UiSettings.setZoomGesturesEnabled(boolean) numaralı telefonu arayarak yakınlaştırma hareketlerini devre dışı bırakabilirsiniz. Bu, kullanıcının yakınlaştırmak ve uzaklaştırmak için
yakınlaştırma kontrollerini kullanıp kullanamayacağını etkilemez.
Kaydırma (kaydırma) hareketleri
Bir kullanıcı, haritayı parmağıyla sürükleyerek haritayı kaydırabilir (kaydırabilir).
UiSettings.setScrollGesturesEnabled(boolean) numaralı telefonu arayarak kaydırmayı devre dışı bırakabilirsiniz.
Yatırma hareketleri
Kullanıcı, iki parmağını haritaya yerleştirip yatırma açısını artırmak veya azaltmak için birlikte aşağı veya yukarı hareket ettirerek haritayı yatırabilir. UiSettings.setTiltGesturesEnabled(boolean) numaralı telefonu arayarak yatırma hareketlerini devre dışı bırakabilirsiniz.
Döndürme hareketleri
Kullanıcılar, iki parmağını haritaya yerleştirip bir döndürme hareketi uygulayarak haritayı döndürebilir. Rotasyonu devre dışı bırakmak için UiSettings.setRotateGesturesEnabled(boolean) yöntemini çağırabilirsiniz.