Unlimited Plugins, WordPress themes, videos & courses! Unlimited asset downloads! From $16.50/m
Advertisement
  1. Code
  2. Mobile Development
Code

Введение в API геолокации

by
Difficulty:BeginnerLength:MediumLanguages:

Russian (Pусский) translation by Masha Kolesnikova (you can also view the original English article)

Введение

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

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

Сегодня нам повезло, что геолокация поддерживается браузерами. В этой статье мы обсудим API геолокации, позволяя приложениям обнаруживать и отслеживать местоположение устройства.

Возможность обнаружения местоположения устройства имеет широкий спектр приложений. Например, в Интернете Google, Microsoft и Yahoo используют местоположение пользователя для персонализации SERPs (Страница результатов поисковой системы) на основе местоположения пользователя. Локализация - еще одна отличная возможность для геолокации.

1. Что это такое?

API геолокации определяет интерфейс высокого уровня для информации о местоположении, такой как широта и долгота, которая связана с устройством, реализующим геолокацию. Сам API является не привязан к источникам информации о местоположении.

Общие источники информации о местоположении включают в себя Глобальную систему определения местоположения (GPS) и информацию о местоположении, выведенную из сетевых сигналов, таких как IP-адрес устройства, RFID, Wi-Fi, Bluetooth, MAC-адреса, идентификаторы сотовой сети GSM / CDMA и пользовательский ввод. Не предоставляется никаких гарантий, что API возвращает фактическое местоположение устройства.

API геолокации является Рекомендацией W3C, которая означает, что спецификация является стабильной. Мы можем предположить, что оно не изменится в будущем, если не будет работать новая версия. Стоит отметить, что API геолокации не является официально частью спецификации HTML5, поскольку он разработан отдельно.

Теперь, когда мы знаем, что такое API геолокации и что он может сделать, пришло время посмотреть, какие методы он предоставляет разработчикам.

2. Внедрение

Точность

API использует несколько источников для определения позиции устройства. Например, на ноутбуке или настольном компьютере без чипа GPS вполне вероятно, что позиция выводится из IP-адреса устройства, а это означает, что местоположение, возвращаемое API, не очень точное.

Однако на мобильном устройстве API может использовать информацию из нескольких и более точных источников, таких как чип GPS устройства, сетевое соединение (Wi-Fi, 3G, HSPA +) и ячейка GSM / CDMA. Вы можете ожидать более точной информации о местоположении на мобильном устройстве, особенно если GPS включен.

Конфиденциальность

Спецификация API геолокации также обсуждает конфиденциальность и разрешения. Фактически, в спецификации четко указано, что разрешение пользователя должно быть явно получено до включения API.

Это означает, что браузер должен отображать уведомление пользователю, запрашивающему их разрешение. Пример сообщения, показанного пользователю, показан ниже (Карты Google).

API

API предоставляет три метода, которые относятся к объекту window.navigator.geolocation. Предоставляемые методы:

  • getCurrentPosition
  • watchPosition
  • clearWatch

Обнаружение поддержки

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

Поиск устройства

Чтобы определить местоположение устройства, мы вызываем getCurrentPosition или watchPosition, в зависимости от ваших потребностей. Оба метода выполняют одну и ту же задачу с несколькими незначительными отличиями.

Чтобы получить местоположение устройства, getCurrentPosition и watchPosition делают асинхронный запрос. Разница между этими методами заключается в том, что getCurrentPosition выполняет одноразовый запрос, а watchPosition контролирует местоположение устройства для изменений и уведомляет приложение о том, когда происходит изменение местоположения.

API геолокации достаточно умен, чтобы вызвать только обратный вызов функции watchPosition-invoked, когда позиция получена - если местоположение пользователя изменяется.

Другим важным различием между getCurrentPosition и watchPosition является возвращаемое значение каждого метода. Метод getCurrentPosition ничего не возвращает, в то время как watchPosition возвращает идентификатор, который может использоваться, чтобы остановить API от контроля местоположения устройства через функцию clearWatch.

Сигнатуры getCurrentPosition и watchPosition выглядят следующим образом:

Как показывают сигнатуры, каждая функция принимает три параметра. Требуется только первый аргумент - функция обратного вызова. Давайте подробнее рассмотрим каждый аргумент.

  1. successCallback: эта функция обратного вызова выполняется после успешного получения местоположения пользователя. Обратный вызов принимает объект position, который содержит информацию о местоположении устройства.
  2. errorCallback: обратный вызов ошибки выполняется при возникновении ошибки. Обратный вызов ошибки принимает объект error, содержащий информацию о типе возникшей ошибки.
  3. options: Объект options дает разработчику возможность настроить асинхронный запрос.

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

Остановить мониторинг местоположения

В предыдущем разделе я упомянул функцию clearWatch. Эта функция позволяет остановить мониторинг местоположения устройства, инициированный вызовом watchPosition.

