Geolocation.getCurrentPosition()

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.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

Метод Geolocation.getCurrentPosition() используется для получения текущего местоположения устройства.

Синтаксис

navigator.geolocation.getCurrentPosition(success[, error[, options]])

Параметры

success

Колбэк-функция, которая принимает объект Position в качестве единственного входного параметра.

error Необязательный

Необязательная колбэк-функция, принимающая объект PositionError как единственный входной параметр.

options Необязательный

Необязательный объект PositionOptions. Включает в себя

  • maximumAge: целое число (миллисекунды) | infinity - максимальное время кеширования позиции.
  • timeout: целое число (миллисекунды) - количество времени до вызова callback ошибки. Если 0, вызов не происходит.
  • enableHighAccuracy: false | true

Пример

js
var options = {
  enableHighAccuracy: true,
  timeout: 5000,
  maximumAge: 0,
};

function success(pos) {
  var crd = pos.coords;

  console.log("Ваше текущее местоположение:");
  console.log(`Широта: ${crd.latitude}`);
  console.log(`Долгота: ${crd.longitude}`);
  console.log(`Плюс-минус ${crd.accuracy} метров.`);
}

function error(err) {
  console.warn(`ERROR(${err.code}): ${err.message}`);
}

navigator.geolocation.getCurrentPosition(success, error, options);

Спецификации

Specification
Geolocation
# getcurrentposition-method

Совместимость с браузерами

BCD tables only load in the browser

Смотрите также