Географическое положение

geolocationОбъект предоставляет доступ к данным местонахождение на основе GPS-датчик устройства или выведен из сети сигналов.

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

Этот API основан на Спецификации W3C Geolocation APIи выполняется только на устройствах, которые уже не обеспечивают реализацию.

Важных конфиденциальности Примечание: Сбор и использование данных геопозиционирования поднимает вопросы, важные конфиденциальности. Политика конфиденциальности вашего приложения должна обсудить, как приложение использует данные геопозиционирования, ли она совместно с другими сторонами и уровень точности данных (например, грубый, тонкий, почтовый индекс уровня, т.д.). Географическое расположение данных обычно считается конфиденциальной, потому что она может выявить местонахождение лица и если хранится, история его или ее путешествия. Таким образом в дополнение к политике конфиденциальности вашего приложения, настоятельно рекомендуется точно в срок уведомления до вашего приложения, доступ к данным геопозиционирования (если операционной системы устройства не так уже). Это уведомление должно обеспечивать ту же информацию, отметили выше, а также получения разрешения пользователя (например, путем представления выбора OK и Нет, спасибо). Для получения дополнительной информации пожалуйста, смотрите в руководстве конфиденциальности.

Методы

• geolocation.getCurrentPosition
• geolocation.watchPosition
• geolocation.clearWatch

Аргументы

• geolocationSuccess
• geolocationError
• geolocationOptions

Объекты (только для чтения)

• Position
• PositionError
• Coordinates

Доступ к функции

Начиная с версии 3.0 Кордова реализует интерфейсы API уровень устройства как плагины. Использование CLI plugin команды, описанные в интерфейс командной строки, чтобы добавить или удалить эту функцию для проекта:

    $ cordova plugin add org.apache.cordova.geolocation
    $ cordova plugin ls
    [ 'org.apache.cordova.geolocation' ]
    $ cordova plugin rm org.apache.cordova.geolocation

Эти команды применяются для всех целевых платформ, но изменить параметры конфигурации платформы, описанные ниже:

• Андроид

  (in app/res/xml/config.xml)
  <feature name="Geolocation">
      <param name="android-package" value="org.apache.cordova.GeoBroker" />
  </feature>
  
  (in app/AndroidManifest.xml)
  <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
  <uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" />
  

• Ежевика WebWorks

  (in www/plugins.xml)
  <feature name="Geolocation">
      <param name="blackberry-package" value="org.apache.cordova.geolocation.Geolocation" />
  </feature>
  
  (in www/config.xml)
  <rim:permissions>
      <rim:permit>read_geolocation</rim:permit>
  </rim:permissions>
  

• iOS (вconfig.xml)

  <feature name="Geolocation">
      <param name="ios-package" value="CDVLocation" />
  </feature>
  

• Windows Phone (вProperties/WPAppManifest.xml)

  <Capabilities>
      <Capability Name="ID_CAP_LOCATION" />
  </Capabilities>
  

  Ссылка: манифест приложения для Windows Phone

Некоторые платформы могут поддерживать эту функцию без необходимости специальной настройки. В разделе Поддержка платформы в разделе Обзор.