From fd95a441fcfc7643082369bced18563d014d3209 Mon Sep 17 00:00:00 2001
From: Victor Sosa <victorsh@apache.org>
Date: Fri, 27 Feb 2015 12:50:54 -0600
Subject: [PATCH] CB-8438 cordova-plugin-geolocation documentation translation:
 cordova-plugin-geolocation

---
 doc/de/index.md | 117 +++++++++++++++++++++++++++++++++--------------
 doc/es/index.md |  83 +++++++++++----------------------
 doc/fr/index.md |  18 ++++++--
 doc/it/index.md |  97 +++++++++++++++++++++++++++++----------
 doc/ja/index.md | 113 ++++++++++++++++++++++++++++++++++-----------
 doc/ko/index.md | 113 ++++++++++++++++++++++++++++++++-------------
 doc/pl/index.md | 101 +++++++++++++++++++++++++++++-----------
 doc/zh/index.md | 119 ++++++++++++++++++++++++++++++++++++------------
 8 files changed, 526 insertions(+), 235 deletions(-)

diff --git a/doc/de/index.md b/doc/de/index.md
index a7afd41d..96bfe858 100644
--- a/doc/de/index.md
+++ b/doc/de/index.md
@@ -27,6 +27,16 @@ Diese API basiert auf der [W3C Geolocation API-Spezifikation][1], und nur auf Ge
 
 **Warnung**: Erhebung und Nutzung von Geolocation-Daten wichtige Privatsphäre wirft. Wie die app benutzt Geolocation-Daten, Ihre app-Datenschutzrichtlinien zu diskutieren, ob es mit allen anderen Parteien und das Niveau der Genauigkeit der Daten (z. B. grob, fein, Postleitzahl, etc..) freigegeben ist. Geolocation-Daten gilt allgemein als empfindlich, weil es den Aufenthaltsort des Benutzers erkennen lässt und wenn gespeichert, die Geschichte von ihren Reisen. Daher neben der app-Privacy Policy sollten stark Sie Bereitstellung einer just-in-Time-Bekanntmachung, bevor die app Geolocation-Daten zugreift (wenn das Betriebssystem des Geräts bereits tun nicht). Diese Benachrichtigung sollte der gleichen Informationen, die vorstehend, sowie die Zustimmung des Benutzers (z.B. durch Präsentation Entscheidungen für das **OK** und **Nein danke**). Weitere Informationen finden Sie in der Datenschutz-Guide.
 
+Dieses Plugin definiert eine globale `navigator.geolocation`-Objekt (für Plattformen, bei denen es sonst fehlt).
+
+Obwohl das Objekt im globalen Gültigkeitsbereich ist, stehen Features von diesem Plugin nicht bis nach dem `deviceready`-Ereignis.
+
+    document.addEventListener("deviceready", onDeviceReady, false);
+    function onDeviceReady() {
+        console.log("navigator.geolocation works well");
+    }
+    
+
 ## Installation
 
     cordova plugin add org.apache.cordova.geolocation
@@ -53,13 +63,15 @@ Diese API basiert auf der [W3C Geolocation API-Spezifikation][1], und nur auf Ge
 
 *   Position
 *   Positionsfehler
-*   Koordinaten
+*   Coordinates
 
 ## navigator.geolocation.getCurrentPosition
 
-Gibt das Gerät die aktuelle Position auf der `geolocationSuccess` Rückruf mit einem `Position` Objekt als Parameter. Wenn ein Fehler auftritt, der `geolocationError` Rückruf wird übergeben ein `PositionError` Objekt.
+Gibt das Gerät aktuelle Position an den `geolocationSuccess`-Rückruf mit einem `Position`-Objekt als Parameter zurück. Wenn ein Fehler vorliegt, wird der Rückruf `geolocationError` ein `PositionError`-Objekt übergeben.
 
-    navigator.geolocation.getCurrentPosition (GeolocationSuccess, [GeolocationError], [GeolocationOptions]);
+    navigator.geolocation.getCurrentPosition(geolocationSuccess,
+                                             [geolocationError],
+                                             [geolocationOptions]);
     
 
 ### Parameter
@@ -72,18 +84,38 @@ Gibt das Gerät die aktuelle Position auf der `geolocationSuccess` Rückruf mit
 
 ### Beispiel
 
-    OnSuccess Rückruf / / diese Methode akzeptiert eine Position-Objekt, das enthält die / / aktuellen GPS-Koordinaten / / Var OnSuccess = function(position) {Warnung (' Breitengrad: ' + position.coords.latitude + '\n' + ' Länge: "+ position.coords.longitude + '\n' + ' Höhe: ' + position.coords.altitude + '\n' + ' Genauigkeit: ' + position.coords.accuracy + '\n' + ' Höhe Genauigkeit: ' + position.coords.altitudeAccuracy + '\n' + ' Überschrift: ' + position.coords.heading + '\n' + ' Geschwindigkeit: ' + position.coords.speed + '\n' + ' Timestamp: ' + position.timestamp + '\n');};
+    // 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 Rückruf erhält ein PositionError-Objekt / / function onError(error) {Alert ('Code: ' + error.code + '\n' + ' Nachricht: ' + error.message + '\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.getCurrentPosition(onSuccess, onError);
     
 
 ## navigator.geolocation.watchPosition
 
-Gibt das Gerät aktuelle Position zurück, wenn eine Änderung erkannt wird. Wenn das Gerät einen neuen Speicherort und ruft die `geolocationSuccess` Rückruf führt mit einem `Position` Objekt als Parameter. Wenn ein Fehler auftritt, der `geolocationError` Rückruf führt mit einem `PositionError` Objekt als Parameter.
+Gibt das Gerät aktuelle Position zurück, wenn eine Änderung erkannt wird. Wenn das Gerät einen neuen Speicherort abgerufen hat, führt der `geolocationSuccess`-Rückruf mit einer `Position`-Objekt als Parameter. Wenn ein Fehler vorliegt, führt der `geolocationError`-Rückruf mit einem `PositionError`-Objekt als Parameter.
 
-    Var WatchId = navigator.geolocation.watchPosition (GeolocationSuccess, [GeolocationError], [GeolocationOptions]);
+    var watchId = navigator.geolocation.watchPosition(geolocationSuccess,
+                                                      [geolocationError],
+                                                      [geolocationOptions]);
     
 
 ### Parameter
@@ -100,19 +132,34 @@ Gibt das Gerät aktuelle Position zurück, wenn eine Änderung erkannt wird. Wen
 
 ### Beispiel
 
-    OnSuccess Callback / / diese Methode akzeptiert eine 'Position'-Objekt, das enthält / / der aktuellen GPS-Koordinaten / / function onSuccess(position) {Var-Element = document.getElementById('geolocation');
-        element.innerHTML = ' Breitengrad: "+ position.coords.latitude + ' < Br / >' + ' Länge:" + position.coords.longitude + ' < Br / >' + ' < hr / >' + element.innerHTML;
-    } / / OnError Rückruf erhält ein PositionError-Objekt / / function onError(error) {Alert ('Code: ' + error.code + '\n' + ' Nachricht: ' + error.message + '\n');}
+    // 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');
+    }
     
-    Optionen: lösen Sie einen Fehler aus, wenn kein Update alle 30 Sekunden empfangen wird.
-    Var WatchID = navigator.geolocation.watchPosition (OnSuccess, OnError, {Timeout: 30000});
+    // Options: throw an error if no update is received every 30 seconds.
+    //
+    var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { timeout: 30000 });
     
 
 ## geolocationOptions
 
-Optionalen Parametern, um das Abrufen von der geolocation`Position`.
+Optionalen Parametern, um das Abrufen von Geolocation `Position`.
 
-    {MaximumAge: 3000, Timeout: 5000, EnableHighAccuracy: true};
+    { maximumAge: 3000, timeout: 5000, enableHighAccuracy: true };
     
 
 ### Optionen
@@ -125,11 +172,11 @@ Optionalen Parametern, um das Abrufen von der geolocation`Position`.
 
 ### Android Eigenarten
 
-Android 2.x-Emulatoren geben ein Geolocation-Ergebnis nicht zurück, es sei denn, die `enableHighAccuracy` Option auf festgelegt ist`true`.
+Android 2.x-Emulatoren geben ein Geolocation-Ergebnis nicht zurück, es sei denn, die `EnableHighAccuracy`-Option auf `true` festgelegt ist.
 
 ## navigator.geolocation.clearWatch
 
-Stoppen, gerade für Änderungen an das Gerät Stelle verweist die `watchID` Parameter.
+Stoppen Sie, gerade für Änderungen an dem Gerät Speicherort verweist mithilfe des Parameters `watchID`.
 
     navigator.geolocation.clearWatch(watchID);
     
@@ -140,55 +187,57 @@ Stoppen, gerade für Änderungen an das Gerät Stelle verweist die `watchID` Par
 
 ### Beispiel
 
-    Optionen: Achten Sie auf Änderungen der Position und verwenden Sie die / / genaue position Erwerbsart verfügbar.
-    Var WatchID = navigator.geolocation.watchPosition (OnSuccess, OnError, {EnableHighAccuracy: True});
+    // Options: watch for changes in position, and use the most
+    // accurate position acquisition method available.
+    //
+    var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { enableHighAccuracy: true });
     
-    ... veranstalten am...
+    // ...later on...
     
     navigator.geolocation.clearWatch(watchID);
     
 
 ## Position
 
