incubator-callback-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mwbro...@apache.org
Subject [7/25] docs commit: Translate and update files related to geolocation
Date Thu, 12 Jul 2012 21:04:38 GMT
Translate and update files related to geolocation


Project: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/commit/6e733530
Tree: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/tree/6e733530
Diff: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/diff/6e733530

Branch: refs/heads/master
Commit: 6e7335309f91c6d765cef180da3859ea8ff6b378
Parents: b6d09bf
Author: Keiko Oda <keiko713@gmail.com>
Authored: Tue Jul 10 17:40:56 2012 -0700
Committer: Keiko Oda <keiko713@gmail.com>
Committed: Wed Jul 11 17:33:15 2012 -0700

----------------------------------------------------------------------
 .../cordova/geolocation/Coordinates/coordinates.md |    7 +-
 .../1.8.1/cordova/geolocation/Position/position.md |   26 ++-----
 .../geolocation/PositionError/positionError.md     |   13 +++-
 .../cordova/geolocation/geolocation.clearWatch.md  |   15 +++--
 .../geolocation/geolocation.getCurrentPosition.md  |    9 ++-
 docs/jp/1.8.1/cordova/geolocation/geolocation.md   |   57 ++++++++++++++-
 .../geolocation/geolocation.watchPosition.md       |   15 ++--
 .../geolocation/parameters/geolocation.options.md  |    7 +-
 .../geolocation/parameters/geolocationSuccess.md   |    4 +-
 9 files changed, 106 insertions(+), 47 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/6e733530/docs/jp/1.8.1/cordova/geolocation/Coordinates/coordinates.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/geolocation/Coordinates/coordinates.md b/docs/jp/1.8.1/cordova/geolocation/Coordinates/coordinates.md
index 47a0de8..a3cbe9a 100644
--- a/docs/jp/1.8.1/cordova/geolocation/Coordinates/coordinates.md
+++ b/docs/jp/1.8.1/cordova/geolocation/Coordinates/coordinates.md
@@ -43,9 +43,10 @@ Coordinates
 
 - Android
 - BlackBerry WebWorks (OS 5.0 以上)
-- iPhone
+- iOS
 - Windows Phone 7 (Mango)
 - Bada 1.2 & 2.x
+- webOS
 
 使用例
 -------------
@@ -60,7 +61,7 @@ Coordinates
               '高度精度: '          + position.coords.altitudeAccuracy  + '\n' +
               '方位: '              + position.coords.heading           + '\n' +
               '速度: '              + position.coords.speed             + '\n' +
-              'タイムスタンプ: '    + new Date(position.timestamp)      + '\n');
+              'タイムスタンプ: '    + position.timestamp                + '\n');
     };
 
     // エラー時のコールバック関数
@@ -78,7 +79,7 @@ Coordinates
     <html>
       <head>
         <title>位置情報の使用例</title>
-        <script type="text/javascript" charset="utf-8" src="cordova-1.7.0.js"></script>
+        <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
         <script type="text/javascript" charset="utf-8">
 
         // Cordovaの読み込み完了まで待機

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/6e733530/docs/jp/1.8.1/cordova/geolocation/Position/position.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/geolocation/Position/position.md b/docs/jp/1.8.1/cordova/geolocation/Position/position.md
index 7345d82..aec86ae 100644
--- a/docs/jp/1.8.1/cordova/geolocation/Position/position.md
+++ b/docs/jp/1.8.1/cordova/geolocation/Position/position.md
@@ -20,13 +20,13 @@ license: Licensed to the Apache Software Foundation (ASF) under one
 Position
 ========
 
-geolocation API によって作成された位置情報 (`Position`) を扱うオブジェクトです。
+geolocation API によって作成された位置情報とタイムスタンプ (`Position`)
とを扱うオブジェクトです。
 
 プロパティー
 ----------
 
 - __coords:__ 地理座標を表します _(Coordinates)_
-- __timestamp:__ ミリ秒単位のタイムスタンプ値を表します _(DOMTimeStamp)_
+- __timestamp:__ タイムスタンプ値を表します _(Date)_
 
 概要
 -----------
@@ -38,9 +38,10 @@ geolocation API によって作成された位置情報 (`Position`) を扱う
 
 - Android
 - BlackBerry WebWorks (OS 5.0 以上)
-- iPhone
+- iOS
 - Windows Phone 7 (Mango)
 - Bada 1.2 & 2.x
+- webOS
 
 使用例
 -------------
