Afficher des lieux à proximité sur une carte dans un flow

Suivez cette recette pour intégrer une carte interactive dans un flow. La carte affiche vos lieux, comme des salles de sport partenaires, dans un rayon de 2 km autour de l’utilisateur. Votre application affiche la carte sous forme de vue native dans un élément personnalisé, avec MapLibre. Votre application demande l’accès à la localisation sur l’écran du flow.

Avant de commencer

  • Mettez à jour votre application avec le SDK Android Adapty 4.4 ou une version ultérieure. Les versions antérieures du SDK affichent le contenu de secours pour chaque élément personnalisé.
  • Configurez votre application pour récupérer et afficher les flows.
  • Pour demander l’accès à la localisation aux utilisateurs, affichez les flows dans une activité qui étend ComponentActivity, comme AppCompatActivity.
  • Ajoutez MapLibre à votre application avec Gradle, depuis org.maplibre.gl:android-sdk-opengl. Avec cet artefact, Google Play propose également votre application aux appareils sans Vulkan, que l’artefact android-sdk par défaut requiert.
  • Définissez minSdk à 23 ou supérieur, comme l’exige MapLibre.

Pour limiter votre application à la localisation approximative, ajoutez ce qui suit à l’intérieur de l’élément <manifest> du fichier AndroidManifest.xml. Assurez-vous que l’élément <manifest> déclare 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. Ajouter l’élément personnalisé à l’écran

Dans le Flow & Paywall Builder, ajoutez un élément personnalisé à un écran de flow et configurez-le pour la carte :

  • Type : map.
  • ID : fitness_centers.
  • Height : Conservez la hauteur Fixed par défaut. La carte remplit l’élément personnalisé.

Veillez à ne pas placer l’élément personnalisé dans des conteneurs qui réagissent au toucher, comme un carousel, afin que seule la carte réponde au glissement.

Dans l’élément personnalisé, ajoutez une Image avec une photo de carte. Les utilisateurs la voient comme contenu de secours dans les cas suivants :

  • Leur version de l’application n’affiche pas la carte.
  • Ils ont refusé l’accès à la localisation avant l’ouverture de l’écran.

Si l’utilisateur n’a pas encore répondu à la demande d’accès à la localisation, votre application l’affiche lorsque la carte apparaît. Pour expliquer aux utilisateurs pourquoi votre application a besoin de leur localisation, ajoutez un élément texte au-dessus de l’élément personnalisé, par exemple « Trouvez des centres de fitness près de chez vous. »

2. Créer la vue de la carte

Créez un type pour vos lieux et un modèle pour l’accès à la localisation :

Créez une vue avec une carte. La vue demande l’accès à la localisation et affiche un marqueur pour chacun de vos lieux situés dans un rayon de 2 km autour de l’utilisateur :

Si l’utilisateur refuse l’accès à la localisation sur l’écran, la vue remplace la carte par un message expliquant comment autoriser l’accès dans les Paramètres.

3. Associer la carte à l’élément personnalisé

Dans votre resolver global, ajoutez les propriétés du modèle LocationAccess et de vos lieux. Renvoyez ensuite la vue carte pour le Type map et l’ID fitness_centers. Les lignes surlignées indiquent ce qui doit être ajouté ou modifié. Si votre application ne possède pas encore de resolver global, copiez l’intégralité du code :

Le SDK appelle le resolver à l’ouverture de l’écran, puis à chaque fois qu’il redessine l’élément personnalisé tant que l’écran est ouvert. L’accès à la localisation détermine ce que le resolver renvoie à chaque appel :

  • Pas encore répondu : La vue de la carte, pour que la vue puisse demander l’accès.
  • Autorisé : La vue de la carte, qui affiche vos lieux à proximité de l’utilisateur.
  • Refusé avant l’ouverture de l’écran : Aucune vue, les utilisateurs voient donc le paywall de secours au lieu du message concernant les Paramètres.
  • Refusé sur l’écran : La vue de la carte, car la vue définit isMapOnScreen pendant qu’elle est affichée à l’écran. Si le resolver ne renvoyait aucune vue ici, le SDK remplacerait le message concernant les Paramètres par le paywall de secours au prochain appel.

Créez le résolveur avec vos emplacements et définissez-le comme résolveur global de l’application. Appelez AdaptyUI.setCustomElementsResolver une seule fois, par exemple au lancement de l’application :

4. Tester sur un appareil

Le Flow & Paywall Builder ne peut pas exécuter le code de votre application, donc son canvas n’affiche que le fallback. Pour prévisualiser la carte :

  1. Publiez le flow. Pour voir la dernière version publiée plutôt qu’une version en cache, enregistrez l’appareil comme appareil de test.
  2. Pour voir un marqueur sur la carte, ajoutez un lieu à moins de 2 km de votre position dans votre liste de lieux.
  3. Lancez un build de votre application incluant le resolver. Ouvrez l’écran et autorisez l’accès à la localisation. Vérifiez que la carte affiche votre position ainsi qu’un marqueur pour le lieu que vous avez ajouté.

Pour tester le fallback, dans l’application Settings, désactivez l’accès à la localisation pour votre application. Ouvrez l’écran et, si la demande d’autorisation apparaît, refusez l’accès à la localisation. La vue de la carte affiche le message relatif aux paramètres. Ouvrez à nouveau l’écran et vérifiez que le fallback s’affiche.

Pour comprendre pourquoi le fallback s’affiche à la place de la carte, suivez les instructions de la section Tester sur un appareil du guide Android.