Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

cordova-plugin-geolocation

Package Overview
Dependencies
Maintainers
1
Versions
28
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

cordova-plugin-geolocation - npm Package Compare versions

Comparing version 0.3.12 to 1.0.0

.travis.yml

123

doc/de/index.md

@@ -20,3 +20,3 @@ <!---

# org.apache.cordova.geolocation
# cordova-plugin-geolocation

@@ -31,5 +31,15 @@ Dieses Plugin bietet Informationen über das Gerät an den Speicherort, z. B. breiten- und Längengrad. Gemeinsame Quellen von Standortinformationen sind Global Positioning System (GPS) und Lage von Netzwerk-Signale wie IP-Adresse, RFID, WLAN und Bluetooth MAC-Adressen und GSM/CDMA Zelle IDs abgeleitet. Es gibt keine Garantie, dass die API des Geräts tatsächliche Position zurückgibt.

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
cordova plugin add cordova-plugin-geolocation

@@ -58,9 +68,11 @@

* 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]);

@@ -78,7 +90,25 @@

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);

@@ -88,5 +118,7 @@

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]);

@@ -108,15 +140,30 @@

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;
}
Optionen: lösen Sie einen Fehler aus, wenn kein Update alle 30 Sekunden empfangen wird.
Var WatchID = navigator.geolocation.watchPosition (OnSuccess, OnError, {Timeout: 30000});
// 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
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 };

@@ -134,7 +181,7 @@

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`.

@@ -150,6 +197,8 @@ navigator.geolocation.clearWatch(watchID);

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...

@@ -161,41 +210,41 @@ navigator.geolocation.clearWatch(watchID);

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.

@@ -215,2 +264,2 @@ ### Eigenschaften

* `PositionError.TIMEOUT`
* Zurückgegeben, wenn das Gerät nicht in der Lage, eine Position innerhalb der festgelegten Zeit abzurufen ist die `timeout` enthalten `geolocationOptions` . Bei Verwendung mit `navigator.geolocation.watchPosition` , könnte dieser Fehler wiederholt übergeben werden, zu der `geolocationError` Rückruf jedes `timeout` Millisekunden.
* Zurückgegeben, wenn das Gerät nicht in der Lage, eine Position innerhalb der festgelegten Zeit abzurufen ist die `timeout` enthalten `geolocationOptions` . Bei Verwendung mit `navigator.geolocation.watchPosition` , könnte dieser Fehler wiederholt übergeben werden, zu der `geolocationError` Rückruf jedes `timeout` Millisekunden.

@@ -20,3 +20,3 @@ <!---

# org.apache.cordova.geolocation
# cordova-plugin-geolocation

@@ -31,5 +31,13 @@ Este plugin proporciona información sobre la ubicación del dispositivo, tales como la latitud y longitud. Fuentes comunes de información de localización incluyen el sistema de posicionamiento Global (GPS) y ubicación deducido de las señales de la red como dirección IP, direcciones de RFID, WiFi y Bluetooth MAC y celulares GSM/CDMA IDs. No hay ninguna garantía de que la API devuelve la ubicación real del dispositivo.

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 cordova-plugin-geolocation

@@ -62,7 +70,5 @@

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]);

@@ -80,25 +86,7 @@

// 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);

@@ -108,7 +96,5 @@

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]);

@@ -130,24 +116,9 @@

// 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;
}
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');}
// onError Callback receives a PositionError object
//
function onError(error) {
alert('code: ' + error.code + '\n' +
'message: ' + error.message + '\n');
}
Opciones: tira un error si no se recibe ninguna actualización cada 30 segundos.
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 });

@@ -158,3 +129,3 @@ ## geolocationOptions

{maximumAge: 3000, timeout: 5000, enableHighAccuracy: true};
{ maximumAge: 3000, timeout: 5000, enableHighAccuracy: true };

@@ -176,3 +147,3 @@

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.

@@ -188,8 +159,6 @@ navigator.geolocation.clearWatch(watchID);

// 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...

@@ -254,2 +223,2 @@ navigator.geolocation.clearWatch(watchID);

* `PositionError.TIMEOUT`
* Cuando el dispositivo es capaz de recuperar una posición dentro del tiempo especificado por el `timeout` incluido en `geolocationOptions` . Cuando se utiliza con `navigator.geolocation.watchPosition` , este error podría pasar repetidamente a la `geolocationError` "callback" cada `timeout` milisegundos.
* Cuando el dispositivo es capaz de recuperar una posición dentro del tiempo especificado por el `timeout` incluido en `geolocationOptions` . Cuando se utiliza con `navigator.geolocation.watchPosition` , este error podría pasar repetidamente a la `geolocationError` "callback" cada `timeout` milisegundos.

@@ -20,3 +20,3 @@ <!---

# org.apache.cordova.geolocation
# cordova-plugin-geolocation

@@ -31,5 +31,13 @@ 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.

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 cordova-plugin-geolocation

@@ -110,3 +118,3 @@

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 }) ;

@@ -118,3 +126,3 @@

{maximumAge : 3000, délai d'attente : 5000, enableHighAccuracy : true} ;
{ maximumAge: 3000, timeout: 5000, enableHighAccuracy: true } ;

@@ -148,3 +156,3 @@

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 }) ;

@@ -192,3 +200,3 @@ .. plus sur...

**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`.

