22.1. Геопозиционирование
Прикладной интерфейс объекта Geolocation (іhttp://www.iv3.org/TR/geolocation-API/) позволяет программам на языке JavaScript запрашивать у броузера географическое местонахождение пользователя. Такие приложения могут отображать карты, маршруты и другую информацию, связанную с текущим местонахождением пользователя. При этом, конечно, возникает важная проблема соблюдения тайны частной информации, поэтому броузеры, поддерживающие прикладной интерфейс Geolocation, всегда запрашивают у пользователя подтверждение, прежде чем передать JavaScript-программе информацию о физическом местонахождении пользователя.
Броузеры с поддержкой интерфейса Geolocation определяют свойство navigator.geolocation. Это свойство ссылается на объект с тремя методами:
navigator.geolocation.getCurrentPosition()
Запрашивает текущее географическое местонахождение пользователя.
navigator.geolocation.watchPosition()
Не только запрашивает текущее местонахождение, но и продолжает следить за координатами, вызывая указанную функцию обратного вызова при изменении местонахождения пользователя.
navigator.geolocation.clearWatch()
Останавливает слежение за местонахождением пользователя. В аргументе этому методу следует передавать число, возвращаемое соответствующим вызовом метода watchPosition().
В устройствах, включающих аппаратную поддержку GPS, имеется возможность определять местонахождение с высокой степенью точности с помощью устройства GPS. Однако чаще информация о местонахождении поступает из Всемирной паутины. Если броузер отправит ІР-адрес специализированной веб-службе, она в большинстве случаев сможет определить (на основе информации о поставщиках услуг Интернета), в каком городе находится пользователь (и рекламодатели часто пользуются этой возможностью, реализуя определение местонахождения на стороне сервера). Броузер часто в состоянии получить еще более точную информацию о местонахождении, запросив у операционной системы список ближайших беспроводных сетей и силы их сигналов. Затем эта информация отправляется веб-службе, которая позволяет вычислить местонахождение с большой точностью (обычно с точностью до микрорайона в городе).
Эти технологии определения географического местонахождения связаны либо с обменом данными по сети, либо с взаимодействием с несколькими спутниками, поэтому прикладной интерфейс объекта Geolocation является асинхронным: методы getCurrentPosition() и watchPosition() возвращают управление немедленно, но они принимают функцию, которая будет вызвана броузером, когда он определит местонахождение пользователя (или когда местонахождение изменится). В простейшем случае запрос местонахождения выглядит так:
navigator.geolocation.getCurrentPosition(function(pos) {
var latitude = pos.coords.latitude;
var longitude = pos.coords.longitude;
alert("Ваши координаты: " + latitude + ", + longitude);
});
В дополнение к широте и долготе в ответ на каждый успешный запрос возвращается также значение (в метрах), указывающее точность определения местонахождения. Пример 22.1 демонстрирует получение информации о местонахождении: он вызывает метод getCurrentPosition(), чтобы определить текущее местонахождение, и использует полученную информацию для отображения карты (полученной от службы Google Maps) текущего местонахождения в масштабе, примерно соответствующем точности определения местонахождения.
Пример 22.1. Использование информации о местонахождении для отображения карты
// Возвращает вновь созданный элемент <img>, настроенный (в случае успешного
// определения местонахождения) на отображение карты для текущего местонахождения.
// Обратите внимание, что вызывающая программа сама должна вставить возвращаемый
// элемент в документ, чтобы отобразить его. Возбуждает исключение, если возможность
// определения местонахождения не поддерживается броузером,
function getmap() {
// Проверить поддержку объекта geolocation
if (!navigator.geolocation)
throw "Определение местонахождения не поддерживается";
// Создать новый элемент <img>, отправить запрос определения местонахождения,
// чтобы в img отобразить карту местонахождения и вернуть изображение,
var image = document.createElement("img");
navigator.geolocation.getCurrentPosition(setMapURL);
return image;
// Эта функция будет вызвана после того, как вызывающая программа получит объект
// изображения, в случае успешного выполнения запроса определения местонахождения,
function setMapURL(pos) {
// Получить информацию о местонахождении из объекта аргумента
var latitude = pos.coords.latitude; // Градусы к северу от экватора
var longitude = pos.coords.longitude; // Градусы к востоку от Гринвича
var accuracy = pos.coords.accuracy; // Метры
// Сконструировать URL для получения статического изображения карты
// от службы Google Мар для этого местонахождения
var url = "http://maps.google.com/maps/api/staticmap" +
"?center=" + latitude + + longitude +
"&size=640x640&sensor=t rue";
// Установить масштаб карты, используя грубое приближение
var zoomlevel=20; // Для начала установить самый крупный масштаб
if (accuracy > 80) // Уменьшить масштаб для низкой точности
zoomlevel -= Math.round(Math.log(accuracy/50)/Math.LN2);
url += "&zoom=" + zoomlevel; // Добавить масштаб в URL
// Отобразить карту в объекте изображения. Спасибо, Google!
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 + ".";
}
elt.innerHTML = msg; // Отобразить информацию о местонахождении
}
}