-Enthält `Position` Koordinaten und Timestamp, erstellt von der Geolocation API.
+Enthält `Position` koordinaten und Timestamp, erstellt von der Geolocation API.
 
 ### Eigenschaften
 
-*   **CoOrds**: eine Reihe von geographischen Koordinaten. *(Koordinaten)*
+*   **coords**: eine Reihe von geographischen Koordinaten. *(Coordinates)*
 
-*   **Timestamp**: Zeitstempel der Erstellung für `coords` . *(Datum)*
+*   **timestamp**: Zeitstempel der Erstellung für `coords` . *(Date)*
 
-## Koordinaten
+## Coordinates
 
-A `Coordinates` Objekt an angeschlossen ist ein `Position` -Objekt, das Callback-Funktionen in Anforderungen für die aktuelle Position zur Verfügung steht. Es enthält eine Reihe von Eigenschaften, die die geographischen Koordinaten von einer Position zu beschreiben.
+Ein `Coordinates`-Objekt ist ein `Position`-Objekt zugeordnet, die Callback-Funktionen in Anforderungen für die aktuelle Position zur Verfügung steht. Es enthält eine Reihe von Eigenschaften, die die geographischen Koordinaten von einer Position zu beschreiben.
 
 ### Eigenschaften
 
-*   **Breitengrad**: Latitude in Dezimalgrad. *(Anzahl)*
+*   **latitude**: Latitude in Dezimalgrad. *(Anzahl)*
 
-*   **Länge**: Länge in Dezimalgrad. *(Anzahl)*
+*   **longitude**: Länge in Dezimalgrad. *(Anzahl)*
 
-*   **Höhe**: Höhe der Position in Meter über dem Ellipsoid. *(Anzahl)*
+*   **altitude**: Höhe der Position in Meter über dem Ellipsoid. *(Anzahl)*
 
-*   **Genauigkeit**: Genauigkeit der breiten- und Längengrad Koordinaten in Metern. *(Anzahl)*
+*   **accuracy**: Genauigkeit der breiten- und Längengrad Koordinaten in Metern. *(Anzahl)*
 
 *   **AltitudeAccuracy**: Genauigkeit der Koordinate Höhe in Metern. *(Anzahl)*
 
-*   **Rubrik**: Fahrtrichtung, angegeben in Grad relativ zu den Norden im Uhrzeigersinn gezählt. *(Anzahl)*
+*   **heading**: Fahrtrichtung, angegeben in Grad relativ zu den Norden im Uhrzeigersinn gezählt. *(Anzahl)*
 
-*   **Geschwindigkeit**: aktuelle Geschwindigkeit über Grund des Geräts, in Metern pro Sekunde angegeben. *(Anzahl)*
+*   **speed**: aktuelle Geschwindigkeit über Grund des Geräts, in Metern pro Sekunde angegeben. *(Anzahl)*
 
 ### Amazon Fire OS Macken
 
-**AltitudeAccuracy**: von Android-Geräten, Rückgabe nicht unterstützt`null`.
+**altitudeAccuracy**: von Android-Geräten, Rückgabe `null` nicht unterstützt.
 
 ### Android Eigenarten
 
-**AltitudeAccuracy**: von Android-Geräten, Rückgabe nicht unterstützt`null`.
+**altitudeAccuracy**: von Android-Geräten, Rückgabe `null` nicht unterstützt.
 
 ## Positionsfehler
 
-Das `PositionError` -Objekt übergeben, um die `geolocationError` Callback-Funktion tritt ein Fehler mit navigator.geolocation.
+Das `PositionError`-Objekt wird an die `geolocationError`-Callback-Funktion übergeben, tritt ein Fehler mit navigator.geolocation.
 
 ### Eigenschaften
 
diff --git a/doc/es/index.md b/doc/es/index.md
index 2a86a74a..e7d6e2d2 100644
--- a/doc/es/index.md
+++ b/doc/es/index.md
@@ -27,9 +27,17 @@ Esta API se basa en la [Especificación de API de geolocalización W3C][1] y só
 
 **ADVERTENCIA**: recopilación y uso de datos de geolocalización plantea cuestiones de privacidad importante. Política de privacidad de su aplicación debe discutir cómo la aplicación utiliza los datos de geolocalización, si se comparte con cualquiera de las partes y el nivel de precisión de los datos (por ejemplo, código postal grueso, fino, nivel, etc.). Datos de geolocalización es generalmente considerados sensibles porque puede revelar paradero del usuario y, si está almacenado, la historia de sus viajes. Por lo tanto, además de política de privacidad de la app, fuertemente considere dar un aviso de just-in-time antes de la aplicación tiene acceso a datos de geolocalización (si el sistema operativo del dispositivo ya no hacerlo). Que el aviso debe proporcionar la misma información mencionada, además de obtener un permiso del usuario (por ejemplo, presentando opciones para **Aceptar** y **No gracias**). Para obtener más información, por favor consulte a la guía de privacidad.
 
+Este plugin define un global `navigator.geolocation` objeto (para plataformas donde falta lo contrario).
+
+Aunque el objeto está en el ámbito global, características proporcionadas por este plugin no están disponibles hasta después de la `deviceready` evento.
+
+    document.addEventListener ("deviceready", onDeviceReady, false);
+    function onDeviceReady() {console.log ("navigator.geolocation funciona bien");}
+    
+
 ## Instalación
 
-    cordova plugin add org.apache.cordova.geolocation
+    Cordova plugin agregar org.apache.cordova.geolocation
     
 
 ## Plataformas soportadas
@@ -57,11 +65,9 @@ Esta API se basa en la [Especificación de API de geolocalización W3C][1] y só
 
 ## navigator.geolocation.getCurrentPosition
 
-Devuelve la posición actual del dispositivo a la `geolocationSuccess` "callback" con un `Position` objeto como parámetro. Si hay un error, el callback `geolocationError` se pasa un objeto `PositionError`.
+Devuelve la posición actual del dispositivo a la `geolocationSuccess` "callback" con un `Position` objeto como parámetro. Si hay un error, el `geolocationError` "callback" pasa un `PositionError` objeto.
 
-    navigator.geolocation.getCurrentPosition(geolocationSuccess,
-                                             [geolocationError],
-                                             [geolocationOptions]);
+    navigator.geolocation.getCurrentPosition (geolocationSuccess, [geolocationError], [geolocationOptions]);
     
 
 ### Parámetros
@@ -74,38 +80,18 @@ Devuelve la posición actual del dispositivo a la `geolocationSuccess` "callback
 
 ### Ejemplo
 
-    // 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');
-    };
+    onSuccess Callback / / este método acepta un objeto Position, que contiene el / / coordenadas GPS actual / / var onSuccess = function(position) {alert (' latitud: ' + position.coords.latitude + '\n' + ' longitud: ' + position.coords.longitude + '\n' + ' altitud: ' + position.coords.altitude + '\n' + ' exactitud: ' + position.coords.accuracy + '\n' + ' altitud exactitud: ' + position.coords.altitudeAccuracy + '\n' + ' hacia: ' + position.coords.heading + '\n' + ' velocidad: ' + 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');
-    }
+    onError Callback recibe un objeto PositionError / / function onError(error) {alert (' código: ' + error.code + '\n' + ' mensaje: ' + error.message + '\n');}
     
-    navigator.geolocation.getCurrentPosition(onSuccess, onError);
+    navigator.geolocation.getCurrentPosition (onSuccess, onError);
     
 
 ## navigator.geolocation.watchPosition
 
-Devuelve la posición actual del dispositivo cuando se detecta un cambio de posición. Cuando el dispositivo recupera una nueva ubicación, la devolución de llamada `geolocationSuccess` se ejecuta con un `Position` de objeto como parámetro. Si hay un error, el callback `geolocationError` se ejecuta con un objeto `PositionError` como parámetro.
+Devuelve la posición actual del dispositivo cuando se detecta un cambio de posición. Cuando el dispositivo recupera una nueva ubicación, el `geolocationSuccess` devolución de llamada se ejecuta con un `Position` objeto como parámetro. Si hay un error, el `geolocationError` devolución de llamada se ejecuta con un `PositionError` objeto como parámetro.
 
-    var watchId = navigator.geolocation.watchPosition(geolocationSuccess,
-                                                      [geolocationError],
-                                                      [geolocationOptions]);
+    var watchId = navigator.geolocation.watchPosition (geolocationSuccess, [geolocationError], [geolocationOptions]);
     
 
 ### Parámetros
@@ -122,34 +108,19 @@ Devuelve la posición actual del dispositivo cuando se detecta un cambio de posi
 
 ### Ejemplo
 
-    // 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');
-    }
+    onSuccess Callback / / este método acepta un objeto 'Position', que contiene / / coordenadas GPS de la corriente / / function onSuccess(position) {var elemento = document.getElementById('geolocation');
+        element.innerHTML = ' latitud: ' + position.coords.latitude + ' < br / >' + ' longitud: ' + position.coords.longitude + ' < br / >' + ' < hr / >' + element.innerHTML;
+    } / / onError Callback recibe un objeto PositionError / / function onError(error) {alert (' código: ' + error.code + '\n' + ' mensaje: ' + error.message + '\n');}
     
