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

Следуйте этому рецепту, чтобы добавить интерактивную карту во флоу. Карта показывает ваши заведения — например, партнёрские фитнес-центры — в радиусе 2 км от пользователя. Приложение отображает карту как нативный вид в пользовательском элементе с помощью MapLibre. Запрос на доступ к геолокации отображается прямо на экране флоу.

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

  • Обновите приложение до Adapty Android SDK 4.4 или более поздней версии. В более ранних версиях SDK для каждого кастомного элемента отображается резервный контент.
  • Настройте приложение для получения и отображения флоу.
  • Чтобы запрашивать у пользователей доступ к геолокации, отображайте флоу в activity, расширяющей ComponentActivity, например AppCompatActivity.
  • Добавьте MapLibre в приложение через Gradle, используя артефакт org.maplibre.gl:android-sdk-opengl. С этим артефактом Google Play также предлагает ваше приложение устройствам без поддержки Vulkan, которая требуется артефакту android-sdk по умолчанию.
  • Установите minSdk равным 23 или выше, так как этого требует MapLibre.

Чтобы ограничить приложение приблизительным местоположением, добавьте следующее внутри элемента <manifest> в AndroidManifest.xml. Убедитесь, что элемент <manifest> объявляет xmlns:tools="http://schemas.android.com/tools".

<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. Добавьте пользовательский элемент на экран

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

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

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

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

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

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

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

Создайте тип для ваших мест и модель для доступа к местоположению:

Создайте представление с картой. Это представление запрашивает доступ к геолокации и отображает маркер для каждого из ваших мест в радиусе 2 км от пользователя:

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

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

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

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

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

Создайте резолвер с вашими плейсами и установите его как общий резолвер приложения. Вызовите AdaptyUI.setCustomElementsResolver один раз, например при запуске приложения:

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

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

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

Чтобы протестировать резервный вариант, в приложении Settings отключите доступ к геолокации для вашего приложения. Откройте экран и, если появится запрос, запретите доступ. Представление карты покажет сообщение о Settings. Откройте экран снова и убедитесь, что резервный вариант отображается.

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