Position

geolocation API によって作成された位置情報とタイムスタンプ (Position) とを扱うオブジェクトです。

プロパティー

  • coords: 地理座標を表します (Coordinates)
  • timestamp: タイムスタンプ値を表します (Date)

概要

Position オブジェクトは Cordova によって作られ、コールバック関数を通してユーザーに返されます。

サポートされているプラットフォーム

  • Android
  • BlackBerry WebWorks (OS 5.0 以上)
  • iOS
  • Windows Phone 7 (Mango)
  • Bada 1.2 & 2.x
  • webOS

使用例

// 成功時のコールバック関数
//
var onSuccess = function(position) {
    alert('緯度: '              + position.coords.latitude          + '\n' +
          '経度: '              + position.coords.longitude         + '\n' +
          '高度: '              + position.coords.altitude          + '\n' +
          '位置精度: '          + position.coords.accuracy          + '\n' +
          '高度精度: '          + position.coords.altitudeAccuracy  + '\n' +
          '方位: '              + position.coords.heading           + '\n' +
          '速度: '              + position.coords.speed             + '\n' +
          'タイムスタンプ: '    + position.timestamp                + '\n');
};

// エラー時のコールバック関数は PositionError オブジェクトを受けとる
//
function onError(error) {
    alert('コード: '        + error.code    + '\n' +
          'メッセージ: '    + error.message + '\n');
}

navigator.geolocation.getCurrentPosition(onSuccess, onError);

詳細な使用例

<!DOCTYPE html>
<html>
  <head>
    <title>デバイスプロパティーの使用例</title>

    <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Cordova の読み込み完了まで待機
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // Cordova 準備完了
    //
    function onDeviceReady() {
        navigator.geolocation.getCurrentPosition(onSuccess, onError);
    }

    // onSuccess Geolocation
    //
    function onSuccess(position) {
        var element = document.getElementById('geolocation');
        element.innerHTML = '緯度: '            + position.coords.latitude      + '<br />' +
                            '経度: '            + position.coords.longitude     + '<br />' +
                            '高度: '            + position.coords.altitude      + '<br />' +
                            '位置精度: '        + position.coords.accuracy      + '<br />' +
                            '高度精度: '        + position.coords.altitudeAccuracy + '<br />' +
                            '方位: '            + position.coords.heading       + '<br />' +
                            '速度: '            + position.coords.speed         + '<br />' +
                            'タイムスタンプ: '  + position.timestamp            + '<br />';
    }

    // エラー時のコールバック関数は PositionError オブジェクトを受けとる
    //
    function onError(error) {
        alert('コード: '        + error.code    + '\n' +
              'メッセージ: '    + error.message + '\n');
    }

    </script>
  </head>
  <body>
    <p id="geolocation">位置情報を取得中...</p>
  </body>
</html>