Un semplice contachilometri parziale che utilizza l'API Geolocation

Michael Mahemoff
Michael Mahemoff

Introduzione

L'API Geolocation ti consente di scoprire dove si trova l'utente e di tenerlo d'occhio mentre si sposta, sempre con il suo consenso. Questa funzionalità potrebbe essere utilizzata nell'ambito delle query degli utenti, ad esempio per guidare qualcuno verso un punto di destinazione. Potrebbe anche essere utilizzato per il "geotagging" di alcuni contenuti creati dall'utente, ad esempio per contrassegnare il luogo in cui è stata scattata una foto. L'API è indipendente dal dispositivo; non importa come il browser determina la posizione, purché i client possano richiedere e ricevere i dati sulla posizione in modo standard. Il meccanismo sottostante potrebbe essere tramite GPS, Wi-Fi o semplicemente chiedendo all'utente di inserire manualmente la propria posizione. Poiché ognuna di queste ricerche richiede un po' di tempo, l'API è asincrona; ogni volta che richiedi una posizione, le passi un metodo di callback.

L'esempio qui è un contachilometri parziale che mostra la posizione iniziale e mantiene una visualizzazione della distanza percorsa dal caricamento della pagina.

Passaggio 1: Verifica la compatibilità della tua macchina

Browser Support

  • Chrome: 5.
  • Edge: 12.
  • Firefox: 3.5.
  • Safari: 5.

Source

Puoi verificare facilmente la compatibilità controllando la presenza dell'oggetto di geolocalizzazione:

// check for Geolocation support
if (navigator.geolocation) {
  console.log('Geolocation is supported!');
}
else {
  console.log('Geolocation is not supported for this Browser/OS version yet.');
}

Passaggio 2: Dichiara l'HTML del contachilometri parziale

In questo esempio, stai creando un contachilometri, quindi dichiara il seguente codice HTML:

<div id="tripmeter">
<p>
Starting Location (lat, lon):<br/>
<span id="startLat">???</span>°, <span id="startLon">???</span>°
</p>
<p>
Current Location (lat, lon):<br/>
<span id="currentLat">???</span>°, <span id="currentLon">???</span>°
</p>
<p>
Distance from starting location:<br/>
<span id="distance">0</span> km
</p>
</div>

Nei prossimi passaggi utilizzerai l'API Geolocation per compilare tutti gli span vuoti.

Passaggio 3: Determinare la posizione attuale dell'utente

getCurrentPosition() segnalerà in modo asincrono la posizione attuale dell'utente. Chiamalo non appena la pagina viene caricata, in modo che compili correttamente e salvi per un secondo momento la posizione iniziale:

window.onload = function() {
var startPos;
navigator.geolocation.getCurrentPosition(function(position) {
startPos = position;
document.getElementById('startLat').innerHTML = startPos.coords.latitude;
document.getElementById('startLon').innerHTML = startPos.coords.longitude;
});
};

Se è la prima volta che un'applicazione in questo dominio richiede le autorizzazioni, il browser in genere verifica il consenso dell'utente. A seconda del browser, potrebbero essere presenti anche preferenze per consentire o non consentire sempre le ricerche delle autorizzazioni, nel qual caso la procedura di conferma verrà ignorata.

Dopo aver eseguito questo codice, dovresti essere in grado di vedere la posizione di partenza. A seconda del dispositivo di localizzazione utilizzato dal browser, l'oggetto posizione potrebbe contenere molte più informazioni rispetto alla sola latitudine e longitudine, ad esempio potrebbe includere un'altitudine o una direzione. Puoi esplorare ulteriormente registrando la variabile di posizione nella console.

Passaggio 4: Gestisci gli errori

Purtroppo, non tutte le ricerche di località vanno a buon fine. È possibile che non sia stato possibile individuare un GPS o che l'utente abbia disattivato improvvisamente le ricerche della posizione. Un secondo argomento facoltativo di getCurrentPosition() verrà chiamato in caso di errore, in modo da poter avvisare l'utente all'interno del callback:

window.onload = function() {
var startPos;
navigator.geolocation.getCurrentPosition(function(position) {
// same as above
}, function(error) {
alert('Error occurred. Error code: ' + error.code);
// error.code can be:
//   0: unknown error
//   1: permission denied
//   2: position unavailable (error response from locaton provider)
//   3: timed out
});
};

Passaggio 5: Monitorare la posizione dell'utente

La chiamata precedente a getCurrentPosition() è stata eseguita una sola volta, al caricamento della pagina. Per monitorare le modifiche, utilizza watchPosition(). In questo modo, una funzione di callback verrà avvisata automaticamente ogni volta che l'utente si sposta:

navigator.geolocation.watchPosition(function(position) {
document.getElementById('currentLat').innerHTML = position.coords.latitude;
document.getElementById('currentLon').innerHTML = position.coords.longitude;
});

Passaggio 6: Mostra la distanza percorsa

Questo passaggio non è direttamente correlato all'API Geolocation, ma completa la demo e fornisce un esempio di come potresti utilizzare i dati sulla posizione. Aggiungi una riga aggiuntiva al gestore watchPosition() per compilare la distanza percorsa:

navigator.geolocation.watchPosition(function(position) {
// same as above
document.getElementById('distance').innerHTML =
    calculateDistance(startPos.coords.latitude, startPos.coords.longitude,
                    position.coords.latitude, position.coords.longitude);
});

La funzione calculateDistance() esegue un algoritmo geometrico per determinare la distanza tra due coordinate. L'implementazione di JavaScript è adattata da uno script fornito da Moveable Type con una licenza Creative Commons:

function calculateDistance(lat1, lon1, lat2, lon2) {
var R = 6371; // km
var dLat = (lat2 - lat1).toRad();
var dLon = (lon2 - lon1).toRad();
var a = Math.sin(dLat / 2) * Math.sin(dLat / 2) +
        Math.cos(lat1.toRad()) * Math.cos(lat2.toRad()) *
        Math.sin(dLon / 2) * Math.sin(dLon / 2);
var c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
var d = R * c;
return d;
}
Number.prototype.toRad = function() {
return this * Math.PI / 180;
}