Afficher les lieux à proximité sur une carte dans un flow
Suivez cette recette pour intégrer une carte interactive dans un flow. Votre application affiche la carte sous forme de vue MapKit native dans un élément personnalisé. Votre application demande l’accès à la localisation sur l’écran du flow.
Cette recette s’applique uniquement aux apps iOS. Les apps développées avec d’autres frameworks affichent uniquement le contenu de secours des éléments personnalisés. La prise en charge d’Android et des frameworks multiplateforme est à venir.
Avant de commencer
- Mettez à jour votre app vers Adapty iOS SDK 4.4 ou version ultérieure. Les versions antérieures du SDK affichent le contenu de secours pour chaque élément personnalisé.
- Configurez votre app pour récupérer et afficher les flows.
- Pour demander l’accès à la localisation, ajoutez la clé
NSLocationWhenInUseUsageDescriptionau fichierInfo.plistde votre app. Définissez sa valeur avec le texte de la demande, par exemple « Trouvez des centres de fitness près de chez vous. »
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. - Hauteur : Conservez la hauteur Fixed par défaut. La carte remplit l’élément personnalisé.
Ne placez pas l’élément personnalisé dans des conteneurs qui répondent au toucher, comme un carrousel. Sinon, un glissement sur la carte déplace également le carrousel.
Dans l’élément personnalisé, ajoutez une Image avec une photo de carte. Les utilisateurs la voient en tant que contenu de secours lorsque :
- Leur version de votre application n’affiche pas la carte.
- Ils ont refusé l’accès à la localisation avant l’ouverture de l’écran.
- Leur appareil fonctionne sous iOS 16.
Si l’utilisateur n’a pas encore répondu à la demande d’accès à la localisation, iOS l’affiche au moment où 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 salles de sport près de chez vous. »
2. Créer la vue de la carte
Créez un modèle pour l’accès à la localisation, et une vue SwiftUI avec une carte. La vue demande l’accès à la localisation, trouve les salles de fitness situées dans un rayon de 2 km autour de l’utilisateur, et affiche un marqueur pour chacune :
La vue cartographique nécessite iOS 17 ou une version ultérieure. Sur iOS 16, les utilisateurs voient le paywall de secours. 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 Réglages.
3. Associer la carte à l’élément personnalisé
Dans votre resolver global, ajoutez une propriété pour le modèle LocationAccess. Puis ajoutez un cas qui retourne la vue carte pour le Type map et l’ID fitness_centers. Les lignes surlignées indiquent ce qu’il faut ajouter. Si votre application n’a pas encore de resolver global, copiez l’intégralité du code :
Le SDK appelle le résolveur à l’ouverture de l’écran, puis de nouveau pendant qu’il est ouvert, par exemple lors du chargement des produits. L’accès à la localisation détermine ce que le résolveur renvoie à chaque appel :
- Pas encore répondue : la vue carte, pour que celle-ci puisse demander l’accès.
- Autorisée : la vue carte, qui affiche les salles de sport proches de l’utilisateur.
- Refusée avant l’ouverture de l’écran :
nil, pour que les utilisateurs voient le paywall de secours plutôt que le message sur les Réglages. - Refusée sur l’écran : la vue carte, parce que la vue définit
isMapOnScreenpendant qu’elle est affichée. Si le résolveur renvoyaitnilici, le SDK remplacerait le message sur les Réglages par le paywall de secours au prochain appel.
Si votre application n’a pas encore défini le resolver global, appelez AdaptyUI.setCustomElementsResolver(_:) une seule fois, par exemple au démarrage 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 :
- 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.
- Lancez un build de votre application incluant le resolver, sur iOS 17 ou version ultérieure. Ouvrez l’écran et autorisez l’accès à la localisation. Vérifiez que la carte affiche votre position ainsi que les marqueurs des salles de sport à proximité.
Pour tester le fallback, refusez l’accès à la localisation : dans l’application Settings, allez dans Privacy & Security > Location Services > votre application, et sélectionnez Never. Ouvrez ensuite l’écran à nouveau.
Pour savoir pourquoi le fallback s’affiche à la place de la carte, suivez les instructions de la section Tester sur un appareil du guide iOS.