Localisation en Wi-Fi: portée avec DAR

Vous pouvez utiliser la fonctionnalité de localisation Wi-Fi fournie par le API Wi-Fi RTT (Round-Trip-Time) pour mesurer la distance à proximité de points d'accès Wi-Fi compatibles avec le texte en temps réel et de pairs Appareils Wi-Fi Aware.

Si vous mesurez la distance à trois points d'accès ou plus, vous pouvez utiliser un l'algorithme de multilatération pour estimer la position de l'appareil la mieux adaptée des mesures. En règle générale, le résultat est précis dans un rayon d'un à deux mètres.

Grâce à cette précision, vous pouvez développer des services précis basés sur la localisation, tels que navigation intérieure, commande vocale clarifiée (par exemple, "Activez ce par exemple) et des informations liées à votre position (par exemple, "Existe-t-il des offres spéciales pour ce produit ?").

L'appareil à l'origine de la demande n'a pas besoin de se connecter aux points d'accès pour mesurer avec le DAR Wi-Fi. Pour des raisons de confidentialité, seul l'appareil à l'origine de la demande peut pour déterminer la distance jusqu'au point d'accès ; les points d'accès n'ont pas ces informations. Les opérations DAR Wi-Fi sont illimitées pour les applications de premier plan, est limité pour les applications en arrière-plan.

Le DAR Wi-Fi et les fonctionnalités de mesure du temps précis (FTM) associées sont spécifié par la norme IEEE 802.11-2016. Le texte en temps réel Wi-Fi nécessite l'heure précise est fournie par FTM, car il calcule la distance entre en mesurant le temps nécessaire à un paquet pour effectuer un aller-retour en multipliant ce temps par la vitesse de la lumière.

Différences d'implémentation selon la version d'Android

Le DAR Wi-Fi a été introduit dans Android 9 (niveau d'API 28). Avec ce protocole pour déterminer la position d'un appareil à l'aide de la multilatération avec les appareils en cours d'exécution Android 9, vous devez avoir accès à des emplacements de points d'accès (PA) prédéterminés dans votre application. C'est à vous de décider comment stocker et récupérer ces données.

Sur les appareils équipés d'Android 10 (niveau d'API 29) ou version ultérieure, les données de localisation du point d'accès peuvent être représenté sous la forme ResponderLocation qui incluent la latitude, la longitude et l'altitude. Pour les points d'accès DAR Wi-Fi qui prendre en charge les informations de configuration d'emplacement/les rapports municipaux d'emplacement (données LCI/LCR) ; le protocole renvoie un objet ResponderLocation lors de la processus de mesure des distances.

Cette fonctionnalité permet aux applications d'interroger les points d'accès pour leur demander directement leur position plutôt que de devoir stocker ces informations à l'avance. Ainsi, votre application peut trouver des points d'accès et déterminer leur position même s'ils n'étaient pas connus auparavant, comme lorsqu'un utilisateur entre dans un nouveau bâtiment.

Conditions requises

• Le matériel de l'appareil qui effectue la requête de distance doit implémenter la Norme 802.11-2016 FTM.
• L'appareil à l'origine de la requête de mesure des distances doit exécuter Android 9 (niveau d'API) 28) ou version ultérieure.
• Les services de localisation doivent être activés sur l'appareil à l'origine de la demande de distance. et la recherche Wi-Fi activée (sous Paramètres > Localisation).
• Si l'application qui effectue la demande de mesure des distances cible Android 13 (niveau d'API 33) ou version ultérieure, il doit disposer du NEARBY_WIFI_DEVICES l'autorisation. Si une telle application cible une version antérieure d'Android, elle doit ont la ACCESS_FINE_LOCATION l'autorisation à la place.
• L'application doit interroger la plage de points d'accès lorsqu'elle est visible ou dans un service de premier plan. L'application ne peut pas accéder aux informations de localisation à partir du ou un arrière-plan.
• Le point d'accès doit respecter la norme FTM IEEE 802.11-2016.

Configuration

Pour configurer votre application afin d'utiliser le texte en temps réel via le Wi-Fi, procédez comme suit :

1. Demander des autorisations

Demandez les autorisations suivantes dans le fichier manifeste de votre application:

<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<!-- If your app targets Android 13 (API level 33)
     or higher, you must declare the NEARBY_WIFI_DEVICES permission. -->
<uses-permission android:name="android.permission.NEARBY_WIFI_DEVICES"
                 <!-- If your app derives location information from Wi-Fi APIs,
                      don't include the "usesPermissionFlags" attribute. -->
                 android:usesPermissionFlags="neverForLocation" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"
                 <!-- If any feature in your app relies on precise location
                      information, don't include the "maxSdkVersion"
                      attribute. -->
                 android:maxSdkVersion="32" />

Les autorisations NEARBY_WIFI_DEVICES et ACCESS_FINE_LOCATION sont dangereuses Vous devez donc les demander au moment de l'exécution chaque fois que l'utilisateur effectuer une recherche RTT. Votre application devra demander l'autorisation autorisation si elle n'a pas déjà été accordée. Pour en savoir plus, sur les autorisations d'exécution, consultez Demandez des autorisations d'application.

2. Vérifier si l'appareil est compatible avec le texte en temps réel via le Wi-Fi

Pour vérifier si l'appareil est compatible avec le DAR Wi-Fi, utilisez le API PackageManager:

context.packageManager.hasSystemFeature(PackageManager.FEATURE_WIFI_RTT)

context.getPackageManager().hasSystemFeature(PackageManager.FEATURE_WIFI_RTT);

3. Vérifier si le texte en temps réel via le Wi-Fi est disponible

Il est possible que le DAR Wi-Fi soit disponible sur l'appareil, mais qu'il ne soit pas disponible actuellement, car l'utilisateur a désactivé le Wi-Fi. En fonction de leur matériel et de leur micrologiciel il est possible que certains appareils ne soient pas compatibles avec le DAR Wi-Fi si SoftAP ou le partage de connexion en cours d'utilisation. Pour vérifier si le texte en temps réel via le Wi-Fi est disponible, appelez isAvailable()

La disponibilité du texte en temps réel Wi-Fi peut changer à tout moment. Votre application doit enregistrer un BroadcastReceiver pour recevoir ACTION_WIFI_RTT_STATE_CHANGED, qui est envoyé lorsque la disponibilité change. Lorsque votre application reçoit la diffusion l'application doit vérifier l'état actuel de la disponibilité et ajuster ses en conséquence.

Exemple :

val filter = IntentFilter(WifiRttManager.ACTION_WIFI_RTT_STATE_CHANGED)
val myReceiver = object: BroadcastReceiver() {

    override fun onReceive(context: Context, intent: Intent) {
        if (wifiRttManager.isAvailable) {
            …
        } else {
            …
        }
    }
}
context.registerReceiver(myReceiver, filter)

IntentFilter filter =
    new IntentFilter(WifiRttManager.ACTION_WIFI_RTT_STATE_CHANGED);
BroadcastReceiver myReceiver = new BroadcastReceiver() {
    @Override
    public void onReceive(Context context, Intent intent) {
        if (wifiRttManager.isAvailable()) {
            …
        } else {
            …
        }
    }
};
context.registerReceiver(myReceiver, filter);

Pour en savoir plus, consultez la section Diffusions.

Créer une demande de télémétrie

Une requête de mesure des distances (RangingRequest) est créé par spécifiant une liste de points d'accès ou de pairs Wi-Fi Aware auxquels une plage est demandée. Vous pouvez spécifier plusieurs points d'accès ou pairs Wi-Fi Aware dans une une requête de télémétrie unique ; les distances entre tous les appareils sont mesurées et renvoyées.

Par exemple, une requête peut utiliser addAccessPoint() pour spécifier un point d'accès auquel mesurer la distance:

val req: RangingRequest = RangingRequest.Builder().run {
    addAccessPoint(ap1ScanResult)
    addAccessPoint(ap2ScanResult)
    build()
}

RangingRequest.Builder builder = new RangingRequest.Builder();
builder.addAccessPoint(ap1ScanResult);
builder.addAccessPoint(ap2ScanResult);

RangingRequest req = builder.build();

Un point d'accès est identifié par son ScanResult, qui peut être obtenu en appelant WifiManager.getScanResults() Vous pouvez utiliser addAccessPoints(Liste) pour ajouter plusieurs points d'accès dans un lot.

De même, une demande de mesure de distance peut ajouter un pair Wi-Fi Aware à l'aide de son adresse MAC ou son PeerHandle, la addWifiAwarePeer(MacAddress peer) et addWifiAwarePeer(PeerHandle peer) . Pour en savoir plus sur la découverte de pairs Wi-Fi Aware, consultez la documentation sur Wi-Fi Aware.

Portée des requêtes

Une application émet une requête de mesure de distance à l'aide du WifiRttManager.startRanging() et en fournissant les éléments suivants : RangingRequest pour spécifier un Executor pour spécifier le contexte de rappel RangingResultCallback pour recevoir les résultats.

Exemple :

val mgr = context.getSystemService(Context.WIFI_RTT_RANGING_SERVICE) as WifiRttManager
val request: RangingRequest = myRequest
mgr.startRanging(request, executor, object : RangingResultCallback() {

    override fun onRangingResults(results: List<RangingResult>) { … }

    override fun onRangingFailure(code: Int) { … }
})

WifiRttManager mgr =
      (WifiRttManager) Context.getSystemService(Context.WIFI_RTT_RANGING_SERVICE);

RangingRequest request ...;
mgr.startRanging(request, executor, new RangingResultCallback() {

  @Override
  public void onRangingFailure(int code) { … }

  @Override
  public void onRangingResults(List<RangingResult> results) { … }
});

L'opération de mesure des distances est effectuée de manière asynchrone et les résultats sont renvoyées dans l'un des rappels RangingResultCallback:

• Si l'ensemble de l'opération de mesure des distances échoue, onRangingFailure est déclenché avec un code d'état décrit dans RangingResultCallback. Un tel échec peut se produire si le service ne peut pas exécuter une opération de mesure des distances. à ce moment-là, par exemple parce que le Wi-Fi est désactivé, parce que l'application a demandé trop d'opérations de mesure des distances et est limité, ou en raison d'une un problème d'autorisation.
• Une fois l'opération de mesure des distances terminée, onRangingResults est déclenché avec une liste de résultats correspondant à la liste des de requête : un résultat par requête. L'ordre des résultats ne dépend pas ne correspondent pas nécessairement à l'ordre des requêtes. Notez que l'opération de mesure des distances mais chaque résultat peut tout de même indiquer une défaillance les mesures.

Interpréter les résultats des distances

Chacun des résultats renvoyés par onRangingResults est spécifié par un RangingResult . Pour chaque requête, procédez comme suit :

1. Identifier la demande

Identifiez la demande d'après les informations fournies lors de la création de la RangingRequest: le plus souvent, une adresse MAC fournie dans le ScanResult identifiant un accès point d'accès. L'adresse MAC peut être obtenue à partir du résultat de la mesure des distances à l'aide de la méthode getMacAddress() .

La liste des résultats de mesure des distances peut ne pas s'afficher dans l'ordre des pairs (accès points) spécifiés dans la demande de distance. Vous devez donc utiliser l'adresse MAC pour identifier le pair, et non l'ordre des résultats.

2. Déterminer si chaque mesure a réussi

Pour déterminer si une mesure a réussi, utilisez le getStatus(). . Toute valeur autre que ÉTAT_SUCCÈS indique un échec. Un échec signifie que tous les autres champs de ce résultat (à l'exception de l'identification de la requête ci-dessus) ne sont pas valides, et les valeurs correspondantes La méthode get* échoue avec une erreur Exception IllegalStateException .

3. Obtenir des résultats pour chaque mesure réussie

Pour chaque mesure réussie, vous pouvez récupérer les valeurs des résultats avec le méthodes get respectives:

• Distance, en mm et écart type de la mesure:

  getDistanceMm().

  getDistanceStdDevMm()

• RSSI des paquets utilisés pour les mesures:

  getRssi()

• Heure, en millisecondes, à laquelle la mesure a été effectuée (il s'agit de l'heure depuis le démarrage):

  getRangingTimestampMillis()

• Nombre de mesures effectuées et nombre de mesures ayant réussi (et sur lesquels sont basées les mesures de distance):

  getNumFailededMeasurements()

  getNumSuccessMeasurements()

Appareils Android compatibles avec le DAR Wi-Fi

Les tableaux ci-dessous répertorient des téléphones, des points d'accès et des appareils destinés au commerce, à l'entreposage et aux centres de distribution. compatibles avec le DAR Wi-Fi. Ces outils sont loin d'être exhaustifs. Nous vous encourageons à nous contacter pour répertorier ici vos produits compatibles avec le texte en temps réel.

Points d'accès

Téléphones

Appareils pour la vente au détail, l'entreposage et la distribution