Функция clearWatch принимает один обязательный аргумент, возвращаемый нам идентификатор после вызова watchPosition.

Теперь, когда мы рассмотрели технические подробности API геолокации, пришло время изучить объекты position, error и options, возвращаемые API геолокации.

Информация о местонахождении

Position

Методы, представленные API геолокации, принимают или возвращают три типа объектов. Первым интересующим нас объектом является объект position, который содержит информацию о местоположении, которая нам интересна. Взгляните на следующую таблицу, чтобы получить представление о содержащейся в ней информации.

Объект позиции, который возвращается из обратных вызовов getCurrentPosition и watchPosition, содержит свойство timestamp и coords. Свойство coords - это объект, содержащий latitude, longitude, altitude, accuracy, altitudeAccuracy, heading, и speed.

Большинство настольных браузеров не вернут значение для свойств altitudealtitudeAccuracyheading и speed. Однако мобильные устройства, такие как смартфоны и планшеты, обеспечивают более точную информацию благодаря наличию микросхемы GPS или другого оборудования, которое помогает обнаружить местоположение устройства.

Свойство timestamp содержит время обнаружения местоположения, которое может быть полезно, если вам нужно знать, как свежие данные были возвращены.

PositionError

Объект error обратного вызова ошибки, необязательный второй аргумент getCurrentPosition и watchPosition, имеет code и свойство message.

Свойство message кратко описывает тип ошибки. Свойство code может иметь одно из четырех значений:

  • 0: запрос не выполнен, но причина неизвестна.
  • 1: запрос не удался, поскольку пользователь не дал разрешения на использование местоположения устройства.
  • 2: запрос завершился неудачно в результате сетевой ошибки.
  • 3: запрос завершился неудачно, поскольку для разрешения позиции устройства потребовалось слишком много времени.

PositionOptions

Необязательный третий аргумент getCurrentPosition и watchPosition - это объект PositionOptions, позволяющий разработчику настраивать асинхронный запрос.

В настоящее время объект PositionOptions поддерживает три варианта:

  • enableHighAccuracy: Если для значения установлено значение true, веб-страница или приложение указывают, что они хотят получить максимально возможный, самый точный результат. Это может привести к более медленному времени отклика или увеличению потребления энергии. Значение по умолчанию false.
  • timeout: Это свойство определяет максимальное количество миллисекунд, после которого запрос должен считаться устаревшим. По умолчанию используется значение Infinity.
  • maximumAge: Когда запрос местоположения будет успешным, браузер кэширует результат для последующего использования. Свойство maximumAge указывает время, в течение которого кеш должен быть недействительным. Значение по умолчанию равно 0, что означает, что запрос не должен кэшироваться.

Поддержка браузера

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

  • Firefox 3.5+
  • Chrome 5.0+
  • Safari 5.0+
  • Opera 10.60+
  • Internet Explorer 9.0+

Поддержка в мобильных браузерах еще лучше, как вы можете видеть в этом резюме:

  • Android 2.0+
  • iPhone 3.0+
  • Opera Mobile 10.1+
  • Symbian (S60 третьего и пятого поколения)
  • Blackberry OS 6

API геолокации широко поддерживается. Возможно, вам интересно, что вы можете сделать, если столкнулись с браузером, который не поддерживает API геолокации. Верьте или нет, для устранения этой проблемы существует несколько полифилов и прокладок. Наиболее заметными решениями являются тот, который был создан Мануэлем Бихом и легкой прокладкой, созданной Полом Ирришем.

Демонстрация

Теперь, когда мы знаем все аспекты API геолокации, пришло время увидеть его в действии. Эта демонстрация полностью функциональна и использует все методы и объекты, описанные в этой статье. Цель проста: каждый раз, когда выполняется запрос на обнаружение позиции устройства, данные о местоположении отображаются пользователю в виде списка.

Демонстрация содержит три кнопки, позволяющие выбрать операцию, которую вы хотите выполнить. Демонстрация также определяет, поддерживает ли браузер API геолокации или нет. Если это не так, вы увидите сообщение «API не поддерживается», и кнопки отключены.

Исходный код демонстрации показан ниже, но вы также можете играть с демо-версией API геолокации.

Заключение

В этой статье мы узнали о Geolocation API. Мы видели, что это такое, как и когда его использовать.

API геолокации - полезный инструмент для улучшения пользовательского опыта и может служить многим целям. Поддержка широка, но не забывайте, что более старые версии Internet Explorer ее не поддерживают.

Как мы обсуждали в этой статье, вы должны знать, что некоторые данные о местоположении, такие как speedaltitude и heading, не всегда доступны. Также не забывайте использовать Geolocation API с осторожностью, потому что это требует значительного заряда батареи, особенно на мобильных устройствах, оснащенных чипом GPS.

Advertisement
Advertisement
Advertisement
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.