@@ -212,2 +220,2 @@ ## PositionError

* `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.
* 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.

@@ -20,3 +20,3 @@ <!---

# org.apache.cordova.geolocation
# cordova-plugin-geolocation

@@ -31,5 +31,15 @@ Questo plugin fornisce informazioni sulla posizione del dispositivo, come latitudine e longitudine. Comuni fonti di informazioni sulla posizione comprendono Global Positioning System (GPS) e posizione dedotta dai segnali di rete come indirizzo IP, indirizzi, RFID, WiFi e Bluetooth MAC e cellulare GSM/CDMA IDs. Non non c'è alcuna garanzia che l'API restituisce la posizione effettiva del dispositivo.

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
cordova plugin add cordova-plugin-geolocation

@@ -62,5 +72,7 @@

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]);

@@ -78,7 +90,25 @@

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);

@@ -88,5 +118,7 @@

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]);

@@ -108,15 +140,30 @@

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;
}
Opzioni: generare un errore se non si è ricevuto nessun aggiornamento ogni 30 secondi.
var watchID = navigator.geolocation.watchPosition (onSuccess, onError, {timeout: 30000});
// 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
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 };

@@ -134,7 +181,7 @@

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`.

@@ -150,6 +197,8 @@ navigator.geolocation.clearWatch(watchID);

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...

@@ -161,3 +210,3 @@ navigator.geolocation.clearWatch(watchID);

Contiene `Position` coordinate e timestamp, creato da geolocation API.
Contiene le coordinate della `Position` e timestamp, creato da geolocation API.

@@ -172,3 +221,3 @@ ### Proprietà

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.

@@ -193,11 +242,11 @@ ### Proprietà

**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.

@@ -217,2 +266,2 @@ ### Proprietà

* `PositionError.TIMEOUT`
* Restituito quando il dispositivo è in grado di recuperare una posizione entro il tempo specificato dal `timeout` incluso `geolocationOptions` . Quando utilizzato con `navigator.geolocation.watchPosition` , questo errore potrebbe essere passato più volte per la `geolocationError` richiamata ogni `timeout` millisecondi.
* Restituito quando il dispositivo è in grado di recuperare una posizione entro il tempo specificato dal `timeout` incluso `geolocationOptions` . Quando utilizzato con `navigator.geolocation.watchPosition` , questo errore potrebbe essere passato più volte per la `geolocationError` richiamata ogni `timeout` millisecondi.

@@ -20,3 +20,3 @@ <!---

# org.apache.cordova.geolocation
# cordova-plugin-geolocation

@@ -31,5 +31,15 @@ このプラグインは緯度や経度などのデバイスの場所に関する情報を提供します。 位置情報の共通のソースはグローバル ポジショニング システム (GPS) と IP アドレス、RFID、WiFi および Bluetooth の MAC アドレス、および GSM/cdma 方式携帯 Id などのネットワーク信号から推定される場所にもあります。 API は、デバイスの実際の場所を返すことの保証はありません。

このプラグインは、グローバル `navigator.geolocation` オブジェクト (プラットフォーム行方不明ですそれ以外の場合) を定義します。
オブジェクトは、グローバル スコープでですが、このプラグインによって提供される機能は、`deviceready` イベントの後まで使用できません。
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
console.log("navigator.geolocation works well");
}
## インストール
cordova plugin add org.apache.cordova.geolocation
cordova plugin add cordova-plugin-geolocation

@@ -62,5 +72,7 @@

デバイスの現在の位置を返します、 `geolocationSuccess` コールバックを `Position` オブジェクトをパラメーターとして。 エラーがある場合、 `geolocationError` コールバックに渡される、 `PositionError` オブジェクト。
`Position` オブジェクトを `geolocationSuccess` コールバックにパラメーターとしてデバイスの現在位置を返します。 エラーがある場合 `geolocationError` コールバックには、`PositionError` オブジェクトが渡されます。
navigator.geolocation.getCurrentPosition (geolocationSuccess、[geolocationError] [geolocationOptions]);
navigator.geolocation.getCurrentPosition(geolocationSuccess,
[geolocationError],
[geolocationOptions]);

@@ -78,10 +90,34 @@

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]);

@@ -103,11 +139,30 @@

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 };

@@ -125,7 +180,7 @@

限り android 2.x エミュレーター地理位置情報の結果を返さない、 `enableHighAccuracy` オプションを設定します。`true`.
`enableHighAccuracy` オプションが `true` に設定しない限り、アンドロイド 2.x エミュレーター地理位置情報の結果を返さない.
## navigator.geolocation.clearWatch
によって参照される、デバイスの場所への変更を見て停止、 `watchID` パラメーター。
`watchID` パラメーターによって参照される、デバイスの場所への変更を見て停止します。

