This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

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 ⁨июль 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

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

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