-    // Options: throw an error if no update is received every 30 seconds.
-    //
-    var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { timeout: 30000 });
+    Opciones: tira un error si no se recibe ninguna actualización cada 30 segundos.
+    var watchID = navigator.geolocation.watchPosition (onSuccess, onError, { timeout: 30000 });
     
 
 ## geolocationOptions
 
 Parámetros opcionales para personalizar la recuperación de la geolocalización`Position`.
 
-    {maximumAge: 3000, timeout: 5000, enableHighAccuracy: true};
+    { maximumAge: 3000, timeout: 5000, enableHighAccuracy: true };
     
 
 ### Opciones
@@ -166,7 +137,7 @@ Emuladores Android 2.x no devuelva un resultado de geolocalización a menos que
 
 ## navigator.geolocation.clearWatch
 
-Deja de ver cambios en la ubicación del dispositivo al que hace referencia el parámetro `watchID`.
+Deja de ver cambios en la ubicación del dispositivo al que hace referencia el `watchID` parámetro.
 
     navigator.geolocation.clearWatch(watchID);
     
@@ -177,12 +148,10 @@ Deja de ver cambios en la ubicación del dispositivo al que hace referencia el p
 
 ### Ejemplo
 
-    // Opciones: ver los cambios en la posición y usar más 
-    // exacta posición disponible del método de adquisición.
-    //
-    var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { enableHighAccuracy: true });
+    Opciones: ver los cambios en la posición y usar más / / exacta posición disponible del método de adquisición.
+    var watchID = navigator.geolocation.watchPosition (onSuccess, onError, { enableHighAccuracy: true });
     
-    // ...despues de...
+    ... después de...
     
     navigator.geolocation.clearWatch(watchID);
     
