You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by mw...@apache.org on 2013/09/10 19:37:28 UTC
[43/51] [abbrv] [partial] Move Japanese to docs/ja and Korean to
docs/ko.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/camera/camera.getPicture.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/camera/camera.getPicture.md b/docs/ja/1.8.1/cordova/camera/camera.getPicture.md
new file mode 100644
index 0000000..1e5cd21
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/camera/camera.getPicture.md
@@ -0,0 +1,207 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+camera.getPicture
+=================
+
+デバイスのカメラで写真を撮る、またはデバイスのアルバム内にある写真を検索します。 Base64 形式でエンコードされたフォトイメージを表す文字列、またはイメージファイルの URI が返されます。
+
+ navigator.camera.getPicture( cameraSuccess, cameraError, [ cameraOptions ] );
+
+概要
+-----------
+
+`camera.getPicture` 関数はユーザーが写真を撮れるように、デバイスが標準で備えるカメラアプリを起動します (もしデフォルト設定である `Camera.sourceType = Camera.PictureSourceType.CAMERA` の場合) 。写真の撮影が完了するとカメラアプリは終了し、アプリケーションに戻ります。
+
+もし `Camera.sourceType = Camera.PictureSourceType.PHOTOLIBRARY` もしくは `Camera.PictureSourceType.SAVEDPHOTOALBUM` が指定された場合、写真選択ダイアログが表示され、アルバムから写真を選択できるようになります。
+
+返り値は `cameraSuccess` 関数に送信されます。値は `cameraOptions` の設定に従い、以下のいずれかのフォーマットで送られます:
+
+- Base64 形式でエンコードされたフォトイメージを表す文字列 (デフォルト)
+- ローカルストレージ内に記録されたファイルの場所を表す文字列
+
+エンコードされたイメージや URI をもとに、以下のような処理の記述が可能です:
+
+- `<img>` タグで画像を表示 _(下記の使用例を参考にしてください)_
+- データをローカルに保存 (`LocalStorage` や [Lawnchair](http://brianleroux.github.com/lawnchair/) など)
+- データをリモートサーバーに送信
+
+注意: iPhone 4 や Black Berry Touch 9800 などの最新デバイスで撮影したイメージの画質は良好で、フォトアルバムから取得する画像はたとえ quality パラメーターで画質を指定したとしても、縮小されません。 _そのような画像を Base64 でエンコードすると、メモリーの問題が発生します。_ よって、 FILE_URI を 'Camera.destinationType' として使用することが推奨されます。
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- iOS
+- Windows Phone 7 (Mango)
+- Bada 1.2
+
+iOS に関する注意点
+----------
+
+JavaScript の alert() をコールバック関数に含めると、問題が生じる可能性があります。 alert を setTimeout() でラップすることで、 alert が表示される前に iOS の image picker または popover が完全に閉じるようにします: setTimeout("alert('message');", 0);
+
+
+Windows Phone 7 に関する注意点
+----------------------
+
+Zune とデバイスが接続している間は、ネイティブカメラアプリケーションは起動せずに、エラーコールバックが呼び出されます。
+
+
+使用例
+-------------
+
+写真を撮影し、 Base64 形式のイメージとして取得します。
+
+ navigator.camera.getPicture(onSuccess, onFail, { quality: 50,
+ destinationType: Camera.DestinationType.DATA_URL
+ });
+
+ function onSuccess(imageData) {
+ var image = document.getElementById('myImage');
+ image.src = "data:image/jpeg;base64," + imageData;
+ }
+
+ function onFail(message) {
+ alert('エラーが発生しました: ' + message);
+ }
+
+撮影した写真の URI を取得します。
+
+ navigator.camera.getPicture(onSuccess, onFail, { quality: 50,
+ destinationType: Camera.DestinationType.FILE_URI });
+
+ function onSuccess(imageURI) {
+ var image = document.getElementById('myImage');
+ image.src = imageURI;
+ }
+
+ function onFail(message) {
+ alert('エラーが発生しました: ' + message);
+ }
+
+
+詳細な使用例
+------------
+
+ <!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">
+
+ var pictureSource; // 写真ソース
+ var destinationType; // 戻り値のフォーマット
+
+ // Cordova がデバイスと接続するまで待機
+ //
+ document.addEventListener("deviceready",onDeviceReady,false);
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ pictureSource=navigator.camera.PictureSourceType;
+ destinationType=navigator.camera.DestinationType;
+ }
+
+ // 写真の撮影に成功した場合 (URI 形式)
+ //
+ function onPhotoDataSuccess(imageData) {
+ // 下記のコメントを外すことで Base64 形式のデータをログに出力
+ // console.log(imageData);
+
+ // 画像ハンドルを取得
+ //
+ var smallImage = document.getElementById('smallImage');
+
+ // 画像要素を表示
+ //
+ smallImage.style.display = 'block';
+
+ // 取得した写真を表示
+ // 画像のリサイズにインライン CSS を使用
+ //
+ smallImage.src = "data:image/jpeg;base64," + imageData;
+ }
+
+ // 写真の撮影に成功した場合 (URI 形式)
+ //
+ function onPhotoURISuccess(imageURI) {
+ // 下記のコメントを外すことでファイル URI をログに出力
+ // console.log(imageURI);
+
+ // 画像ハンドルを取得
+ //
+ var largeImage = document.getElementById('largeImage');
+
+ // 画像要素を表示
+ //
+ largeImage.style.display = 'block';
+
+ // 取得した写真を表示
+ // 画像のリサイズにインライン CSS を使
+ //
+ largeImage.src = imageURI;
+ }
+
+ // ボタンがクリックされた場合の処理
+ //
+ function capturePhoto() {
+ // 編集が許可された写真を撮影し、 Base64 形式のイメージとして取得する場合
+ navigator.camera.getPicture(onPhotoDataSuccess, onFail, { quality: 50,
+ destinationType: destinationType.DATA_URL });
+ }
+
+ // ボタンがクリックされた場合の処理
+ //
+ function capturePhotoEdit() {
+ // 編集が許可された写真を撮影し、 Base64 形式のイメージとして取得する場合
+ navigator.camera.getPicture(onPhotoDataSuccess, onFail, { quality: 20, allowEdit: true,
+ destinationType: destinationType.DATA_URL });
+ }
+
+ // ボタンがクリックされた場合の処理
+ //
+ function getPhoto(source) {
+ // 写真をファイル URI として取得する場合
+ navigator.camera.getPicture(onPhotoURISuccess, onFail, { quality: 50,
+ destinationType: destinationType.FILE_URI,
+ sourceType: source });
+ }
+
+ // エラー発生時の処理
+ //
+ function onFail(message) {
+ alert('エラーが発生しました: ' + message);
+ }
+
+ </script>
+ </head>
+ <body>
+ <button onclick="capturePhoto();">写真を撮影</button> <br>
+ <button onclick="capturePhotoEdit();">写真を撮影して編集</button> <br>
+ <button onclick="getPhoto(pictureSource.PHOTOLIBRARY);">フォトライブラリから取得</button><br>
+ <button onclick="getPhoto(pictureSource.SAVEDPHOTOALBUM);">フォトアルバムから取得</button><br>
+ <img style="display:none;width:60px;height:60px;" id="smallImage" src="" />
+ <img style="display:none;" id="largeImage" src="" />
+ </body>
+ </html>
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/camera/camera.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/camera/camera.md b/docs/ja/1.8.1/cordova/camera/camera.md
new file mode 100644
index 0000000..a35c707
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/camera/camera.md
@@ -0,0 +1,92 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+Camera
+======
+
+> `camera` オブジェクトは、デバイスのカメラアプリへの制御を提供します。
+
+メソッド
+-------
+
+- camera.getPicture
+
+パーミッション
+-----------
+
+### Android
+
+#### app/res/xml/plugins.xml
+
+ <plugin name="Camera" value="org.apache.cordova.CameraLauncher" />
+
+#### app/AndroidManifest
+
+ <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
+
+### Bada
+
+#### manifest.xml
+
+ <Privilege>
+ <Name>CAMERA</Name>
+ </Privilege>
+ <Privilege>
+ <Name>RECORDING</Name>
+ </Privilege>
+
+### BlackBerry WebWorks
+
+#### www/plugins.xml
+
+ <plugin name="Camera" value="org.apache.cordova.camera.Camera" />
+
+#### www/config.xml
+
+ <feature id="blackberry.media.camera" />
+
+ <rim:permissions>
+ <rim:permit>use_camera</rim:permit>
+ </rim:permissions>
+
+### iOS
+
+#### App/Supporting Files/Cordova.plist
+
+ <key>Plugins</key>
+ <dict>
+ <key>Camera</key>
+ <string>CDVCamera</string>
+ </dict>
+
+### webOS
+
+ パーミッションの設定は必要ありません。
+
+### Windows Phone
+
+#### Properties/WPAppManifest.xml
+
+ <Capabilities>
+ <Capability Name="ID_CAP_CAMERA" />
+ <Capability Name="ID_CAP_ISV_CAMERA" />
+ <Capability Name="ID_HW_FRONTCAMERA" />
+ </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/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/camera/parameter/CameraPopoverOptions.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/camera/parameter/CameraPopoverOptions.md b/docs/ja/1.8.1/cordova/camera/parameter/CameraPopoverOptions.md
new file mode 100644
index 0000000..6a329d5
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/camera/parameter/CameraPopoverOptions.md
@@ -0,0 +1,71 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+CameraPopoverOptions
+====================
+
+画像をライブラリーもしくはアルバムから選択する際の、 iPad でのポップオーバーの位置や矢印の向きを指定するためのパラメーターです。 iOS のみのオプションです。
+
+ { x : 0,
+ y : 32,
+ width : 320,
+ height : 480,
+ arrowDir : Camera.PopoverArrowDirection.ARROW_ANY
+ };
+
+CameraPopoverOptions
+--------------------
+
+- __x:__ ポップオーバーの x 座標をピクセルで表します。 (`Number`)
+
+- __y:__ ポップオーバーの y 座標をピクセルで表します。 (`Number`)
+
+- __width:__ ポップオーバーの幅をピクセルで表します。 (`Number`)
+
+- __height:__ ポップオーバーの高さをピクセルで表します。 (`Number`)
+
+- __arrowDir:__ ポップオーバーの矢印の向きを表します。 Camera.PopoverArrowDirection で定義されます。 (`Number`)
+
+ Camera.PopoverArrowDirection = {
+ ARROW_UP : 1, // iOS の UIPopoverArrowDirection 定数に同じ
+ ARROW_DOWN : 2,
+ ARROW_LEFT : 4,
+ ARROW_RIGHT : 8,
+ ARROW_ANY : 15
+ };
+
+ポップオーバーのサイズは矢印の方向や画面の向きによって調節され、変わる可能性があることについて注意してください。アンカー要素の位置を特定するとき、画面の向きの変化を考慮に入れることを忘れないで下さい。
+
+使用例
+-------------
+
+ var popover = new CameraPopoverOptions(300,300,100,100,Camera.PopoverArrowDirection.ARROW_ANY);
+ var options = { quality: 50, destinationType: Camera.DestinationType.DATA_URL,sourceType: Camera.PictureSource.SAVEDPHOTOALBUM, popoverOptions : popover };
+
+ navigator.camera.getPicture(onSuccess, onFail, options);
+
+ function onSuccess(imageData) {
+ var image = document.getElementById('myImage');
+ image.src = "data:image/jpeg;base64," + imageData;
+ }
+
+ function onFail(message) {
+ alert('Failed because: ' + message);
+ }
+
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/camera/parameter/cameraError.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/camera/parameter/cameraError.md b/docs/ja/1.8.1/cordova/camera/parameter/cameraError.md
new file mode 100644
index 0000000..90b57f0
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/camera/parameter/cameraError.md
@@ -0,0 +1,32 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+cameraError
+===========
+
+エラーが発生した場合に呼び出されるコールバック関数です。
+
+ function(message) {
+ // エラーメッセージを表示
+ }
+
+パラメーター
+----------
+
+- __message:__ デバイスのネイティブコードによって与えられたメッセージ (`String`)
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/camera/parameter/cameraOptions.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/camera/parameter/cameraOptions.md b/docs/ja/1.8.1/cordova/camera/parameter/cameraOptions.md
new file mode 100644
index 0000000..bd59a0e
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/camera/parameter/cameraOptions.md
@@ -0,0 +1,125 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+cameraOptions
+=============
+
+カメラの設定をカスタマイズするのためのオプションパラメーターです。
+
+ { quality : 75,
+ destinationType : Camera.DestinationType.DATA_URL,
+ sourceType : Camera.PictureSourceType.CAMERA,
+ allowEdit : true,
+ encodingType: Camera.EncodingType.JPEG,
+ targetWidth: 100,
+ targetHeight: 100,
+ popoverOptions: CameraPopoverOptions };
+
+オプション
+-------
+
+- __quality:__ イメージの画質を指定します。 範囲: 0から100 (`Number`)
+
+- __destinationType:__ 返り値のフォーマットを指定します。フォーマットは navigator.camera.DestinationType で定義されています。 (`Number`)
+
+ Camera.DestinationType = {
+ DATA_URL : 0, // 画像を Base64 形式で取得
+ FILE_URI : 1 // 画像をファイル URI として取得
+ };
+
+- __sourceType:__ 取得ソースを指定します。ソースは nagivator.camera.PictureSourceType で定義されています。 (`Number`)
+
+ Camera.PictureSourceType = {
+ PHOTOLIBRARY : 0,
+ CAMERA : 1,
+ SAVEDPHOTOALBUM : 2
+ };
+
+- __allowEdit:__ イメージ選択の前に、簡単な編集を許可します。 (`Boolean`)
+
+- __encodingType:__ 画像ファイルのエンコード形式を選択します。形式は navigator.camera.EncodingType で定義されています。 (`Number`)
+
+ Camera.EncodingType = {
+ JPEG : 0, // 画像を JPEG 形式で取得
+ PNG : 1 // 画像を PNG 形式で取得
+ };
+
+- __targetWidth:__ 画像をスケールするための幅をピクセルで指定します。 targetHeight と同時に使用してください。アスペクト比は保持されます。 (`Number`)
+- __targetHeight:__ 画像をスケールするための高さをピクセルで指定します。 targetWidth と同時に使用してください。アスペクト比は保持されます。 (`Number`)
+
+- __mediaType:__ 画像の取得元を指定します。 PictureSourceType に PHOTOLIBRARY もしくは SAVEPHOTOALBUM が指定されている場合にのみ有効です。取得元は nagivator.camera.MediaType で定義されています。 (`Number`)
+
+ Camera.MediaType = {
+ PICTURE: 0, // 取得元は静止画像のみとします。デフォルトです。返り値のフォーマットは DestinationType によって指定されたものになります。
+ VIDEO: 1, // 取得元はビデオのみとします。戻り値のフォーマットは常にファイル URI となります。
+ ALLMEDIA : 2 // 全てのメディアタイプからの取得を許可します。
+ };
+
+- __correctOrientation:__ 写真が撮影されたときと同じ向きになるよう写真を回転させます。 (`Boolean`)
+- __saveToPhotoAlbum:__ 写真が撮影された後、デバイスのフォトアルバムに画像を保存します。 (`Boolean`)
+- __popoverOptions:__ iPad でのポップオーバーの位置を指定します。iOS のみのオプションです。 CameraPopoverOptions で定義されます。
+
+Android に関する注意点
+--------------
+
+- `allowEdit` は無視されます。
+- Camera.PictureSourceType.PHOTOLIBRARY と Camera.PictureSourceType.SAVEDPHOTOALBUM は同じフォトアルバムを表示します。
+- Camera.EncodingType はサポートされていません。
+- `correctOrientation` パラメーターは無視されます。
+- `saveToPhotoAlbum` パラメーターは無視されます。
+
+BlackBerry に関する注意点
+-----------------
+
+- `quality` パラメーターは無視されます。
+- `sourceType` パラメーターは無視されます。
+- `allowEdit` は無視されます。
+- 撮影後にカメラアプリを閉じるためには、アプリケーションにキー入力許可の権限が付与されている必要があります。
+- 大きなサイズで撮影を行った場合、高画質カメラを搭載したデバイスでエンコードすることができない場合があります。 (Torch 9800 など)
+- Camera.MediaType はサポートされていません。
+- `correctOrientation` パラメーターは無視されます。
+- `saveToPhotoAlbum` パラメーターは無視されます。
+
+WebOS に関する注意点
+-----------
+
+- `quality` パラメーターは無視されます。
+- `sourceType` パラメーターは無視されます。
+- `allowEdit` は無視されます。
+- Camera.MediaType はサポートされていません。
+- `correctOrientation` パラメーターは無視されます。
+- `saveToPhotoAlbum` パラメーターは無視されます。
+
+iOS に関する注意点
+--------------
+
+- メモリエラーを防ぐには、 `quality` パラメーターを50以下に設定してください。
+- `destinationType.FILE_URI` が使用された場合、撮影された写真や編集された写真はアプリケーションの temporary ディレクトリに保存されます。もしストレージの空きが少ない場合、このディレクトリは navigator.fileMgr API を使って消去できます。
+
+Windows Phone 7 に関する注意点
+--------------
+
+- `allowEdit` は無視されます。
+- `correctOrientation` パラメーターは無視されます。
+- `saveToPhotoAlbum` パラメーターは無視されます。
+
+Bada 1.2 に関する注意点
+--------------
+- オプションはサポートされていません。
+- 常に FILE URI を返します。
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/camera/parameter/cameraSuccess.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/camera/parameter/cameraSuccess.md b/docs/ja/1.8.1/cordova/camera/parameter/cameraSuccess.md
new file mode 100644
index 0000000..4abbd0b
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/camera/parameter/cameraSuccess.md
@@ -0,0 +1,42 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+cameraSuccess
+=============
+
+撮影が成功したときに呼び出されるコールバック関数です。
+
+ function(imageData) {
+ // 任意のコード
+ }
+
+パラメーター
+----------
+
+- __imageData:__ Base64 エンコーディングされた画像データ、またはイメージファイルの URI (`cameraOptions`による) (`String`)
+
+使用例
+-------
+
+ // 画像を表示
+ //
+ function cameraCallback(imageData) {
+ var image = document.getElementById('myImage');
+ image.src = "data:image/jpeg;base64," + imageData;
+ }
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/compass/compass.clearWatch.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/compass/compass.clearWatch.md b/docs/ja/1.8.1/cordova/compass/compass.clearWatch.md
new file mode 100755
index 0000000..43ec19e
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/compass/compass.clearWatch.md
@@ -0,0 +1,110 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+compass.clearWatch
+========================
+
+watch ID パラメーターによって参照されるコンパスの監視を停止します。
+
+ navigator.compass.clearWatch(watchID);
+
+- __watchID__: `compass.watchHeading` によって返される ID。
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- iPhone
+- Windows Phone 7 ( Mango ) ハードウェア内で有効な場合
+- Bada 1.2 & 2.x
+
+使用例
+-------------
+
+ var watchID = navigator.compass.watchHeading(onSuccess, onError, options);
+
+ // ... 後に続く ...
+
+ navigator.compass.clearWatch(watchID);
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Compass Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // watch ID が現在の `watchHeading` を参照
+ var watchID = null;
+
+ // Cordova の読み込み完了まで待機
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ startWatch();
+ }
+
+ // コンパスの監視を開始
+ //
+ function startWatch() {
+
+ // コンパスを3秒ごとに更新
+ var options = { frequency: 3000 };
+
+ watchID = navigator.compass.watchHeading(onSuccess, onError, options);
+ }
+
+ // コンパスの監視を停止
+ //
+ function stopWatch() {
+ if (watchID) {
+ navigator.compass.clearWatch(watchID);
+ watchID = null;
+ }
+ }
+
+ // onSuccess: 現在の方位を取得
+ //
+ function onSuccess(heading) {
+ var element = document.getElementById('heading');
+ element.innerHTML = '方位: ' + heading.magneticHeading;
+ }
+
+ // onError: 方位の取得に失敗
+ //
+ function onError(compassError) {
+ alert('コンパスのエラーが発生しました: ' + compassError.code);
+ }
+
+
+ </script>
+ </head>
+ <body>
+ <div id="heading">方位を待機...</div>
+ <button onclick="startWatch();">監視開始</button>
+ <button onclick="stopWatch();">監視中止</button>
+ </body>
+ </html>
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/compass/compass.clearWatchFilter.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/compass/compass.clearWatchFilter.md b/docs/ja/1.8.1/cordova/compass/compass.clearWatchFilter.md
new file mode 100644
index 0000000..b6f4b32
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/compass/compass.clearWatchFilter.md
@@ -0,0 +1,23 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+compass.clearWatchFilter
+========================
+
+1.6以降はサポートされていません。 `compass.clearWatch` を参照してください。
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/compass/compass.getCurrentHeading.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/compass/compass.getCurrentHeading.md b/docs/ja/1.8.1/cordova/compass/compass.getCurrentHeading.md
new file mode 100755
index 0000000..faefa1e
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/compass/compass.getCurrentHeading.md
@@ -0,0 +1,95 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+compass.getCurrentHeading
+=========================
+
+現在のコンパスの向きを取得します。
+
+ navigator.compass.getCurrentHeading(compassSuccess, compassError, compassOptions);
+
+概要
+-----------
+
+コンパスはデバイスが向いている方向を感知するセンサーです。コンパスはその方角を0から359.99の範囲で計測します。
+
+コンパスの向き情報は、 compassSuccess コールバック関数の CompassHeading オブジェクトを通じて返されます。
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- iPhone
+- Windows Phone 7 ( Mango ) ハードウェア内で有効な場合
+- Bada 1.2 & 2.x
+
+使用例
+-------------
+
+ function onSuccess(heading) {
+ alert('現在の方位: ' + heading.magneticHeading);
+ };
+
+ function onError(error) {
+ alert('コンパスのエラーが発生しました: ' + error.code);
+ };
+
+ navigator.compass.getCurrentHeading(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.compass.getCurrentHeading(onSuccess, onError);
+ }
+
+ // onSuccess: 現在の方位を取得
+ //
+ function onSuccess(heading) {
+ alert('現在の方位: ' + heading.magneticHeading);
+ }
+
+ // onError: 方位の取得に失敗
+ //
+ function onError(compassError) {
+ alert('コンパスのエラーが発生しました: ' + compassError.code);
+ }
+
+ </script>
+ </head>
+ <body>
+ <h1>使用例</h1>
+ <p>getCurrentHeading</p>
+ </body>
+ </html>
+
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/compass/compass.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/compass/compass.md b/docs/ja/1.8.1/cordova/compass/compass.md
new file mode 100755
index 0000000..8af03a2
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/compass/compass.md
@@ -0,0 +1,81 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+Compass
+=======
+
+> デバイスの向いている方向に関する情報を取得します。
+
+メソッド
+-------
+
+- compass.getCurrentHeading
+- compass.watchHeading
+- compass.clearWatch
+- compass.watchHeadingFilter (廃止)
+- compass.clearWatchFilter (廃止)
+
+引数
+---------
+
+- compassSuccess
+- compassError
+- compassOptions
+- compassHeading
+
+パーミッション
+-----------
+
+### Android
+
+#### app/res/xml/plugins.xml
+
+ <plugin name="Compass" value="org.apache.cordova.CompassListener" />
+
+### Bada
+
+ パーミッションの設定は必要ありません。
+
+### BlackBerry WebWorks
+
+ パーミッションの設定は必要ありません。
+
+### iOS
+
+#### App/Supporting Files/Cordova.plist
+
+ <key>Plugins</key>
+ <dict>
+ <key>Compass</key>
+ <string>CDVLocation</string>
+ </dict>
+
+### webOS
+
+ パーミッションの設定は必要ありません。
+
+### Windows Phone
+
+#### Properties/WPAppManifest.xml
+
+ <Capabilities>
+ <Capability Name="ID_CAP_SENSORS" />
+ </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/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/compass/compass.watchHeading.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/compass/compass.watchHeading.md b/docs/ja/1.8.1/cordova/compass/compass.watchHeading.md
new file mode 100755
index 0000000..87ff8c8
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/compass/compass.watchHeading.md
@@ -0,0 +1,131 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+compass.watchHeading
+====================
+
+コンパス方位を一定の時間間隔で取得します。
+
+ var watchID = navigator.compass.watchHeading(compassSuccess, compassError, [compassOptions]);
+
+概要
+-----------
+
+コンパスはデバイスが向いている方向を感知するセンサーです。コンパスはその方角を0から359.99の範囲で計測します。
+
+`compass.watchHeading` 関数は一定の時間間隔でデバイスの現在の方位を取得します。方位情報が取得されるごとに `headingSuccess` コールバック関数が実行されます。時間間隔は `compassOptions` オブジェクトの `frequency` パラメーターを通じてミリ秒単位で指定します。
+
+本関数の戻り値である watch ID は、コンパスの監視間隔への参照を表します。 `compass.clearWatch` 関数に watch ID を渡すことで、監視を停止できます。
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- iPhone
+- Windows Phone 7 ( Mango ) ハードウェア内で有効な場合
+- Bada 1.2 & 2.x
+
+
+使用例
+-------------
+
+ function onSuccess(heading) {
+ var element = document.getElementById('heading');
+ element.innerHTML = '方位: ' + heading.magneticHeading;
+ };
+
+ function onError(compassError) {
+ alert('コンパスのエラーが発生しました: ' + compassError.code);
+ };
+
+ var options = { frequency: 3000 }; // 3秒ごとに更新
+
+ var watchID = navigator.compass.watchHeading(onSuccess, onError, options);
+
+詳細な使用例
+------------
+
+ <!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">
+
+ // watch ID が現在の `watchHeading` を参照
+ var watchID = null;
+
+ // Cordova の読み込み完了まで待機
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ startWatch();
+ }
+
+ // コンパスの監視を開始
+ //
+ function startWatch() {
+
+ // コンパスを3秒ごとに更新
+ var options = { frequency: 3000 };
+
+ watchID = navigator.compass.watchHeading(onSuccess, onError, options);
+ }
+
+ // コンパスの監視を停止
+ //
+ function stopWatch() {
+ if (watchID) {
+ navigator.compass.clearWatch(watchID);
+ watchID = null;
+ }
+ }
+
+ // onSuccess: 現在の方位を取得
+ //
+ function onSuccess(heading) {
+ var element = document.getElementById('heading');
+ element.innerHTML = '方位: ' + heading.magneticHeading;
+ }
+
+ // onError: 方位の取得に失敗
+ //
+ function onError(compassError) {
+ alert('コンパスのエラーが発生しました: ' + compassError.code);
+ }
+
+ </script>
+ </head>
+ <body>
+ <div id="heading">方位を待機...</div>
+ <button onclick="startWatch();">監視開始</button>
+ <button onclick="stopWatch();">監視中止</button>
+ </body>
+ </html>
+
+iOS に関する注意点
+--------------
+
+iOS では、指定された角度分だけデバイスの現在の方位が変更されたとき、 `compass.watchHeading` でそのデバイスの現在の向きを取得することもできます。方位が指定された角度以上で変更されるたび、 `headingSuccess` コールバック関数が呼び出されます。角度は、 `compassOptions` オブジェクトの `filter` パラメーターで指定します。 `compass.clearWatch` に `watch ID` を渡すことで、通常と同じように監視を停止できます。この機能は、1.6で廃止になった iOS 限定の watchHeadingFilter 関数と clearWatchFilter 関数に置き換わるものです。
+
+iOS では、一度に一つの watchHeading のみが有効です。もし filter を用いて watchHeading が使用されている場合、 getCurrentHeading 関数または watchHeading 関数は既に存在している filter の値を、方位の角度変化量の指定に使用します。 iOS では、時間による監視より、 filter を用いた方位変化量による監視の方が効果的です。
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/compass/compass.watchHeadingFilter.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/compass/compass.watchHeadingFilter.md b/docs/ja/1.8.1/cordova/compass/compass.watchHeadingFilter.md
new file mode 100644
index 0000000..76228f8
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/compass/compass.watchHeadingFilter.md
@@ -0,0 +1,23 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+compass.watchHeadingFilter
+==========================
+
+1.6以降はサポートされていません。同等の機能として、 `compass.watchHeading` を参照してください。
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/compass/compassError/compassError.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/compass/compassError/compassError.md b/docs/ja/1.8.1/cordova/compass/compassError/compassError.md
new file mode 100644
index 0000000..a558ba0
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/compass/compassError/compassError.md
@@ -0,0 +1,40 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+CompassError
+==========
+
+エラーが起きた場合、 `compassError` コールバック関数には `CompassError` オブジェクトが返されます。
+
+プロパティー
+----------
+
+- __code:__ 事前に定義された以下のエラーコードのうちの1つを表します
+
+定数
+---------
+- `CompassError.COMPASS_INTERNAL_ERR`
+- `CompassError.COMPASS_NOT_SUPPORTED`
+
+概要
+-----------
+
+エラーが起きた場合、 `compassError` コールバック関数には `CompassError` オブジェクトが返されます。
+
+
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/compass/parameters/compassError.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/compass/parameters/compassError.md b/docs/ja/1.8.1/cordova/compass/parameters/compassError.md
new file mode 100755
index 0000000..15b3473
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/compass/parameters/compassError.md
@@ -0,0 +1,30 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+compassError
+==========
+
+コンパス方位の取得に失敗したときに呼び出されるコールバック関数です。
+
+使用例
+-------
+
+function(CompassError) {
+ // エラー処理
+}
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/compass/parameters/compassHeading.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/compass/parameters/compassHeading.md b/docs/ja/1.8.1/cordova/compass/parameters/compassHeading.md
new file mode 100644
index 0000000..681cea7
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/compass/parameters/compassHeading.md
@@ -0,0 +1,47 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+compassHeading
+==========
+
+エラーが起きた場合、 `compassSuccess` コールバック関数には `CompassHeading` オブジェクトが返されます。
+
+プロパティー
+----------
+- __magneticHeading:__ ある瞬間のコンパス方位を磁北を基準に0から359.99の範囲で表します。 _(Number)_
+- __trueHeading:__ ある瞬間のコンパス方位を真北を基準に0から359.99の範囲で表します。負の値は、 trueHeading の値が定まっていないことを示しています。 _(Number)_
+- __headingAccuracy:__ magneticHeading の値と trueHeading の値との角度の差、偏角を表します。 _(Number)_
+- __timestamp:__ コンパス方位を取得した時間を表します。 _(milliseconds)_
+
+概要
+-----------
+
+`CompassHeading` オブジェクトは、 `compassSuccess` コールバック関数を通じてユーザーに返されます。
+
+Android に関する注意点
+--------------
+- trueHeading はサポートされていません。 trueHeading には magneticHeading と同じ値が代入されます。
+- このため、 Android では trueHeading と magneticHeading に差が無いので、 headingAccuracy は常に0となります。
+
+iOS に関する注意点
+----------
+
+- trueHeading は、位置情報サービスが `navigator.geolocation.watchLocation()` によって稼動している場合にのみ返されます。
+- iOS 4より上位のデバイスでは、もしデバイスが横方向などに回転していて、アプリがそれをサポートしていれば、 magneticHeading の値は現在のデバイスの向きに対応して返されます。
+
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/compass/parameters/compassOptions.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/compass/parameters/compassOptions.md b/docs/ja/1.8.1/cordova/compass/parameters/compassOptions.md
new file mode 100755
index 0000000..2a0f97c
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/compass/parameters/compassOptions.md
@@ -0,0 +1,45 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+compassOptions
+==============
+
+コンパス取得の設定をカスタマイズするためのパラメーターを表します。
+
+オプション
+-------
+
+- __frequency:__ コンパスの向きを取得する頻度をミリ秒で表します。 _(Number)_ (デフォルト: 100)
+- __filter:__ watchHeading の成功時のコールバック関数を初期化する際に必要な、角度の変化量を表します。 _(Number)_
+
+Android に関する注意点
+--------------
+
+- filter はサポートされていません。
+
+Windows Phone 7 に関する注意点
+--------------
+
+- filter はサポートされていません。
+
+Bada に関する注意点
+-----------
+
+- filter はサポートされていません。
+
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/compass/parameters/compassSuccess.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/compass/parameters/compassSuccess.md b/docs/ja/1.8.1/cordova/compass/parameters/compassSuccess.md
new file mode 100644
index 0000000..fa4268d
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/compass/parameters/compassSuccess.md
@@ -0,0 +1,40 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+compassSuccess
+==============
+
+コンパス方位の取得に成功したときに、 compassHeading オブジェクトを用いてコンパス方位情報を提供するコールバック関数です。
+
+ function(heading) {
+ // 任意のコード
+ }
+
+パラメーター
+----------
+
+
+- __heading:__ 方位情報。 _(compassHeading)_
+
+使用例
+-------
+
+ function onSuccess(heading) {
+ alert('現在の方位: ' + heading.magneticHeading);
+ };
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/connection/connection.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/connection/connection.md b/docs/ja/1.8.1/cordova/connection/connection.md
new file mode 100644
index 0000000..798facf
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/connection/connection.md
@@ -0,0 +1,92 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+Connection
+==========
+
+> `connection` オブジェクトを通じて、携帯電話ネットワーク及び wifi 接続情報にアクセス出来ます。
+
+このオブジェクトは、 `navigator.network` インターフェース以下からアクセスされます。
+
+プロパティー
+----------
+
+- connection.type
+
+定数
+---------
+
+- Connection.UNKNOWN
+- Connection.ETHERNET
+- Connection.WIFI
+- Connection.CELL_2G
+- Connection.CELL_3G
+- Connection.CELL_4G
+- Connection.NONE
+
+パーミッション
+-----------
+
+### Android
+
+#### app/res/xml/plugins.xml
+
+ <plugin name="NetworkStatus" value="org.apache.cordova.NetworkManager" />
+
+#### app/AndroidManifest.xml
+
+ <uses-permission android:name="android.permission.INTERNET" />
+ <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
+ <uses-permission android:name="android.permission.READ_PHONE_STATE" />
+
+### Bada
+
+ <Privilege>
+ <Name>SYSTEM_SERVICE</Name>
+ </Privilege>
+
+### BlackBerry WebWorks
+
+#### www/plugins.xml
+
+ <plugin name="Network Status" value="org.apache.cordova.network.Network" />
+
+### iOS
+
+#### App/Supporting Files/Cordova.plist
+
+ <key>Plugins</key>
+ <dict>
+ <key>NetworkStatus</key>
+ <string>CDVConnection</string>
+ </dict>
+
+### webOS
+
+ パーミッションの設定は必要ありません。
+
+### Windows Phone
+
+#### Properties/WPAppManifest.xml
+
+ <Capabilities>
+ <Capability Name="ID_CAP_NETWORKING" />
+ </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/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/connection/connection.type.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/connection/connection.type.md b/docs/ja/1.8.1/cordova/connection/connection.type.md
new file mode 100644
index 0000000..6b2745f
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/connection/connection.type.md
@@ -0,0 +1,125 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+connection.type
+===================
+
+使われているネットワーク接続のタイプを確認します。
+
+概要
+-----------
+
+このプロパティーは、デバイスのネットワーク接続状態や接続のタイプを手早く取得出来ます。
+
+
+サポートされているプラットフォーム
+-------------------
+
+- iOS
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- Windows Phone 7 (Mango)
+- Bada 2.x
+- webOS
+
+使用例
+-------------
+
+ function checkConnection() {
+ var networkState = navigator.network.connection.type;
+
+ var states = {};
+ states[Connection.UNKNOWN] = '不明な接続';
+ states[Connection.ETHERNET] = 'イーサネット接続';
+ states[Connection.WIFI] = 'WiFi接続';
+ states[Connection.CELL_2G] = '2G接続';
+ states[Connection.CELL_3G] = '3G接続';
+ states[Connection.CELL_4G] = '4G接続';
+ states[Connection.NONE] = 'ネットワーク接続なし';
+
+ alert('コネクションタイプ: ' + states[networkState]);
+ }
+
+ checkConnection();
+
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>navigator.network.connection.type 使用例</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() {
+ checkConnection();
+ }
+
+ function checkConnection() {
+ var networkState = navigator.network.connection.type;
+
+ var states = {};
+ states[Connection.UNKNOWN] = '不明な接続';
+ states[Connection.ETHERNET] = 'イーサネット接続';
+ states[Connection.WIFI] = 'WiFi接続';
+ states[Connection.CELL_2G] = '2G接続';
+ states[Connection.CELL_3G] = '3G接続';
+ states[Connection.CELL_4G] = '4G接続';
+ states[Connection.NONE] = 'ネットワーク接続なし';
+
+ alert('コネクションタイプ: ' + states[networkState]);
+ }
+
+ </script>
+ </head>
+ <body>
+ <p>ダイアログボックスがネットワーク状態を表示します。</p>
+ </body>
+ </html>
+
+iOS に関する注意点
+----------
+
+- iOS はネットワーク接続のタイプを特定することが出来ません。
+ - 携帯電話ネットワークでの接続時、 `navigator.network.connection.type` には `Connection.CELL_2G` がセットされます。
+
+Bada に関する注意点
+-----------
+
+- Bada は WiFi または 携帯電話ネットワークに接続されているかどうかのみを特定できます。
+ - 携帯電話ネットワークでの接続時、 `navigator.network.connection.type` には `Connection.CELL_2G` がセットされます。
+
+webOS に関する注意点
+------------
+
+- 接続が確立されているかのみを表し、タイプについては特定できません。
+
+Windows Phone に関する注意点
+--------------------
+
+- Windows Phone Emulator は常に `navigator.network.connection.type` を `Connection.UNKNOWN` と返します。
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/contacts/Contact/contact.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/contacts/Contact/contact.md b/docs/ja/1.8.1/cordova/contacts/Contact/contact.md
new file mode 100644
index 0000000..648439c
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/contacts/Contact/contact.md
@@ -0,0 +1,231 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+Contact
+=======
+
+連絡先に格納された情報を表します。
+
+プロパティー
+----------
+
+- __id:__ 固定のIDを表します _(DOMString)_
+- __displayName:__ 連絡先の名称を表します _(DOMString)_
+- __name:__ 個人名に関するオブジェクトを表します _(ContactName)_
+- __nickname:__ ニックネームを表します _(DOMString)_
+- __phoneNumbers:__ 連絡先のすべての電話番号の配列を表します _(ContactField[])_
+- __emails:__ 連絡先のすべてのメールアドレスの配列を表します _(ContactField[])_
+- __addresses:__ 連絡先のすべての住所の配列を表します _(ContactAddress[])_
+- __ims:__ 連絡先のすべてのIMアドレスの配列を表します _(ContactField[])_
+- __organizations:__ 連絡先のすべての組織名の配列を表します _(ContactOrganization[])_
+- __birthday:__ 連絡先の誕生日を表します _(Date)_
+- __note:__ 連絡先のメモを表します _(DOMString)_
+- __photos:__ 連絡先の写真の配列を表します _(ContactField[])_
+- __categories:__ 連絡先のユーザー定義カテゴリーの配列を表します _(ContactField[])_
+- __urls:__ 連絡先に関連したURLの配列を表します _(ContactField[])_
+
+メソッド
+-------
+
+- __clone__: オブジェクトのディープコピーを行い、新しい Contact オブジェクトを作成して返します。 id プロパティーは `null` に設定されます。
+- __remove__: オブジェクトを連絡先データベースから削除します。 削除が失敗した場合は `ContactError` を伴ったエラーコールバック関数が呼び出されます。
+- __save__: 新しい連絡先を連絡先データベースに保存します。 __id__ が既に登録されている場合は連絡先データベースを上書きします。
+
+
+詳細
+-------
+
+`Contact` オブジェクトはユーザーの連絡先を格納します。 連絡先はデバイスの連絡先データベースから作成したり、保存したり、削除することが可能です。 `contacts.find` 関数を呼ぶことで、連絡先データベースから連絡先を取得することも出来ます。
+
+_注意: プラットフォームによっては、いくつかのフィールドがサポートされていない場合があります。プラットフォームごとの注意点に詳細を記載しています。_
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- iOS
+- Bada 1.2 & 2.0
+
+保存する例
+------------------
+
+ function onSuccess(contact) {
+ alert("保存に成功しました。");
+ };
+
+ function onError(contactError) {
+ alert("エラー = " + contactError.code);
+ };
+
+ // 新しい連絡先オブジェクトを作成
+ var contact = navigator.contacts.create();
+ contact.displayName = "Plumber";
+ contact.nickname = "Plumber"; // すべてのデバイスに対応するため、両方の項目をセット
+
+ // その他のフィールドを作成
+ var name = new ContactName();
+ name.givenName = "Jane";
+ name.familyName = "Doe";
+ contact.name = name;
+
+ // デバイスに保存
+ contact.save(onSuccess,onError);
+
+コピーを行う例
+-------------------
+
+ // 連絡先オブジェクトをコピー
+ var clone = contact.clone();
+ clone.name.givenName = "John";
+ console.log("元の名前 = " + contact.name.givenName);
+ console.log("クローンの名前 = " + clone.name.givenName);
+
+削除を行う例
+--------------------
+
+ function onSuccess() {
+ alert("削除に成功しました。");
+ };
+
+ function onError(contactError) {
+ alert("エラー = " + contactError.code);
+ };
+
+ // デバイスから連絡先を削除
+ contact.remove(onSuccess,onError);
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Contact の使用例</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() {
+ // 作成
+ var contact = navigator.contacts.create();
+ contact.displayName = "Plumber";
+ contact.nickname = "Plumber"; // すべてのデバイスに対応するため、両方の項目をセット
+ var name = new ContactName();
+ name.givenName = "Jane";
+ name.familyName = "Doe";
+ contact.name = name;
+
+ // 保存
+ contact.save(onSaveSuccess,onSaveError);
+
+ // クローンを作成
+ var clone = contact.clone();
+ clone.name.givenName = "John";
+ console.log("元の名前 = " + contact.name.givenName);
+ console.log("クローンの名前 = " + clone.name.givenName);
+
+ // 削除
+ contact.remove(onRemoveSuccess,onRemoveError);
+ }
+
+ // onSaveSuccess: 連絡先の取得に成功した場合
+ //
+ function onSaveSuccess(contact) {
+ alert("保存に成功しました。");
+ }
+
+ // onSaveError: 連絡先の取得に失敗した場合
+ //
+ function onSaveError(contactError) {
+ alert("エラー = " + contactError.code);
+ }
+
+ // onRemoveSuccess: 連絡先の取得に成功した場合
+ //
+ function onRemoveSuccess(contacts) {
+ alert("削除に成功しました。");
+ }
+
+ // onRemoveError: 連絡先の取得に失敗した場合
+ //
+ function onRemoveError(contactError) {
+ alert("エラー = " + contactError.code);
+ }
+
+ </script>
+ </head>
+ <body>
+ <h1>使用例</h1>
+ <p>連絡先の検索</p>
+ </body>
+ </html>
+
+Android 2.X に関する注意点
+------------------
+
+- __categories:__ このプロパティーは Android 2.X ではサポートされておらず、常に `null` を返します。
+
+Android 1.X に関する注意点
+------------------
+
+- __name:__ このプロパティーは Android 1.X ではサポートされておらず、常に `null` を返します。
+- __nickname:__ このプロパティーは Android 1.X ではサポートされておらず、常に `null` を返します。
+- __birthday:__ このプロパティーは Android 1.X ではサポートされておらず、常に `null` を返します。
+- __photos:__ このプロパティーは Android 1.X ではサポートされておらず、常に `null` を返します。
+- __categories:__ このプロパティーは Android 1.X ではサポートされておらず、常に `null` を返します。
+- __urls:__ このプロパティーは Android 1.X ではサポートされておらず、常に `null` を返します。
+
+
+BlackBerry WebWorks (OS 5.0 and higher) に関する注意点
+---------------------------------------------
+
+- __id:__ サポートされています。 連絡先が保存されたときに、デバイスによって割り当てられます。
+- __displayName:__ サポートされています。 BlackBerry では __user1__ フィールドとして保存されます。
+- __nickname:__ このプロパティーはサポートされておらず、常に `null` を返します。.
+- __phoneNumbers:__ 部分的にサポートされています。 BlackBerry では、電話番号はもし _type_ が 'home' の場合は __homePhone1__と __homePhone2__ に、 _type_ が 'work' の場合は __workPhone1__ と __workPhone2__ に、 _type_ が 'mobile' の場合は __mobilePhone__ に、 _type_ が 'fax' の場合は __faxPhone__ に、 _type_ が 'pager' の場合は __pagerPhone__ に、それ以外の場合は __otherPhone__ に保存されます。
+- __emails:__ 部分的にサポートされています。 BlackBerry では、最初の3メールアドレスが __email1__, __email2__, __email3__ フィールドに保存されます。
+- __addresses:__ 部分的にサポートされています。 BlackBerry では、最初の2つの住所が __homeAddress__ と __workAddress__ フィールドに保存されます。
+- __ims:__ このプロパティーはサポートされておらず、常に `null` を返します。
+- __organizations:__ 部分的にサポートされています。 BlackBerry では、最初の組織の名前とタイトルが __company__ と __title__ フィールドに保存されます。
+- __photos:__ 部分的にサポートされています。 サムネイルサイズの写真のみサポートされています。 連絡先に写真を登録する場合、 Base64 エンコードされたイメージか、イメージの場所を指定する URL を渡します。 写真は BlackBerry の連絡先データベースに保存される前に縮小されます。 連絡先写真は Base64 エンコードされたイメージとして返されます。
+- __categories:__ 部分的にサポートされています。 'Business' と 'Personal' カテゴリーのみサポートされています。
+- __urls:__ 部分的にサポートされています。 BlackBerry では、最初の URL が __webpage__ フィールドに保存されます。
+
+iOS に関する注意点
+----------
+- __displayName:__ このプロパティーは iOS ではサポートされておらず、 ContactName が指定されていない場合限り `null` を返します。 もし ContactName が指定されていない場合、合成された名前、 __nickname__ 、または "" が __displayName__ として返されます。
+- __birthday:__ 入力として、このプロパティーは JavaScript の Date オブジェクトとして指定する必要があります。 JavaScript の Date オブジェクトとして返されます。
+- __photos:__ 取得した写真はアプリの一時ディレクトリに保存され、写真への File URL が返されます。一時ディレクトリの中身はアプリを終了する際に削除されます。
+- __categories:__ このプロパティーはサポートされておらず、常に `null` を返します。
+
+Bada に関する注意点
+-----------
+
+- __displayName:__ このプロパティーはサポートされていません。
+- __birthday:__ このプロパティーはサポートされていません。
+- __photos:__ このプロパティーは写真へのURL1つを格納したリストです。
+- __categories:__ このプロパティーはサポートされていません。
+- __ims:__ このプロパティーはサポートされていません。
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/contacts/ContactAddress/contactaddress.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/contacts/ContactAddress/contactaddress.md b/docs/ja/1.8.1/cordova/contacts/ContactAddress/contactaddress.md
new file mode 100644
index 0000000..9e3e195
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/contacts/ContactAddress/contactaddress.md
@@ -0,0 +1,172 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+ContactAddress
+==============
+
+`Contact` オブジェクトの住所プロパティーを表します。
+
+プロパティー
+----------
+- __pref:__ `ContactAddress` がユーザーの推奨値を含むかどうかを表します。含む場合、 `true` がセットされます _(boolean)_
+- __type:__ フィールドのタイプを表します (例: 'home') _(DOMString)_
+- __formatted:__ 住所全体を表します _(DOMString)_
+- __streetAddress:__ 番地を表します _(DOMString)_
+- __locality:__ 都市名を表します _(DOMString)_
+- __region:__ 地域名を表します _(DOMString)_
+- __postalCode:__ 郵便番号を表します _(DOMString)_
+- __country:__ 国を表します _(DOMString)_
+
+詳細
+-------
+
+`ContactAddress` オブジェクトは連絡先の住所に関するプロパティーを表します。 `Contact` オブジェクトは、複数の住所が格納された `ContactAddress[]` 配列を保持しています。
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- iOS
+- Bada 1.2 & 2.0
+
+使用例
+-------------
+
+ // すべての連絡先の住所情報を取得し、表示します
+ function onSuccess(contacts) {
+ for (var i=0; i<contacts.length; i++) {
+ for (var j=0; j<contacts[i].addresses.length; j++) {
+ alert("推奨値: " + contacts[i].addresses[j].pref + "\n" +
+ "タイプ: " + contacts[i].addresses[j].type + "\n" +
+ "住所: " + contacts[i].addresses[j].formatted + "\n" +
+ "番地: " + contacts[i].addresses[j].streetAddress + "\n" +
+ "都市名: " + contacts[i].addresses[j].locality + "\n" +
+ "地域名: " + contacts[i].addresses[j].region + "\n" +
+ "郵便番号: " + contacts[i].addresses[j].postalCode + "\n" +
+ "国名: " + contacts[i].addresses[j].country);
+ }
+ }
+ };
+
+ function onError(contactError) {
+ alert('エラーが発生しました。');
+ };
+
+ // 連絡先を検索します
+ var options = new ContactFindOptions();
+ options.filter="";
+ var filter = ["displayName","addresses"];
+ navigator.contacts.find(filter, onSuccess, onError, options);
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Contact の使用例</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() {
+ // find all contacts
+ var options = new ContactFindOptions();
+ options.filter="";
+ var filter = ["displayName","addresses"];
+ navigator.contacts.find(filter, onSuccess, onError, options);
+ }
+
+ // onSuccess: 連絡先の取得に成功した場合
+ //
+ function onSuccess(contacts) {
+ // すべての連絡先の住所情報を取得し、表示します
+ for (var i=0; i<contacts.length; i++) {
+ for (var j=0; j<contacts[i].addresses.length; j++) {
+ alert("推奨値: " + contacts[i].addresses[j].pref + "\n" +
+ "タイプ: " + contacts[i].addresses[j].type + "\n" +
+ "住所: " + contacts[i].addresses[j].formatted + "\n" +
+ "番地: " + contacts[i].addresses[j].streetAddress + "\n" +
+ "都市名: " + contacts[i].addresses[j].locality + "\n" +
+ "地域名: " + contacts[i].addresses[j].region + "\n" +
+ "郵便番号: " + contacts[i].addresses[j].postalCode + "\n" +
+ "国名: " + contacts[i].addresses[j].country);
+ }
+ }
+ };
+
+ // onError: 連絡先の取得に失敗した場合
+ //
+ function onError(contactError) {
+ alert('エラーが発生しました。');
+ }
+
+ </script>
+ </head>
+ <body>
+ <h1>使用例</h1>
+ <p>連絡先の検索</p>
+ </body>
+ </html>
+
+Android 2.X に関する注意点
+------------------
+
+- __pref:__ このプロパティーは Android 2.X ではサポートされておらず、常に `false` を返します。
+
+Android 1.X に関する注意点
+------------------
+
+- __pref:__ このプロパティーは Android 1.X ではサポートされておらず、常に `false` を返します。
+- __type:__ このプロパティーは Android 1.X ではサポートされておらず、常に `null` を返します。
+- __streetAddress:__ このプロパティーは Android 1.X ではサポートされておらず、常に `null` を返します。
+- __locality:__ このプロパティーは Android 1.X ではサポートされておらず、常に `null` を返します。
+- __region:__ このプロパティーは Android 1.X ではサポートされておらず、常に `null` を返します。
+- __postalCode:__ このプロパティーは Android 1.X ではサポートされておらず、常に `null` を返します。
+- __country:__ このプロパティーは Android 1.X ではサポートされておらず、常に `null` を返します。
+
+BlackBerry WebWorks (OS 5.0 and higher) に関する注意点
+--------------------------------------------
+
+- __pref:__ このプロパティーは BlackBerry ではサポートされておらず、常に `false` を返します。
+- __type:__ 部分的にサポートされています。 一つの連絡先につき、一つずつの "Work" と "Home" タイプの住所が保存できます。
+- __formatted:__ 部分的にサポートされています。 BlackBerry のアドレスフィールドの連結を返します。
+- __streetAddress:__ サポートされています。 BlackBerry の __address1__ と __address2__ アドレスフィールドの連結を返します。
+- __locality:__ サポートされています。 BlackBerry の __city__ アドレスフィールドに保存されます。
+- __region:__ サポートされています。 BlackBerry の __stateProvince__ アドレスフィールドに保存されます。
+- __postalCode:__ サポートされています。 BlackBerry の __zipPostal__ アドレスフィールドに保存されます。
+- __country:__ サポートされています。
+
+iOS に関する注意点
+----------
+
+- __pref:__ このプロパティーは iOS ではサポートされておらず、常に `false` を返します。
+- __formatted:__ サポートされていません。
+
+Bada に関する注意点
+-----------
+- __formatted:__ このプロパティーはサポートされていません。
+- __type:__ WORK か HOME かのいずれかである必要があります。
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/contacts/ContactError/contactError.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/contacts/ContactError/contactError.md b/docs/ja/1.8.1/cordova/contacts/ContactError/contactError.md
new file mode 100644
index 0000000..da17e6d
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/contacts/ContactError/contactError.md
@@ -0,0 +1,45 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+ContactError
+========
+
+`ContactError` オブジェクトは、エラーが発生したときに `contactError` コールバック関数に渡されるオブジェクトです。
+
+プロパティー
+----------
+
+- __code:__ 事前に定義された以下のエラーコードのうちの1つを表します
+
+定数
+---------
+
+- `ContactError.UNKNOWN_ERROR`
+- `ContactError.INVALID_ARGUMENT_ERROR`
+- `ContactError.TIMEOUT_ERROR`
+- `ContactError.PENDING_OPERATION_ERROR`
+- `ContactError.IO_ERROR`
+- `ContactError.NOT_SUPPORTED_ERROR`
+- `ContactError.PERMISSION_DENIED_ERROR`
+
+概要
+-----------
+
+`ContactError` オブジェクトは、エラーが発生したときに `contactError` コールバック関数に渡されるオブジェクトです。
+