Summary

  • Первый открытый проект Geolocation API W3C опубликовал 22 декабря 2008 года: скрипт получал общий способ спросить местоположение устройства без обязательной привязки к GPS.
  • Рекомендация от 24 октября 2013 года определила разовые запросы, непрерывные обновления, точность, кэш и явное разрешение пользователя. Второе издание 2016 года внесло исправления в текст.

Путешественница ищет трамвай. На бумажной карте улицы выглядят знакомыми, но река упорно оказывается с неверной стороны. Веб-карта могла бы нарисовать синюю точку и закончить спор. Для этого ей нужны координаты путешественницы. Те же цифры могут пригодиться и для другого рассказа — например, о том, где она побывала за весь день. Поэтому получение ответа было не просто функцией датчика, а передачей между людьми и программами.

Первый открытый проект от 22 декабря 2008 года предлагал высокоуровневый интерфейс для положения устройства, на котором работает браузер. В примерах были поиск мест в чужом городе и отображение себя на карте. Страница получала широту, долготу и оценку точности, а не инструкцию к каждому приёмнику и радиомодулю. Разным устройствам можно было ответить на один и тот же вопрос своими средствами.

Источник положения стандарт не назначал. GPS, IP-адрес, Wi-Fi, Bluetooth и сигналы сотовой сети могли участвовать в оценке. Браузер с устройством выбирали доступные подсказки; сайт видел результат в общем формате. Эта свобода делала интерфейс полезным и одновременно требовала сдержанности: точка на карте не является нотариальным свидетельством о том, на каком камне мостовой стоит человек. В ответе есть погрешность, и её надо читать вместе с координатами.

Вопрос можно было задать один раз или оставить открытым. getCurrentPosition() давал текущую позицию для карты. watchPosition() возвращал новые значения по мере движения, а clearWatch() прекращал наблюдение. Найти ближайшее кафе и сопровождать путь через несколько кварталов — разные услуги. Проект последнего обсуждения от 7 июля 2009 года продвинул интерфейс и разговор о конфиденциальности. История публикаций W3C показывает, сколько времени прошло между первым проектом и рекомендацией 2013 года.

Рекомендация от 24 октября 2013 года чётко установила порядок передачи. Браузер не должен посылать местоположение сайту без явного разрешения пользователя. В обычном браузере запрос разрешения указывает имя запрашивающего хоста. Разрешение, сохранённое после сессии, должно отзываться. Отказ приводит к ошибке PERMISSION_DENIED. Карта может спросить, но любопытство страницы не заменяет согласия человека.

Сам запрос тоже допускал настройки. maximumAge позволял принять уже сохранённую позицию определённого возраста, timeout ограничивал ожидание нового определения, а enableHighAccuracy выражал пожелание высокой точности. Последнее могло занять больше времени и энергии, но не гарантировало лучший результат. Время, пока человек решает, давать ли разрешение, не засчитывалось в срок определения местоположения. Торопливой карте приходилось дать путешественнице прочитать вопрос.

В ответ входило поле accuracy в метрах. Документ 2013 года рекомендовал соотносить точность с доверительным уровнем 95 процентов. Круг вокруг синей точки лучше передаёт смысл такой оценки, чем игла, якобы попавшая точно в ботинок прохожей. Рекомендация также не обещала, что API всегда вернёт истинное местоположение устройства. Для погоды в городе примерная зона достаточна, а для конкретной двери — уже нет.

Первое разрешение не охватывало любое последующее использование. W3C предписывал получателям запрашивать положение при необходимости, использовать его для заявленной задачи, удалять по её завершении без отдельного разрешения на сохранение и не пересылать дальше без явного согласия. Поиск остановки и постоянный архив передвижений могут начаться с одной пары чисел. Это разные договорённости с путешественницей.

Второе издание 2016 года включило исправления к рекомендации 2013-го. Основное разделение осталось: устройство и браузер оценивают, человек решает о первой передаче, приложение отвечает за применение полученного. Одна небольшая форма вопроса пригодилась картам, погоде и путеводителям, не заставляя их требовать одинаковой точности и одинаковой длительности наблюдения.

Так веб-страница научилась обращаться к физической улице на общем языке. Возможность спросить не делала ответ автоматически доступным. Путешественница, возможно, ещё держит карту вверх ногами. Зато браузер научился сначала обращаться к ней, а уже потом ставить точку.