Basit Mod

Android için Haritalar SDK'sı, haritanın bitmap resmini sunarak kullanıcıya sınırlı etkileşim sunar. Buna basit mod haritası denir.

Kod örnekleri

GitHub'daki ApiDemos deposu, basit modun kullanımını gösteren örnekler içerir:

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

Basit moda genel bakış

Basit mod haritası, belirli bir konum ve yakınlaştırma düzeyindeki bir haritanın bitmap görüntüsüdür. Basit mod, tüm harita türlerini (normal, karma, uydu, arazi) ve tam API tarafından sağlanan işlevlerin bir alt kümesini destekler. Basit mod, bir yayında birden fazla harita sağlamak veya anlamlı etkileşimi destekleyemeyecek kadar küçük bir harita sunmak 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 haritayı Google Haritalar mobil uygulamasında görüntülemelerine ve yol tarifi istemelerine 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. GoogleMap'yi aşağıdaki şekillerde basit moda ayarlayabilirsiniz:

• MapView veya MapFragment için 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 ilk durumunu ayarlama hakkında ayrıntılı bilgi için harita nesnesi kılavuzuna bakın.

Harita görünümü veya yol tarifi isteği başlatma 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) kodunu ç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 ayarı geçersiz kılabilirsiniz. MapView veya MapFragment içeren görünümde setClickable()'ü çağırarak da haritadaki tıklama etkinliklerini devre dışı bırakabilirsiniz. Bu iki tekniğin ayrıntıları için etkinliklerle ilgili belgelere bakın.

Yaşam döngüsü olayları

API'yi tam 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.

MapView sınıfı basit modda kullanıldığında, yaşam döngüsü etkinliklerini yönlendirme aşağıdaki durumlar hariç isteğe bağlıdır:

• onCreate() çağrılması zorunludur. Aksi takdirde harita gösterilmez.
• Basit mod haritanızda Konumum noktasını göstermek ve varsayılan konum kaynağını kullanmak istiyorsanız onResume() ve onPause() çağrılarını yapmanız gerekir. Çünkü 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 basit mod haritasının davranışı açıklanmaktadır. Bir uygulama, basit modda desteklenmeyen bir yöntemi çağırırsa API bir uyarı mesajı günlüğe kaydeder.