Geolocation: getCurrentPosition() Methode
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Die getCurrentPosition()
Methode des Geolocation
-Interfaces wird verwendet, um die aktuelle Position des Geräts zu ermitteln.
Beachten Sie, dass neben der Notwendigkeit eines sicheren Kontexts diese Funktion möglicherweise durch die geolocation
Permissions-Policy
blockiert wird und auch die ausdrückliche Erlaubnis durch den Benutzer erforderlich ist. Falls erforderlich, wird der Benutzer aufgefordert, wenn diese Methode aufgerufen wird. Der Berechtigungsstatus kann mit der geolocation
-Berechtigung im Permissions API abgefragt werden.
Syntax
getCurrentPosition(success)
getCurrentPosition(success, error)
getCurrentPosition(success, error, options)
Parameter
success
-
Eine Callback-Funktion, die ein
GeolocationPosition
-Objekt als einziges Eingabeparameter übernimmt. error
Optional-
Eine optionale Callback-Funktion, die ein
GeolocationPositionError
-Objekt als einziges Eingabeparameter übernimmt. options
Optional-
Ein optionales Objekt, das die folgenden Parameter enthält:
maximumAge
Optional-
Ein positiver
long
-Wert, der das maximale Alter in Millisekunden eines möglicherweise zwischengespeicherten Standorts angibt, der akzeptabel ist, zurückgegeben zu werden. Wenn auf0
gesetzt, bedeutet dies, dass das Gerät keinen zwischengespeicherten Standort verwenden kann und versuchen muss, die echte aktuelle Position zu erhalten. Wenn aufInfinity
gesetzt, muss das Gerät unabhängig vom Alter einen zwischengespeicherten Standort zurückgeben. Standard:0
. timeout
Optional-
Ein positiver
long
-Wert, der die maximale Zeitspanne (in Millisekunden) darstellt, die dem Gerät zur Verfügung steht, um einen Standort zurückzugeben. Der Standardwert istInfinity
, was bedeutet, dassgetCurrentPosition()
nicht zurückkehrt, bis der Standort verfügbar ist. enableHighAccuracy
Optional-
Ein boolescher Wert, der angibt, dass die Anwendung die bestmöglichen Ergebnisse erhalten möchte. Wenn
true
und das Gerät in der Lage ist, eine genauere Position bereitzustellen, wird dies geschehen. Beachten Sie, dass dies zu langsameren Reaktionszeiten oder erhöhtem Stromverbrauch führen kann (zum Beispiel mit einem GPS-Chip auf einem Mobilgerät). Andererseits, wennfalse
, kann das Gerät die Freiheit haben, Ressourcen zu sparen, indem es schneller antwortet und/oder weniger Energie verbraucht. Standard:false
.
Rückgabewert
Keiner (undefined
).
Beispiele
const options = {
enableHighAccuracy: true,
timeout: 5000,
maximumAge: 0,
};
function success(pos) {
const crd = pos.coords;
console.log("Your current position is:");
console.log(`Latitude : ${crd.latitude}`);
console.log(`Longitude: ${crd.longitude}`);
console.log(`More or less ${crd.accuracy} meters.`);
}
function error(err) {
console.warn(`ERROR(${err.code}): ${err.message}`);
}
navigator.geolocation.getCurrentPosition(success, error, options);
Spezifikationen
Specification |
---|
Geolocation # getcurrentposition-method |