APIと呼ばれるJavaScriptベースのAPIを利用します。APIによって吸収されるため、開発者は対象とするプラットフォームの違いを意識することなくコーディングを行うことが可能です。APIの使い方を解説します。APIは、PhoneGapを用いてモバイル端末の位置情報サービスにアクセスするためのAPIです。多くのモバイル端末では、GPSセンサーや無線LANのアクセスポイント情報などを元にして端末の現在位置を算出する機能を持っています。APIを使えば、それらの位置情報にアクセスするためのネイティブのサービスをJavaScriptから利用することができるようになります。Specification」に準拠しています。APIとの互換性も極めて高いものとなっています。APIによって取得できるのは、端末の現在位置の座標(緯度・経度)や高度、移動方向や速度などといった情報です。これらの位置情報はPositionオブジェクトという読み込み専用のオブジェクトに格納されます。アプリ内ではgeolocation.getCurrentPositionというメソッドによってPositionオブジェクトを取得し、そこに格納された位置情報を参照することができます。具体的には、Positionオブジェクトは端末の位置情報を次のようなプロパティの値として保持しています。位置情報サービスを利用する場合、ほとんどのプラットフォームがパーミッションを要求します。したがって、アプリ側ではパーミッション申請のための設定ファイルを用意しておかなければいけません。Buildを利用する場合には、config.xmlに次の設定を追加します。API編も参考にしてください。Buildを使わずにローカルの開発環境でビルドを行う場合の設定方法は公式サイトのAPIドキュメントに掲載されています。位置情報を取得するそれでは、実際に端末から位置情報を取得してみましょう。前述のように、端末の現在の位置情報はgeolocation.getCurrentPositionメソッドを呼び出すことで取得できます。getCurrentPositionには引数として取得成功時のコールバック関数とエラー発生時のコールバック関数を指定します。成功時のコールバック関数には、位置情報が格納されたPositionオブジェクをが渡されます。エラー発生時のコールバック関数には、エラー情報を格納したPositionErrorオブジェクトが渡されます。次のコードは、アプリの起動時に位置情報を取得し、その内容を表示するプログラムのサンプルです。</html>ライブラリの読み込みが完了した際に呼び出されるonDeviceReadyメソッドでgetGeolocationメソッドを実行しています。図2は、iPhone上でこのプログラムを実行してみた例です。現在地の座標等の情報が取得できていることがわかります。速度は移動していないので-1になっています。APIでは一定速度で移動したときにしか方角を取得できないためです。APIを用いて行う方が適しています。APIでは、位置情報を監視して、変化があった場合にその値を取得するといったこともできます。監視はgeolocation.watchPositionメソッドとgeolocation.clearWatchメソッドによって行います。watchPositionで次のようにして監視を開始します。options);第1引数には位置情報の取得が成功した際に呼び出されるコールバック関数を、第2引数にはエラー発生時に呼び出されるコールバック関数を指定します。第3引数は位置情報の取得のためのオプションを指定するもので、次のプロパティが使用できます。GPSなどを利用したより制度の高い位置情報を使用するかどうかtrue/falseで指定する。デフォルトはfalseで、ネットワークベースでの位置情報を使用する。コールバック関数が呼ばれるまでのタイムアウト時間をミリ秒単位で指定する。キャッシュされた位置情報を利用する有効時間をミリ秒単位で指定する。IDは監視を終了する際に使用されます。IDを指定して次のように行います。[サンプルコード:位置情報の監視を終了する]navigator.geolocation.clearWatch(watchId);次の例は、先ほどのgetCurrentPositionメソッドの使用例に、watchPosition/clearWatchメソッドによる監視の開始と終了を追加したものです。</html>このプログラムをiPhone上で実行すると、まず現在の位置情報を取得して図3のように表示します。ここまでは先程の例と同様です。ここで[監視スタート]ボタンを押すと位置情報の監視をはじめて、もし端末が移動した場合には、図4のようにその都度表示されている値が変化するはずです。監視の終了は[監視ストップ]ボタンによって行います。位置情報の利用は、モバイル端末を使う醍醐味のひとつと言えます。APIは極めてシンプルに作られているので、すぐに使いこなすことができるでしょう。地域を選択してください地域を選択すると、アドビサイトで使用する言語と内容が変わります。