Geolocation.getCurrentPosition()

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

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

Синтаксис

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

Параметры

success

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

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 API
# getcurrentposition-method

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

BCD tables only load in the browser

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