@@ -55,7 +56,7 @@ geolocation API によって作成された位置情報 (`Position`) を扱う
               '高度精度: '          + position.coords.altitudeAccuracy  + '\n' +
               '方位: '              + position.coords.heading           + '\n' +
               '速度: '              + position.coords.speed             + '\n' +
-              'タイムスタンプ: '    + new Date(position.timestamp)      + '\n');
+              'タイムスタンプ: '    + position.timestamp                + '\n');
     };
 
     // エラー時のコールバック関数は PositionError オブジェクトを受けとる
@@ -75,7 +76,7 @@ geolocation API によって作成された位置情報 (`Position`) を扱う
       <head>
         <title>デバイスプロパティーの使用例</title>
 
-        <script type="text/javascript" charset="utf-8" src="cordova-1.7.0.js"></script>
+        <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
         <script type="text/javascript" charset="utf-8">
 
         // Cordova の読み込み完了まで待機
@@ -99,7 +100,7 @@ geolocation API によって作成された位置情報 (`Position`) を扱う
                                 '高度精度: '        + position.coords.altitudeAccuracy
+ '<br />' +
                                 '方位: '            + position.coords.heading       + '<br
/>' +
                                 '速度: '            + position.coords.speed         + '<br
/>' +
-                                'タイムスタンプ: '  + new Date(position.timestamp)
 + '<br />';
+                                'タイムスタンプ: '  + position.timestamp         
  + '<br />';
         }
 
         // エラー時のコールバック関数は PositionError オブジェクトを受けとる
@@ -115,16 +116,3 @@ geolocation API によって作成された位置情報 (`Position`)
を扱う
         <p id="geolocation">位置情報を取得中...</p>
       </body>
     </html>
-
-iPhone に関する注意点
--------------
-
-- __timestamp:__ ミリ秒ではなく、秒が使用されています。
-
-対処法としては、1000倍することにより手動でマイクロ秒にすることが考えられます。
-
-    var onSuccess = function(position) {
-        alert('緯度: '              + position.coords.latitude      + '\n' +
-              '経度: '              + position.coords.longitude     + '\n' +
-              'タイムスタンプ: '    + new Date(position.timestamp * 1000) + '\n');
-    };

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/6e733530/docs/jp/1.8.1/cordova/geolocation/PositionError/positionError.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/geolocation/PositionError/positionError.md b/docs/jp/1.8.1/cordova/geolocation/PositionError/positionError.md
index c50d986..ffd7e10 100755
--- a/docs/jp/1.8.1/cordova/geolocation/PositionError/positionError.md
+++ b/docs/jp/1.8.1/cordova/geolocation/PositionError/positionError.md
@@ -20,7 +20,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one
 PositionError
 ========
 
-`PositionError` オブジェクトは、エラーが発生したときに geolocationError
コールバック関数に渡されます。
+`PositionError` オブジェクトは、エラーが発生したときに `geolocationError`
コールバック関数に渡されます。
 
 プロパティー
 ----------
@@ -40,3 +40,14 @@ PositionError
 
 `PositionError` オブジェクトは、位置情報取得に関するエラーが発生したときに
`geolocationError` コールバック関数を通してユーザーに返されます。
 
+### `PositionError.PERMISSION_DENIED`
+
+ユーザーがアプリケーションに対して、位置情報の取得を許可しなかった場合に返されます。これはプラットフォームに依存します。
+
+### `PositionError.POSITION_UNAVAILABLE`
+
+デバイスが位置を取得できなかった場合に返されます。大抵、これはデバイスがネットワークに接続されていない、および/または衛生情報が取得出来なかったことを意味します。
+
+### `PositionError.TIMEOUT`
+
+デバイスが、 `geolocationOptions` の `timeout` プロパティーによって指定された時間内に位置が取得できなかった場合に返されます。
`geolocation.watchPosition` と一緒に使用するとき、このエラーは `geolocationError`
コールバックの中で毎 `timeout` ミリ秒後呼ばれる可能性があります。

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/6e733530/docs/jp/1.8.1/cordova/geolocation/geolocation.clearWatch.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/geolocation/geolocation.clearWatch.md b/docs/jp/1.8.1/cordova/geolocation/geolocation.clearWatch.md
index ced5290..2b608d8 100644
--- a/docs/jp/1.8.1/cordova/geolocation/geolocation.clearWatch.md
+++ b/docs/jp/1.8.1/cordova/geolocation/geolocation.clearWatch.md
@@ -39,16 +39,18 @@ watch ID パラメーターによって参照されるデバイスの位置情
 
 - Android
 - BlackBerry WebWorks (OS 5.0 以上)