@@ -141,5 +196,9 @@ navigator.geolocation.clearWatch(watchID);

オプション: の位置では、変更を監視して最も//正確な位置取得法利用可能。
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);

@@ -150,3 +209,3 @@

含まれています `Position` 座標、地理位置情報 API で作成されたタイムスタンプ。
`Position` 座標と地理位置情報 API で作成されたタイムスタンプが含まれます。

@@ -157,41 +216,41 @@ ### プロパティ

* **タイムスタンプ**: 作成のタイムスタンプを `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**: 発生したエラーの詳細を説明するエラー メッセージ。

@@ -205,2 +264,2 @@ ### 定数

* `PositionError.TIMEOUT`
* デバイスがで指定された時間内の位置を取得することができるときに返される、 `timeout` に含まれている `geolocationOptions` 。 使用すると `navigator.geolocation.watchPosition` 、このエラーが繰り返しに渡すことが、 `geolocationError` コールバックごと `timeout` (ミリ秒単位)。
* デバイスがで指定された時間内の位置を取得することができるときに返される、 `timeout` に含まれている `geolocationOptions` 。 使用すると `navigator.geolocation.watchPosition` 、このエラーが繰り返しに渡すことが、 `geolocationError` コールバックごと `timeout` (ミリ秒単位)。

@@ -20,3 +20,3 @@ <!---

# org.apache.cordova.geolocation
# cordova-plugin-geolocation

@@ -31,5 +31,15 @@ 이 플러그인 위도 및 경도 등의 소자의 위치에 대 한 정보를 제공합니다. 일반적인 위치 정보 등 글로벌 포지셔닝 시스템 (GPS) 및 위치와 같은 IP 주소, RFID, WiFi 및 블루투스 MAC 주소 및 GSM/CDMA 셀 Id 네트워크 신호에서 유추 합니다. 보장은 없다는 API 소자의 실제 위치를 반환 합니다.

이 플러그인 (플랫폼은 그렇지 않으면 누락 된)에 대 한 전역 `navigator.geolocation` 개체를 정의 합니다.
개체가 전역 범위에 있지만,이 플러그인에 의해 제공 되는 기능 하지 사용할 수 있습니다까지 `deviceready` 이벤트 후.
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
console.log("navigator.geolocation works well");
}
## 설치
cordova plugin add org.apache.cordova.geolocation
cordova plugin add cordova-plugin-geolocation

@@ -62,5 +72,7 @@

디바이스의 현재 위치를 반환 합니다는 `geolocationSuccess` 로 콜백은 `Position` 매개 변수로 개체. 오류가 발생 하는 경우는 `geolocationError` 콜백 전달 되는 `PositionError` 개체.
매개 변수 `Position` 개체와 `geolocationSuccess`를 디바이스의 현재 위치를 반환합니다. 오류가 있는 경우에, `geolocationError` 콜백 `PositionError` 개체에 전달 됩니다.
navigator.geolocation.getCurrentPosition (geolocationSuccess, [geolocationError] [geolocationOptions]);
navigator.geolocation.getCurrentPosition(geolocationSuccess,
[geolocationError],
[geolocationOptions]);

@@ -78,7 +90,25 @@

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);

@@ -88,5 +118,7 @@

위치에 변화를 탐지할 때 소자의 현재 위치를 반환 합니다. 새 위치를 검색 하는 장치는 `geolocationSuccess` 콜백 실행 한 `Position` 매개 변수로 개체. 오류가 발생 하는 경우는 `geolocationError` 콜백 실행 한 `PositionError` 매개 변수로 개체.
위치에 변화를 탐지할 때 소자의 현재 위치를 반환 합니다. 장치 새 위치를 검색 하는 경우 `geolocationSuccess` 콜백 매개 변수로 개체를 `Position`으로 실행 합니다. 오류가 있는 경우에, `geolocationError` 콜백 매개 변수로 `PositionError` 개체를 실행 합니다.
var watchId = navigator.geolocation.watchPosition (geolocationSuccess, [geolocationError] [geolocationOptions]);
var watchId = navigator.geolocation.watchPosition(geolocationSuccess,
[geolocationError],
[geolocationOptions]);

@@ -108,15 +140,30 @@

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;
}
옵션: 없음 업데이트 30 초 마다 수신 되 면 오류가 throw 합니다.
var watchID = navigator.geolocation.watchPosition (onSuccess onError, {타임 아웃: 30000});
// 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 };

@@ -134,7 +181,7 @@

하지 않는 한 안 드 로이드 2.x 에뮬레이터 위치 결과 반환 하지 않습니다는 `enableHighAccuracy` 옵션을 설정`true`.
`EnableHighAccuracy` 옵션을 `true`로 설정 되어 있지 않으면 안 드 로이드 2.x 에뮬레이터 위치 결과 반환 하지 않는.
## navigator.geolocation.clearWatch
참조 디바이스의 위치 변경에 대 한 보고 중지는 `watchID` 매개 변수.
`watchID` 매개 변수에서 참조 하는 소자의 위치 변경에 대 한 보고 중지 합니다.

@@ -150,6 +197,8 @@ navigator.geolocation.clearWatch(watchID);

옵션: 대 한 위치에서 변경 하 고 가장 많이 사용 / / 정확한 위치 수집 방법을 사용할 수 있습니다.
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...

@@ -161,3 +210,3 @@ navigator.geolocation.clearWatch(watchID);

포함 `Position` 좌표 및 타임 스탬프, geolocation API에 의해 만들어진.
`Position` 좌표 및 지리적 위치 API에 의해 생성 하는 타임 스탬프를 포함 합니다.

@@ -168,15 +217,15 @@ ### 속성

* **타임 스탬프**: 생성 타임 스탬프에 대 한 `coords` . *(날짜)*
* **timestamp**: 생성 타임 스탬프에 대 한 `coords` . *(날짜)*
## Coordinates
A `Coordinates` 개체에 연결 되는 `Position` 콜백 함수는 현재 위치에 대 한 요청에 사용할 수 있는 개체. 그것은 위치의 지리적 좌표를 설명 하는 속성 집합이 포함 되어 있습니다.
`Coordinates` 개체를 현재 위치에 대 한 요청에 콜백 함수를 사용할 수 있는 `Position` 개체에 첨부 됩니다. 그것은 위치의 지리적 좌표를 설명 하는 속성 집합이 포함 되어 있습니다.
### 속성
* **위도**: 소수점도 위도. *(수)*
* **latitude**: 소수점도 위도. *(수)*
* **경도**: 경도 10 진수 각도. *(수)*
* **longitude**: 경도 10 진수 각도. *(수)*
* **고도**: 높이의 타원 면 미터에 위치. *(수)*
* **altitude**: 높이의 타원 면 미터에 위치. *(수)*

@@ -187,23 +236,23 @@ * **정확도**: 정확도 레벨 미터에 위도 및 경도 좌표. *(수)*

* **제목**: 여행, 진 북을 기준으로 시계 방향으로 세도에 지정 된 방향으로. *(수)*
* **heading**: 여행, 진 북을 기준으로 시계 방향으로 세도에 지정 된 방향으로. *(수)*
* **속도**: 초당 미터에 지정 된 디바이스의 현재 땅 속도. *(수)*
* **speed**: 초당 미터에 지정 된 디바이스의 현재 땅 속도. *(수)*
### 아마존 화재 OS 단점
**altitudeAccuracy**: 반환 안 드 로이드 장치에 의해 지원 되지 않습니다`null`.
**altitudeAccuracy**: `null` 반환 안 드 로이드 장치에 의해 지원 되지 않습니다.
### 안 드 로이드 단점
**altitudeAccuracy**: 반환 안 드 로이드 장치에 의해 지원 되지 않습니다`null`.
**altitudeAccuracy**: `null` 반환 안 드 로이드 장치에 의해 지원 되지 않습니다.
## PositionError
`PositionError`개체에 전달 되는 `geolocationError` 콜백 함수 navigator.geolocation 오류가 발생 한 경우.
`PositionError` 개체는 navigator.geolocation와 함께 오류가 발생 하면 `geolocationError` 콜백 함수에 전달 됩니다.
### 속성
* **코드**: 미리 정의 된 오류 코드 중 하나가 아래에 나열 된.
* **code**: 미리 정의 된 오류 코드 중 하나가 아래에 나열 된.
* **메시지**: 발생 한 오류 세부 정보를 설명 하는 오류 메시지.
* **message**: 발생 한 오류 세부 정보를 설명 하는 오류 메시지.

@@ -217,2 +266,2 @@ ### 상수

* `PositionError.TIMEOUT`
* 장치에 지정 된 시간 내에서 위치를 검색할 수 없는 경우 반환 되는 `timeout` 에 포함 된 `geolocationOptions` . 함께 사용 될 때 `navigator.geolocation.watchPosition` ,이 오류를 반복적으로 전달 될 수는 `geolocationError` 콜백 매 `timeout` 밀리초.
* 장치에 지정 된 시간 내에서 위치를 검색할 수 없는 경우 반환 되는 `timeout` 에 포함 된 `geolocationOptions` . 함께 사용 될 때 `navigator.geolocation.watchPosition` ,이 오류를 반복적으로 전달 될 수는 `geolocationError` 콜백 매 `timeout` 밀리초.

@@ -20,3 +20,3 @@ <!---

# org.apache.cordova.geolocation
# cordova-plugin-geolocation

@@ -31,5 +31,15 @@ Ten plugin zawiera informacje o lokalizacji urządzenia, takie jak szerokość i długość geograficzną. Najczęstsze źródła informacji o lokalizacji obejmują Global Positioning System (GPS) i lokalizacji wywnioskować z sieci sygnały, takie jak adres IP, RFID, WiFi i Bluetooth MAC adresy, a komórki GSM/CDMA identyfikatorów. Nie ma żadnej gwarancji, że API zwraca rzeczywistej lokalizacji urządzenia.

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
cordova plugin add cordova-plugin-geolocation

@@ -58,9 +68,11 @@

* 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]);

@@ -78,7 +90,25 @@

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);

@@ -88,5 +118,7 @@

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]);

@@ -108,15 +140,30 @@

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;
}
Opcje: rzucać błąd, jeśli nie aktualizacji jest co 30 sekund.
var watchID = navigator.geolocation.watchPosition (onSuccess, onError, {limit czasu: 30000});
// 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
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 };

@@ -134,7 +181,7 @@

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`.

