HTML5 — геолокация

HTML5 Geolocation API позволяет вам поделиться своим местоположением с вашими любимыми веб-сайтами. JavaScript может фиксировать вашу широту и долготу и может быть отправлен на бэкэнд-сервер и выполнять такие интересные вещи, как поиск местных предприятий или отображение вашего местоположения на карте.

Сегодня большинство браузеров и мобильных устройств поддерживают Geolocation API. API геолокации работают с новым свойством объекта глобального навигатора, т.е. Геолокационный объект, который можно создать следующим образом:

var geolocation = navigator.geolocation;

Объект геолокации — это сервисный объект, который позволяет виджетам получать информацию о географическом местоположении устройства.

Методы геолокации

Объект геолокации предоставляет следующие методы:

Этот метод извлекает текущее географическое местоположение пользователя.

Этот метод извлекает периодические обновления о текущем географическом местоположении устройства.

Этот метод отменяет текущий вызов watchPosition.

пример

Ниже приведен пример кода для использования любого из вышеуказанного метода —

function getLocation() {
   var geolocation = navigator.geolocation;
   geolocation.getCurrentPosition(showLocation, errorHandler);
}

Здесь showLocation и errorHandler являются методами обратного вызова, которые будут использоваться для получения фактической позиции, как описано в следующем разделе, и для обработки ошибок, если они есть.

Свойства местоположения

Методы геолокации getCurrentPosition () и getPositionUsingMethodName () определяют метод обратного вызова, который получает информацию о местоположении. Эти методы вызываются асинхронно с объектом Position, который хранит полную информацию о местоположении.

Объект Position указывает текущее географическое местоположение устройства. Местоположение выражается в виде набора географических координат вместе с информацией о курсе и скорости.

В следующей таблице описаны свойства объекта Position. Для необязательных свойств, если система не может предоставить значение, значение свойства устанавливается равным нулю.

пример

Ниже приведен пример кода, который использует объект Position. Здесь метод showLocation является методом обратного вызова —

function showLocation( position ) {
   var latitude = position.coords.latitude;
   var longitude = position.coords.longitude;
   ...
}

Обработка ошибок

Геолокация сложна, и очень нужно отлавливать любые ошибки и обрабатывать их корректно.

Методы геолокации getCurrentPosition () и watchPosition () используют метод обратного вызова обработчика ошибок, который предоставляет объект PositionError . Этот объект имеет следующие два свойства —

В следующей таблице описаны возможные коды ошибок, возвращаемые в объекте PositionError.

пример

Ниже приведен пример кода, который использует объект PositionError. Здесь errorHandler метод является методом обратного вызова —

function errorHandler( err ) {
   
   if (err.code == 1) {
      
      // access is denied
   }
   ...
}

Параметры позиции

Ниже приведен фактический синтаксис метода getCurrentPosition ():

getCurrentPosition(callback, ErrorCallback, options)

Здесь третьим аргументом является объект PositionOptions, который определяет набор параметров для получения географического местоположения устройства.

Ниже приведены параметры, которые можно указать в качестве третьего аргумента.

пример

Ниже приведен пример кода, который показывает, как использовать вышеупомянутые методы —