Cette page a été traduite par l'API Cloud Translation.

Déclencher des zones de géorepérage côté client pour suivre les ressources mobiles avec le SDK Nav

Ce document décrit le géorepérage côté client, les cas d'utilisation et la façon de l'appliquer aux cas d'utilisation dans une application mobile. Il explique également comment implémenter un exemple sur Android à l'aide du SDK Navigation Google.

SDK Nav avec détection de zone géographique — **SDK Navigation avec détection de géorepérage**

Les entreprises doivent souvent savoir quand un appareil mobile entre ou quitte une zone spécifique. Pour ce faire, des limites géographiques virtuelles, ou géorepérages, sont maintenues, ce qui permet au logiciel de déclencher des événements lorsqu'un appareil franchit une limite.

Il est important de savoir quand un véhicule traverse une limite pour plusieurs cas d'utilisation, par exemple:

Engagement client: les entreprises peuvent utiliser le géorepérage pour envoyer des notifications push aux utilisateurs finaux concernant des offres spéciales, des événements ou de nouveaux produits.
Sécurité: les entreprises peuvent utiliser le géorepérage pour créer des périmètres virtuels autour de zones sensibles, comme des centres de données ou des entrepôts, et alerter le personnel de sécurité si quelqu'un entre ou quitte la zone.
Transports: les entreprises peuvent utiliser le géorepérage pour suivre la position de leurs véhicules et optimiser leurs itinéraires et leurs horaires.

Il est donc important que vous sachiez comment représenter ces zones (polygones) dans une application destinée aux clients. Cette application doit suivre la position de l'appareil et vérifier s'il a franchi une certaine zone géographique.

Portée

Ce document se concentre sur une implémentation côté client du géorepérage . Cela signifie que l'application cliente doit disposer des éléments suivants:

Les polygones qu'il doit vérifier pour détecter les violations
Position en temps réel de l'utilisateur
Logique permettant de vérifier si l'emplacement actuel se trouve à l'intérieur ou à l'extérieur de l'un des polygones.

Ce guide inclut des exemples sur Android, mais il existe des méthodes équivalentes sur iOS. Le service de localisation Android dispose d'une implémentation intégrée pour les géorepérages circulaires, que vous pouvez consulter sur cette page. Le code de référence et la description ci-dessous constituent un point de départ pour des implémentations plus complexes.

SDK Navigation

Le SDK Navigation est une bibliothèque Android / iOS native ajoutée à l'application conducteur. Il est responsable des éléments suivants:

Obtenir les emplacements des points d'ancrage de la route à partir de l'application qui l'exécute. Cette méthode est plus précise que FusedLocationProvider (FLP) d'Android, car elle utilise le réseau routier de Google pour associer les positions au segment routier le plus proche, ce qui rend l'heure d'arrivée beaucoup plus précise, ainsi que d'autres informations de FLP.
Une expérience de navigation pas à pas qui permet aux conducteurs d'atteindre efficacement leur destination en tenant compte du trafic en temps réel et d'autres restrictions de parcours.
Déclenchement d'événements via des écouteurs d'événements et des rappels enregistrés.

Écouteurs

Le SDK Navigation propose de nombreux écouteurs que vous pouvez utiliser. dont les suivants :

