Показать ближайшие места на карте во флоу

Следуйте этому рецепту, чтобы добавить интерактивную карту во флоу. Приложение отображает карту как нативный вид MapKit в пользовательском элементе. Приложение запрашивает доступ к местоположению на экране флоу.

Tip

Этот рецепт распространяется только на iOS-приложения. В приложениях на других фреймворках пользовательские элементы отображают только резервный контент. Поддержка Android и кросс-платформенных фреймворков появится позже.

Прежде чем начать

  • Обновите приложение до Adapty iOS SDK 4.4 или выше. В более ранних версиях SDK для каждого кастомного элемента отображается резервный контент.
  • Настройте приложение для получения и отображения флоу.
  • Чтобы запросить у пользователей доступ к геолокации, добавьте ключ NSLocationWhenInUseUsageDescription в файл Info.plist вашего приложения. Укажите в качестве значения текст запроса, например: «Найдите фитнес-центры рядом с вами».

1. Добавьте пользовательский элемент на экран

В Flow & Paywall Builder добавьте пользовательский элемент на экран флоу и настройте его для карты:

  • Type: map.
  • ID: fitness_centers.
  • Height: Оставьте высоту по умолчанию — Fixed. Карта заполняет пользовательский элемент.

Не помещайте пользовательский элемент в контейнеры, реагирующие на касание, например в карусель. Иначе при перетаскивании карты будет двигаться и карусель.

Внутри пользовательского элемента добавьте Image с картинкой карты. Пользователи видят её как резервный контент в следующих случаях:

  • Версия приложения пользователя не отображает карту.
  • Пользователь отказал в доступе к геолокации до открытия экрана.
  • Устройство работает на iOS 16.

Если пользователь ещё не ответил на запрос доступа к геолокации, iOS покажет его при появлении карты. Чтобы объяснить пользователям, зачем приложению нужна их геолокация, добавьте текстовый элемент над пользовательским элементом, например: «Найдите фитнес-центры рядом с вами».

2. Создайте представление карты

Создайте модель для доступа к местоположению и представление SwiftUI с картой. Представление запрашивает доступ к местоположению, находит фитнес-центры в радиусе 2 км от пользователя и отображает маркер для каждого из них:

Представление карты требует iOS 17 или выше. На iOS 16 пользователи видят резервный пейвол. Если пользователь отклоняет запрос доступа к геолокации, вместо карты отображается сообщение с инструкцией, как разрешить доступ в настройках.

3. Свяжите карту с кастомным элементом

В вашем общем резолвере приложения добавьте свойство для модели LocationAccess. Затем добавьте case, который возвращает вью с картой для Type map и ID fitness_centers. Добавляемые строки выделены. Если у вашего приложения ещё нет резолвера, скопируйте весь код целиком:

SDK вызывает резолвер при открытии экрана и повторно во время его работы — например, когда загружаются продукты. Результат каждого вызова зависит от доступа к геолокации:

  • Ещё не отвечено: Вид карты, чтобы вид мог запросить доступ.
  • Разрешено: Вид карты, который показывает фитнес-центры рядом с пользователем.
  • Отказано до открытия экрана: nil, чтобы пользователи видели резервный вариант вместо сообщения о настройках.
  • Отказано на экране: Вид карты, потому что вид устанавливает isMapOnScreen, пока находится на экране. Если бы резолвер вернул здесь nil, SDK заменил бы сообщение о настройках на резервный вариант при следующем вызове.

Если в вашем приложении ещё не задан глобальный резолвер, вызовите AdaptyUI.setCustomElementsResolver(_:) один раз — например, при запуске приложения:

4. Протестируйте на устройстве

Во Flow & Paywall Builder нельзя запустить код вашего приложения, поэтому на холсте отображается только резервный вариант. Чтобы просмотреть карту:

  1. Опубликуйте флоу. Чтобы увидеть последнюю опубликованную версию вместо кэшированной, зарегистрируйте устройство как тестовое.
  2. Запустите сборку приложения с включённым резолвером на iOS 17 или более новой версии. Откройте экран и разрешите доступ к местоположению. Убедитесь, что на карте отображается ваше местоположение и маркеры ближайших фитнес-центров.

Чтобы протестировать резервный вариант, запретите доступ к геолокации: в приложении Settings перейдите в Privacy & Security > Location Services > ваше приложение и выберите Never. Затем снова откройте экран.

Чтобы разобраться, почему вместо карты отображается резервный вариант, следуйте инструкциям в разделе Тест на устройстве руководства по iOS.