Répondre aux mises à jour de localisation (HTML)
[ Cet article est destiné aux développeurs de Windows 8.x et Windows Phone 8.x qui créent des applications Windows Runtime. Si vous développez une application pour Windows 10, voir la Documentation ]
Cette rubrique explique comment répondre aux changements d’emplacement géographique de l’utilisateur.
Ce que vous devez savoir
Technologies
- Windows Runtime
Prérequis
Vous devez être familiarisé avec HTML et JavaScript.
Instructions
Étape 1: Vérifier que la localisation est activée
Pour que votre application puisse accéder à la fonction de localisation, l’option Emplacement doit être activée sur l’appareil. Dans l’application Paramètres, vérifiez que les paramètres de confidentialité relatifs à la géolocalisation suivants sont bien activés :
- Le paramètre Emplacement de cet appareil... est activé (non applicable dans Windows 10 Mobile).
- Le paramètre des services de localisation Emplacement est activé.
- Sous Choisir les applications qui peuvent utiliser votre emplacement, votre application est définie sur Activé.
Étape 2: Ouvrir Microsoft Visual Studio
Créez un projet, en choisissant une Application vide dans les types de projet Applications du Windows Store/JavaScript .
Étape 3: Créer un projet
Dans la boîte de dialogue Nouveau projet, choisissez une application vide dans les types de projets JavaScript.
Étape 4: Activer la fonctionnalité de localisation
Double-cliquez sur package.appxmanifest dans l’Explorateur de solutions pour les projets Windows et Windows Phone, puis sélectionnez l’onglet Capacités. Activez Emplacement dans la liste Capacités. Cette opération ajoute la fonctionnalité Location de l’appareil au fichier manifeste du package.
<Capabilities>
<!-- DeviceCapability elements must follow Capability elements (if present) -->
<DeviceCapability Name="location"/>
</Capabilities>
Étape 5: Remplacer le code JavaScript
Dans le projet partagé, ouvrez default.js (/js/default.js). Remplacez le code contenu dans le fichier par ce qui suit.
(function () {
"use strict";
var app = WinJS.Application;
var activation = Windows.ApplicationModel.Activation;
app.onactivated = function (args) {
if (args.detail.kind === activation.ActivationKind.launch) {
args.setPromise(WinJS.UI.processAll().
done(function () {
// Add an event handler to the button.
document.querySelector("#startTracking").addEventListener("click",
trackloc);
// Add an event handler to the button.
document.querySelector("#stopTracking").addEventListener("click",
stoptracking);
}));
}
};
var loc = null;
function trackloc() {
if (loc == null) {
loc = new Windows.Devices.Geolocation.Geolocator();
}
if (loc != null) {
loc.addEventListener("positionchanged", onPositionChanged);
loc.addEventListener("statuschanged", onStatusChanged);
// display initial status, in case location is turned off.
document.getElementById('geolocatorStatus').innerHTML =
getStatusString(loc.locationStatus);
}
}
function stoptracking() {
if (loc != null) {
loc.removeEventListener("positionchanged", onPositionChanged);
}
}
function onPositionChanged(args) {
var pos = args.position;
document.getElementById('latitude').innerHTML =
pos.coordinate.point.position.latitude;
document.getElementById('longitude').innerHTML =
pos.coordinate.point.position.longitude;
document.getElementById('accuracy').innerHTML =
pos.coordinate.accuracy;
document.getElementById('geolocatorStatus').innerHTML =
getStatusString(loc.locationStatus);
}
// Handle change in status to display an appropriate message.
function onStatusChanged(args) {
var newStatus = args.status;
document.getElementById('geolocatorStatus').innerHTML =
getStatusString(newStatus);
}
function getStatusString(locStatus) {
switch (locStatus) {
case Windows.Devices.Geolocation.PositionStatus.ready:
// Location data is available
return "Location is available.";
break;
case Windows.Devices.Geolocation.PositionStatus.initializing:
// This status indicates that a GPS is still acquiring a fix
return "A GPS device is still initializing.";
break;
case Windows.Devices.Geolocation.PositionStatus.noData:
// No location data is currently available
return "Data from location services is currently unavailable.";
break;
case Windows.Devices.Geolocation.PositionStatus.disabled:
// The app doesn't have permission to access location,
// either because location has been turned off.
return "Your location is currently turned off. " +
"Change your settings through the Settings charm " +
" to turn it back on.";
break;
case Windows.Devices.Geolocation.PositionStatus.notInitialized:
// This status indicates that the app has not yet requested
// location data by calling GetGeolocationAsync() or
// registering an event handler for the positionChanged event.
return "Location status is not initialized because " +
"the app has not requested location data.";
case Windows.Devices.Geolocation.PositionStatus.notAvailable:
// Location is not available on this version of Windows
return "You do not have the required location services " +
"present on your system.";
break;
default:
return "Unknown status.";
}
}
app.start();
})();
Étape 6: Ajouter le code HTML pour les applications
Ouvrez le fichier default.html des projets Windows et Windows Phone, puis copiez le code HTML suivant entre les balises BODY du fichier.
<p>Geolocation Event Sample</p><br />
<span id="status"></span><br />
<button id="startTracking">Track Location</button><br />
<br />
<button id="stopTracking">Stop Tracking</button><br />
Latitude: <span id="latitude">Waiting for update...</span><br />
Longitude: <span id="longitude">Waiting for update...</span><br />
Accuracy (in meters): <span id="accuracy">Waiting for update...</span><br />
Location Status: <span id="geolocatorStatus"></span><br />
Étape 7: Générer l’application
Sélectionnez Générer > Générer la solution pour générer le projet.
Étape 8: Tester l’application
- Dans le menu Déboguer, cliquez sur Démarrer le débogage pour tester la solution.
- La première fois que vous exécutez l’exemple, une invite vous demande si l’application peut utiliser votre localisation. Choisissez l’option Autoriser.
- Cliquez sur le bouton Obtenir la localisation pour obtenir la localisation actuelle.
Remarques
Les services de localisation utilisent un certain nombre de sources différentes pour déterminer l’emplacement. Si le GPS, le Wi-Fi et les stations cellulaires avoisinantes ne sont pas disponibles, ils auront alors recours à l’adresse IP. Dans ce cas, vous risquez de ne pas pouvoir obtenir les événements relatifs aux mises à jour de localisation, puisque les données des adresses IP ne sont pas mises à jour fréquemment.
Si votre application n’a besoin d’obtenir des données de géolocalisation qu’une seule fois, plutôt que de vous abonner aux mises à jour, utilisez la méthode GetGeopositionAsync décrite dans la section Démarrage rapide : détection de l’emplacement géographique d’un utilisateur.
Rubriques associées
Exemple de géolocalisation Windows 10