Amazon Location Service - Getting Started with First Map App

` élément dans votre code HTML pour contenir la carte. Vous pouvez le styliser `

` dans votre CSS pour définir les dimensions selon les besoins de votre application. Vous devez télécharger le fichier CSS depuis notre GitHub dépôt. `style.css` Cela vous aidera à vous concentrer sur la logique métier. Enregistrez les `index.html` fichiers `style.css` et dans le même dossier. Téléchargez le `style.css` fichier depuis [GitHub](https://github.com/aws-geospatial/amazon-location-samples-js/blob/quick_start_sample_js/quick-start/style.css). ```

``` #### Ajouter une clé d'API et des détails sur AWS la région Ajoutez la clé d'API que vous avez créée dans [Utiliser des clés d'API pour s'authentifier](using-apikeys.md) ce fichier, ainsi que la AWS région dans laquelle la clé a été créée. ``` ..... .....

``` ### Ajoutez une carte à votre application Dans cette section, nous allons ajouter des fonctionnalités cartographiques à l'application. Avant de commencer, vos fichiers doivent se trouver dans cette structure de dossiers. Si ce n'est pas déjà fait, veuillez télécharger le `style.css` fichier depuis [GitHub](https://github.com/aws-geospatial/amazon-location-samples-js/blob/quick_start_sample_js/quick-start/style.css). ``` |---FirstApp [Folder] |-------------- index.html [File] |-------------- style.css [File] ``` #### Création d'une fonction pour initialiser la carte Pour configurer votre carte, créez la fonction suivante`initializeMap(...)`, après la ligne`//Add functions`. Choisissez un emplacement central initial et un niveau de zoom. Dans cet exemple, nous avons placé le centre de la carte sur Vancouver, au Canada, avec un niveau de zoom de 10. Ajoutez des commandes de navigation pour zoomer facilement. ``` /** * Initializes the map with the specified style and color scheme. */ function initializeMap(mapStyle = "Standard", colorScheme = "Dark") { const styleUrl = `https://maps.geo.${AWS_REGION}.amazonaws.com/v2/styles/${mapStyle}/descriptor?key=${API_KEY}&color-scheme=${colorScheme}`; const map = new maplibregl.Map({ container: 'map', // The ID of the map container style: styleUrl, // The style URL for the map center: [-123.116226, 49.246292], // Starting center coordinates zoom: 10, // Initial zoom level validateStyle: false // Disable style validation }); return map; // Return the initialized map } ``` #### Initialisation de la carte Appelez `initializeMap(...)` pour initialiser la carte. Vous pouvez éventuellement l'initialiser avec votre style et votre palette de couleurs préférés après la `initializeMap` fonction. Pour plus d'options de style, voir[AWS styles et fonctionnalités de carte](map-styles.md). ``` // Step 1: Setup API Key and AWS Region const API_KEY = "Your_API_Key"; const AWS_REGION = "Region_where_you_created_API_Key"; // Step 2.1 Add maps to application // Step 2.2 initialize the map const map = initializeMap("Standard","Light"); // Step 3: Add places features to application ``` Ouvrez `index.html` dans un navigateur pour voir la carte en action. #### Ajouter un contrôle de navigation Vous pouvez éventuellement ajouter des commandes de navigation (zoom et rotation) à la carte. Cela doit être fait après avoir appelé`initializeMap(...)`. ``` // Step 2.1 initialize the map const map = initializeMap("Standard","Light"); // Step 2.2 Add navigation controls to the map map.addControl(new maplibregl.NavigationControl()); // Step 3: Add places features to application ``` #### Vérifiez le code de la carte Félicitations \$1 Votre première application est prête à utiliser une carte. Ouvrez `index.html` dans un navigateur. Assurez-vous qu'`style.css`il se trouve dans le même dossier que`index.html`. Votre code HTML final devrait ressembler à ceci : ``` Amazon Location Service - Getting Started with First Map App

