Mostrar lugares cercanos en un mapa en un flow
Sigue esta receta para incluir un mapa interactivo en un flow. Tu app renderiza el mapa como una vista nativa de MapKit en un elemento personalizado. Tu app solicita acceso a la ubicación en la pantalla del flow.
Esta receta solo cubre aplicaciones iOS. Las aplicaciones creadas con otros frameworks solo muestran el contenido de respaldo de los elementos personalizados. El soporte para Android y frameworks multiplataforma está en camino.
Antes de empezar
- Actualiza tu app a Adapty iOS SDK 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, añade la clave
NSLocationWhenInUseUsageDescriptional archivoInfo.plistde tu app. Establece su valor con el texto del mensaje, por ejemplo, “Encuentra centros de fitness cerca de ti.”
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.
No coloques el elemento personalizado dentro de contenedores que respondan al toque, como un carrusel. De lo contrario, al arrastrar el mapa también se moverá el carrusel.
Dentro del elemento personalizado, añade una Image con una imagen de un mapa. Los usuarios la verán como respaldo cuando:
- La versión de su app no muestre el mapa.
- Hayan denegado el acceso a la ubicación antes de abrir la pantalla.
- Su dispositivo use iOS 16.
Si el usuario aún no ha respondido al permiso de ubicación, iOS lo mostrará cuando aparezca el mapa. Para explicarles 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 modelo para el acceso a la ubicación y una vista SwiftUI con un mapa. La vista solicita acceso a la ubicación, busca gimnasios en un radio de 2 km del usuario y muestra un marcador por cada uno:
La vista del mapa requiere iOS 17 o posterior. En iOS 16, los usuarios ven el paywall de respaldo. 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 Ajustes.
3. Vincula el mapa al elemento personalizado
En tu resolver global, añade una propiedad para el modelo LocationAccess. Luego añade un caso que devuelva la vista del mapa para el Type map y el ID fitness_centers. Las líneas resaltadas muestran qué debes añadir. 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 mientras está abierta, por ejemplo cuando se cargan los productos. 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 gimnasios cercanos al usuario.
- Denegado antes de abrir la pantalla:
nil, para que los usuarios vean el respaldo en lugar del mensaje sobre Configuración. - Denegado en la pantalla: la vista del mapa, porque la vista establece
isMapOnScreenmientras está en pantalla. Si el resolver devolvieranilaquí, el SDK reemplazaría el mensaje sobre Configuración con el respaldo en la siguiente llamada.
Si tu app aún no tiene un resolver global, llama a AdaptyUI.setCustomElementsResolver(_:) una 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 lienzo solo muestra el respaldo. Para previsualizar el mapa:
- Publica el flow. Para ver la última versión publicada en lugar de una en caché, registra el dispositivo como dispositivo de prueba.
- Ejecuta una compilación de tu app que incluya el resolver, en iOS 17 o posterior. Abre la pantalla y permite el acceso a la ubicación. Comprueba que el mapa muestra tu ubicación y marcadores de los centros de fitness cercanos.
Para probar el respaldo, deniega el acceso a la ubicación: en la app Settings, ve a Privacy & Security > Location Services > tu app y selecciona Never. Luego vuelve a abrir la pantalla.
Para saber por qué aparece el respaldo en lugar del mapa, sigue las instrucciones en la sección Probar en un dispositivo de la guía de iOS.