JavaScript. Подробное руководство, 6-е издание

   image.src = url;
   }
  }

Прикладной интерфейс Geolocation обладает несколькими особенностями, которые не были продемонстрированы в примере 22.1:

• В дополнение к первому аргументу с функцией обратного вызова методы getCurrentPosition и watchPosition принимают вторую необязательную функцию, которая будет вызвана в случае неудачного выполнения запроса.

• Помимо функций обработчиков успешного и неудачного выполнения запроса эти два метода принимают в третьем необязательном аргументе объект с параметрами. Свойства этого объекта определяют: желательна ли высокая точность определения местонахождения, насколько «устаревшей» может быть информация о местонахождении и предельное время ожидания определения местонахождения.

• Объект, который передается обработчику в случае успешного выполнения запроса, также включает время и может (на некоторых устройствах) содержать дополнительную информацию, такую как высота над уровнем моря, скорость и направление перемещения.

Эти дополнительные возможности демонстрируются в примере 22.2.

Пример 22.2. Демонстрация всех возможностей определения местонахождения

  // Асинхронно определяет местонахождение и отображает его в указанном элементе,
  function whereami(elt) {
   // Этот объект передается методу getCurrentPosition в 3 аргументе
   var options = {
   // Чтобы получить координаты с высокой точностью (например, с устройства GPS),
   // присвойте этому свойству значение true. Отметьте, однако, что это может
   // увеличить расход энергии в аккумуляторах.
   enableHighAccuracy: false, // Приблизительно: по умолчанию

   // Определите свое значение, если допустимо брать координаты из кэша.
   // По умолчанию имеет значение 0, что обеспечивает получение самой
   // свежей информации.
   maximumAge: 300000, // Пригодна информация, полученная в течение последних 5 минут

   // Предельное время ожидания выполнения запроса.
   // По умолчанию имеет значение Infinity, что соответствует бесконечному
   // времени ожидания выполнения запроса вызовом метода getCurrentPosition
   timeout: 15000 // Ждать не более 15 секунд
   };

   if (navigator.geolocation) // Запросить координаты, если возможно
   navigator.geolocation.getCurrentPosition(success, error, options):
   else
elt.innerHTML = "Возможность определения местонахождения " +
   "не поддерживается этим броузером":

   // Эта функция будет вызвана в случае неудачного выполнения запроса
   function error(e) {
   // Объект ошибки содержит числовой код и текстовое сообщение. Коды:
   // 1: пользователь не дал разрешения на определение местонахождения
   // 2: броузер не смог определить местонахождение
   // 3: истекло предельное время ожидания
   elt.innerHTML = "Ошибка определения местонахождения " + e.code + ": + е.message;
   }

   // Эта функция будет вызвана в случае успешного выполнения запроса
   function success(pos) {
   // Эти поля возвращаются всегда. Обратите внимание, что поле timestamp
   // принадлежит внешнему объекту pos, а не вложенному coords,
   var msg = "At " +
   new Date(pos.timestamp).toLocaleString +

" вы находились в " + pos.coords.accuracy + " метрах от точки " +

pos.coords.latitude + " северной широты " +

   pos.coords.longitude + " восточной долготы.":

   // Если устройство возвращает высоту над уровнем моря, добавить эту информацию,
   if (pos.coords.altitude) {
   msg += " Вы находитесь на высоте " +
   pos.coords.altitude + " ± " + pos.coords.altitudeAccuracy +
   " метров над уровнем моря.";
   }

   // Если устройство возвращает направление и скорость движения,
   // добавить и эту информацию.
   if (pos.coords.speed) {
   msg += " Вы перемещаетесь со скоростью " +
   pos.coords.speed + "м/сек в направлении " + pos.coords.heading + ".";