Mostrar lugares cercanos en un mapa dentro de un flow

Sigue esta guía para incluir un mapa interactivo en un flow. El mapa muestra tus lugares, como gimnasios asociados, en un radio de 2 km alrededor del usuario. Tu app renderiza el mapa como una vista nativa en un elemento personalizado, con MapLibre. Tu app solicita acceso a la ubicación en la pantalla del flow.

Antes de empezar

  • Actualiza tu app al SDK de Adapty para Android 4.4 o posterior. Las versiones anteriores del SDK muestran el contenido de respaldo para cada elemento personalizado.
  • Configura tu app para obtener y mostrar flows.
  • Para solicitar a los usuarios acceso a la ubicación, muestra los flows en una activity que extienda ComponentActivity, como AppCompatActivity.
  • Añade MapLibre a tu app con Gradle, desde org.maplibre.gl:android-sdk-opengl. Con este artefacto, Google Play también ofrece tu app a dispositivos sin Vulkan, que el artefacto predeterminado android-sdk requiere.
  • Establece minSdk en 23 o superior, ya que MapLibre lo requiere.

Para limitar tu app a la ubicación aproximada, añade lo siguiente dentro del elemento <manifest> de AndroidManifest.xml. Asegúrate de que el elemento <manifest> declara 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. Añade el elemento personalizado a la pantalla

En el Flow & Paywall Builder, añade un elemento personalizado a una pantalla del flow y configúralo para el mapa:

  • Type: map.
  • ID: fitness_centers.
  • Height: Mantén la altura Fixed por defecto. El mapa ocupa todo el elemento personalizado.

Mantén el elemento personalizado fuera de contenedores que respondan al toque, como un carrusel, para que solo el mapa responda al arrastre.

Dentro del elemento personalizado, añade una Imagen con una imagen del mapa. Los usuarios la verán como respaldo cuando:

  • La versión de su app no muestre el mapa.
  • Denegaron el acceso a la ubicación antes de que se abriera la pantalla.

Si el usuario aún no ha respondido al mensaje de acceso a la ubicación, tu app lo muestra cuando aparece el mapa. Para explicar a los usuarios por qué tu app necesita su ubicación, añade un elemento de texto encima del elemento personalizado, como “Encuentra centros de fitness cerca de ti.”

2. Crear la vista del mapa

Crea un tipo para tus lugares y un modelo para el acceso a la ubicación:

Crea una vista con un mapa. La vista solicita acceso a la ubicación y muestra un marcador por cada uno de tus lugares dentro de 2 km del usuario:

Si el usuario deniega el acceso a la ubicación en la pantalla, la vista reemplaza el mapa con un mensaje sobre cómo permitir el acceso en Configuración.

3. Vincula el mapa al elemento personalizado

En tu resolver global, añade las propiedades del modelo LocationAccess y tus lugares. Luego devuelve la vista del mapa para el Type map y el ID fitness_centers. Las líneas resaltadas muestran qué añadir o cambiar. Si tu app aún no tiene un resolver global, copia el código completo:

El SDK llama al resolver cuando se abre la pantalla, y de nuevo cada vez que redibuja el elemento personalizado mientras la pantalla está abierta. El acceso a la ubicación determina lo que devuelve el resolver en cada llamada:

  • Sin respuesta aún: La vista del mapa, para que la vista pueda solicitar acceso.
  • Permitido: La vista del mapa, que muestra tus lugares cercanos al usuario.
  • Denegado antes de que se abriera la pantalla: Ninguna vista, por lo que los usuarios ven el paywall de respaldo en lugar del mensaje sobre la Configuración.
  • Denegado en la pantalla: La vista del mapa, porque la vista establece isMapOnScreen mientras está en pantalla. Si el resolver no devolviera ninguna vista aquí, el SDK reemplazaría el mensaje sobre la Configuración con el paywall de respaldo en la siguiente llamada.

Crea el resolver con tus elementos y configúralo como el resolver global de la aplicación. Llama a AdaptyUI.setCustomElementsResolver una sola vez, por ejemplo al iniciar la app:

4. Prueba en un dispositivo

El Flow & Paywall Builder no puede ejecutar el código de tu app, por lo que el canvas solo muestra el respaldo. Para previsualizar el mapa:

  1. Publica el flow. Para ver la última versión publicada en lugar de una en caché, registra el dispositivo como dispositivo de prueba.
  2. Para ver un marcador en el mapa, añade un lugar dentro de un radio de 2 km desde tu ubicación a tu lista de lugares.
  3. Compila tu app con el resolver incluido. Abre la pantalla y permite el acceso a la ubicación. Comprueba que el mapa muestra tu ubicación y un marcador para el lugar que añadiste.

Para probar el paywall de respaldo, abre la app Settings, desactiva el acceso a la ubicación para tu app. Abre la pantalla y, si aparece la solicitud, deniega el acceso a la ubicación. La vista del mapa mostrará el mensaje sobre Settings. Abre la pantalla de nuevo y verifica que aparezca el paywall de respaldo.

Para saber por qué aparece el paywall de respaldo en lugar del mapa, sigue las instrucciones de la sección Pruebas en un dispositivo de la guía de Android.