-- iPhone
+- iOS
 - Windows Phone 7 (Mango)
 - Bada 1.2 & 2.x
+- webOS
 
 使用例
 -------------
 
-    // 3秒ごとに位置情報を取得する設定 (オプション)
+    // 位置の変化を監視し、取得可能なもっとも精度の高い位置を使います
+    // (オプション)
     //
-    var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { frequency: 3000
});
+    var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { enableHighAccuracy:
true });
 
     // ... 後に続く ...
 
@@ -63,7 +65,7 @@ watch ID パラメーターによって参照されるデバイスの位置情
       <head>
         <title>デバイスプロパティーの使用例</title>
 
-        <script type="text/javascript" charset="utf-8" src="cordova-1.7.0.js"></script>
+        <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
         <script type="text/javascript" charset="utf-8">
 
         // Cordova の読み込み完了まで待機
@@ -75,8 +77,9 @@ watch ID パラメーターによって参照されるデバイスの位置情
         // Cordova 準備完了
         //
         function onDeviceReady() {
-            // 3秒ごとに更新
-            var options = { frequency: 3000 };
+            // デバイスで有効な最も制度の高い位置で更新
+            //
+            var options = { enableHighAccuracy: true };
             watchID = navigator.geolocation.watchPosition(onSuccess, onError, options);
         }
 

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/6e733530/docs/jp/1.8.1/cordova/geolocation/geolocation.getCurrentPosition.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/geolocation/geolocation.getCurrentPosition.md b/docs/jp/1.8.1/cordova/geolocation/geolocation.getCurrentPosition.md
index 38d59b6..6db6930 100644
--- a/docs/jp/1.8.1/cordova/geolocation/geolocation.getCurrentPosition.md
+++ b/docs/jp/1.8.1/cordova/geolocation/geolocation.getCurrentPosition.md
@@ -44,9 +44,10 @@ geolocation.getCurrentPosition
 
 - Android
 - BlackBerry WebWorks (OS 5.0 以上)
-- iPhone
+- iOS
 - Windows Phone 7 (Mango)
 - Bada 1.2 & 2.x
+- webOS
 
 使用例
 -------------
@@ -63,7 +64,7 @@ geolocation.getCurrentPosition
               '高度精度: '          + position.coords.altitudeAccuracy + '\n' +
               '方位: '              + position.coords.heading       + '\n' +
               '速度: '              + position.coords.speed         + '\n' +
-              'タイムスタンプ: '    + new Date(position.timestamp) + '\n');
+              'タイムスタンプ: '    + position.timestamp            + '\n');
     };
 
     // エラー時のコールバック関数は PositionError オブジェクトを受けとる
@@ -83,7 +84,7 @@ geolocation.getCurrentPosition
       <head>
         <title>デバイスプロパティーの使用例</title>
 
-        <script type="text/javascript" charset="utf-8" src="cordova-1.7.0.js"></script>
+        <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
         <script type="text/javascript" charset="utf-8">
 
         // Cordova の読み込み完了まで待機
@@ -107,7 +108,7 @@ geolocation.getCurrentPosition
                                 '高度精度: '        + position.coords.altitudeAccuracy
+ '<br />' +
                                 '方位: '            + position.coords.heading       + '<br
/>' +
                                 '速度: '            + position.coords.speed         + '<br
/>' +
-                                'タイムスタンプ: '  + new Date(position.timestamp)
 + '<br />';
+                                'タイムスタンプ: '  + position.timestamp         
  + '<br />';
         }
 
         // エラー時のコールバック関数は PositionError オブジェクトを受けとる

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/6e733530/docs/jp/1.8.1/cordova/geolocation/geolocation.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/geolocation/geolocation.md b/docs/jp/1.8.1/cordova/geolocation/geolocation.md
index 822c9ee..897c68d 100644
--- a/docs/jp/1.8.1/cordova/geolocation/geolocation.md
+++ b/docs/jp/1.8.1/cordova/geolocation/geolocation.md
@@ -24,7 +24,7 @@ Geolocation
 
 Geolocation は緯度や経度といったデバイスの位置情報を提供します。主に
Global Positioning System (GPS) から位置情報を取得しますが、 IP アドレスや
RFID, WiFi, Bluetooh, MAC アドレス, 基地局 ID などのソースからも現在位置を推測します。ただしこの
API がデバイスの正確な位置を特定する保証はありません。
 
