Basit Mod

Android için Haritalar SDK'sı, kullanıcılara sınırlı etkileşim olanağı sunarak haritanın bit eşlem görüntüsünü yayınlayabilir. Buna lite mod harita denir.

Kod örnekleri

GitHub'daki ApiDemos deposunda, lite modunun kullanımını gösteren örnekler yer alır:

• LiteDemoActivity - Java: Java'da basit mod haritası kullanmanın temelleri
• LiteDemoActivity - Kotlin: Kotlin'de basit mod haritası kullanmanın temelleri
• LiteListDemoActivity - Java: Java'da basit modu kullanarak ListView'larda haritaları verimli bir şekilde görüntüleme
• LiteListDemoActivity - Kotlin: Kotlin'de basit modu kullanarak ListView'lerde haritaları verimli bir şekilde görüntüleme

Basit moda genel bakış

Basit mod harita, belirli bir konumda ve yakınlaştırma düzeyinde haritanın bit eşlem görüntüsüdür. Lite modu, tüm harita türlerini (normal, karma, uydu, arazi) ve tam API'nin sağladığı işlevlerin bir alt kümesini destekler. Lite modu, bir akışta birden fazla harita veya anlamlı etkileşimi destekleyemeyecek kadar küçük bir harita sağlamak istediğinizde kullanışlıdır.

Haritayı görüntüleyen kullanıcılar haritayı yakınlaştıramaz veya kaydıramaz. Haritadaki simgeler, kullanıcıların Google Haritalar mobil uygulamasında haritayı görüntülemesine ve yol tarifi istemesine olanak tanır.

Basit mod haritası ekleme

Basit mod, Google Haritalar Android API'sinin tam sürümüyle aynı sınıfları ve arayüzleri kullanır. Aşağıdaki yöntemlerle GoogleMap'ı Lite moduna ayarlayabilirsiniz:

• MapView veya MapFragment için bir XML özelliği olarak
• Veya GoogleMapOptions nesnesinde

MapView veya MapFragment için XML özelliği olarak

<fragment xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:map="http://schemas.android.com/apk/res-auto"
    android:name="com.google.android.gms.maps.MapFragment"
    android:id="@+id/map"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    map:cameraZoom="13"
    map:mapType="normal"
    map:liteMode="true"/>

GoogleMapOptions nesnesinde

val options = GoogleMapOptions()
    .liteMode(true)

      

GoogleMapOptions options = new GoogleMapOptions()
    .liteMode(true);

      

Haritanın başlangıç durumunu ayarlama hakkında ayrıntılı bilgi için harita nesnesi kılavuzuna bakın.

Harita görünümü başlatma veya yol tarifi isteği intent'leri

Varsayılan olarak, haritanın sağ alt kısmındaki araç çubuğunda Google Haritalar mobil uygulamasında harita görünümüne veya yol tarifi isteğine erişim sağlayan simgeler bulunur. UiSettings.setMapToolbarEnabled(false) işlevini çağırarak araç çubuğunu devre dışı bırakabilirsiniz. Daha fazla bilgi için araç çubuğu belgelerine bakın.

Ayrıca, kullanıcı haritaya dokunduğunda API varsayılan olarak Google Haritalar mobil uygulamasını başlatır. Kendi dinleyicinizi ayarlamak için GoogleMap.setOnMapClickListener() kullanarak bu davranışı geçersiz kılabilirsiniz. MapView veya MapFragment içeren görünümde setClickable() çağrısı yaparak haritadaki tıklama etkinliklerini de devre dışı bırakabilirsiniz. Bu iki teknikle ilgili ayrıntılar için etkinlik belgelerine bakın.

Yaşam döngüsü olayları

API'yi tamamen etkileşimli modda kullanırken MapView sınıfının kullanıcıları, tüm etkinlik yaşam döngüsü yöntemlerini MapView sınıfındaki ilgili yöntemlere yönlendirmelidir. Yaşam döngüsü yöntemlerine örnek olarak onCreate(), onDestroy(), onResume() ve onPause() verilebilir.

Lite modunda MapView sınıfı kullanılırken aşağıdaki durumlar hariç yaşam döngüsü etkinliklerinin yönlendirilmesi isteğe bağlıdır:

• onCreate() işlevinin çağrılması zorunludur. Aksi takdirde harita görünmez.
• Lite mod haritanızda Konumum noktasını göstermek ve varsayılan konum kaynağını kullanmak istiyorsanız onResume() ve onPause() işlevlerini çağırmanız gerekir. Konum kaynağı yalnızca bu çağrılar arasında güncellenir. Kendi konum kaynağınızı kullanıyorsanız bu iki yöntemi çağırmanız gerekmez.

Desteklenen API özellikleri

Aşağıdaki tabloda, API işlevselliğinin her alanı için basitleştirilmiş mod haritasının davranışı açıklanmaktadır. Bir uygulama, lite modda desteklenmeyen bir yöntemi çağırırsa API bir uyarı mesajı kaydeder.