@@ -150,6 +197,8 @@ navigator.geolocation.clearWatch(watchID);

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...

@@ -161,3 +210,3 @@ navigator.geolocation.clearWatch(watchID);

Zawiera `Position` współrzędnych i sygnatury czasowej, stworzony przez geolocation API.
Zawiera współrzędne `Position` i sygnatury czasowej, stworzony przez geolocation API.

@@ -170,5 +219,5 @@ ### Właściwości

## 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.

@@ -193,11 +242,11 @@ ### Właściwości

**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.

@@ -217,2 +266,2 @@ ### Właściwości

* `PositionError.TIMEOUT`
* Zwracane, gdy urządzenie jest w stanie pobrać pozycji w czasie określonym przez `timeout` w `geolocationOptions` . Gdy używana z `navigator.geolocation.watchPosition` , ten błąd może być wielokrotnie przekazywane do `geolocationError` zwrotne co `timeout` milisekund.
* Zwracane, gdy urządzenie jest w stanie pobrać pozycji w czasie określonym przez `timeout` w `geolocationOptions` . Gdy używana z `navigator.geolocation.watchPosition` , ten błąd może być wielokrotnie przekazywane do `geolocationError` zwrotne co `timeout` milisekund.

@@ -20,3 +20,3 @@ <!---

