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.
Questa API è basata sulla Specifica di W3C Geolocation APIe viene eseguito solo su dispositivi che non già forniscono un'implementazione.
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"); }
Ciò richiede cordova 5.0 + (attuale stabile 1.0.0)
cordova plugin add cordova-plugin-geolocation
Versioni precedenti di cordova comunque possono installare tramite l'id deprecata (stantio 0.3.12)
cordova plugin add org.apache.cordova.geolocation
È anche possibile installare direttamente tramite url di repo (instabile)
cordova plugin add https://github.com/apache/cordova-plugin-geolocation.git
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]);
geolocationSuccess: il callback passato alla posizione corrente.
geolocationError: (facoltativo) il callback che viene eseguito se si verifica un errore.
geolocationOptions: (opzionale) le opzioni di geolocalizzazione.
// 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);
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]);
geolocationSuccess: il callback passato alla posizione corrente.
geolocationError: (facoltativo) il callback che viene eseguito se si verifica un errore.
geolocationOptions: opzioni (opzionale) la geolocalizzazione.
navigator.geolocation.clearWatch
a smettere di guardare per cambiamenti di posizione.// 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 });
Parametri opzionali per personalizzare il recupero di geolocalizzazione Position
.
{ maximumAge: 3000, timeout: 5000, enableHighAccuracy: true };
enableHighAccuracy: fornisce un suggerimento che l'applicazione ha bisogno i migliori risultati possibili. Per impostazione predefinita, il dispositivo tenta di recuperare un Position
usando metodi basati sulla rete. Impostando questa proprietà su true
indica al framework di utilizzare metodi più accurati, come posizionamento satellitare. (Boolean)
timeout: la lunghezza massima di tempo (in millisecondi) che è consentito per passare dalla chiamata a navigator.geolocation.getCurrentPosition
o geolocation.watchPosition
fino a quando il corrispondente geolocationSuccess
callback viene eseguito. Se il geolocationSuccess
callback non viene richiamato entro questo tempo, il geolocationError
callback viene passata una PositionError.TIMEOUT
codice di errore. (Si noti che, quando utilizzato in combinazione con geolocation.watchPosition
, il geolocationError
callback potrebbe essere chiamato un intervallo ogni timeout
millisecondi!) (Numero)
maximumAge: accettare una posizione memorizzata nella cache in cui età è minore il tempo specificato in millisecondi. (Numero)
Emulatori Android 2. x non restituiscono un risultato di geolocalizzazione a meno che l'opzione enableHighAccuracy
è impostata su true
.
Smettere di guardare per le modifiche alla posizione del dispositivo a cui fa riferimento il parametro watchID
.
navigator.geolocation.clearWatch(watchID);
watchPosition
intervallo per cancellare. (String)// 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);
Contiene le coordinate della Position
e timestamp, creato da geolocation API.
CoOrds: un insieme di coordinate geografiche. (Coordinate)
timestamp: timestamp di creazione per coords
. (Data)
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.
latitudine: latitudine in gradi decimali. (Numero)
longitudine: longitudine in gradi decimali. (Numero)
altitudine: altezza della posizione in metri sopra l'ellissoide. (Numero)
accuratezza: livello di accuratezza delle coordinate latitudine e longitudine in metri. (Numero)
altitudeAccuracy: livello di accuratezza della coordinata altitudine in metri. (Numero)
rubrica: senso di marcia, specificata in gradi in senso orario rispetto al vero nord di conteggio. (Numero)
velocità: velocità attuale terra del dispositivo, specificato in metri al secondo. (Numero)
altitudeAccuracy: non supportato dai dispositivi Android, restituendo null
.
altitudeAccuracy: non supportato dai dispositivi Android, restituendo null
.
L'oggetto PositionError
viene passato alla funzione di callback geolocationError
quando si verifica un errore con navigator.geolocation.
codice: uno dei codici di errore predefiniti elencati di seguito.
messaggio: messaggio di errore che descrive i dettagli dell'errore rilevato.
PositionError.PERMISSION_DENIED
PositionError.POSITION_UNAVAILABLE
PositionError.TIMEOUT
timeout
incluso geolocationOptions
. Quando utilizzato con navigator.geolocation.watchPosition
, questo errore potrebbe essere passato più volte per la geolocationError
richiamata ogni timeout
millisecondi.