Bir flow'da yakındaki yerleri haritada göster

Bir flow’a etkileşimli harita eklemek için bu tarifi uygula. Uygulaman, haritayı özel öğe içinde yerel bir MapKit görünümü olarak render eder. Uygulamana, flow ekranında konum erişimi istenir.

Tip

Bu tarif yalnızca iOS uygulamalarını kapsar. Diğer framework’lerle oluşturulan uygulamalar yalnızca özel öğelerin yedek içeriğini görüntüler. Android ve çapraz platform framework desteği yakında geliyor.

Başlamadan önce

  • Uygulamanızı Adapty iOS 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ı getirme ve görüntüleme için yapılandırın.
  • Kullanıcılardan konum erişimi istemek için uygulamanızın Info.plist dosyasına NSLocationWhenInUseUsageDescription anahtarını ekleyin. Değerini “Yakınındaki spor salonlarını bul.” gibi bir istem metniyle ayarlayın.

1. Ekrana özel öğeyi ekle

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

  • Type: map.
  • ID: fitness_centers.
  • Height: Varsayılan Fixed yüksekliği koruyun. Harita, özel öğeyi tamamen kaplar.

Özel öğeyi; carousel gibi dokunuşa tepki veren container’ların içine koymayın. Aksi takdirde haritada yapılan bir sürükleme hareketi carousel’i de hareket ettirir.

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

  • Uygulamanızın sürümü haritayı görüntüleyemiyorsa.
  • Ekran açılmadan önce konum erişimini reddettilerse.
  • Cihazları iOS 16 çalıştırıyorsa.

Kullanıcı konum erişim istemine henüz yanıt vermediyse, harita göründüğünde iOS bu isteği otomatik olarak gösterir. Uygulamanızın konuma neden ihtiyaç duyduğunu kullanıcılara açıklamak için özel öğenin üzerine “Yakınındaki spor salonlarını bul” gibi bir metin öğesi ekleyin.

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

Konum erişimi için bir model ve haritanın yer aldığı bir SwiftUI görünümü oluşturun. Görünüm konum erişimi ister, kullanıcının 2 km yakınındaki spor merkezlerini bulur ve her biri için bir işaretçi gösterir:

Harita görünümü iOS 17 veya üzerini gerektirir. iOS 16’da kullanıcılar yedek paywall’u görür. Kullanıcı ekranda konum erişimini reddederse, görünüm haritayı Ayarlar’dan erişimin nasıl etkinleştirileceğini açıklayan bir mesajla değiştirir.

3. Özel öğeyle eşleştirme

Uygulama genelinde resolver’ınıza LocationAccess modeli için bir property ekleyin. Ardından map Tipi ve fitness_centers ID’si için harita görünümünü döndüren bir case ekleyin. Vurgulanan satırlar eklenecek kısımları göstermektedir. Uygulamanızda henüz uygulama genelinde bir resolver yoksa kodun tamamını kopyalayabilirsiniz:

SDK, ekran açıldığında ve ekran açıkken (örneğin ürünler yüklenirken) 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 spor salonlarını gösteren harita görünümü.
  • Ekran açılmadan önce reddedildi: nil, böylece kullanıcılar Ayarlar hakkındaki mesaj yerine yedeği görür.
  • Ekranda reddedildi: Harita görünümü, çünkü görünüm ekrandayken isMapOnScreen değerini ayarlar. Çözümleyici burada nil döndürseydi, SDK bir sonraki çağrıda Ayarlar hakkındaki mesajı yedekle değiştirirdi.

Uygulamanız henüz uygulama genelinde bir çözümleyici (resolver) ayarlamadıysa, uygulama başlangıcı gibi uygun bir yerde AdaptyUI.setCustomElementsResolver(_:) fonksiyonunu bir kez çağırın:

4. Cihazda Test Edin

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

  1. Flow’u yayınlayın. Önbelleğe alınmış bir sürüm yerine en son yayınlanan sürümü görmek için cihazı test cihazı olarak kaydedin.
  2. Çözümleyiciyi içeren uygulamanızın bir derlemesini iOS 17 veya sonraki bir sürümde çalıştırın. Ekranı açın ve konum erişimine izin verin. Haritanın konumunuzu ve yakınındaki spor salonlarına ait işaretçileri gösterdiğini doğrulayın.

Yedeği test etmek için konum erişimini reddedin: Ayarlar uygulamasında Gizlilik ve Güvenlik > Konum Servisleri > uygulamanız yolunu izleyip Asla’yı seçin. Ardından ekranı tekrar açın.

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