-この API は [W3C Geo location API Specification](http://dev.w3.org/geo/api/spec-source.html)
をベースとしています。いくつかのデバイスではすでにこの機能の実装を提供しています。
これらについては、 Cordova の実装ではなくビルトインのサポートが実行されます。位置情報のサポートがされてないデバイスについては、Cordovaの実装によってW3Cの仕様に沿った機能が提供されます。
+この API は [W3C Geo location API Specification](http://dev.w3.org/geo/api/spec-source.html)
をベースとしています。いくつかのデバイス (Android, BlackBerry, Bada, Windows
Phone 7, webOS) ではすでにこの機能の実装を提供しています。 これらについては、
Cordova の実装ではなくビルトインのサポートが実行されます。位置情報のサポートがされてないデバイスについては、Cordovaの実装によってW3Cの仕様に沿った機能が提供されます。
 
 メソッド
 -------
@@ -47,3 +47,58 @@ Geolocation は緯度や経度といったデバイスの位置情報を提供
 - Position
 - PositionError
 - Coordinates
+
+パーミッション
+-----------
+
+### Android
+
+#### app/res/xml/plugins.xml
+
+    <plugin name="Geolocation" value="org.apache.cordova.GeoBroker" />
+
+#### 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"
/>
+
+### Bada
+
+    パーミッションの設定は必要ありません。
+
+### BlackBerry WebWorks
+
+#### www/plugins.xml
+
+    <plugin name="Geolocation" value="org.apache.cordova.geolocation.Geolocation" />
+
+#### www/config.xml
+
+    <rim:permissions>
+        <rim:permit>read_geolocation</rim:permit>
+    </rim:permissions>
+
+### iOS
+
+#### App/Supporting Files/Cordova.plist
+
+    <key>Plugins</key>
+    <dict>
+        <key>Geolocation</key>
+        <string>CDVLocation</string>
+    </dict>
+
+### webOS
+
+    パーミッションの設定は必要ありません。
+
+### Windows Phone
+
+#### Properties/WPAppManifest.xml
+
+    <Capabilities>
+        <Capability Name="ID_CAP_LOCATION" />
+    </Capabilities>
+
+参照: [Application Manifest for Windows Phone](http://msdn.microsoft.com/en-us/library/ff769509%28v=vs.92%29.aspx)

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/6e733530/docs/jp/1.8.1/cordova/geolocation/geolocation.watchPosition.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/geolocation/geolocation.watchPosition.md b/docs/jp/1.8.1/cordova/geolocation/geolocation.watchPosition.md
index 434810c..30a28e9 100644
--- a/docs/jp/1.8.1/cordova/geolocation/geolocation.watchPosition.md
+++ b/docs/jp/1.8.1/cordova/geolocation/geolocation.watchPosition.md
@@ -36,7 +36,7 @@ geolocation.watchPosition
 返り値
 -------
 
-- __String__: 位置変化を参照する watch ID を返します。 watch ID は `geolocation.clearWatch`
に渡すことで位置変化の監視を中止することができます。
+- __String__: 位置変化を参照する watch ID を返します。 watch ID は `geolocation.clearWatch`
に渡すことで位置変化の監視を中止するために使われます。
 
 概要
 -----------
@@ -48,9 +48,10 @@ geolocation.watchPosition
 
 - Android
 - BlackBerry WebWorks (OS 5.0 以上)
-- iPhone
+- iOS
 - Windows Phone 7 (Mango)
 - Bada 1.2 & 2.x
+- webOS
 
 使用例
 -------------
@@ -73,9 +74,9 @@ geolocation.watchPosition
               'メッセージ: '    + error.message + '\n');
     }
 
-    // 3秒ごとに位置情報を取得する設定 (オプション)
+    // もし30秒ごとに更新が取得できない場合、エラーが投げられる
(オプション)
     //
-    var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { frequency: 3000
});
+    var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { frequency: 30000
});
 
 
 詳細な使用例
@@ -86,7 +87,7 @@ geolocation.watchPosition
       <head>
         <title>デバイスプロパティーの使用例</title>
 
-        <script type="text/javascript" charset="utf-8" src="cordova-1.7.0.js"></script>
+        <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
         <script type="text/javascript" charset="utf-8">
 
         // Cordova の読み込み完了まで待機
