Basit Mod

Android için Haritalar SDK'sı haritanın bit eşlem resmini sunarak kullanıcıya sınırlı etkileşim sunabilir. Bu harita, basit mod haritası olarak adlandırılır.

Kod örnekleri

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

Basit moda genel bakış

Basit mod haritası, belirli bir konum ve yakınlaştırma düzeyindeki bir haritanın bit eşlem 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 akışta çok sayıda harita veya anlamlı etkileşimi destekleyemeyecek kadar küçük bir harita sağlamak istediğinizde yararlı olur.

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üleme ve yol tarifi isteme erişimi verir.

Basit mod haritası ekleme

Basit mod, tam Google Haritalar Android API'si ile aynı sınıfları ve arayüzleri kullanır. Aşağıdaki yöntemleri kullanarak GoogleMap cihazını 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

Kotlin



val options = GoogleMapOptions()
    .liteMode(true)

Java


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

Haritanın ilk durumunu ayarlama hakkında ayrıntılı bilgi için harita nesnesi kılavuzunu inceleyin.

Harita görünümü veya yol tarifi isteği başlatma amacı

Varsayılan olarak, haritanın sağ alt kısmındaki araç çubuğu, Google Haritalar mobil uygulamasındaki bir harita görünümüne veya yol tarifi isteğine erişim sağlayan simgeler içerir. UiSettings.setMapToolbarEnabled(false) numaralı telefonu arayarak araç çubuğunu devre dışı bırakabilirsiniz. Daha ayrıntılı bilgi için araç çubuğu dokümanlarına bakın.

Ayrıca varsayılan olarak, bir kullanıcı haritaya dokunduğunda API, Google Haritalar mobil uygulamasını başlatır. GoogleMap.setOnMapClickListener() işlevini kullanarak kendi işleyicinizi ayarlayarak bunu geçersiz kılabilirsiniz. Ayrıca, MapView veya MapFragment öğesini içeren görünümde setClickable() yöntemini çağırarak harita üzerinde tıklama etkinliklerini devre dışı bırakabilirsiniz. Bu iki teknikle ilgili ayrıntılar için etkinlikler 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.

MapView sınıfını basit modda kullanırken, aşağıdaki durumlar haricinde yaşam döngüsü olaylarını yönlendirme işlemi isteğe bağlıdır:

  • onCreate() numaralı telefonu aramak zorunludur, aksi takdirde harita görünmez.
  • Basit mod haritanızda Konumum noktasını göstermek ve varsayılan konum kaynağını kullanmak istiyorsanız, konum kaynağı yalnızca bu aramalar arasında güncellendiğinden onResume() ve onPause() çağrılarını çağırmanız gerekir. Kendi konum kaynağınızı kullanıyorsanız, bu iki yöntemi çağırmanıza gerek yoktur.

Desteklenen API özellikleri

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

İşlevler
Harita türleri
Destekleniyor mu? Evet
GoogleMapOptions.mapType() ve GoogleMap.setMapType() üzerinden kullanılabilen şu harita türleri: MAP_TYPE_NORMAL, MAP_TYPE_SATELLITE, MAP_TYPE_TERRAIN, MAP_TYPE_HYBRID, MAP_TYPE_NONE
Çoklu çizgiler, poligonlar, daireler
Destekleniyor mu? Evet
Şekiller için basit mod işlevi, tam API ile eşleşir.
Projeksiyon
Destekleniyor mu? Evet
Projection için basit mod işlevi, tam API ile eşleşir.
Konumum
Destekleniyor mu? Evet
Konumum katmanının basit mod işlevi, tam API ile eşleşir.
Harita dolgusu
Destekleniyor mu? Evet
Harita dolgusu için basit mod desteği, tam API ile eşleşir.
Bilgi pencereleri
Destekleniyor mu? Evet
Bir işaretçinin title() değerini ayarlarsanız kullanıcı işaretçiye dokunduğunda varsayılan bilgi penceresi görünür. İşaretçide showInfoWindow() yöntemini çağırarak bilgi penceresini programatik olarak gösterebilirsiniz. InfoWindowAdapter arayüzü aracılığıyla özel bilgi pencereleri de oluşturabilirsiniz.
Özel temel harita stilleri
Destekleniyor mu? Kısmen
Android için Haritalar SDK'sı, temel haritanın özel stilini destekler. Basit Mod yalnızca JSON tabanlı özel stilleri destekler, stilize edilmiş bir harita oluşturmak için harita kimliği gerektiren bulut tabanlı stilleri desteklemez.
İşaretçiler
Destekleniyor mu? Kısmen
Bir işaretçi ekleyebilir ve bir tıklama etkinliğine yanıt verebilirsiniz. Özel işaretçi simgeleri de ekleyebilirsiniz. Bir işaretçiyi sürüklenebilir yapmak mümkün değildir. Basit mod haritalarındaki işaretçiler düzdür ve döndürülemez.
Kamera konumu, yakınlaştırma ve animasyon
Destekleniyor mu? Kısmen

Kamera hedefini ve yakınlaştırmayı ayarlayabilirsiniz, ancak eğimi veya yönü ayarlayamazsınız. Basit modda yakınlaştırma düzeyi, en yakın tam sayıya yuvarlanır. GoogleMap.moveCamera() numaralı telefonu aradığınızda, başka bir basit mod harita görüntüsü alırsınız. Kamerayı ayarlama ve yönetme hakkında daha fazla bilgi için Görünümü Değiştirme bölümüne bakın.

GoogleMap.animateCamera() çağrısı, kamera hareketinin animasyonuna neden olmaz. Kamera görünümü anında yeni konuma taşınır.
Etkinlikleri eşleştirme
Destekleniyor mu? Kısmen

Basit mod GoogleMap.setOnMapClickListener() ve GoogleMap.setOnMapLongClickListener() özelliklerini destekler.

Basit modda bir haritada tıklama etkinliklerini devre dışı bırakmak için MapView veya MapFragment öğesini içeren görünümde setClickable() çağırabilirsiniz. Bu, örneğin, bir haritayı veya haritaları liste görünümünde görüntülerken tıklama etkinliğinin haritayla ilgili olmayan bir işlemi başlatmasını istediğiniz durumlarda yararlıdır.

Ayrıntılı bilgi için etkinlikler belgelerini inceleyin.
İç mekan haritaları ve binalar
Destekleniyor mu? Hayır
Basit mod, Haritalar Static API ile aynı karoları gösterir. Bu, iç mekan kat planı varsayılan karoya yerleştirilmişse görüneceği anlamına gelir. Aksi takdirde çalışmaz. Ayrıca, gösterilen seviyeyi değiştiremez veya seviye seçiciyi değiştiremezsiniz.
Trafik katmanı
Destekleniyor mu? Hayır
GoogleMap.setTrafficEnabled(), basit modda desteklenmez.
Zeminde bindirmeler
Destekleniyor mu? Hayır
GoogleMap.addGroundOverlay(), basit modda desteklenmez.
Karo yer paylaşımları
Destekleniyor mu? Hayır
GoogleMap.addTileOverlay(), basit modda desteklenmez.
Hareketler
Destekleniyor mu? Hayır
Basit mod, hareketleri desteklemez. Hareketleri etkinleştirmenin ve devre dışı bırakmanın herhangi bir etkisi olmaz.
Street View
Destekleniyor mu? Hayır
Street View, basit modda desteklenmez.