Lisa testing pulling in plugins for plugin: cordova-plugin-geolocation
Project: http://git-wip-us.apache.org/repos/asf/cordova-plugin-geolocation/repo Commit: http://git-wip-us.apache.org/repos/asf/cordova-plugin-geolocation/commit/c0ac7e4e Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-geolocation/tree/c0ac7e4e Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-geolocation/diff/c0ac7e4e Branch: refs/heads/master Commit: c0ac7e4e2308366116e86186c396bb3e87756daf Parents: d31aa03 Author: ldeluca <[email protected]> Authored: Thu Feb 27 11:14:47 2014 -0500 Committer: ldeluca <[email protected]> Committed: Thu Feb 27 11:14:47 2014 -0500 ---------------------------------------------------------------------- doc/fr/index.md | 256 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 256 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/cordova-plugin-geolocation/blob/c0ac7e4e/doc/fr/index.md ---------------------------------------------------------------------- diff --git a/doc/fr/index.md b/doc/fr/index.md new file mode 100644 index 0000000..4993612 --- /dev/null +++ b/doc/fr/index.md @@ -0,0 +1,256 @@ +<!--- + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. +--> + +# org.apache.cordova.geolocation + +Ce plugin fournit des informations sur l'emplacement de l'appareil, tels que la latitude et la longitude. Les sources habituelles d'information incluent le Système de Positionnement Global (GPS) et la position déduite de signaux des réseaux tels que l'adresse IP, RFID, les adresses MAC WiFi et Bluetooth et les IDs cellulaires GSM/CDMA. Il n'y a cependant aucune garantie que cette API renvoie la position réelle de l'appareil. + +Cette API est basée sur la [Spécification de l'API Geolocation du W3C][1] et s'exécute uniquement sur les appareils qui n'en proposent pas déjà une implémentation. + + [1]: http://dev.w3.org/geo/api/spec-source.html + +**Avertissement**: collecte et utilisation des données de géolocalisation soulève des questions importantes de la vie privée. La politique de confidentialité de votre application devrait traiter de la manière dont l'application utilise les données de géolocalisation, si elle les partage avec d'autres parties ou non et définir le niveau de précision de celles-ci (par exemple grossier, fin, restreint au code postal, etc.). Données de géolocalisation sont généralement considéré comme sensibles car elle peut révéler la localisation de l'utilisateur et, si stocké, l'histoire de leurs voyages. Par conséquent, en plus de la politique de confidentialité de l'application, vous devez envisager fortement fournissant un avis juste-à -temps, avant que l'application accède aux données de géolocalisation (si le système d'exploitation de périphérique n'est pas faire déjà ). Cette notice devrait contenir les informations susmentionnées, ainsi que permettre de recueillir l'autorisation de l'utilisateur (par exemple, en offrant les possibilités **OK** et **Non merci**). Pour plus d'informations, veuillez vous référer à la section "Guide du respect de la vie privée". + +## Installation + + cordova plugin add org.apache.cordova.geolocation + + +### Firefox OS Quirks + +Créez **www/manifest.webapp** comme décrit dans [Les Docs manifeste][2]. Ajouter permisions : + + [2]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest + + "permissions": { + "geolocation": { "description": "Used to position the map to your current position" } + } + + +## Plates-formes prises en charge + +* Amazon Fire OS +* Android +* BlackBerry 10 +* Firefox OS +* iOS +* Paciarelli +* Windows Phone 7 et 8 +* Windows 8 + +## Méthodes + +* navigator.geolocation.getCurrentPosition +* navigator.geolocation.watchPosition +* navigator.geolocation.clearWatch + +## Objets (lecture seule) + +* Position +* PositionError +* Coordonnées + +## navigator.geolocation.getCurrentPosition + +Retourne la position actuelle de l'appareil à la `geolocationSuccess` rappel avec un `Position` objet comme paramètre. Si une erreur se produit, un objet `PositionError` est passé en paramètre à la fonction callback `geolocationError`. + + navigator.geolocation.getCurrentPosition(geolocationSuccess, + [geolocationError], + [geolocationOptions]); + + +### Paramètres + +* **geolocationSuccess** : la fonction callback à laquelle est transmise la position actuelle. + +* **geolocationError** : *(facultative)* la fonction callback s'exécutant si une erreur survient. + +* **geolocationOptions** : *(facultatives)* des préférences de géolocalisation. + +### Exemple + + // onSuccess Callback + // This method accepts a Position object, which contains the + // current GPS coordinates + // + var onSuccess = function(position) { + alert('Latitude: ' + position.coords.latitude + '\n' + + 'Longitude: ' + position.coords.longitude + '\n' + + 'Altitude: ' + position.coords.altitude + '\n' + + 'Accuracy: ' + position.coords.accuracy + '\n' + + 'Altitude Accuracy: ' + position.coords.altitudeAccuracy + '\n' + + 'Heading: ' + position.coords.heading + '\n' + + 'Speed: ' + position.coords.speed + '\n' + + 'Timestamp: ' + position.timestamp + '\n'); + }; + + // onError Callback receives a PositionError object + // + function onError(error) { + alert('code: ' + error.code + '\n' + + 'message: ' + error.message + '\n'); + } + + navigator.geolocation.getCurrentPosition(onSuccess, onError); + + +## navigator.geolocation.watchPosition + +Retourne la position actuelle de l'appareil lorsqu'un changement de position est détecté. Lorsque l'appareil récupère un nouvelle position, la fonction callback `geolocationSuccess` est exécutée avec un objet `Position` comme paramètre. Si une erreur se produit, la fonction callback `geolocationError` est appelée avec un obet `PositionError` comme paramètre. + + var watchId = navigator.geolocation.watchPosition(geolocationSuccess, + [geolocationError], + [geolocationOptions]); + + +### Paramètres + +* **geolocationSuccess**: la fonction de rappel qui est passée de la position actuelle. + +* **geolocationError** : (facultative) la fonction callback s'exécutant lorsqu'une erreur survient. + +* **geolocationOptions** : (facultatives) options de personnalisation de la géolocalisation. + +### Retourne + +* **Chaîne**: retourne un id de montre qui fait référence à l'intervalle de position montre. L'id de la montre doit être utilisé avec `navigator.geolocation.clearWatch` d'arrêter de regarder pour les changements de position. + +### Exemple + + // onSuccess Callback + // This method accepts a `Position` object, which contains + // the current GPS coordinates + // + function onSuccess(position) { + var element = document.getElementById('geolocation'); + element.innerHTML = 'Latitude: ' + position.coords.latitude + '<br />' + + 'Longitude: ' + position.coords.longitude + '<br />' + + '<hr />' + element.innerHTML; + } + + // onError Callback receives a PositionError object + // + function onError(error) { + alert('code: ' + error.code + '\n' + + 'message: ' + error.message + '\n'); + } + + // Options: throw an error if no update is received every 30 seconds. + // + var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { timeout: 30000 }); + + +## geolocationOptions + +Paramètres optionnels permettant la personnalisation de la récupération d'une `Position` géolocalisée. + + { maximumAge: 3000, timeout: 5000, enableHighAccuracy: true }; + + +### Options + +* **enableHighAccuracy** : indique que l'application nécessite les meilleurs résultats possibles. Par défaut, l'appareil tente de récupérer une `Position` à l'aide de méthodes basées sur le réseau. Définir cette propriété à `true` demande à Cordova d'utiliser des méthodes plus précises, telles que la localisation par satellite. *(Boolean)* + +* **délai d'attente**: la longueur maximale de temps (en millisecondes) qui peut passer de l'appel à `navigator.geolocation.getCurrentPosition` ou `geolocation.watchPosition` jusqu'à ce que le correspondant `geolocationSuccess` rappel s'exécute. Si `geolocationSuccess` n'est pas appelée dans ce délai, le code d'erreur `PositionError.TIMEOUT` est transmis à la fonction callback `geolocationError`. (Notez que, dans le cas de `geolocation.watchPosition`, la fonction callback `geolocationError` pourrait être appelée à un intervalle régulier de `timeout` millisecondes !) *(Number)* + +* **maximumAge** : accepter une position mise en cache dont l'âge ne dépasse pas le délai spécifié en millisecondes. *(Number)* + +### Quirks Android + +Les émulateurs d'Android 2.x ne retournent aucun résultat de géolocalisation à moins que l'option `enableHighAccuracy` ne soit réglée sur `true`. + +## navigator.geolocation.clearWatch + +Arrêter d'observer les changements de position de l'appareil référencés par le paramètre `watchID`. + + navigator.geolocation.clearWatch(watchID); + + +### Paramètres + +* **watchID** : l'identifiant de l'intervalle `watchPosition` à effacer. (String) + +### Exemple + + // Options : observer les changements de position, et utiliser + // la méthode d'acquisition la plus précise disponible. + // + var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { enableHighAccuracy: true }); + + // ...later on... + + navigator.geolocation.clearWatch(watchID); + + +## Position + +Contient les coordonnées et l'horodatage de `Position` créés par l'API geolocation. + +### Propriétés + +* **coords** : un ensemble de coordonnées géographiques. *(Coordinates)* + +* **timestamp** : horodatage de la création de `coords`. *(Date)* + +## Coordonnées + +A `Coordinates` objet est attaché à un `Position` objet qui n'existe pas de fonctions de rappel dans les requêtes pour la position actuelle. Il contient un ensemble de propriétés qui décrivent les coordonnées géographiques d'une position. + +### Propriétés + +* **latitude** : latitude en degrés décimaux. *(Number)* + +* **longitude** : longitude en degrés décimaux. *(Number)* + +* **altitude** : hauteur de la position en mètres au-dessus de l'ellipsoïde. *(Number)* + +* **accuracy** : niveau de précision des valeurs de latitude et longitude, en mètres. *(Number)* + +* **altitudeAccuracy** : niveau de précision de la valeur d'altitude, en mètres. *(Number)* + +* **heading** : direction du trajet, indiquée en degrés comptés dans le sens horaire par rapport au vrai Nord. *(Number)* + +* **speed** : vitesse au sol actuelle de l'appareil, indiquée en mètres par seconde. *(Number)* + +### Amazon Fire OS Quirks + +**altitudeAccuracy** : n'est pas prise en charge par les appareils Android, renvoie alors `null`. + +### Quirks Android + +**altitudeAccuracy**: ne pas pris en charge par les appareils Android, retour`null`. + +## PositionError + +Le `PositionError` objet est passé à la `geolocationError` fonction de rappel lorsqu'une erreur se produit avec navigator.geolocation. + +### Propriétés + +* **code**: l'un des codes d'erreur prédéfinis énumérés ci-dessous. + +* **message** : un message d'erreur détaillant l'erreur rencontrée. + +### Constantes + +* `PositionError.PERMISSION_DENIED` + * Retourné lorsque les utilisateurs ne permettent pas l'application extraire des informations de position. Cela dépend de la plate-forme. +* `PositionError.POSITION_UNAVAILABLE` + * Retourné lorsque le périphérique n'est pas en mesure de récupérer une position. En général, cela signifie que l'appareil n'est pas connecté à un réseau ou ne peut pas obtenir un correctif de satellite. +* `PositionError.TIMEOUT` + * Retourné lorsque le périphérique n'est pas en mesure de récupérer une position dans le délai précisé par le `timeout` inclus dans `geolocationOptions` . Lorsqu'il est utilisé avec `navigator.geolocation.watchPosition` , cette erreur pourrait être transmise à plusieurs reprises à la `geolocationError` rappel chaque `timeout` millisecondes. \ No newline at end of file