@@ -98,8 +99,8 @@ geolocation.watchPosition
         // Cordova 準備完了
         //
         function onDeviceReady() {
-            // 3秒ごとに更新
-            var options = { frequency: 3000 };
+            // もし30秒ごとに更新が取得できない場合、エラーが投げられる
+            var options = { frequency: 30000 };
             watchID = navigator.geolocation.watchPosition(onSuccess, onError, options);
         }
 

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/6e733530/docs/jp/1.8.1/cordova/geolocation/parameters/geolocation.options.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/geolocation/parameters/geolocation.options.md b/docs/jp/1.8.1/cordova/geolocation/parameters/geolocation.options.md
index b7934fd..264e054 100644
--- a/docs/jp/1.8.1/cordova/geolocation/parameters/geolocation.options.md
+++ b/docs/jp/1.8.1/cordova/geolocation/parameters/geolocation.options.md
@@ -20,16 +20,15 @@ license: Licensed to the Apache Software Foundation (ASF) under one
 geolocationOptions
 ==================
 
-位置情報取得の設定をカスタマイズするためのパラメーターを表します。
+位置情報 (`Position`) 取得の設定をカスタマイズするためのパラメーターを表します。
 
     { maximumAge: 3000, timeout: 5000, enableHighAccuracy: true };
 
 オプション
 -------
 
-- __frequency:__ 位置情報を取得する頻度をミリ秒で表します。 このオプションは
W3C の仕様に含まれておらず、将来的には実装が廃止されます。 maximumAge
を代わりに使用してください。 _(Number)_ (デフォルト: 10000)
-- __enableHighAccuracy:__ より精度の高い位置情報を取得するためのヒントを提供するかどうかを表します
_(Boolean)_
-- __timeout:__ `geolocation.getCurrentPosition` または `geolocation.watchPosition` 関数が呼び出されたときに、それぞれに対応する
`geolocationSuccess` コールバック関数が呼ばれるまでの最大経過時間をミリ秒単位で表します
_(Number)_
+- __enableHighAccuracy:__ より精度の高い位置情報を取得するためのヒントを提供するかどうかを表します。デフォルトでは、デバイスはネットワークベースでの位置情報取得を試みます。プロパティーを
`true` と設定することで、衛星位置情報などの精度の高い方法を使用します
_(Boolean)_
+- __timeout:__ `geolocation.getCurrentPosition` または `geolocation.watchPosition` 関数が呼び出されたときに、それぞれに対応する
`geolocationSuccess` コールバック関数が呼ばれるまでの最大経過時間をミリ秒単位で表します。もし
`geolocationSuccess` コールバック関数がこの時間内に呼ばれなかった場合、
`PositionError.TIMEOUT` エラーコードを伴った `geolocationError` コールバック関数が呼び出されます。注意:
`geolocation.watchPosition` と一緒に使われる場合、 `geolocationError` コールバックが毎
`timeout` ミリ秒呼び出される可能性があります _(Number)_
 - __maximumAge:__ キャッシュされた位置情報の取得を許容する最大時間をミリ秒単位で表します
_(Number)_
 
 Android に関する注意点

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/6e733530/docs/jp/1.8.1/cordova/geolocation/parameters/geolocationSuccess.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/geolocation/parameters/geolocationSuccess.md b/docs/jp/1.8.1/cordova/geolocation/parameters/geolocationSuccess.md
index 14c1e2d..d519071 100644
--- a/docs/jp/1.8.1/cordova/geolocation/parameters/geolocationSuccess.md
+++ b/docs/jp/1.8.1/cordova/geolocation/parameters/geolocationSuccess.md
@@ -20,7 +20,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one
 geolocationSuccess
 ==================
 
-位置情報取得に成功したときに呼び出されるコールバック関数です。
+位置情報取得に成功したとき (`geolocation.getCurrentPosition` と一緒に使われた時)
、または位置情報が変化したとき (`geolocation.watchPosition` と一緒に使われた時)
に呼び出されるコールバック関数です。
 
     function(position) {
         // 任意のコード
@@ -42,5 +42,5 @@ geolocationSuccess
               '高度精度: '          + position.coords.altitudeAccuracy  + '\n' +
               '方位: '              + position.coords.heading           + '\n' +
               '速度: '              + position.coords.speed             + '\n' +
-              'タイムスタンプ: '    + new Date(position.timestamp)      + '\n');
+              'タイムスタンプ: '    + position.timestamp                + '\n');
     }


Mime
View raw message