Показать ближайшие места на карте во флоу
Следуйте этому рецепту, чтобы добавить интерактивную карту во флоу. Приложение отображает карту как нативный вид MapKit в пользовательском элементе. Приложение запрашивает доступ к местоположению на экране флоу.
Этот рецепт распространяется только на 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 нельзя запустить код вашего приложения, поэтому на холсте отображается только резервный вариант. Чтобы просмотреть карту:
- Опубликуйте флоу. Чтобы увидеть последнюю опубликованную версию вместо кэшированной, зарегистрируйте устройство как тестовое.
- Запустите сборку приложения с включённым резолвером на iOS 17 или более новой версии. Откройте экран и разрешите доступ к местоположению. Убедитесь, что на карте отображается ваше местоположение и маркеры ближайших фитнес-центров.
Чтобы протестировать резервный вариант, запретите доступ к геолокации: в приложении Settings перейдите в Privacy & Security > Location Services > ваше приложение и выберите Never. Затем снова откройте экран.
Чтобы разобраться, почему вместо карты отображается резервный вариант, следуйте инструкциям в разделе Тест на устройстве руководства по iOS.