# org.apache.cordova.geolocation
# cordova-plugin-geolocation

@@ -33,3 +33,3 @@ Этот плагин предоставляет информацию о местоположении устройства, например, Широта и Долгота. Общие источники информации о местонахождении включают глобальной системы позиционирования (GPS) и местоположение, выведено из сети сигналов, таких как IP-адрес, RFID, WiFi и Bluetooth MAC-адреса и идентификаторы базовых станций сотовой GSM/CDMA. Нет никакой гарантии, что API возвращает фактическое местоположение устройства.

cordova plugin add org.apache.cordova.geolocation
cordova plugin add cordova-plugin-geolocation

@@ -208,2 +208,2 @@

* `PositionError.TIMEOUT`
* Возвращается, если устройство не удается получить позиции в течение времени, заданного параметром `timeout` в `geolocationOptions` . При использовании с `navigator.geolocation.watchPosition` , эта ошибка может быть неоднократно передан `geolocationError` обратного вызова каждый `timeout` миллисекунд.
* Возвращается, если устройство не удается получить позиции в течение времени, заданного параметром `timeout` в `geolocationOptions` . При использовании с `navigator.geolocation.watchPosition` , эта ошибка может быть неоднократно передан `geolocationError` обратного вызова каждый `timeout` миллисекунд.

@@ -20,3 +20,3 @@ <!---

# org.apache.cordova.geolocation
# cordova-plugin-geolocation

@@ -31,5 +31,15 @@ 這個外掛程式提供了有關該設備的位置,例如緯度和經度資訊。 常見的位置資訊來源包括全球定位系統 (GPS) 和網路信號,如 IP 位址、 RFID、 WiFi 和藍牙 MAC 位址和 GSM/CDMA 儲存格 Id 從推斷出的位置。 沒有任何保證,API 返回設備的實際位置。

這個外掛程式定義了一個全球 `navigator.geolocation` 物件 (為平臺哪裡否則丟失)。
儘管物件是在全球範圍內,提供這個外掛程式的功能不可用直到 `deviceready` 事件之後。
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
console.log("navigator.geolocation works well");
}
## 安裝
cordova plugin add org.apache.cordova.geolocation
cordova plugin add cordova-plugin-geolocation

@@ -62,5 +72,7 @@

返回設備的當前位置到 `geolocationSuccess` 回檔與 `Position` 物件作為參數。 如果有錯誤, `geolocationError` 回檔通過 `PositionError` 物件。
返回設備的當前位置到 `geolocationSuccess` 回檔與 `Position` 物件作為參數。 如果有錯誤,`geolocationError` 回檔傳遞一個 `PositionError` 物件。
navigator.geolocation.getCurrentPosition (geolocationSuccess,[geolocationError] [geolocationOptions]) ;
navigator.geolocation.getCurrentPosition(geolocationSuccess,
[geolocationError],
[geolocationOptions]);

@@ -78,10 +90,34 @@

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]);

@@ -99,15 +135,34 @@

* **字串**: 返回引用的觀看位置間隔的表 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 };

@@ -119,3 +174,3 @@

* **超時**: 時間 (毫秒) 從調用傳遞,允許的最大長度 `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` 毫秒!)*(人數)*

