Bir flow'da harita üzerinde yakın yerleri göster

Bir flow’a etkileşimli harita eklemek için bu tarifi izleyin. Harita, kullanıcının 2 km yakınındaki ortak spor merkezleri gibi yerlerinizi gösterir. Uygulamanız, haritayı MapLibre ile bir özel öğede yerel görünüm olarak render eder. Uygulamanız, flow ekranında konum erişimi ister.

Başlamadan önce

  • Uygulamanızı Adapty Android SDK 4.4 veya sonraki bir sürüme güncelleyin. Daha eski SDK sürümleri, her özel öğe için yedek içeriği gösterir.
  • Uygulamanızı flow’ları getirmek ve görüntülemek için ayarlayın.
  • Kullanıcılardan konum erişimi istemek için flow’ları, AppCompatActivity gibi ComponentActivity’yi genişleten bir activity içinde görüntüleyin.
  • MapLibre’yi org.maplibre.gl:android-sdk-opengl kaynağından Gradle ile uygulamanıza ekleyin. Bu artifact sayesinde Google Play, uygulamanızı varsayılan android-sdk artifact’ının gerektirdiği Vulkan desteği olmayan cihazlara da sunar.
  • MapLibre’nin gerektirdiği şekilde minSdk değerini 23 veya daha yükseğe ayarlayın.

Uygulamanızı yaklaşık konumla sınırlamak için AndroidManifest.xml dosyasının <manifest> elemanının içine aşağıdakileri ekleyin. <manifest> elemanının xmlns:tools="http://schemas.android.com/tools" tanımladığından emin olun.

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!-- removes precise location, which MapLibre declares -->
<uses-permission
    android:name="android.permission.ACCESS_FINE_LOCATION"
    tools:node="remove" />

1. Ekrana özel öğeyi ekleyin

Flow & Paywall Builder’da, bir flow ekranına özel bir öğe ekleyin ve harita için ayarlayın:

  • Tür: map.
  • ID: fitness_centers.
  • Yükseklik: Varsayılan Fixed yüksekliği koruyun. Harita, özel öğeyi doldurur.

Özel öğeyi, carousel gibi dokunuşa tepki veren container’ların içine koymayın; böylece yalnızca harita sürükleme hareketine yanıt verir.

Özel öğenin içine, harita görseli içeren bir Image ekleyin. Kullanıcılar bunu şu durumlarda yedek içerik olarak görür:

  • Uygulamanızın kullandıkları sürümü haritayı gösteremiyor.
  • Ekran açılmadan önce konum erişimini reddettiler.

Kullanıcı konum erişim iznini henüz yanıtlamamışsa, uygulama haritayı gösterdiğinde bu izni ister. Kullanıcılara uygulamanızın neden konumlarına ihtiyaç duyduğunu belirtmek için özel öğenin üzerine “Yakınındaki spor salonlarını bul.” gibi bir metin öğesi ekleyin.

2. Harita görünümü oluşturun

Yerleriniz için bir tür ve konum erişimi için bir model oluşturun:

Bir harita içeren bir görünüm oluşturun. Bu görünüm konum erişimi ister ve kullanıcının 2 km yakınındaki her yeriniz için bir işaretçi gösterir:

Kullanıcı ekranda konum erişimini reddederse, görünüm haritayı Ayarlar’dan erişimin nasıl etkinleştirileceğini anlatan bir mesajla değiştirir.

3. Haritayı özel elemente bağlama

Uygulama genelinde resolver’ınıza LocationAccess modeli ve yerleriniz için özellikler ekleyin. Ardından map Türü ve fitness_centers ID’si için harita görünümünü döndürün. Vurgulanan satırlar, neyin ekleneceğini veya değiştirileceğini gösterir. Uygulamanızda henüz uygulama genelinde bir resolver yoksa kodun tamamını kopyalayın:

SDK, ekran açıldığında ve ekran açıkken özel öğe her yeniden çizildiğinde resolver’ı çağırır. Konum erişimi, her çağrıda resolver’ın ne döndüreceğini belirler:

  • Henüz yanıtlanmadı: Harita görünümü; böylece görünüm erişim talep edebilir.
  • İzin verildi: Kullanıcının yakınındaki yerlerinizi gösteren harita görünümü.
  • Ekran açılmadan önce reddedildi: Hiçbir görünüm döndürülmez; kullanıcılar Ayarlar mesajı yerine yedek içeriği görür.
  • Ekranda reddedildi: Harita görünümü; çünkü görünüm ekrandayken isMapOnScreen değerini ayarlar. Resolver burada hiçbir görünüm döndürmeseydi, SDK bir sonraki çağrıda Ayarlar mesajını yedek içerikle değiştirirdi.

Çözümleyiciyi yerlerinizle oluşturun ve uygulama genelinde çözümleyici olarak ayarlayın. AdaptyUI.setCustomElementsResolver fonksiyonunu uygulama başlangıcında bir kez çağırın:

4. Cihazda Test Edin

Flow & Paywall Builder, uygulama kodunuzu çalıştıramaz; bu nedenle tuval yalnızca yedek içeriği gösterir. Haritayı önizlemek için:

  1. Flow’u yayınlayın. Önbelleğe alınmış sürüm yerine en son yayınlanan sürümü görmek için cihazı test cihazı olarak kaydedin.
  2. Haritada bir işaretçi görmek için konumunuzun 2 km yakınına bir yer ekleyin ve bunu yerler listenize dahil edin.
  3. Çözücüyü içeren bir uygulama derlemesi çalıştırın. Ekranı açın ve konum erişimine izin verin. Haritanın konumunuzu ve eklediğiniz yere ait işaretçiyi gösterdiğini doğrulayın.

Yedek ekranı test etmek için Ayarlar uygulamasında uygulamanızın konum erişimini kapatın. Ekranı açın ve istem belirirse konum erişimini reddedin. Harita görünümü, Ayarlar hakkında bir mesaj gösterir. Ekranı tekrar açın ve yedek ekranın görüntülendiğini doğrulayın.

Harita yerine neden yedek ekranın göründüğünü öğrenmek için Android kılavuzunun Cihazda test etme bölümündeki talimatları izleyin.