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

Пример

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);

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

Спецификация Статус Комментарий
Geolocation API Рекомендация Начальная спецификация.

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

BCD tables only load in the browser

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