@@ -126,9 +181,9 @@ * **maximumAge**: 接受其年齡大於指定以毫秒為單位的時間沒有緩存的位置。*(人數)*

Android 2.x 模擬器不返回地理定位結果除非 `enableHighAccuracy` 選項設置為`true`.
Android 2.x 模擬器不除非 `enableHighAccuracy` 選項設置為 `true`,否則返回地理定位結果.
## navigator.geolocation.clearWatch
再看對所引用的設備的位置更改為 `watchID` 參數。
停止觀察到 `watchID` 參數所引用的設備的位置。
navigator.geolocation.clearWatch(watchID) ;
navigator.geolocation.clearWatch(watchID);

@@ -142,7 +197,11 @@

選項: 監視的更改的位置,並使用最 / / 準確定位採集方法可用。
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 });
navigator.geolocation.clearWatch(watchID) ;
// ...later on...
navigator.geolocation.clearWatch(watchID);

@@ -157,41 +216,41 @@ ## Position

* **時間戳記**: 創建時間戳記為 `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**: 描述所遇到的錯誤的詳細資訊的錯誤訊息。

@@ -205,2 +264,2 @@ ### 常量

* `PositionError.TIMEOUT`
* 返回設備時,無法在指定的時間內檢索位置 `timeout` 中包含 `geolocationOptions` 。 與一起使用時 `navigator.geolocation.watchPosition` ,此錯誤可能反復傳遞給 `geolocationError` 回檔每 `timeout` 毫秒為單位)。
* 返回設備時,無法在指定的時間內檢索位置 `timeout` 中包含 `geolocationOptions` 。 與一起使用時 `navigator.geolocation.watchPosition` ,此錯誤可能反復傳遞給 `geolocationError` 回檔每 `timeout` 毫秒為單位)。
{
"name": "cordova-plugin-geolocation",
"version": "0.3.12",
"description": "Cordova Geolocation Plugin",
"cordova": {
"id": "org.apache.cordova.geolocation",
"platforms": [
"android",
"amazon-fireos",
"ios",
"blackberry10",
"ubuntu",
"wp7",
"wp8",
"windows8",
"windows",
"firefoxos"
]
},
"repository": {
"type": "git",
"url": "https://git-wip-us.apache.org/repos/asf/cordova-plugin-geolocation.git"
},
"keywords": [
"cordova",
"geolocation",
"ecosystem:cordova",
"cordova-android",
"cordova-amazon-fireos",
"cordova-ios",
"cordova-blackberry10",
"cordova-ubuntu",
"cordova-wp7",
"cordova-wp8",
"cordova-windows8",
"cordova-windows",
"cordova-firefoxos"
],
"author": "Apache Software Foundation",
"license": "Apache 2.0"
}
"name": "cordova-plugin-geolocation",
"version": "1.0.0",
"description": "Cordova Geolocation Plugin",
"cordova": {
"id": "cordova-plugin-geolocation",
"platforms": [
"android",
"amazon-fireos",
"ios",
"blackberry10",
"ubuntu",
"wp7",
"wp8",
"windows8",
"windows",
"firefoxos"
]
},
"repository": {
"type": "git",
"url": "https://git-wip-us.apache.org/repos/asf/cordova-plugin-geolocation.git"
},
"keywords": [
"cordova",
"geolocation",
"ecosystem:cordova",
"cordova-android",
"cordova-amazon-fireos",
"cordova-ios",
"cordova-blackberry10",
"cordova-ubuntu",
"cordova-wp7",
"cordova-wp8",
"cordova-windows8",
"cordova-windows",
"cordova-firefoxos"
],
"author": "Apache Software Foundation",
"license": "Apache 2.0"
}

@@ -20,4 +20,265 @@ <!---

# org.apache.cordova.geolocation
# cordova-plugin-geolocation
Plugin documentation: [doc/index.md](doc/index.md)
[![Build Status](https://travis-ci.org/apache/cordova-plugin-geolocation.svg)](https://travis-ci.org/apache/cordova-plugin-geolocation)
This plugin provides information about the device's location, such as
latitude and longitude. Common sources of location information include
Global Positioning System (GPS) and location inferred from network
signals such as IP address, RFID, WiFi and Bluetooth MAC addresses,
and GSM/CDMA cell IDs. There is no guarantee that the API returns the
device's actual location.
This API is based on the
[W3C Geolocation API Specification](http://dev.w3.org/geo/api/spec-source.html),
and only executes on devices that don't already provide an implementation.
__WARNING__: Collection and use of geolocation data
raises important privacy issues. Your app's privacy policy should
discuss how the app uses geolocation data, whether it is shared with
any other parties, and the level of precision of the data (for
example, coarse, fine, ZIP code level, etc.). Geolocation data is
generally considered sensitive because it can reveal user's
whereabouts and, if stored, the history of their travels.
Therefore, in addition to the app's privacy policy, you should
strongly consider providing a just-in-time notice before the app
accesses geolocation data (if the device operating system doesn't do
so already). That notice should provide the same information noted
above, as well as obtaining the user's permission (e.g., by presenting
choices for __OK__ and __No Thanks__). For more information, please
see the Privacy Guide.
This plugin defines a global `navigator.geolocation` object (for platforms
where it is otherwise missing).
Although the object is in the global scope, features provided by this plugin
are not available until after the `deviceready` event.
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
console.log("navigator.geolocation works well");
}
## Installation
cordova plugin add cordova-plugin-geolocation
## Supported Platforms
- Amazon Fire OS
- Android
- BlackBerry 10
- Firefox OS
- iOS
- Tizen
- Windows Phone 7 and 8
- Windows 8
- Windows
## Methods
- navigator.geolocation.getCurrentPosition
- navigator.geolocation.watchPosition
- navigator.geolocation.clearWatch
## Objects (Read-Only)
- Position
- PositionError
- Coordinates
## navigator.geolocation.getCurrentPosition
Returns the device's current position to the `geolocationSuccess`
callback with a `Position` object as the parameter. If there is an
error, the `geolocationError` callback is passed a
`PositionError` object.
navigator.geolocation.getCurrentPosition(geolocationSuccess,
[geolocationError],
[geolocationOptions]);
### Parameters
- __geolocationSuccess__: The callback that is passed the current position.
- __geolocationError__: _(Optional)_ The callback that executes if an error occurs.
- __geolocationOptions__: _(Optional)_ The geolocation options.
### Example
// 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
Returns the device's current position when a change in position is detected.
When the device retrieves a new location, the `geolocationSuccess`
callback executes with a `Position` object as the parameter. If
there is an error, the `geolocationError` callback executes with a
`PositionError` object as the parameter.
var watchId = navigator.geolocation.watchPosition(geolocationSuccess,
[geolocationError],
[geolocationOptions]);
### Parameters
- __geolocationSuccess__: The callback that is passed the current position.
- __geolocationError__: (Optional) The callback that executes if an error occurs.
- __geolocationOptions__: (Optional) The geolocation options.
### Returns
- __String__: returns a watch id that references the watch position interval. The watch id should be used with `navigator.geolocation.clearWatch` to stop watching for changes in position.
### Example
// 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
Optional parameters to customize the retrieval of the geolocation
`Position`.
{ maximumAge: 3000, timeout: 5000, enableHighAccuracy: true };
### Options
- __enableHighAccuracy__: Provides a hint that the application needs the best possible results. By default, the device attempts to retrieve a `Position` using network-based methods. Setting this property to `true` tells the framework to use more accurate methods, such as satellite positioning. _(Boolean)_
- __timeout__: The maximum length of time (milliseconds) that is allowed to pass from the call to `navigator.geolocation.getCurrentPosition` or `geolocation.watchPosition` until the corresponding `geolocationSuccess` callback executes. If the `geolocationSuccess` callback is not invoked within this time, the `geolocationError` callback is passed a `PositionError.TIMEOUT` error code. (Note that when used in conjunction with `geolocation.watchPosition`, the `geolocationError` callback could be called on an interval every `timeout` milliseconds!) _(Number)_
- __maximumAge__: Accept a cached position whose age is no greater than the specified time in milliseconds. _(Number)_
### Android Quirks
Android 2.x emulators do not return a geolocation result unless the `enableHighAccuracy` option is set to `true`.
## navigator.geolocation.clearWatch
Stop watching for changes to the device's location referenced by the
`watchID` parameter.
navigator.geolocation.clearWatch(watchID);
### Parameters
- __watchID__: The id of the `watchPosition` interval to clear. (String)
### Example
// 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
Contains `Position` coordinates and timestamp, created by the geolocation API.
### Properties
- __coords__: A set of geographic coordinates. _(Coordinates)_
- __timestamp__: Creation timestamp for `coords`. _(Date)_
## Coordinates
A `Coordinates` object is attached to a `Position` object that is
available to callback functions in requests for the current position.
It contains a set of properties that describe the geographic coordinates of a position.
### Properties
* __latitude__: Latitude in decimal degrees. _(Number)_
* __longitude__: Longitude in decimal degrees. _(Number)_
* __altitude__: Height of the position in meters above the ellipsoid. _(Number)_
* __accuracy__: Accuracy level of the latitude and longitude coordinates in meters. _(Number)_
* __altitudeAccuracy__: Accuracy level of the altitude coordinate in meters. _(Number)_
* __heading__: Direction of travel, specified in degrees counting clockwise relative to the true north. _(Number)_
* __speed__: Current ground speed of the device, specified in meters per second. _(Number)_
### Amazon Fire OS Quirks
__altitudeAccuracy__: Not supported by Android devices, returning `null`.
### Android Quirks
__altitudeAccuracy__: Not supported by Android devices, returning `null`.
## PositionError
The `PositionError` object is passed to the `geolocationError`
callback function when an error occurs with navigator.geolocation.
### Properties
- __code__: One of the predefined error codes listed below.
- __message__: Error message describing the details of the error encountered.
### Constants
- `PositionError.PERMISSION_DENIED`
- Returned when users do not allow the app to retrieve position information. This is dependent on the platform.
- `PositionError.POSITION_UNAVAILABLE`
- Returned when the device is unable to retrieve a position. In general, this means the device is not connected to a network or can't get a satellite fix.
- `PositionError.TIMEOUT`
- Returned when the device is unable to retrieve a position within the time specified by the `timeout` included in `geolocationOptions`. When used with `navigator.geolocation.watchPosition`, this error could be repeatedly passed to the `geolocationError` callback every `timeout` milliseconds.

@@ -106,1 +106,18 @@ <!--

* CB-8351 ios: Use argumentForIndex rather than NSArray extension
### 1.0.0 (Apr 15, 2015)
* CB-8746 gave plugin major version bump
* CB-8683 changed plugin-id to pacakge-name
* CB-8653 properly updated translated docs to use new id
* CB-8653 updated translated docs to use new id
* Use TRAVIS_BUILD_DIR, install paramedic by npm
* CB-8681 Fixed occasional test failures
* docs: added Windows to supported platforms
* CB-8653 Updated Readme
* CB-8659: ios: 4.0.x Compatibility: Remove use of initWebView method
* CB-8659: ios: 4.0.x Compatibility: Remove use of deprecated headers
* Wrong parameter in Firefox OS plugin
* CB-8568 Integrate TravisCI
* CB-8438 cordova-plugin-geolocation documentation translation: cordova-plugin-geolocation
* CB-8538 Added package.json file
* CB-8443 Geolocation tests fail on Windows due to done is called multiple times

@@ -42,3 +42,6 @@ /*

var id = args[0];
var nativeId = geo.watchPosition(success, error, {
function successCallback(position) {
success(position.coords);
}
var nativeId = geo.watchPosition(successCallback, error, {
enableHighAccuracy: args[1]

@@ -45,0 +48,0 @@ });

@@ -22,12 +22,38 @@ /*

exports.defineAutoTests = function () {
var fail = function (done) {
expect(true).toBe(false);
done();
},
succeed = function (done) {
expect(true).toBe(true);
done();
};
var isWindowsStore = (cordova.platformId == "windows8") || (cordova.platformId == "windows" && !WinJS.Utilities.isPhone);
var fail = function (done, context, message) {
// prevents done() to be called several times
if (context) {
if (context.done) return;
context.done = true;
}
if (message) {
expect(false).toBe(true, message);
} else {
expect(false).toBe(true);
}
// watchPosition could call its callback sync (before returning the value)
// so we invoke done async to make sure we know watcher id to .clear in afterEach
setTimeout(function () {
done();
});
},
succeed = function (done, context) {
// prevents done() to be called several times
if (context) {
if (context.done) return;
context.done = true;
}
expect(true).toBe(true);
// watchPosition could call its callback sync (before returning the value)
// so we invoke done async to make sure we know watcher id to .clear in afterEach
setTimeout(function () {
done();
});
},
isWindowsStore = (cordova.platformId == "windows8") || (cordova.platformId == "windows" && !WinJS.Utilities.isPhone);
describe('Geolocation (navigator.geolocation)', function () {

@@ -66,2 +92,3 @@

}
navigator.geolocation.getCurrentPosition(

@@ -86,2 +113,3 @@ fail.bind(null, done),

}
navigator.geolocation.getCurrentPosition(function (p) {

@@ -94,6 +122,5 @@ expect(p.coords).toBeDefined();

{
maximumAge: 300000 // 5 minutes maximum age of cached position
maximumAge: (5 * 60 * 1000) // 5 minutes maximum age of cached position
});
});
}, 25000); // first geolocation call can take several seconds on some devices
});

@@ -105,2 +132,10 @@

beforeEach(function(done) {
// This timeout is set to lessen the load on platform's geolocation services
// which were causing occasional test failures
setTimeout(function() {
done();
}, 100);
});
describe('error callback', function () {

@@ -119,5 +154,7 @@

}
var context = this;
errorWatch = navigator.geolocation.watchPosition(
fail.bind(null, done),
succeed.bind(null, done),
fail.bind(null, done, context, 'Unexpected win'),
succeed.bind(null, done, context),
{

@@ -144,13 +181,21 @@ maximumAge: 0,

}
var context = this;
successWatch = navigator.geolocation.watchPosition(
function (p) {
// prevents done() to be called several times
if (context.done) return;
context.done = true;
expect(p.coords).toBeDefined();
expect(p.timestamp).toBeDefined();
done();
// callback could be called sync so we invoke done async to make sure we know watcher id to .clear in afterEach
setTimeout(function () {
done();
});
},
fail.bind(null, done),
fail.bind(null, done, context, 'Unexpected fail callback'),
{
maximumAge: (5 * 60 * 1000) // 5 minutes maximum age of cached position
});
});

@@ -157,0 +202,0 @@

Sorry, the diff of this file is not supported yet

Sorry, the diff of this file is not supported yet

Sorry, the diff of this file is not supported yet

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc