Baseline Widely available
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.
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 auf 0
gesetzt, bedeutet dies, dass das Gerät keinen zwischengespeicherten Standort verwenden kann und versuchen muss, die echte aktuelle Position zu erhalten. Wenn auf Infinity
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 ist Infinity
, was bedeutet, dass getCurrentPosition()
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, wenn false
, kann das Gerät die Freiheit haben, Ressourcen zu sparen, indem es schneller antwortet und/oder weniger Energie verbraucht. Standard: false
.
Keiner (undefined
).
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 Browser-Kompatibilität Siehe auch
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4