``` ### Ajoutez des lieux à votre application Dans cette section, nous allons configurer les fonctionnalités d'ajout de places à l'application. Téléchargez le JavaScript fichier depuis GitHub, [https://github.com/aws-geospatial/amazon-location-samples-js/blob/quick_start_sample_js/quick-start/utils.js](https://github.com/aws-geospatial/amazon-location-samples-js/blob/quick_start_sample_js/quick-start/utils.js). Avant de commencer, vos fichiers doivent se trouver dans cette structure de dossiers : ``` |---FirstApp [Folder] |-------------- index.html [File] |-------------- style.css [File] |-------------- utils.js [File] ``` #### Créer une fonction pour créer GeoPlaces Pour ajouter une fonctionnalité de recherche, initialisez la `GeoPlaces` classe à l'aide de `AuthHelper` et`AmazonLocationClient`. Ajoutez la `getGeoPlaces(map)` fonction suivante avant le `` tag`index.html`. ``` /** * Gets a GeoPlaces instance for Places operations. */ function getGeoPlaces(map) { const authHelper = amazonLocationClient.withAPIKey(API_KEY, AWS_REGION); // Authenticate using the API key and AWS region const locationClient = new amazonLocationClient.GeoPlacesClient(authHelper.getClientConfig()); // Create a GeoPlaces client const geoPlaces = new GeoPlaces(locationClient, map); // Create GeoPlaces instance return geoPlaces; // Return the GeoPlaces instance } ``` #### Créer une fonction pour ajouter un champ de recherche à l'application Ajoutez ce qui suit `addSearchBox(map, geoPlaces)` et `renderPopup(feature)` les `createPopup(feature)` fonctions avant le `` tag `index.html` pour terminer la configuration de la fonctionnalité de recherche. ``` /** * Adds search box to the map. */ function addSearchBox(map, geoPlaces) { const searchBox = new MaplibreGeocoder(geoPlaces, { maplibregl, showResultsWhileTyping: true, // Show results while typing debounceSearch: 300, // Debounce search requests limit: 30, // Limit number of results popuprender: renderPopup, // Function to render popup reverseGeocode: true, // Enable reverse geocoding zoom: 14, // Zoom level on result selection placeholder: "Search text or nearby (lat,long)" // Placeholder text for search box. }); // Add the search box to the map map.addControl(searchBox, 'top-left'); // Event listener for when a search result is selected searchBox.on('result', async (event) => { const { id, result_type } = event.result; // Get result ID and type if (result_type === "Place") { // Check if the result is a place const placeResults = await geoPlaces.searchByPlaceId(id); // Fetch details for the selected place if (placeResults.features.length) { createPopup(placeResults.features[0]).addTo(map); // Create and add popup for the place } } }); } /** * Renders the popup content for a given feature. */ function renderPopup(feature) { return ` `; } /** * Creates a popup for a given feature and sets its position. */ function createPopup(feature) { return new maplibregl.Popup({ offset: 30 }) // Create a new popup .setLngLat(feature.geometry.coordinates) // Set the popup position .setHTML(renderPopup(feature)); // Set the popup content } ``` #### Ajouter un champ de recherche à l'application Créez un `GeoPlaces` objet en appelant `getGeoPlaces(map)` comme défini dans la section 3.1, puis appelez `addSearchBox(map, geoPlaces)` pour ajouter le champ de recherche à l'application. ``` // Step 2: Add maps to application // Step 2.1 initialize the map const map = initializeMap("Standard","Light"); // Step 2.2 Add navigation controls to the map map.addControl(new maplibregl.NavigationControl()); // Step 3: Add places feature to application // Step 3.1: Get GeoPlaces instance. It will be used for adding search box and map click functionality const geoPlaces = getGeoPlaces(map); // Step 3.2: Add search box to the map addSearchBox(map, geoPlaces); ``` Votre recherche de lieux est prête à être utilisée. `index.html`Ouvrez-le dans un navigateur pour le voir en action. #### Ajouter une fonction pour afficher une fenêtre contextuelle lorsque l'utilisateur clique sur la carte Créez une fonction `addMapClick(map, geoPlaces)` pour afficher une fenêtre contextuelle lorsque l'utilisateur clique sur la carte. Ajoutez cette fonction juste avant le `` tag. ``` /** * Sets up reverse geocoding on map click events. */ function addMapClick(map, geoPlaces) { map.on('click', async ({ lngLat }) => { // Listen for click events on the map const response = await geoPlaces.reverseGeocode({ query: [lngLat.lng, lngLat.lat], limit: 1, click: true }); // Perform reverse geocoding if (response.features.length) { // If there are results const clickMarker = new maplibregl.Marker({ color: "orange" }); // Create a marker const feature = response.features[0]; // Get the clicked feature const clickedPopup = createPopup(feature); // Create popup for the clicked feature clickMarker.setLngLat(feature.geometry.coordinates) // Set marker position .setPopup(clickedPopup) // Attach popup to marker .addTo(map); // Add marker to the map clickedPopup.on('close', () => clickMarker.remove()).addTo(map); // Remove marker when popup is closed } }); } ``` #### Fonction d'appel pour ajouter une fonction Map Click Pour activer l'action de clic sur la carte, appelez `addMapClick(map, geoPlaces)` après la ligne contenant`addSearchBox(map, geoPlaces)`. ``` // Step 3: Add places feature to application // Step 3.1: Get GeoPlaces instance. It will be used for adding search box and map click functionality const geoPlaces = getGeoPlaces(map); // Step 3.2: Add search box to the map addSearchBox(map, geoPlaces); // Step 3.3: Setup map click functionality addMapClick(map, geoPlaces); ``` #### Consultez l'application Maps and Places Félicitations \$1 Votre première application est prête à utiliser Maps and Places. Ouvrez `index.html` dans un navigateur. Assurez-vous que vous `style.css` `utils.js` êtes dans le même dossier que`index.html`. Votre code HTML final devrait ressembler à ceci : ``` Amazon Location Service - Getting Started with First Map App

``` ### En savoir plus Vous avez terminé le didacticiel de démarrage rapide et vous devriez avoir une idée de la façon dont Amazon Location Service est utilisé pour créer des applications. Pour tirer le meilleur parti d'Amazon Location, vous pouvez consulter les ressources suivantes : + **Détails de la suggestion de requête** : envisagez d'étendre la `GeoPlaces` classe ou d'utiliser une approche similaire `ReverseGeocode` pour obtenir plus de détails sur les résultats renvoyés par l'`Suggestion`API. + **Choisissez l'API adaptée aux besoins de votre entreprise** - Pour déterminer l'API Amazon Location la mieux adaptée à vos besoins, consultez cette ressource :[Choisissez la bonne API](choose-an-api.md). + **Consultez les guides pratiques d'Amazon Location. Consultez le guide** du [développeur d'Amazon Location Service](https://docs.aws.amazon.com/location/) pour accéder à des didacticiels et à d'autres ressources. + **Documentation et informations sur le produit** - Pour obtenir une documentation complète, consultez le [guide du développeur Amazon Location Service](https://docs.aws.amazon.com/location/). Pour en savoir plus sur le produit, rendez-vous sur la page [produit d'Amazon Location Service](https://aws.amazon.com/location). # Créez votre première application Geofences and Trackers Dans cette section, vous allez créer une application qui présente les principales fonctionnalités de l'utilisation des géofences et traceurs Amazon Location Geofences. Les applications montrent comment un traceur et une clôture géographique interagissent à l'aide d'une combinaison des fonctionnalités Lambda AWS IoT et Amazon Location. Choisissez une plateforme iOS ou Android pour commencer. Avant de commencer à créer votre application, suivez les procédures décrites [Utilisez la console Amazon Location Service pour vous authentifier](set-up-auth.md) pour accorder l'accès approprié. **Topics** + [Création d'une application iOS](ios-geofence-app.md) + [Créer une application Android](android-geofence-app.md) # Création d'une application iOS Suivez ces procédures pour créer une application iOS à l'aide d'Amazon Location Service. Clonez les fichiers de projet à partir de [GitHub](https://github.com/aws-geospatial/amazon-location-samples-ios/tree/main/tracking-with-geofence-notifications). ## Créez des ressources Amazon Location pour votre application Vous pouvez générer des ressources Amazon Location Service une fois que votre AWS compte est prêt. Ces ressources seront essentielles pour exécuter les extraits de code fournis. **Note** Si vous n'avez pas encore créé de AWS compte, veuillez en [créer un AWS](https://portal.aws.amazon.com/billing/signup#/start/email). Pour commencer, vous devez créer un identifiant de pool d'identités Amazon Cognito, suivez la procédure suivante : 1. Dans la AWS console, accédez au service Amazon Cognito, puis sélectionnez Groupes **d'identités dans le menu de gauche, puis sélectionnez Créer un pool** **d'identités**. 1. Assurez-vous que l'option **Accès invité** est cochée, puis appuyez sur **Suivant** pour continuer. 1. Créez ensuite un nouveau rôle IAM ou utilisez un rôle IAM existant. 1. Entrez le nom du pool d'identités et assurez-vous que le pool d'identités a accès aux `(geo)` ressources Amazon Location pour la carte et le tracker que vous allez créer lors de la procédure suivante. 1. Vous devez maintenant créer et mettre en forme une carte dans la console AWS Amazon Location, en suivant la procédure suivante : 1. Accédez à la [section Cartes](https://console.aws.amazon.com/location/maps/home) de la console Amazon Location et sélectionnez **Create Map** pour prévisualiser les styles de carte disponibles. 1. Donnez un **nom** et une **description à la nouvelle ressource cartographique**. Enregistrez le nom que vous attribuez à la ressource cartographique, tel qu'il sera utilisé ultérieurement dans le didacticiel. 1. Lorsque vous choisissez un style de carte, pensez au fournisseur de données cartographiques. Reportez-vous à la section 82 des [conditions de AWS service](https://aws.amazon.com/service-terms) pour plus de détails. 1. Acceptez les [conditions générales d'Amazon Location](https://aws.amazon.com/service-terms/#:~:text=82.%20Amazon%20Location%20Service), puis sélectionnez **Create Map**. Une fois la carte créée, vous pouvez interagir avec elle en zoomant, en arrière ou en vous déplaçant dans n'importe quelle direction. Pour créer un outil de suivi à l'aide de la console Amazon Location 1. Ouvrez la [console Amazon Location Service](https://console.aws.amazon.com/location/). 1. Dans le volet de navigation de gauche, choisissez **Trackers**. 1. Choisissez **Créer un tracker**. 1. Remplissez tous les champs obligatoires. 1. Sous **Filtrage des positions**, choisissez l'option qui correspond le mieux à la manière dont vous avez l'intention d'utiliser votre ressource de suivi. Si vous ne définissez pas le filtrage de position, le paramètre par défaut est TimeBased. Pour plus d'informations, consultez la section Trackers dans ce guide et PositionFiltering dans le manuel Amazon Location Service Trackers API Reference. 1. Choisissez **Créer un tracker** pour terminer. ## Création d'une collection Geofence Lorsque vous créez une collection de géofences, vous pouvez utiliser la console, l'API ou la CLI. Les procédures suivantes vous guident à travers chaque option. Créez une collection de géofences à l'aide de la console Amazon Location : 1. Ouvrez la console Amazon Location Service à l'adresse https://console.aws.amazon.com/location/. 1. Dans le volet de navigation de gauche, choisissez Geofence Collections. 1. Choisissez Créer une collection de géofences. 1. Saisissez un nom et une description pour la collection. 1. Dans le cadre d'une EventBridge règle avec CloudWatch comme cible, vous pouvez créer une EventBridge règle facultative pour commencer à réagir aux événements de géofence. Cela permet à Amazon Location de publier des événements sur Amazon CloudWatch Logs. 1. Choisissez Créer une collection de géofences. Créez une collection de géofences à l'aide de l'emplacement Amazon : APIs Utilisez l' CreateGeofenceCollection opération depuis Amazon Location Geofences APIs. L'exemple suivant utilise une demande d'API pour créer une collection de géofences appelée. `GOECOLLECTION_NAME` ``` POST /geofencing/v0/collections Content-type: application/json { "CollectionName": "GOECOLLECTION_NAME", "Description": "Geofence collection 1 for shopping center", "Tags": { "Tag1" : "Value1" } } ``` Créez une collection de géofences à l'aide AWS CLI des commandes suivantes : Utilisez la commande create-geofence-collection. L'exemple suivant utilise an AWS CLI pour créer une collection de géofences appelée. `GOECOLLECTION_NAME` ``` aws location \ create-geofence-collection \ --collection-name "GOECOLLECTION_NAME" \ --description "Shopping center geofence collection" \ --tags Tag1=Value1 ``` ## Associer un traceur à une collection de géofences Pour lier un tracker à une collection de géofences, vous pouvez utiliser la console, l'API ou la CLI. Les procédures suivantes vous guident à travers chaque option. Associez une ressource de suivi à une collection de géofences à l'aide de la console Amazon Location Service : 1. Ouvrez la console Amazon Location. 1. Dans le volet de navigation de gauche, choisissez **Trackers**. 1. Sous **Device Trackers**, sélectionnez le lien du nom du tracker cible. 1. Sous **Collections Geofence liées**, choisissez **Link Geofence** Collection. 1. Dans la **fenêtre Linked Geofence Collection**, sélectionnez une collection de géofences dans le menu déroulant. 1. Choisissez **Lier**. 1. Une fois que vous aurez lié la ressource de suivi, le statut Actif lui sera attribué. Associez une ressource de suivi à une collection de géofences à l'aide d'Amazon Location : APIs Utilisez l'``AsssociateTrackerConsumer opération des Amazon Location Trackers APIs. L'exemple suivant utilise une demande d'API associée à une collection de géofences à l'aide de son Amazon Resource Name (ARN). ExampleTracker ``` POST /tracking/v0/trackers/ExampleTracker/consumers Content-type: application/json { "ConsumerArn": "arn:aws:geo:us-west-2:123456789012:geofence-collection/GOECOLLECTION_NAME" } ``` Associez une ressource de suivi à une collection de géofences à l'aide AWS CLI des commandes suivantes : Utilisez la commande `associate-tracker-consumer `. L'exemple suivant utilise an AWS CLI pour créer une collection de géofences appelée. `GOECOLLECTION_NAME` ``` aws location \ associate-tracker-consumer \ --consumer-arn "arn:aws:geo:us-west-2:123456789012:geofence-collection/GOECOLLECTION_NAME" \ --tracker-name "ExampleTracker" ``` ## Utiliser AWS Lambda avec MQTT Création d’une fonction Lambda. Pour créer une connexion entre Amazon Location Service AWS IoT Core et Amazon, vous avez besoin d'une AWS Lambda fonction permettant de traiter les messages transférés par des EventBridge CloudWatch événements. Cette fonction permet d'extraire toutes les données de position, de les formater pour Amazon Location Service et de les envoyer via l'API Amazon Location Tracker. Vous pouvez créer cette fonction via la AWS Lambda console, ou vous pouvez utiliser le AWS Command Line Interface (AWS CLI) ou le AWS Lambda APIs. Pour créer une fonction Lambda qui publie des mises à jour de position sur Amazon Location à l'aide de la console : 1. Ouvrez la AWS Lambda console à l'adresse https://console.aws.amazon.com/lambda/. 1. Dans le menu de navigation de gauche, choisissez Functions. 1. Choisissez Créer une fonction et assurez-vous que l'option Auteur à partir de zéro est sélectionnée. 1. Remplissez les cases suivantes : + un nom de fonction + pour l'option **Runtime**, choisissez Node.js 16.x. 1. Choisissez Créer une fonction. 1. Cliquez sur l'onglet Code pour ouvrir l'éditeur. 1. Remplacez le code de l'espace réservé dans le fichier index.js par le code suivant : ``` const AWS = require('aws-sdk') const iot = new AWS.Iot(); exports.handler = function(event) { console.log("event===>>>", JSON.stringify(event)); var param = { endpointType: "iot:Data-ATS" }; iot.describeEndpoint(param, function(err, data) { if (err) { console.log("error===>>>", err, err.stack); // an error occurred } else { var endp = data['endpointAddress']; const iotdata = new AWS.IotData({endpoint: endp}); const trackerEvent = event["detail"]["EventType"]; const src = event["source"]; const time = event["time"]; const gfId = event["detail"]["GeofenceId"]; const resources = event["resources"][0]; const splitResources = resources.split("."); const geofenceCollection = splitResources[splitResources.length - 1]; const coordinates = event["detail"]["Position"]; const deviceId = event["detail"]["DeviceId"]; console.log("deviceId===>>>", deviceId); const msg = { "trackerEventType" : trackerEvent, "source" : src, "eventTime" : time, "geofenceId" : gfId, "coordinates": coordinates, "geofenceCollection": geofenceCollection }; const params = { topic: `${deviceId}/tracker`, payload: JSON.stringify(msg), qos: 0 }; iotdata.publish(params, function(err, data) { if (err) { console.log("error===>>>", err, err.stack); // an error occurred } else { console.log("Ladmbda triggered===>>>", trackerEvent); // successful response } }); } }); } ``` 1. Choisissez Déployer pour enregistrer la fonction mise à jour. 1. Cliquez sur l’onglet Configuration. 1. Dans la section Déclencheurs, cliquez sur Ajouter un déclencheur. 1. Sélectionnez EventBridge (CloudWatch Événements) dans le champ Source. 1. Sélectionnez l'option radio « Règles existantes ». 1. Entrez le nom de la règle comme suit `AmazonLocationMonitor-GEOFENCECOLLECTION\$1NAME`. 1. Cliquez sur le bouton Ajouter. 1. Cela ajoutera également des « déclarations de politique basées sur les ressources » dans l'onglet des autorisations Client de test MQTT 1. Ouvrez la [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/). 1. Dans le volet de navigation de gauche, choisissez le client de test MQTT. 1. Vous verrez une section intitulée **Client de test MQTT** dans laquelle vous pouvez configurer votre connexion MQTT. 1. Après avoir configuré les paramètres nécessaires, cliquez sur le bouton **Connect** pour établir une connexion avec le broker MQTT à l'aide des paramètres fournis. 1. Prenez note de la valeur du point de terminaison. Une fois connecté, vous pouvez vous abonner à des sujets MQTT ou publier des messages sur des sujets en utilisant les champs de saisie correspondants fournis dans l'interface client de test MQTT. Ensuite, vous allez joindre la politique MQTT : 1. Dans le menu de gauche, sous **Gérer**, développez l'option **de sécurité** et cliquez sur **Politiques**. 1. Cliquez sur le bouton **Créer une politique**. 1. Entrez un nom de stratégie. 1. Dans le **document de politique**, sélectionnez l'onglet **JSON**. 1. Copiez-collez la politique ci-dessous, mais assurez-vous de mettre à jour tous les éléments avec votre `REGION` et `ACCOUNT_ID` : ``` { "Version": "2012-10-17", "Statement": [ { "Action": [ "iot:Connect", "iot:Publish", "iot:Subscribe", "iot:Receive" ], "Resource": [ "arn:aws:iot:REGION:ACCOUNT_ID:client/${cognito-identity.amazonaws.com:sub}", "arn:aws:iot:REGION:ACCOUNT_ID:topic/${cognito-identity.amazonaws.com:sub}", "arn:aws:iot:REGION:ACCOUNT_ID:topicfilter/${cognito-identity.amazonaws.com:sub}/", "arn:aws:iot:REGION:ACCOUNT_ID:topic/${cognito-identity.amazonaws.com:sub}/tracker" ], "Effect": "Allow" } ] } ``` 1. Cliquez sur le bouton **Créer** pour terminer. ## Configurer un exemple de code d'application Pour configurer l'exemple de code, les outils suivants doivent être installés : + Git + XCode 15.3 ou version ultérieure + iOS Simulator 16 ou version ultérieure Utilisez cette procédure pour configurer l'exemple de code d'application : 1. Clonez le dépôt git à partir de cette URL : [https://github.com/aws-geospatial/amazon-location-samples-ios/tree/main/tracking- with-geofence-notifications](https://github.com/aws-geospatial/amazon-location-samples-ios/tree/main/tracking-with-geofence-notifications). 1. Ouvrez le fichier de projet `AWSLocationSampleApp.xcodeproj`. 1. Attendez le processus de résolution du package. 1. **Facultatif** : Dans le menu de navigation du projet, renommez `ConfigTemplate.xcconfig` `Config.xcconfig` et renseignez les valeurs suivantes : ``` IDENTITY_POOL_ID = `YOUR_IDENTITY_POOL_ID` MAP_NAME = `YOUR_MAP_NAME` TRACKER_NAME = `YOUR_TRACKER_NAME` WEBSOCKET_URL = `YOUR_MQTT_TEST_CLIENT_ENDPOINT` GEOFENCE_ARN = `YOUR_GEOFENCE_COLLECTION_NAME` ``` ## Utiliser l'exemple d'application Après avoir configuré l'exemple de code, vous pouvez désormais exécuter l'application sur un simulateur iOS ou un appareil physique. 1. Créez et exécutez l'application. 1. L'application vous demandera des autorisations de localisation et de notification. Tu dois les autoriser. 1. Appuyez sur le bouton « Configuration Cognito ». 1. Si vous n'avez pas renseigné les valeurs du fichier `Config.xcConfig`, vous devez remplir le champ avec les valeurs de ressources que vous avez créées précédemment dans l'écran de configuration. ``` IDENTITY_POOL_ID = `YOUR_IDENTITY_POOL_ID` MAP_NAME = `YOUR_MAP_NAME` TRACKER_NAME = `YOUR_TRACKER_NAME` WEBSOCKET_URL = `YOUR_MQTT_TEST_CLIENT_ENDPOINT` GEOFENCE_ARN = `YOUR_GEOFENCE_COLLECTION_NAME` ``` 1. Enregistrez la configuration 1. Vous pouvez désormais voir les options de filtre pour le temps, la distance et la précision. Utilisez-les selon vos besoins. 1. Accédez à l'onglet « Suivi » de l'application et vous verrez la carte et le bouton « Démarrer le suivi ». 1. Si vous avez installé l'application sur un simulateur, vous souhaiterez peut-être simuler des changements de position. Cela peut être fait dans l'option du menu Fonctionnalités -> Emplacement. Par exemple, sélectionnez Fonctionnalités -> Emplacement -> Freeway Drive. 1. Appuyez sur le bouton « Démarrer le suivi ». Vous devriez voir les points de suivi sur la carte. 1. L'application suit également les emplacements en arrière-plan. Ainsi, lorsque vous déplacez l'application en arrière-plan, elle vous demandera l'autorisation de poursuivre le suivi en mode arrière-plan. 1. Vous pouvez arrêter le suivi en appuyant sur le bouton « Arrêter le suivi ». # Créer une application Android Suivez ces procédures pour créer une application iOS à l'aide d'Amazon Location Service. Clonez les fichiers de projet à partir de [GitHub](https://github.com/aws-geospatial/amazon-location-samples-android/tree/main/tracking-with-geofence-notifications). ## Créez des ressources Amazon Location pour votre application Vous pouvez générer des ressources Amazon Location Service une fois que votre AWS compte est prêt. Ces ressources seront essentielles pour exécuter les extraits de code fournis. **Note** Si vous n'avez pas encore créé de AWS compte, veuillez en [créer un AWS](https://portal.aws.amazon.com/billing/signup#/start/email). Pour commencer, vous devez créer un identifiant de pool d'identités Amazon Cognito, suivez la procédure suivante : 1. Dans la AWS console, accédez au service Amazon Cognito, puis sélectionnez Groupes **d'identités dans le menu de gauche, puis sélectionnez Créer un pool** **d'identités**. 1. Assurez-vous que l'option **Accès invité** est cochée, puis appuyez sur **Suivant** pour continuer. 1. Créez ensuite un nouveau rôle IAM ou utilisez un rôle IAM existant. 1. Entrez le nom du pool d'identités et assurez-vous que le pool d'identités a accès aux `(geo)` ressources Amazon Location pour la carte et le tracker que vous allez créer lors de la procédure suivante. 1. Vous devez maintenant créer et mettre en forme une carte dans la console AWS Amazon Location, en suivant la procédure suivante : 1. Accédez à la [section Cartes](https://console.aws.amazon.com/location/maps/home) de la console Amazon Location et sélectionnez **Create Map** pour prévisualiser les styles de carte disponibles. 1. Donnez un **nom** et une **description à la nouvelle ressource cartographique**. Enregistrez le nom que vous attribuez à la ressource cartographique, tel qu'il sera utilisé ultérieurement dans le didacticiel. 1. Lorsque vous choisissez un style de carte, pensez au fournisseur de données cartographiques. Reportez-vous à la section 82 des [conditions de AWS service](https://aws.amazon.com/service-terms) pour plus de détails. 1. Acceptez les [conditions générales d'Amazon Location](https://aws.amazon.com/service-terms/#:~:text=82.%20Amazon%20Location%20Service), puis sélectionnez **Create Map**. Une fois la carte créée, vous pouvez interagir avec elle en zoomant, en arrière ou en vous déplaçant dans n'importe quelle direction. Pour créer un outil de suivi à l'aide de la console Amazon Location 1. Ouvrez la [console Amazon Location Service](https://console.aws.amazon.com/location/). 1. Dans le volet de navigation de gauche, choisissez **Trackers**. 1. Choisissez **Créer un tracker**. 1. Remplissez tous les champs obligatoires. 1. Sous **Filtrage des positions**, choisissez l'option qui correspond le mieux à la manière dont vous avez l'intention d'utiliser votre ressource de suivi. Si vous ne définissez pas le filtrage de position, le paramètre par défaut est TimeBased. Pour plus d'informations, consultez la section Trackers dans ce guide et PositionFiltering dans le manuel Amazon Location Service Trackers API Reference. 1. Choisissez **Créer un tracker** pour terminer. ## Création d'une collection Geofence Lorsque vous créez une collection de géofences, vous pouvez utiliser la console, l'API ou la CLI. Les procédures suivantes vous guident à travers chaque option. Créez une collection de géofences à l'aide de la console Amazon Location : 1. Ouvrez la console Amazon Location Service à l'adresse https://console.aws.amazon.com/location/. 1. Dans le volet de navigation de gauche, choisissez Geofence Collections. 1. Choisissez Créer une collection de géofences. 1. Saisissez un nom et une description pour la collection. 1. Dans le cadre d'une EventBridge règle avec CloudWatch comme cible, vous pouvez créer une EventBridge règle facultative pour commencer à réagir aux événements de géofence. Cela permet à Amazon Location de publier des événements sur Amazon CloudWatch Logs. 1. Choisissez Créer une collection de géofences. Créez une collection de géofences à l'aide de l'emplacement Amazon : APIs Utilisez l' CreateGeofenceCollection opération depuis Amazon Location Geofences APIs. L'exemple suivant utilise une demande d'API pour créer une collection de géofences appelée. `GOECOLLECTION_NAME` ``` POST /geofencing/v0/collections Content-type: application/json { "CollectionName": "GOECOLLECTION_NAME", "Description": "Geofence collection 1 for shopping center", "Tags": { "Tag1" : "Value1" } } ``` Créez une collection de géofences à l'aide AWS CLI des commandes suivantes : Utilisez la commande create-geofence-collection. L'exemple suivant utilise an AWS CLI pour créer une collection de géofences appelée. `GOECOLLECTION_NAME` ``` aws location \ create-geofence-collection \ --collection-name "GOECOLLECTION_NAME" \ --description "Shopping center geofence collection" \ --tags Tag1=Value1 ``` ## Associer un traceur à une collection de géofences Pour lier un tracker à une collection de géofences, vous pouvez utiliser la console, l'API ou la CLI. Les procédures suivantes vous guident à travers chaque option. Associez une ressource de suivi à une collection de géofences à l'aide de la console Amazon Location Service : 1. Ouvrez la console Amazon Location. 1. Dans le volet de navigation de gauche, choisissez **Trackers**. 1. Sous **Device Trackers**, sélectionnez le lien du nom du tracker cible. 1. Sous **Collections Geofence liées**, choisissez **Link Geofence** Collection. 1. Dans la **fenêtre Linked Geofence Collection**, sélectionnez une collection de géofences dans le menu déroulant. 1. Choisissez **Lier**. 1. Une fois que vous aurez lié la ressource de suivi, le statut Actif lui sera attribué. Associez une ressource de suivi à une collection de géofences à l'aide d'Amazon Location : APIs Utilisez l'``AsssociateTrackerConsumer opération des Amazon Location Trackers APIs. L'exemple suivant utilise une demande d'API associée à une collection de géofences à l'aide de son Amazon Resource Name (ARN). ExampleTracker ``` POST /tracking/v0/trackers/ExampleTracker/consumers Content-type: application/json { "ConsumerArn": "arn:aws:geo:us-west-2:123456789012:geofence-collection/GOECOLLECTION_NAME" } ``` Associez une ressource de suivi à une collection de géofences à l'aide AWS CLI des commandes suivantes : Utilisez la commande `associate-tracker-consumer `. L'exemple suivant utilise an AWS CLI pour créer une collection de géofences appelée. `GOECOLLECTION_NAME` ``` aws location \ associate-tracker-consumer \ --consumer-arn "arn:aws:geo:us-west-2:123456789012:geofence-collection/GOECOLLECTION_NAME" \ --tracker-name "ExampleTracker" ``` ## Utiliser AWS Lambda avec MQTT Création d’une fonction Lambda. Pour créer une connexion entre Amazon Location Service AWS IoT Core et Amazon, vous avez besoin d'une AWS Lambda fonction permettant de traiter les messages transférés par des EventBridge CloudWatch événements. Cette fonction permet d'extraire toutes les données de position, de les formater pour Amazon Location Service et de les envoyer via l'API Amazon Location Tracker. Vous pouvez créer cette fonction via la AWS Lambda console, ou vous pouvez utiliser le AWS Command Line Interface (AWS CLI) ou le AWS Lambda APIs. Pour créer une fonction Lambda qui publie des mises à jour de position sur Amazon Location à l'aide de la console : 1. Ouvrez la AWS Lambda console à l'adresse https://console.aws.amazon.com/lambda/. 1. Dans le menu de navigation de gauche, choisissez Functions. 1. Choisissez Créer une fonction et assurez-vous que l'option Auteur à partir de zéro est sélectionnée. 1. Remplissez les cases suivantes : + un nom de fonction + pour l'option **Runtime**, choisissez Node.js 16.x. 1. Choisissez Créer une fonction. 1. Cliquez sur l'onglet Code pour ouvrir l'éditeur. 1. Remplacez le code de l'espace réservé dans le fichier index.js par le code suivant : ``` const AWS = require('aws-sdk') const iot = new AWS.Iot(); exports.handler = function(event) { console.log("event===>>>", JSON.stringify(event)); var param = { endpointType: "iot:Data-ATS" }; iot.describeEndpoint(param, function(err, data) { if (err) { console.log("error===>>>", err, err.stack); // an error occurred } else { var endp = data['endpointAddress']; const iotdata = new AWS.IotData({endpoint: endp}); const trackerEvent = event["detail"]["EventType"]; const src = event["source"]; const time = event["time"]; const gfId = event["detail"]["GeofenceId"]; const resources = event["resources"][0]; const splitResources = resources.split("."); const geofenceCollection = splitResources[splitResources.length - 1]; const coordinates = event["detail"]["Position"]; const deviceId = event["detail"]["DeviceId"]; console.log("deviceId===>>>", deviceId); const msg = { "trackerEventType" : trackerEvent, "source" : src, "eventTime" : time, "geofenceId" : gfId, "coordinates": coordinates, "geofenceCollection": geofenceCollection }; const params = { topic: `${deviceId}/tracker`, payload: JSON.stringify(msg), qos: 0 }; iotdata.publish(params, function(err, data) { if (err) { console.log("error===>>>", err, err.stack); // an error occurred } else { console.log("Ladmbda triggered===>>>", trackerEvent); // successful response } }); } }); } ``` 1. Choisissez Déployer pour enregistrer la fonction mise à jour. 1. Cliquez sur l’onglet Configuration. 1. Dans la section Déclencheurs, cliquez sur Ajouter un déclencheur. 1. Sélectionnez EventBridge (CloudWatch Événements) dans le champ Source. 1. Sélectionnez l'option radio « Règles existantes ». 1. Entrez le nom de la règle comme suit `AmazonLocationMonitor-GEOFENCECOLLECTION\$1NAME`. 1. Cliquez sur le bouton Ajouter. 1. Cela ajoutera également des « déclarations de politique basées sur les ressources » dans l'onglet des autorisations Client de test MQTT 1. Ouvrez la [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/). 1. Dans le volet de navigation de gauche, choisissez le client de test MQTT. 1. Vous verrez une section intitulée **Client de test MQTT** dans laquelle vous pouvez configurer votre connexion MQTT. 1. Après avoir configuré les paramètres nécessaires, cliquez sur le bouton **Connect** pour établir une connexion avec le broker MQTT à l'aide des paramètres fournis. 1. Notez la valeur du point de terminaison. Une fois connecté, vous pouvez vous abonner à des sujets MQTT ou publier des messages sur des sujets en utilisant les champs de saisie correspondants fournis dans l'interface client de test MQTT. Ensuite, vous allez joindre la politique MQTT : 1. Dans le menu de gauche, sous **Gérer**, développez l'option **de sécurité** et cliquez sur **Politiques**. 1. Cliquez sur le bouton **Créer une politique**. 1. Entrez un nom de stratégie. 1. Dans le **document de politique**, sélectionnez l'onglet **JSON**. 1. Copiez-collez la politique ci-dessous, mais assurez-vous de mettre à jour tous les éléments avec votre `REGION` et `ACCOUNT_ID` : ``` { "Version": "2012-10-17", "Statement": [ { "Action": [ "iot:Connect", "iot:Publish", "iot:Subscribe", "iot:Receive" ], "Resource": [ "arn:aws:iot:REGION:ACCOUNT_ID:client/${cognito-identity.amazonaws.com:sub}", "arn:aws:iot:REGION:ACCOUNT_ID:topic/${cognito-identity.amazonaws.com:sub}", "arn:aws:iot:REGION:ACCOUNT_ID:topicfilter/${cognito-identity.amazonaws.com:sub}/", "arn:aws:iot:REGION:ACCOUNT_ID:topic/${cognito-identity.amazonaws.com:sub}/tracker" ], "Effect": "Allow" } ] } ``` **Note** Enregistrez le nom de la politique et le nom du sujet à utiliser dans la procédure suivante. 1. Cliquez sur le bouton **Créer** pour terminer. Après avoir terminé la procédure précédente, vous allez maintenant mettre à jour les autorisations pour le rôle d'invité comme suit : 1. Accédez à Amazon Cognito et ouvrez votre pool d'identités. Passez ensuite à l'accès utilisateur et sélectionnez le rôle d'invité. 1. Cliquez sur les politiques d'autorisation pour activer la modification. ``` { 'Version': '2012-10-17 ', 'Statement': [ { 'Action': [ 'geo:GetMap*', 'geo:BatchUpdateDevicePosition', 'geo:BatchEvaluateGeofences', 'iot:Subscribe', 'iot:Publish', 'iot:Connect', 'iot:Receive', 'iot:AttachPrincipalPolicy', 'iot:AttachPolicy', 'iot:DetachPrincipalPolicy', 'iot:DetachPolicy' ], 'Resource': [ 'arn:aws:geo:us-east-1:{USER_ID}:map/{MAP_NAME}', 'arn:aws:geo:us-east-1:{USER_ID}:tracker/{TRACKER_NAME}', 'arn:aws:geo:us-east-1:{USER_ID}:geofence-collection/{GEOFENCE_COLLECTION_NAME}', 'arn:aws:iot:us-east-1:{USER_ID}:client/${cognito-identity.amazonaws.com:sub}', 'arn:aws:iot:us-east-1:{USER_ID}:topic/${cognito-identity.amazonaws.com:sub}', 'arn:aws:iot:us-east-1:{USER_ID}:topicfilter/${cognito-identity.amazonaws.com:sub}/*', 'arn:aws:iot:us-east-1:{USER_ID}:topic/${cognito-identity.amazonaws.com:sub}/tracker' ], 'Effect': 'Allow' }, { 'Condition': { 'StringEquals': { 'cognito-identity.amazonaws.com:sub': '${cognito-identity.amazonaws.com:sub}' } }, 'Action': [ 'iot:AttachPolicy', 'iot:DetachPolicy', 'iot:AttachPrincipalPolicy', 'iot:DetachPrincipalPolicy' ], 'Resource': [ '*' ], 'Effect': 'Allow' } ] } ``` 1. Avec les modifications de politique ci-dessus, toutes les AWS ressources nécessaires sont désormais configurées de manière appropriée pour l'application. ## Configurer l'exemple de code d'application 1. Ouvrez Android Studio et sélectionnez **Nouveau**, puis Projeter **depuis le contrôle de version**. 1. Accédez au menu **Fichier** dans le coin supérieur gauche d'Android Studio. 1. Sélectionnez « Nouveau » dans le menu déroulant. 1. Choisissez « Projet à partir du contrôle de version ». 1. Entrez l'URL du référentiel Dans la boîte de dialogue qui apparaît, recherchez le champ « URL ». 1. Copiez et collez l'URL suivante pour l'exemple d'application dans ce champ : [https://github.com/aws-geospatial/amazon-location-samples-android.git](https://github.com/aws-geospatial/amazon-location-samples-android.git) 1. Choisissez le répertoire dans lequel vous souhaitez cloner le référentiel. Utilisez le répertoire par défaut ou optez pour un emplacement personnalisé. 1. Après avoir défini l'URL du dépôt et les préférences du répertoire, cliquez sur le bouton « Cloner ». Android Studio va procéder au clonage du dépôt à l'emplacement que vous avez indiqué. 1. Vous avez maintenant cloné l'application sur votre machine et vous pouvez commencer à l'utiliser. ## Utiliser l'exemple d'application Pour utiliser l'exemple, suivez les procédures suivantes : + **Créez un `custom.properties`** : Pour configurer votre `custom.properties` fichier, procédez comme suit : 1. Ouvrez votre éditeur de texte ou IDE préféré. 1. Créez un nouveau fichier. 1. Enregistrez le fichier sous le nom `custom.properties`. 1. Mettez à jour le `custom.properties` avec l'exemple de code suivant et remplacez le `MQTT_END_POINT``POLICY_NAME`,`GEOFENCE_COLLECTION_NAME`, et `TOPIC_TRACKER` par les valeurs réelles : ``` MQTT_END_POINT=xxxxxxxxxxxxx-xxx.xxx.us-east-1.amazonaws.com POLICY_NAME=xxxxxxxxx GEOFENCE_COLLECTION_NAME=xxxxxxxxxxxxxxxxx TOPIC_TRACKER=xxxxxxxxxx ``` 1. Nettoyez et reconstruisez le projet. Ensuite, vous pouvez exécuter le projet. + **Connectez-vous** : Pour vous connecter à l'application, suivez les étapes ci-dessous : 1. Appuyez sur le bouton **de connexion**. 1. Fournissez un **identifiant de pool d'identités**, un **nom de tracker** et un **nom de carte**. 1. Appuyez **à nouveau sur Se connecter** pour terminer. + **Gérer les filtres** : Ouvrez l'écran de configuration et effectuez les opérations suivantes : 1. Basculez entre les filtres on/off à l'aide de l'interface utilisateur du commutateur. 1. Mettez à jour les filtres de temps et de distance en cas de besoin. + **Opérations de suivi :** Ouvrez l'écran de suivi et effectuez les opérations suivantes : + Vous pouvez démarrer et arrêter le suivi au premier plan, en arrière-plan ou en mode économie de batterie en appuyant sur les boutons correspondants.