diff --git a/doc/fr/index.md b/doc/fr/index.md
index 472b8095..003c8db4 100644
--- a/doc/fr/index.md
+++ b/doc/fr/index.md
@@ -27,9 +27,17 @@ Cette API est basée sur la [Spécification de l'API Geolocation du W3C][1] et s
 
 **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".
 
+Ce plugin définit un global `navigator.geolocation` objet (pour les plateformes où il est autrement manquant).
+
+Bien que l'objet est dans la portée globale, les fonctions offertes par ce plugin ne sont pas disponibles jusqu'après la `deviceready` événement.
+
+    document.addEventListener (« deviceready », onDeviceReady, false) ;
+    function onDeviceReady() {console.log ("navigator.geolocation fonctionne bien");}
+    
+
 ## Installation
 
-    cordova plugin add org.apache.cordova.geolocation
+    Cordova plugin ajouter org.apache.cordova.geolocation
     
 
 ## Plates-formes prises en charge
@@ -105,14 +113,14 @@ Retourne la position actuelle de l'appareil lorsqu'un changement de position est
     } / / onError rappel reçoit un objet PositionError / / function onError(error) {alert ('code: ' + error.code + « \n » + "message: ' + error.message + « \n »);}
     
     Options : lever une erreur si aucune mise à jour n'est reçu toutes les 30 secondes.
-    var watchID = navigator.geolocation.watchPosition (onSuccess, onError, {timeout : 30000}) ;
+    var watchID = navigator.geolocation.watchPosition (onSuccess, onError, { timeout: 30000 }) ;
     
 
 ## geolocationOptions
 
 Paramètres optionnels pour personnaliser la récupération de la géolocalisation`Position`.
 
-    {maximumAge : 3000, délai d'attente : 5000, enableHighAccuracy : true} ;
+    { maximumAge: 3000, timeout: 5000, enableHighAccuracy: true } ;
     
 
 ### Options
@@ -141,7 +149,7 @@ Arrêter de regarder pour les modifications à l'emplacement de l'appareil réf
 ### Exemple
 
     Options : suivi des modifications dans la position et utilise le plus / / exacte position méthode d'acquisition disponible.
-    var watchID = navigator.geolocation.watchPosition (onSuccess, onError, {enableHighAccuracy : true}) ;
+    var watchID = navigator.geolocation.watchPosition (onSuccess, onError, { enableHighAccuracy: true }) ;
     
     .. plus sur...
     
@@ -184,7 +192,7 @@ A `Coordinates` objet est attaché à un `Position` objet qui n'existe pas de fo
 
 ### Quirks Android
 
-**altitudeAccuracy** : n'est pas prise en charge par les appareils Android, renvoie alors `null`.
+**altitudeAccuracy**: ne pas pris en charge par les appareils Android, retour`null`.
 
 ## PositionError
 
diff --git a/doc/it/index.md b/doc/it/index.md
index 1f072c8b..5e89a457 100644
--- a/doc/it/index.md
+++ b/doc/it/index.md
@@ -27,6 +27,16 @@ Questa API è basata sulla [Specifica di W3C Geolocation API][1]e viene eseguito
 
 **Avviso**: raccolta e utilizzo dei dati di geolocalizzazione solleva questioni di privacy importante. Politica sulla privacy dell'app dovrebbe discutere come app utilizza dati di geolocalizzazione, se è condiviso con altre parti e il livello di precisione dei dati (ad esempio, Cap grossolana, fine, livello, ecc.). Dati di geolocalizzazione sono generalmente considerati sensibili perché può rivelare la sorte dell'utente e, se conservati, la storia dei loro viaggi. Pertanto, oltre alla politica di privacy dell'app, è fortemente consigliabile fornendo un preavviso di just-in-time prima app accede ai dati di geolocalizzazione (se il sistema operativo del dispositivo non farlo già). Tale comunicazione deve fornire le informazioni stesse notate sopra, oltre ad ottenere l'autorizzazione (ad esempio, presentando scelte per **OK** e **No grazie**). Per ulteriori informazioni, vedere la guida sulla Privacy.
 
+Questo plugin definisce un oggetto globale `navigator.geolocation` (per le piattaforme dove altrimenti è manca).
+
+Sebbene l'oggetto sia in ambito globale, funzionalità fornite da questo plugin non sono disponibili fino a dopo l'evento `deviceready`.
+
+    document.addEventListener("deviceready", onDeviceReady, false);
+    function onDeviceReady() {
+        console.log("navigator.geolocation works well");
+    }
+    
+
 ## Installazione
 
     cordova plugin add org.apache.cordova.geolocation
@@ -57,9 +67,11 @@ Questa API è basata sulla [Specifica di W3C Geolocation API][1]e viene eseguito
 
 ## navigator.geolocation.getCurrentPosition
 
-Restituisce la posizione corrente del dispositivo per la `geolocationSuccess` callback con un `Position` oggetto come parametro. Se c'è un errore, il `geolocationError` callback viene passata una `PositionError` oggetto.
+Restituisce la posizione corrente del dispositivo il callback di `geolocationSuccess` con un `Position` di oggetto come parametro. Se c'è un errore, `geolocationError` callback viene passato un oggetto `PositionError`.
 
-    navigator.geolocation.getCurrentPosition (geolocationSuccess, [geolocationError], [geolocationOptions]);
+    navigator.geolocation.getCurrentPosition(geolocationSuccess,
+                                             [geolocationError],
+                                             [geolocationOptions]);
     
 
 ### Parametri
@@ -72,18 +84,38 @@ Restituisce la posizione corrente del dispositivo per la `geolocationSuccess` ca
 
 ### Esempio
 
-    onSuccess Callback / / questo metodo accetta un oggetto posizione che contiene il / / coordinate GPS corrente / / onSuccess var = function(position) {alert (' latitudine: ' + position.coords.latitude + '\n' + ' Longitudine: ' + position.coords.longitude + '\n' + ' altitudine: ' + position.coords.altitude + '\n' + ' accuratezza: ' + position.coords.accuracy + '\n' + ' altitudine accuratezza: ' + position.coords.altitudeAccuracy + '\n' + ' rubrica: ' + position.coords.heading + '\n' + ' Velocità: ' + position.coords.speed + '\n' + ' Timestamp: ' + position.timestamp + '\n');};
+    // 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 riceve un oggetto di PositionError / / function onError(error) {alert (' codice: ' Error + + '\n' + ' messaggio: ' + error.message + '\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.getCurrentPosition(onSuccess, onError);
     
 
 ## navigator.geolocation.watchPosition
 
-Restituisce la posizione corrente del dispositivo quando viene rilevata una modifica della posizione. Quando il dispositivo recupera una nuova posizione, la `geolocationSuccess` callback viene eseguita con un `Position` oggetto come parametro. Se c'è un errore, il `geolocationError` callback viene eseguita con un `PositionError` oggetto come parametro.
+Restituisce la posizione corrente del dispositivo quando viene rilevata una modifica della posizione. Quando il dispositivo recupera una nuova posizione, il callback `geolocationSuccess` esegue con un `Position` di oggetto come parametro. Se c'è un errore, `geolocationError` callback viene eseguito con un oggetto `PositionError` come parametro.
 
-    var watchId = navigator.geolocation.watchPosition (geolocationSuccess, [geolocationError], [geolocationOptions]);
+    var watchId = navigator.geolocation.watchPosition(geolocationSuccess,
+                                                      [geolocationError],
+                                                      [geolocationOptions]);
     
 
 ### Parametri
@@ -100,19 +132,34 @@ Restituisce la posizione corrente del dispositivo quando viene rilevata una modi
 
 ### Esempio
 
-    onSuccess Callback / / questo metodo accetta un oggetto 'Position', che contiene / / corrente coordinate GPS / / function onSuccess(position) {var elemento = document.getElementById('geolocation');
-        Element. InnerHtml = ' latitudine: ' + position.coords.latitude + ' < br / >' + ' Longitudine: ' + position.coords.longitude + ' < br / >' + ' < hr / >' + element. InnerHtml;
-    } / / onError Callback riceve un oggetto di PositionError / / function onError(error) {alert (' codice: ' Error + + '\n' + ' messaggio: ' + error.message + '\n');}
+    // 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');
+    }
     
-    Opzioni: generare un errore se non si è ricevuto nessun aggiornamento ogni 30 secondi.
-    var watchID = navigator.geolocation.watchPosition (onSuccess, onError, {timeout: 30000});
+    // Options: throw an error if no update is received every 30 seconds.
+    //
+    var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { timeout: 30000 });
     
 
 ## geolocationOptions
 
-Parametri opzionali per personalizzare il recupero di geolocalizzazione`Position`.
+Parametri opzionali per personalizzare il recupero di geolocalizzazione `Position`.
 
-    {maximumAge: 3000, timeout: 5000, enableHighAccuracy: true};
+    { maximumAge: 3000, timeout: 5000, enableHighAccuracy: true };
     
 
 ### Opzioni
@@ -125,11 +172,11 @@ Parametri opzionali per personalizzare il recupero di geolocalizzazione`Position
 
 ### Stranezze Android
 
-Emulatori Android 2. x non restituiscono un risultato di geolocalizzazione a meno che il `enableHighAccuracy` opzione è impostata su`true`.
+Emulatori Android 2. x non restituiscono un risultato di geolocalizzazione a meno che l'opzione `enableHighAccuracy` è impostata su `true`.
 
 ## navigator.geolocation.clearWatch
 
-Smettere di guardare per le modifiche alla posizione del dispositivo a cui fa riferimento la `watchID` parametro.
+Smettere di guardare per le modifiche alla posizione del dispositivo a cui fa riferimento il parametro `watchID`.
 
     navigator.geolocation.clearWatch(watchID);
     
@@ -140,17 +187,19 @@ Smettere di guardare per le modifiche alla posizione del dispositivo a cui fa ri
 
 ### Esempio
 
-    Opzioni: guardare per cambiamenti di posizione e utilizzare più / / preciso metodo di acquisizione disponibile position.
-    var watchID = navigator.geolocation.watchPosition (onSuccess, onError, {enableHighAccuracy: true});
+    // Options: watch for changes in position, and use the most
+    // accurate position acquisition method available.
+    //
+    var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { enableHighAccuracy: true });
     
-    ... spedale su...
+    // ...later on...
     
     navigator.geolocation.clearWatch(watchID);
     
 
 ## Position
 
-Contiene `Position` coordinate e timestamp, creato da geolocation API.
+Contiene le coordinate della `Position` e timestamp, creato da geolocation API.
 
 ### Proprietà
 
@@ -160,7 +209,7 @@ Contiene `Position` coordinate e timestamp, creato da geolocation API.
 
 ## Coordinates
 
-A `Coordinates` oggetto è associato a un `Position` oggetto disponibile per le funzioni di callback in richieste per la posizione corrente. Contiene un insieme di proprietà che descrivono le coordinate geografiche di una posizione.
+Un oggetto `Coordinates` è associato a un oggetto `Position` disponibile per le funzioni di callback in richieste per la posizione corrente. Contiene un insieme di proprietà che descrivono le coordinate geografiche di una posizione.
 
 ### Proprietà
 
@@ -180,15 +229,15 @@ A `Coordinates` oggetto è associato a un `Position` oggetto disponibile per le
 
 ### Amazon fuoco OS stranezze
 
-**altitudeAccuracy**: non supportato dai dispositivi Android, restituendo`null`.
+**altitudeAccuracy**: non supportato dai dispositivi Android, restituendo `null`.
 
 ### Stranezze Android
 
-**altitudeAccuracy**: non supportato dai dispositivi Android, restituendo`null`.
+**altitudeAccuracy**: non supportato dai dispositivi Android, restituendo `null`.
 
 ## PositionError
 
-Il `PositionError` oggetto è passato per la `geolocationError` funzione di callback quando si verifica un errore con navigator.geolocation.
+L'oggetto `PositionError` viene passato alla funzione di callback `geolocationError` quando si verifica un errore con navigator.geolocation.
 
 ### Proprietà
 
diff --git a/doc/ja/index.md b/doc/ja/index.md
index c9bd1b13..7d7ad4af 100644
--- a/doc/ja/index.md
+++ b/doc/ja/index.md
@@ -27,6 +27,16 @@
 
 **警告**: 地理位置情報データの収集と利用を重要なプライバシーの問題を発生させます。 アプリのプライバシー ポリシーは他の当事者とデータ (たとえば、粗い、罰金、郵便番号レベル、等) の精度のレベルでは共有されているかどうか、アプリが地理位置情報データを使用する方法を議論すべきです。 地理位置情報データと一般に見なされる敏感なユーザーの居場所を開示することができますので、彼らの旅行の歴史保存されている場合。 したがって、アプリのプライバシー ポリシーに加えて、強くする必要があります (デバイス オペレーティング システムしない場合そう既に)、アプリケーションに地理位置情報データをアクセスする前に - 時間のお知らせを提供します。 その通知は、上記の (例えば、 **[ok]**を**おかげで**選択肢を提示する) によってユーザーのアクセス許可を取得するだけでなく、同じ情報を提供する必要があります。 詳細については、プライバシーに関するガイドを参照してください。
 
+このプラグインは、グローバル `navigator.geolocation` オブジェクト (プラットフォーム行方不明ですそれ以外の場合) を定義します。
+
+オブジェクトは、グローバル スコープでですが、このプラグインによって提供される機能は、`deviceready` イベントの後まで使用できません。
+
+    document.addEventListener("deviceready", onDeviceReady, false);
+    function onDeviceReady() {
+        console.log("navigator.geolocation works well");
+    }
+    
+
 ## インストール
 
     cordova plugin add org.apache.cordova.geolocation
@@ -57,9 +67,11 @@
 
 ## navigator.geolocation.getCurrentPosition
 
-デバイスの現在の位置を返します、 `geolocationSuccess` コールバックを `Position` オブジェクトをパラメーターとして。 エラーがある場合、 `geolocationError` コールバックに渡される、 `PositionError` オブジェクト。
+`Position` オブジェクトを `geolocationSuccess` コールバックにパラメーターとしてデバイスの現在位置を返します。 エラーがある場合 `geolocationError` コールバックには、`PositionError` オブジェクトが渡されます。
 
-    navigator.geolocation.getCurrentPosition （geolocationSuccess、[geolocationError] [geolocationOptions]);
+    navigator.geolocation.getCurrentPosition(geolocationSuccess,
+                                             [geolocationError],
+                                             [geolocationOptions]);
     
 
 ### パラメーター
@@ -72,14 +84,38 @@
 
 ### 例
 
-    onSuccess コールバック/このメソッドを含む位置のオブジェクトを受け入れる/、/現在 GPS 座標///var onSuccess function(position) = {警告 (' 緯度: '+ position.coords.latitude + '\n' +' 経度: '+ position.coords.longitude + '\n' +' 高度: '+ position.coords.altitude + '\n' +' 精度: '+ position.coords.accuracy + '\n' +' 高度精度: '+ position.coords.altitudeAccuracy + '\n' +' 見出し: '+ position.coords.heading + '\n' +' 速度: '+ position.coords.speed + '\n' +' タイムスタンプ: ' + position.timestamp + '\n');};onError コールバックが PositionError オブジェクトを受け取る//onError(error) 関数 {警告 (' コード: '+ error.code + '\n' +' メッセージ: ' + error.message + '\n');}navigator.geolocation.getCurrentPosition (onSuccess、onError);
+    // 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
 
-位置の変更が検出された場合は、デバイスの現在位置を返します。 デバイスを新しい場所を取得するとき、 `geolocationSuccess` コールバックを実行すると、 `Position` オブジェクトをパラメーターとして。 エラーがある場合、 `geolocationError` コールバックを実行すると、 `PositionError` オブジェクトをパラメーターとして。
+位置の変更が検出された場合は、デバイスの現在位置を返します。 取得されると、デバイスの新しい場所、`geolocationSuccess` コールバック パラメーターとして `位置` オブジェクトを実行します。 エラーがある場合、`geolocationError` コールバック パラメーターとして `PositionError` オブジェクトで実行します。
 
-    var watchId = navigator.geolocation.watchPosition （geolocationSuccess、[geolocationError] [geolocationOptions]);
+    var watchId = navigator.geolocation.watchPosition(geolocationSuccess,
+                                                      [geolocationError],
+                                                      [geolocationOptions]);
     
 
 ### パラメーター
@@ -96,15 +132,34 @@
 
 ### 例
 
-    onSuccess コールバック//このメソッドを含む '位置' オブジェクトを受け入れる/現在の GPS 座標///onSuccess(position) 関数 {var 要素 = document.getElementById('geolocation');element.innerHTML = '緯度:' + position.coords.latitude + '< br/>' +' 経度: '+ position.coords.longitude +' < br/>' + ' < hr/>' + element.innerHTML;}/onError コールバックが PositionError オブジェクトを受け取る///onError(error) 関数 {警告 (' コード: '+ error.code + '\n' +' メッセージ: ' + error.message + '\n');}オプション: 30 秒ごとの更新を受信しない場合エラーをスローします。
-    var watchID = navigator.geolocation.watchPosition (onError、onSuccess {タイムアウト: 30000});
+    // 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
 
-地理位置情報の検索をカスタマイズするための省略可能なパラメーター`Position`.
+地理位置情報 `の位置` の検索をカスタマイズするための省略可能なパラメーター.
 
-    {maximumAge: 3000、タイムアウト: 5000、enableHighAccuracy: true};
+    { maximumAge: 3000, timeout: 5000, enableHighAccuracy: true };
     
 
 ### オプション
@@ -117,11 +172,11 @@
 
 ### Android の癖
 
-限り android 2.x エミュレーター地理位置情報の結果を返さない、 `enableHighAccuracy` オプションを設定します。`true`.
+`enableHighAccuracy` オプションが `true` に設定しない限り、アンドロイド 2.x エミュレーター地理位置情報の結果を返さない.
 
 ## navigator.geolocation.clearWatch
 
-によって参照される、デバイスの場所への変更を見て停止、 `watchID` パラメーター。
+`watchID` パラメーターによって参照される、デバイスの場所への変更を見て停止します。
 
     navigator.geolocation.clearWatch(watchID);
     
@@ -132,59 +187,63 @@
 
 ### 例
 
-    オプション: の位置では、変更を監視して最も//正確な位置取得法利用可能。
-    var watchID = navigator.geolocation.watchPosition （成功すると、onError、{enableHighAccuracy: true});... うな上.
+    // Options: watch for changes in position, and use the most
+    // accurate position acquisition method available.
+    //
+    var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { enableHighAccuracy: true });
+    
+    // ...later on...
     
     navigator.geolocation.clearWatch(watchID);
     
 
 ## Position
 
-含まれています `Position` 座標、地理位置情報 API で作成されたタイムスタンプ。
+`Position` 座標と地理位置情報 API で作成されたタイムスタンプが含まれます。
 
 ### プロパティ
 
 *   **coords**: 地理的座標のセット。*（座標）*
 
-*   **タイムスタンプ**: 作成のタイムスタンプを `coords` 。*（日）*
+*   **timestamp**: 作成のタイムスタンプを `coords` 。*（日）*
 
 ## Coordinates
 
-A `Coordinates` オブジェクトに使用されて、 `Position` は、現在の位置のための要求でコールバック関数を利用可能なオブジェクト。 位置の地理座標を記述するプロパティのセットが含まれています。
+`Coordinates` のオブジェクトは現在の位置のための要求でコールバック関数に使用する `Position` オブジェクトにアタッチされます。 位置の地理座標を記述するプロパティのセットが含まれています。
 
 ### プロパティ
 
-*   **緯度**: 10 度緯度。*(数)*
+*   **latitude**: 10 度緯度。*(数)*
 
-*   **経度**: 10 進度の経度。*(数)*
+*   **longitude**: 10 進度の経度。*(数)*
 
-*   **高度**: 楕円体上のメートルの位置の高さ。*(数)*
+*   **altitude**: 楕円体上のメートルの位置の高さ。*(数)*
 
-*   **精度**: メートルの緯度と経度座標の精度レベル。*(数)*
+*   **accuracy**: メートルの緯度と経度座標の精度レベル。*(数)*
 
 *   **altitudeAccuracy**： メートルの高度座標の精度レベル。*(数)*
 
-*   **見出し**: 進行方向、カウント、真北から時計回りの角度で指定します。*(数)*
+*   **headingし**: 進行方向、カウント、真北から時計回りの角度で指定します。*(数)*
 
-*   **速度**： 毎秒メートルで指定されたデバイスの現在の対地速度。*(数)*
+*   **speed**： 毎秒メートルで指定されたデバイスの現在の対地速度。*(数)*
 
 ### アマゾン火 OS 癖
 
-**altitudeAccuracy**： 返すの Android デバイスでサポートされていません`null`.
+**altitudeAccuracy**: `null` を返すことの Android デバイスでサポートされていません.
 
 ### Android の癖
 
-**altitudeAccuracy**： 返すの Android デバイスでサポートされていません`null`.
+**altitudeAccuracy**: `null` を返すことの Android デバイスでサポートされていません.
 
 ## PositionError
 
-`PositionError`オブジェクトに渡されます、 `geolocationError` navigator.geolocation でエラーが発生した場合のコールバック関数。
+`PositionError` オブジェクト navigator.geolocation でエラーが発生したときに `geolocationError` コールバック関数に渡されます。
 
 ### プロパティ
 
-*   **コード**: 次のいずれかの定義済みのエラー コード。
+*   **code**: 次のいずれかの定義済みのエラー コード。
 
-*   **メッセージ**: 発生したエラーの詳細を説明するエラー メッセージ。
+*   **message**: 発生したエラーの詳細を説明するエラー メッセージ。
 
 ### 定数
 
diff --git a/doc/ko/index.md b/doc/ko/index.md
index ddfd8bfb..cb161529 100644
--- a/doc/ko/index.md
+++ b/doc/ko/index.md
@@ -27,6 +27,16 @@
 
 **경고**: 중요 한 개인 정보 보호 문제를 제기 하는 위치 정보 데이터의 수집 및 사용 합니다. 응용 프로그램의 개인 정보 보호 정책 다른 당사자와의 데이터 (예를 들어, 굵고, 괜 찮 아 요, 우편 번호, 등)의 정밀도 수준을 공유 여부를 app 지리적 데이터를 사용 하는 방법 토론 해야 한다. 그것은 사용자의 행방을 밝힐 수 있기 때문에 및 저장, 그들의 여행 역사 지리적 위치 데이터는 일반적으로 민감한 간주. 따라서, 애플 리 케이 션의 개인 정보 보호 정책 뿐만 아니라 강력 하 게 좋습니다 (해당 되는 경우 장치 운영 체제 이렇게 이미 하지 않는) 응용 프로그램 위치 정보 데이터에 액세스 하기 전에 그냥--시간 통지. 그 통지는 (예를 들어, **확인** 및 **아니오**선택 제시) 하 여 사용자의 허가 취득 뿐만 아니라, 위에서 언급 된 동일한 정보를 제공 해야 합니다. 자세한 내용은 개인 정보 보호 가이드를 참조 하십시오.
 
+이 플러그인 (플랫폼은 그렇지 않으면 누락 된)에 대 한 전역 `navigator.geolocation` 개체를 정의 합니다.
+
+개체가 전역 범위에 있지만,이 플러그인에 의해 제공 되는 기능 하지 사용할 수 있습니다까지 `deviceready` 이벤트 후.
+
+    document.addEventListener("deviceready", onDeviceReady, false);
+    function onDeviceReady() {
+        console.log("navigator.geolocation works well");
+    }
+    
+
 ## 설치
 
     cordova plugin add org.apache.cordova.geolocation
@@ -57,9 +67,11 @@
 
 ## navigator.geolocation.getCurrentPosition
 
-디바이스의 현재 위치를 반환 합니다는 `geolocationSuccess` 로 콜백은 `Position` 매개 변수로 개체. 오류가 발생 하는 경우는 `geolocationError` 콜백 전달 되는 `PositionError` 개체.
+매개 변수 `Position` 개체와 `geolocationSuccess`를 디바이스의 현재 위치를 반환합니다. 오류가 있는 경우에, `geolocationError` 콜백 `PositionError` 개체에 전달 됩니다.
 
-    navigator.geolocation.getCurrentPosition (geolocationSuccess, [geolocationError] [geolocationOptions]);
+    navigator.geolocation.getCurrentPosition(geolocationSuccess,
+                                             [geolocationError],
+                                             [geolocationOptions]);
     
 
 ### 매개 변수
@@ -72,18 +84,38 @@
 
 ### 예를 들어
 
-    onSuccess 콜백 / /이 메서드 허용 위치 개체를 포함 하는 / 현재 GPS 좌표 / / / var onSuccess function(position) = {경고 (' 위도: ' + position.coords.latitude + '\n' + ' 경도: ' + position.coords.longitude + '\n' + ' 고도: ' + position.coords.altitude + '\n' + ' 정확도: ' + position.coords.accuracy + '\n' + ' 고도 정확도: ' + position.coords.altitudeAccuracy + '\n' + ' 제목: ' + position.coords.heading + '\n' + ' 속도: ' + position.coords.speed + '\n' + ' 타임 스탬프: ' + position.timestamp + '\n');};
+    // 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 콜백 수신 PositionError 개체 / / onError(error) 기능 {경고 (' 코드: ' error.code + '\n' + ' 메시지: ' error.message + '\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.getCurrentPosition(onSuccess, onError);
     
 
 ## navigator.geolocation.watchPosition
 
-위치에 변화를 탐지할 때 소자의 현재 위치를 반환 합니다. 새 위치를 검색 하는 장치는 `geolocationSuccess` 콜백 실행 한 `Position` 매개 변수로 개체. 오류가 발생 하는 경우는 `geolocationError` 콜백 실행 한 `PositionError` 매개 변수로 개체.
+위치에 변화를 탐지할 때 소자의 현재 위치를 반환 합니다. 장치 새 위치를 검색 하는 경우 `geolocationSuccess` 콜백 매개 변수로 개체를 `Position`으로 실행 합니다. 오류가 있는 경우에, `geolocationError` 콜백 매개 변수로 `PositionError` 개체를 실행 합니다.
 
-    var watchId = navigator.geolocation.watchPosition (geolocationSuccess, [geolocationError] [geolocationOptions]);
+    var watchId = navigator.geolocation.watchPosition(geolocationSuccess,
+                                                      [geolocationError],
+                                                      [geolocationOptions]);
     
 
 ### 매개 변수
@@ -100,19 +132,34 @@
 
 ### 예를 들어
 
-    onSuccess 콜백 /이 메서드를 포함 하는 '위치' 개체를 허용 하는 / / 현재 GPS 좌표 / / / onSuccess(position) 기능 {var 요소 = document.getElementById('geolocation');
-        element.innerHTML = ' 위도: ' + position.coords.latitude + ' < br / >' + ' 경도: ' + position.coords.longitude + ' < br / >' + ' < hr / >' + element.innerHTML;
-    } / / onError 콜백 수신 PositionError 개체 / / onError(error) 기능 {경고 (' 코드: ' error.code + '\n' + ' 메시지: ' error.message + '\n');}
+    // 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');
+    }
     
-    옵션: 없음 업데이트 30 초 마다 수신 되 면 오류가 throw 합니다.
-    var watchID = navigator.geolocation.watchPosition (onSuccess onError, {타임 아웃: 30000});
+    // Options: throw an error if no update is received every 30 seconds.
+    //
+    var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { timeout: 30000 });
     
 
 ## geolocationOptions
 
-선택적 매개 변수는 위치 정보 검색을 사용자 지정 하려면`Position`.
+지리적 `Position` 검색을 사용자 지정 하는 선택적 매개 변수.
 
-    {maximumAge: 3000, 타임 아웃: 5000, enableHighAccuracy: true};
+    { maximumAge: 3000, timeout: 5000, enableHighAccuracy: true };
     
 
 ### 옵션
@@ -125,11 +172,11 @@
 
 ### 안 드 로이드 단점
 
-하지 않는 한 안 드 로이드 2.x 에뮬레이터 위치 결과 반환 하지 않습니다는 `enableHighAccuracy` 옵션을 설정`true`.
+`EnableHighAccuracy` 옵션을 `true`로 설정 되어 있지 않으면 안 드 로이드 2.x 에뮬레이터 위치 결과 반환 하지 않는.
 
 ## navigator.geolocation.clearWatch
 
-참조 디바이스의 위치 변경에 대 한 보고 중지는 `watchID` 매개 변수.
+`watchID` 매개 변수에서 참조 하는 소자의 위치 변경에 대 한 보고 중지 합니다.
 
     navigator.geolocation.clearWatch(watchID);
     
@@ -140,61 +187,63 @@
 
 ### 예를 들어
 
-    옵션: 대 한 위치에서 변경 하 고 가장 많이 사용 / / 정확한 위치 수집 방법을 사용할 수 있습니다.
-    var watchID = navigator.geolocation.watchPosition (onSuccess onError, {enableHighAccuracy: true});
+    // Options: watch for changes in position, and use the most
+    // accurate position acquisition method available.
+    //
+    var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { enableHighAccuracy: true });
     
-    ....later에...
+    // ...later on...
     
     navigator.geolocation.clearWatch(watchID);
     
 
 ## Position
 
-포함 `Position` 좌표 및 타임 스탬프, geolocation API에 의해 만들어진.
+`Position` 좌표 및 지리적 위치 API에 의해 생성 하는 타임 스탬프를 포함 합니다.
 
 ### 속성
 
 *   **coords**: 지리적 좌표 집합. *(좌표)*
 
-*   **타임 스탬프**: 생성 타임 스탬프에 대 한 `coords` . *(날짜)*
+*   **timestamp**: 생성 타임 스탬프에 대 한 `coords` . *(날짜)*
 
 ## Coordinates
 
-A `Coordinates` 개체에 연결 되는 `Position` 콜백 함수는 현재 위치에 대 한 요청에 사용할 수 있는 개체. 그것은 위치의 지리적 좌표를 설명 하는 속성 집합이 포함 되어 있습니다.
+`Coordinates` 개체를 현재 위치에 대 한 요청에 콜백 함수를 사용할 수 있는 `Position` 개체에 첨부 됩니다. 그것은 위치의 지리적 좌표를 설명 하는 속성 집합이 포함 되어 있습니다.
 
 ### 속성
 
-*   **위도**: 소수점도 위도. *(수)*
+*   **latitude**: 소수점도 위도. *(수)*
 
-*   **경도**: 경도 10 진수 각도. *(수)*
+*   **longitude**: 경도 10 진수 각도. *(수)*
 
-*   **고도**: 높이의 타원 면 미터에 위치. *(수)*
+*   **altitude**: 높이의 타원 면 미터에 위치. *(수)*
 
 *   **정확도**: 정확도 레벨 미터에 위도 및 경도 좌표. *(수)*
 
 *   **altitudeAccuracy**: 미터에 고도 좌표의 정확도 수준. *(수)*
 
-*   **제목**: 여행, 진 북을 기준으로 시계 방향으로 세도에 지정 된 방향으로. *(수)*
+*   **heading**: 여행, 진 북을 기준으로 시계 방향으로 세도에 지정 된 방향으로. *(수)*
 
-*   **속도**: 초당 미터에 지정 된 디바이스의 현재 땅 속도. *(수)*
+*   **speed**: 초당 미터에 지정 된 디바이스의 현재 땅 속도. *(수)*
 
 ### 아마존 화재 OS 단점
 
-**altitudeAccuracy**: 반환 안 드 로이드 장치에 의해 지원 되지 않습니다`null`.
+**altitudeAccuracy**: `null` 반환 안 드 로이드 장치에 의해 지원 되지 않습니다.
 
 ### 안 드 로이드 단점
 
-**altitudeAccuracy**: 반환 안 드 로이드 장치에 의해 지원 되지 않습니다`null`.
+**altitudeAccuracy**: `null` 반환 안 드 로이드 장치에 의해 지원 되지 않습니다.
 
 ## PositionError
 
-`PositionError`개체에 전달 되는 `geolocationError` 콜백 함수 navigator.geolocation 오류가 발생 한 경우.
+`PositionError` 개체는 navigator.geolocation와 함께 오류가 발생 하면 `geolocationError` 콜백 함수에 전달 됩니다.
 
 ### 속성
 
-*   **코드**: 미리 정의 된 오류 코드 중 하나가 아래에 나열 된.
+*   **code**: 미리 정의 된 오류 코드 중 하나가 아래에 나열 된.
 
-*   **메시지**: 발생 한 오류 세부 정보를 설명 하는 오류 메시지.
+*   **message**: 발생 한 오류 세부 정보를 설명 하는 오류 메시지.
 
 ### 상수
 
diff --git a/doc/pl/index.md b/doc/pl/index.md
index 239595a0..2bff9ceb 100644
--- a/doc/pl/index.md
+++ b/doc/pl/index.md
@@ -27,6 +27,16 @@ Ten interfejs API jest oparty na [Specyfikacji W3C Geolocation API][1]i tylko wy
 
 **Ostrzeżenie**: zbierania i wykorzystywania danych geolokacyjnych podnosi kwestie prywatności ważne. Polityka prywatności danej aplikacji należy omówić, jak aplikacja używa danych, czy jest on dzielony z innych stron i poziom dokładności danych (na przykład, gruba, porządku, kod pocztowy poziom, itp.). Danych geolokacyjnych ogólnie uznaje wrażliwych, bo to może ujawnić pobytu użytkownika i, jeśli przechowywane, historii ich podróży. W związku z tym oprócz aplikacji prywatności, zdecydowanie warto powiadomienia just-in-time, zanim aplikacja uzyskuje dostęp do danych (jeśli urządzenie system operacyjny nie robi już). Że ogłoszenie powinno zawierać te same informacje, o których wspomniano powyżej, jak również uzyskanie uprawnienia użytkownika (np. poprzez przedstawianie wyborów **OK** i **Nie dzięki**). Aby uzyskać więcej informacji zobacz przewodnik prywatności.
 
+Ten plugin definiuje obiekt globalny `navigator.geolocation` (dla platformy gdzie to inaczej brak).
+
+Mimo, że obiekt jest w globalnym zasięgu, funkcji oferowanych przez ten plugin nie są dostępne dopiero po turnieju `deviceready`.
+
+    document.addEventListener("deviceready", onDeviceReady, false);
+    function onDeviceReady() {
+        console.log("navigator.geolocation works well");
+    }
+    
+
 ## Instalacja
 
     cordova plugin add org.apache.cordova.geolocation
@@ -53,13 +63,15 @@ Ten interfejs API jest oparty na [Specyfikacji W3C Geolocation API][1]i tylko wy
 
 *   Stanowisko
 *   PositionError
-*   Współrzędne
+*   Coordinates
 
 ## navigator.geolocation.getCurrentPosition
 
-Zwraca aktualną pozycję urządzenia do `geolocationSuccess` wywołania zwrotnego z `Position` obiektu jako parametr. Jeśli występuje błąd, `geolocationError` wywołania zwrotnego jest przekazywany `PositionError` obiektu.
+Zwraca bieżącą pozycję urządzenia do `geolocationSuccess` wywołanie zwrotne z `Position` obiektu jako parametr. Jeśli występuje błąd, wywołania zwrotnego `geolocationError` jest przekazywany obiekt `PositionError`.
 
-    navigator.geolocation.getCurrentPosition (geolocationSuccess, [geolocationError], [geolocationOptions]);
+    navigator.geolocation.getCurrentPosition(geolocationSuccess,
+                                             [geolocationError],
+                                             [geolocationOptions]);
     
 
 ### Parametry
@@ -72,18 +84,38 @@ Zwraca aktualną pozycję urządzenia do `geolocationSuccess` wywołania zwrotne
 
 ### Przykład
 
-    onSuccess Callback / / Metoda ta akceptuje pozycji obiektu, który zawiera / / GPS aktualne współrzędne / / var onSuccess = function(position) {wpisu ("Latitude:" + position.coords.latitude + '\n' + ' długości geograficznej: "+ position.coords.longitude + '\n' +" wysokości: "+ position.coords.altitude + '\n' +" dokładność: "+ position.coords.accuracy + '\n' +" wysokości dokładność: "+ position.coords.altitudeAccuracy + '\n' +" pozycji: "+ position.coords.heading + '\n' +" prędkości: "+ position.coords.speed + '\n' + ' sygnatury czasowej:" + position.timestamp + '\n');};
+    // 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 wywołania zwrotnego otrzymuje obiekt PositionError / / funkcja onError(error) {wpisu ("kod:" error.code + "\n" + "wiadomość: ' + error.message +"\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.getCurrentPosition(onSuccess, onError);
     
 
 ## navigator.geolocation.watchPosition
 
-Zwraca bieżącą pozycję urządzenia po wykryciu zmiany pozycji. Gdy urządzenie pobiera nową lokalizację, `geolocationSuccess` wykonuje wywołanie zwrotne z `Position` obiektu jako parametr. Jeśli występuje błąd, `geolocationError` wykonuje wywołanie zwrotne z `PositionError` obiektu jako parametr.
+Zwraca bieżącą pozycję urządzenia po wykryciu zmiany pozycji. Gdy urządzenie pobiera nową lokalizację, wywołania zwrotnego `geolocationSuccess` wykonuje się z `Position` obiektu jako parametr. Jeśli występuje błąd, wywołania zwrotnego `geolocationError` wykonuje się z obiektem `PositionError` jako parametr.
 
-    var watchId = navigator.geolocation.watchPosition (geolocationSuccess, [geolocationError], [geolocationOptions]);
+    var watchId = navigator.geolocation.watchPosition(geolocationSuccess,
+                                                      [geolocationError],
+                                                      [geolocationOptions]);
     
 
 ### Parametry
@@ -100,19 +132,34 @@ Zwraca bieżącą pozycję urządzenia po wykryciu zmiany pozycji. Gdy urządzen
 
 ### Przykład
 
-    onSuccess Callback / / Metoda ta akceptuje obiekt "Stanowisko", który zawiera / / bieżące współrzędne GPS / / funkcja onSuccess(position) {var elementu = document.getElementById('geolocation');
-        element.innerHTML = "Latitude:" + position.coords.latitude + ' < br / >' + ' długości geograficznej: "+ position.coords.longitude +" < br / > "+" < hr / > "+ element.innerHTML;
-    } / / onError wywołania zwrotnego otrzymuje obiekt PositionError / / funkcja onError(error) {wpisu ("kod:" error.code + "\n" + "wiadomość: ' + error.message +"\n");}
+    // 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');
+    }
     
-    Opcje: rzucać błąd, jeśli nie aktualizacji jest co 30 sekund.
-    var watchID = navigator.geolocation.watchPosition (onSuccess, onError, {limit czasu: 30000});
+    // Options: throw an error if no update is received every 30 seconds.
+    //
+    var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { timeout: 30000 });
     
 
 ## geolocationOptions
 
-Opcjonalne parametry aby dostosować wyszukiwanie geolocation`Position`.
+Parametry opcjonalne dostosować pobierania geolocation `Position`.
 
-    {maximumAge: 3000, limit: 5000, enableHighAccuracy: true};
+    { maximumAge: 3000, timeout: 5000, enableHighAccuracy: true };
     
 
 ### Opcje
@@ -125,11 +172,11 @@ Opcjonalne parametry aby dostosować wyszukiwanie geolocation`Position`.
 
 ### Dziwactwa Androida
 
-Emulatory Androida 2.x nie zwracają wynik geolokalizacji, chyba że `enableHighAccuracy` jest opcja zestaw do`true`.
+Emulatory Androida 2.x nie zwracają wynik geolocation, chyba że opcja `enableHighAccuracy` jest ustawiona na `wartość true`.
 
 ## navigator.geolocation.clearWatch
 
-Przestać oglądać zmiany położenia urządzenia przez `watchID` parametru.
+Przestać oglądać zmiany położenia urządzenia określany przez parametr `watchID`.
 
     navigator.geolocation.clearWatch(watchID);
     
@@ -140,17 +187,19 @@ Przestać oglądać zmiany położenia urządzenia przez `watchID` parametru.
 
 ### Przykład
 
-    Opcje: obserwować zmiany w pozycji i najczęściej / / dokładne położenie dostępną metodą nabycia.
-    var watchID = navigator.geolocation.watchPosition (onSuccess, onError, {enableHighAccuracy: true});
+    // Options: watch for changes in position, and use the most
+    // accurate position acquisition method available.
+    //
+    var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { enableHighAccuracy: true });
     
-    .. .later na...
+    // ...later on...
     
     navigator.geolocation.clearWatch(watchID);
     
 
 ## Stanowisko
 
-Zawiera `Position` współrzędnych i sygnatury czasowej, stworzony przez geolocation API.
+Zawiera współrzędne `Position` i sygnatury czasowej, stworzony przez geolocation API.
 
 ### Właściwości
 
@@ -158,9 +207,9 @@ Zawiera `Position` współrzędnych i sygnatury czasowej, stworzony przez geoloc
 
 *   **sygnatura czasowa**: Sygnatura czasowa utworzenia dla `coords` . *(Data)*
 
-## Współrzędne
+## Coordinates
 
-A `Coordinates` obiektu jest dołączony do `Position` obiekt, który jest dostępny dla funkcji wywołania zwrotnego w prośby o aktualnej pozycji. Zawiera zestaw właściwości, które opisują geograficzne współrzędne pozycji.
+`Coordinates` obiektu jest dołączone do `Position` obiektu, który jest dostępny dla funkcji wywołania zwrotnego w prośby o aktualnej pozycji. Zawiera zestaw właściwości, które opisują geograficzne współrzędne pozycji.
 
 ### Właściwości
 
@@ -180,15 +229,15 @@ A `Coordinates` obiektu jest dołączony do `Position` obiekt, który jest dost
 
 ### Amazon ogień OS dziwactwa
 
-**altitudeAccuracy**: nie obsługiwane przez Android urządzeń, powrót`null`.
+**altitudeAccuracy**: nie obsługiwane przez Android urządzeń, zwracanie `wartości null`.
 
 ### Dziwactwa Androida
 
-**altitudeAccuracy**: nie obsługiwane przez Android urządzeń, powrót`null`.
+**altitudeAccuracy**: nie obsługiwane przez Android urządzeń, zwracanie `wartości null`.
 
 ## PositionError
 
-`PositionError`Obiekt jest przekazywany do `geolocationError` funkcji wywołania zwrotnego, gdy wystąpi błąd z navigator.geolocation.
+`PositionError` obiekt jest przekazywany do funkcji wywołania zwrotnego `geolocationError`, gdy wystąpi błąd z navigator.geolocation.
 
 ### Właściwości
 
diff --git a/doc/zh/index.md b/doc/zh/index.md
index 9bd09ecc..b49a8853 100644
--- a/doc/zh/index.md
+++ b/doc/zh/index.md
@@ -27,6 +27,16 @@
 
 **警告**： 地理定位資料的收集和使用提出了重要的隱私問題。 您的應用程式的隱私權原則應該討論這款應用程式如何使用地理定位資料，資料是否共用它的任何其他締約方和的資料 （例如，粗、 細，ZIP 代碼級別，等等） 的精度水準。 地理定位資料一般認為是敏感，因為它能揭示使用者的下落以及如果存儲，他們的旅行的歷史。 因此，除了應用程式的隱私權原則，您應強烈考慮之前應用程式訪問地理定位資料 （如果設備作業系統不會這樣做已經) 提供在時間的通知。 該通知應提供相同的資訊上文指出的並獲取該使用者的許可權 （例如，通過為**確定**並**不感謝**提出的選擇）。 有關詳細資訊，請參閱隱私指南。
 
+這個外掛程式定義了一個全球 `navigator.geolocation` 物件 （為平臺哪裡否則丟失）。
+
+儘管物件是在全球範圍內，提供這個外掛程式的功能不可用直到 `deviceready` 事件之後。
+
+    document.addEventListener("deviceready", onDeviceReady, false);
+    function onDeviceReady() {
+        console.log("navigator.geolocation works well");
+    }
+    
+
 ## 安裝
 
     cordova plugin add org.apache.cordova.geolocation
@@ -57,9 +67,11 @@
 
 ## navigator.geolocation.getCurrentPosition
 
-返回設備的當前位置到 `geolocationSuccess` 回檔與 `Position` 物件作為參數。 如果有錯誤， `geolocationError` 回檔通過 `PositionError` 物件。
+返回設備的當前位置到 `geolocationSuccess` 回檔與 `Position` 物件作為參數。 如果有錯誤，`geolocationError` 回檔傳遞一個 `PositionError` 物件。
 
-    navigator.geolocation.getCurrentPosition （geolocationSuccess，[geolocationError] [geolocationOptions]) ；
+    navigator.geolocation.getCurrentPosition(geolocationSuccess,
+                                             [geolocationError],
+                                             [geolocationOptions]);
     
 
 ### 參數
@@ -72,14 +84,38 @@
 
 ### 示例
 
-    onSuccess 回檔 / / 此方法接受一個位置的物件，它包含 / / 目前的 GPS 座標 / / var onSuccess = function(position) {警報 (' 緯度： '+ position.coords.latitude + \n +' 經度： '+ position.coords.longitude + '\n' +' 海拔高度： '+ position.coords.altitude + \n +' 準確性： '+ position.coords.accuracy + '\n' +' 海拔高度準確性： '+ position.coords.altitudeAccuracy + '\n' +' 標題： '+ position.coords.heading + \n +' 速度： '+ position.coords.speed + '\n' +' 時間戳記： ' + position.timestamp + \n) ；} ；onError 回檔接收一個 PositionError 物件 / / 函數 onError(error) {警報 (' 代碼： '+ error.code + '\n' +' 消息： ' + error.message + \n);}navigator.geolocation.getCurrentPosition (onSuccess，onError) ；
+    // 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
 
-當檢測到更改位置返回該設備的當前的位置。 當設備中檢索一個新的位置， `geolocationSuccess` 回檔執行與 `Position` 物件作為參數。 如果有錯誤， `geolocationError` 回檔執行與 `PositionError` 物件作為參數。
+返回設備的當前的位置，當檢測到更改位置。 當設備檢索一個新位置時，則 `geolocationSuccess` 回檔執行與 `Position` 物件作為參數。 如果有錯誤，則 `geolocationError` 回檔執行同一個 `PositionError` 物件作為參數。
 
-    var watchId = navigator.geolocation.watchPosition （geolocationSuccess，[geolocationError] [geolocationOptions]) ；
+    var watchId = navigator.geolocation.watchPosition(geolocationSuccess,
+                                                      [geolocationError],
+                                                      [geolocationOptions]);
     
 
 ### 參數
@@ -92,38 +128,57 @@
 
 ### 返回
 
-*   **字串**： 返回引用的觀看位置間隔的表 id。 應與一起使用的表 id `navigator.geolocation.clearWatch` 停止了觀看中位置的更改。
+*   **String**： 返回引用的觀看位置間隔的表 id。 應與一起使用的表 id `navigator.geolocation.clearWatch` 停止了觀看中位置的更改。
 
 ### 示例
 
-    onSuccess 回檔 / / 此方法接受一個 '立場' 物件，其中包含 / / 當前 GPS 座標 / / 函數 onSuccess(position) {var 元素 = document.getElementById('geolocation') ；element.innerHTML = '緯度:' + position.coords.latitude + '< br / >' +' 經度: '+ position.coords.longitude +' < br / >' + ' < hr / >' + element.innerHTML;} / / onError 回檔接收一個 PositionError 物件 / / 函數 onError(error) {警報 (' 代碼： '+ error.code + '\n' +' 消息： ' + error.message + \n);}如果沒有更新收到每隔 30 秒選項： 將引發錯誤。
-    var watchID = navigator.geolocation.watchPosition （onSuccess，onError，{超時： 30000});
+    // 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
 
-若要自訂的地理定位檢索的可選參數`Position`.
+若要自訂的地理 `Position` 檢索的可選參數.
 
-    {maximumAge: 3000，超時： 5000，enableHighAccuracy: true} ；
+    { maximumAge: 3000, timeout: 5000, enableHighAccuracy: true };
     
 
 ### 選項
 
 *   **enableHighAccuracy**： 提供應用程式需要最佳的可能結果的提示。 預設情況下，該設備將嘗試檢索 `Position` 使用基於網路的方法。 將此屬性設置為 `true` 告訴要使用更精確的方法，如衛星定位的框架。 *(布林值)*
 
-*   **超時**： 時間 (毫秒) 從調用傳遞，允許的最大長度 `navigator.geolocation.getCurrentPosition` 或 `geolocation.watchPosition` 直到相應的 `geolocationSuccess` 回檔執行。 如果 `geolocationSuccess` 不會在此時間內調用回檔 `geolocationError` 傳遞回檔 `PositionError.TIMEOUT` 錯誤代碼。 (請注意，與一起使用時 `geolocation.watchPosition` 、 `geolocationError` 的時間間隔可以調用回檔每 `timeout` 毫秒!)*（人數）*
+*   **timeout**： 時間 (毫秒) 從調用傳遞，允許的最大長度 `navigator.geolocation.getCurrentPosition` 或 `geolocation.watchPosition` 直到相應的 `geolocationSuccess` 回檔執行。 如果 `geolocationSuccess` 不會在此時間內調用回檔 `geolocationError` 傳遞回檔 `PositionError.TIMEOUT` 錯誤代碼。 (請注意，與一起使用時 `geolocation.watchPosition` 、 `geolocationError` 的時間間隔可以調用回檔每 `timeout` 毫秒!)*（人數）*
 
 *   **maximumAge**： 接受其年齡大於指定以毫秒為單位的時間沒有緩存的位置。*（人數）*
 
 ### Android 的怪癖
 
-Android 2.x 模擬器不返回地理定位結果除非 `enableHighAccuracy` 選項設置為`true`.
+Android 2.x 模擬器不除非 `enableHighAccuracy` 選項設置為 `true`，否則返回地理定位結果.
 
 ## navigator.geolocation.clearWatch
 
-再看對所引用的設備的位置更改為 `watchID` 參數。
+停止觀察到 `watchID` 參數所引用的設備的位置。
 
-    navigator.geolocation.clearWatch(watchID) ；
+    navigator.geolocation.clearWatch(watchID);
     
 
 ### 參數
@@ -132,10 +187,14 @@ Android 2.x 模擬器不返回地理定位結果除非 `enableHighAccuracy` 選
 
 ### 示例
 
-    選項： 監視的更改的位置，並使用最 / / 準確定位採集方法可用。
-    var watchID = navigator.geolocation.watchPosition （onSuccess，onError，{enableHighAccuracy: true});....later 上的......
+    // Options: watch for changes in position, and use the most
+    // accurate position acquisition method available.
+    //
+    var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { enableHighAccuracy: true });
+    
+    // ...later on...
     
-    navigator.geolocation.clearWatch(watchID) ；
+    navigator.geolocation.clearWatch(watchID);
     
 
 ## Position
@@ -146,45 +205,45 @@ Android 2.x 模擬器不返回地理定位結果除非 `enableHighAccuracy` 選
 
 *   **coords**： 一組的地理座標。*（座標）*
 
-*   **時間戳記**： 創建時間戳記為 `coords` 。*（日期）*
+*   **timestamp**： 創建時間戳記為 `coords` 。*（日期）*
 
 ## Coordinates
 
-A `Coordinates` 物件附加到 `Position` 物件，可用於在當前職位的請求中的回呼函數。 它包含一組屬性，描述位置的地理座標。
+`Coordinates` 的物件附加到一個 `Position` 物件，可用於在當前職位的請求中的回呼函數。 它包含一組屬性描述位置的地理座標。
 
 ### 屬性
 
-*   **緯度**： 緯度以十進位度為單位。*（人數）*
+*   **latitude**： 緯度以十進位度為單位。*（人數）*
 
-*   **經度**: 經度以十進位度為單位。*（人數）*
+*   **longitude**: 經度以十進位度為單位。*（人數）*
 
-*   **海拔高度**： 高度在米以上橢球體中的位置。*（人數）*
+*   **altitude**： 高度在米以上橢球體中的位置。*（人數）*
 
-*   **準確性**： 中米的緯度和經度座標的精度級別。*（人數）*
+*   **accuracy**： 中米的緯度和經度座標的精度級別。*（人數）*
 
 *   **altitudeAccuracy**： 在米的海拔高度座標的精度級別。*（人數）*
 
-*   **標題**： 旅行，指定以度為單位元數目相對於真北順時針方向。*（人數）*
+*   **heading**： 旅行，指定以度為單位元數目相對於真北順時針方向。*（人數）*
 
-*   **速度**： 當前地面速度的設備，指定在米每秒。*（人數）*
+*   **speed**： 當前地面速度的設備，指定在米每秒。*（人數）*
 
 ### 亞馬遜火 OS 怪癖
 
-**altitudeAccuracy**: 不支援的 Android 設備，返回`null`.
+**altitudeAccuracy**: 不支援的 Android 設備，返回 `null`.
 
 ### Android 的怪癖
 
-**altitudeAccuracy**: 不支援的 Android 設備，返回`null`.
+**altitudeAccuracy**: 不支援的 Android 設備，返回 `null`.
 
 ## PositionError
 
-`PositionError`物件傳遞給 `geolocationError` 與 navigator.geolocation 發生錯誤時的回呼函數。
+`PositionError` 物件將傳遞給 `geolocationError` 回呼函數中，當出現 navigator.geolocation 錯誤時發生。
 
 ### 屬性
 
-*   **代碼**： 下面列出的預定義的錯誤代碼之一。
+*   **code**： 下面列出的預定義的錯誤代碼之一。
 
-*   **消息**： 描述所遇到的錯誤的詳細資訊的錯誤訊息。
+*   **message**： 描述所遇到的錯誤的詳細資訊的錯誤訊息。
 
 ### 常量