Les modifications de position sont effectuées via le fournisseur RoadSnappedLocation.
Événements de recalcul d'itinéraire (l'utilisateur ne fait pas demi-tour, ne tourne pas à gauche, etc. et s'écarte de l'itinéraire recommandé) via ReroutingListener.
Événements d'arrivée (l'utilisateur arrive à la destination prévue) via ArrivalListener.
Événements de distance restante et d'heure d'arrivée prévue (recevoir une notification lorsque le conducteur est sur le point d'arriver à destination, en fonction des mètres ou du temps) disponibles via RemainingTimeOrDistanceChangedListener

Dans ce guide, seul le RoadSnappedLocationProvider et son LocationListener sont utilisés.

Solution de géorepérage côté client

Voyons maintenant comment créer une fonctionnalité de géorepérage côté client. Dans l'exemple ci-dessous, le SDK Navigation fonctionne en mode "Itinéraire détaillé" et un polygone est défini dans l'itinéraire pour représenter notre géorepérage.

Les géorepérages sont stockés dans BigQuery et récupérés par votre backend.
Le backend envoie régulièrement les géorepérages aux applications Drive.
Le conducteur se déplace et l'application du conducteur vérifie régulièrement les géorepérages pour détecter un déclencheur.
L'application conducteur informe le backend d'un événement déclencheur afin qu'il puisse agir.

À mesure que le véhicule avance sur le parcours, l'application vérifie régulièrement si le polygone a été franchi. Lorsque l'application détecte qu'elle a franchi une zone de géorepérage, un message Zone de géorepérage franchie s'affiche dans l'UI.

Configurer les dépendances pour Android-Maps-Utils

Cette solution utilise Android-Maps-Utils, une bibliothèque Open Source contenant des utilitaires utiles pour un large éventail d'applications utilisant l'API Android Google Maps.

Cette bibliothèque est publique et hébergée sur GitHub. Vous pouvez y accéder à l'adresse suivante:

Android: https://github.com/googlemaps/android-maps-utils
iOS: https://github.com/googlemaps/google-maps-ios-utils

Pour inclure cette bibliothèque dans votre application Android (champ d'application de ce document), vous devez modifier votre fichier build.gradle pour l'inclure. Notez que ce fichier build.gradle est destiné au module (application) que vous compilez, et non au niveau du projet.

dependencies {
   ...
   // Utilities for Maps SDK for Android (requires Google Play Services)
   implementation 'com.google.maps.android:android-maps-utils:2.3.0'
}

Ensuite, après avoir synchronisé Gradle avec votre dernier fichier build.gradle, vous pouvez importer com.google.maps.android.PolyUtil dans votre fichier Java:

import com.google.android.gms.maps.model.PolygonOptions;
import com.google.maps.android.PolyUtil;

Définir vos zones de géorepérage

Notez que PolygonOptions est également importé ici. En effet, c'est ce qui est utilisé pour représenter le polygone:

mPolygonOptions = new PolygonOptions()
       .add(new LatLng(29.4264525,-98.4948758))
       .add(new LatLng(29.4267029,-98.4948758))
       .add(new LatLng(29.4273742,-98.4945822))
       .add(new LatLng(29.4264562,-98.4943592))
       .fillColor(0x0000ff36)
       .strokePattern(Arrays.asList(new Dash(45.0f), new Gap(10.0f)))
       .strokeColor(Color.BLUE)
       .strokeWidth(5);

Comme vous pouvez le voir ci-dessus, nous définissons ici un polygone fixe avec des coordonnées prédéfinies (paires latitude, longitude). Toutefois, dans des scénarios réels, ces coordonnées et ces définitions de polygones proviennent le plus souvent d'un point de terminaison backend et seront probablement récupérées à distance. Cela signifie que le ou les polygones doivent être créés instantanément par l'application.

Pour en savoir plus sur ce qui peut être spécifié dans PolygonOptions, cliquez ici.

Vous devez définir le ou les polygones lors de la création de votre fragment ou de votre activité. Exemple :

protected void onCreate(Bundle savedInstanceState) {
   ...
   mPolygonOptions = new PolygonOptions()
           .add(new LatLng(29.4264525,-98.4948758))
           .add(new LatLng(29.4267029,-98.4948758))
           .add(new LatLng(29.4273742,-98.4945822))
           .add(new LatLng(29.4264562,-98.4943592))
           .fillColor(0x0000ff36)
           .strokePattern(Arrays.asList(new Dash(45.0f), new Gap(10.0f)))
           .strokeColor(Color.BLUE)
           .strokeWidth(5);

   ...// more code here
}

Écouter les mises à jour de la position

Une fois que vous avez défini vos géorepérages, il vous suffit de créer un écouteur de mise à jour de position pour vous abonner à l'événement mentionné ci-dessus dans le SDK Navigation appelé RoadSnappedLocationProvider, qui renvoie la dernière position de l'appareil.

mLocListener = new RoadSnappedLocationProvider.LocationListener() {
   @Override
   public void onLocationChanged(Location snapped) {
       LatLng snappedL = new LatLng(snapped.getLatitude(), snapped.getLongitude());
       if(PolyUtil.containsLocation(snappedL, mPolygonOptions.getPoints(), true) && !mGeofenceBreached){
           Log.d("Geofence", "Vehicle has breached the polygon");
       }
   }
   @Override
   public void onRawLocationUpdate(Location location) {
   }
};

Avec Android-Maps-Utils, vous pouvez utiliser PolyUtil.containsLocation pour vérifier si l'emplacement reçu se trouve dans le polygone prédéfini. Dans l'exemple ci-dessous, le polygone prédéfini, qui représente la zone géographique, est utilisé. En pratique, vous pouvez avoir plusieurs polygones et une boucle est alors nécessaire.

Une autre approche

Ce document se concentre sur une application destinée aux clients qui vérifie si une zone géographique personnalisée (polygone) est enfreinte. Toutefois, il peut arriver que vous souhaitiez effectuer de telles vérifications sur votre backend.

Cela signifie que l'application signale les mises à jour de position à un backend, qui vérifie ensuite si le véhicule a pénétré dans un certain polygone, et ne dépend donc pas de l'application cliente pour effectuer la validation.

Voici une solution possible:

[Environnement d'exécution] Architecture de géorepérage côté serveur

Exemple d'architecture illustrant une approche côté serveur du géorepérage

L'application du conducteur, à l'aide du SDK pilote, envoie des informations de localisation à Fleet Engine. Les mises à jour de la position et la navigation dans l'application sont effectuées via le SDK Navigation.
Fleet Engine génère ces mises à jour dans Cloud Logging ou Pub/Sub.
Le backend collecte ces signaux de localisation.
Les géorepérages sont stockés dans Big Query pour être analysés par le backend.
Lorsque la zone géographique est déclenchée, des alertes sont envoyées à l'application Driver.

Dans cette architecture, le SDK Driver et Fleet Engine sont utilisés. Fleet Engine peut émettre des mises à jour Pub/Sub et générer des entrées de journal dans Cloud Logging. Dans les deux cas, la position du véhicule peut être récupérée.

Le backend peut ensuite surveiller la file d'attente Pub/Sub, lire les journaux et surveiller les mises à jour des véhicules. Ensuite, chaque fois qu'une mise à jour est effectuée (ou toutes les quelques secondes, minutes, en fonction de son caractère critique), le backend peut appeler les fonctions SIG BigQuery pour déterminer si un véhicule donné se trouve à l'intérieur ou à l'extérieur des géorepérages. Si un ou plusieurs géorepérages ont été violés, le backend peut intervenir et déclencher des pipelines internes ou d'autres workflows pertinents.

Conclusion

Le géorepérage est un outil puissant qui peut être utilisé à des fins diverses. Les entreprises peuvent utiliser le géorepérage pour cibler les utilisateurs finaux avec des annonces et des promotions pertinentes, fournir des services basés sur la localisation et améliorer la sécurité.

Le SDK Navigation fournit des écouteurs d'événements utiles qui peuvent détecter de nombreux moments importants au cours d'un trajet. Les entreprises ont souvent besoin de zones géographiques personnalisées pour des cas d'utilisation spécifiques. Dans ce document, nous avons montré comment y parvenir, mais les possibilités sont infinies. Nous avons hâte de découvrir vos créations.

Étapes suivantes

Regardez le webinaire Explorer, apprendre et vous inspirer des possibilités offertes par Google Maps Platform.

Autres ressources recommandées:

SDK Navigation pour Android