概要  パッケージ   クラス  階層ツリー  非推奨 API  索引  ヘルプ 
 前のクラス   次のクラス フレームあり    フレームなし    
概要:  入れ子 | フィールド | コンストラクタ | メソッド 詳細:  フィールド | コンストラクタ | メソッド

com.nttdocomo.system
クラス LocationRecord

Object
  拡張com.nttdocomo.system.LocationRecord
public final class LocationRecord
extends Object
 [iアプリオプションAPI]

携帯電話のネイティブの位置履歴データ管理機能にアクセスする手段を提供します。 このクラスのインスタンスは、 携帯電話のネイティブの位置履歴データの 1 つのエントリを表します。

このクラスに定義されているクラスメソッドの使い方や、 ネイティブのデータへのアクセス方法に関する規定の大原則は com.nttdocomo.system パッケージの記述を参照して下さい。 ただし、 エントリ登録機能 (addEntry) は提供されません。

位置履歴データのエントリからは、位置履歴データのエントリ ID、ならびに、 位置情報(緯度・経度・測地系・測位レベル・測位時刻)が取得できます。

ネイティブの位置履歴データを持たない端末も存在します。 そのような端末でこのクラスのメソッドを呼び出した場合には UnsupportedOperationException が発生します。

導入されたバージョン:
DoJa-4.0LE

メソッドの概要
static LocationRecord getEntry(int id)
           位置履歴データのエントリ ID を指定して、 ユーザ操作なしに位置履歴データのエントリを取得します。
 int getId()
          位置履歴データのエントリ ID を取得します。
 Location getLocation()
           この位置履歴データに格納されている測位結果を取得します。
static LocationRecord selectEntry()
           ユーザ操作により位置履歴データのエントリを取得します。
 
クラス Object から継承したメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

メソッドの詳細

selectEntry

public static LocationRecord selectEntry()
                                  throws InterruptedOperationException

ユーザ操作により位置履歴データのエントリを取得します。 測位に成功した位置履歴データの一覧から、エントリ情報を取得できます。

パーミッションとして位置情報APIの利用が許可されているトラステッド i アプリのみこのメソッドを呼び出すことができます。 上記以外の動作の詳細については、 com.nttdocomo.system パッケージに記述されている 「エントリ取得時の振る舞い」の説明を参照して下さい。

戻り値:
取得した位置履歴データのエントリを返します。 ユーザが選択操作をキャンセルするとnullを返します。 また、選択可能なエントリが存在しない場合にもnullを返します。
例外:
UnsupportedOperationException - 位置情報取得機能をサポートしていない場合に発生します。
IllegalStateException - 待ち受け実行時の非活性化状態で呼び出された場合に発生します。
SecurityException - パーミッションとして位置情報APIの利用が許可されているが、 i アプリ個別のユーザ設定により許可されない場合に発生します。
SecurityException - ロック機能などのネイティブ独自のセキュリティ設定により、 位置履歴データのエントリを取得できない場合に発生します。
InterruptedOperationException - 競合条件などにより、選択操作が異常終了した場合に発生します。

getEntry

public static LocationRecord getEntry(int id)
                               throws StoreException

位置履歴データのエントリ ID を指定して、 ユーザ操作なしに位置履歴データのエントリを取得します。

パーミッションとして位置情報APIの利用が許可されているトラステッド i アプリのみこのメソッドを呼び出すことができます。 上記以外の動作の詳細については、 com.nttdocomo.system パッケージに記述されている 「エントリ取得時の振る舞い」の説明を参照して下さい。

パラメータ:
id - 位置履歴データのエントリ ID を指定します。
戻り値:
取得した位置履歴データのエントリを返します。
例外:
UnsupportedOperationException - 位置情報取得機能をサポートしていない場合に発生します。
SecurityException - パーミッションとして位置情報APIの利用が許可されているが、 i アプリ個別のユーザ設定により許可されない場合に発生します。
SecurityException - ロック機能などのネイティブ独自のセキュリティ設定により、 位置履歴エントリを取得できない場合に発生します。
StoreException - 指定した ID のエントリが存在しない場合に発生します(NOT_FOUND)。
関連項目:
getId(), selectEntry()

getId

public int getId()
位置履歴データのエントリ ID を取得します。

戻り値:
位置履歴データのエントリ ID を返します。

getLocation

public Location getLocation()

この位置履歴データに格納されている測位結果を取得します。

測位結果として取得した位置情報の各項目は、 それぞれ以下のように初期化されています。

緯度・経度・測地系・測位時刻:
それぞれ、対応する測位結果の項目に応じて初期化されています。
水平方向の精度:
測位結果に含まれている測位レベルに応じて初期化されています。
高度:
常に Location.ALTITUDE_UNKNOWN で初期化されています。

戻り値:
測位結果を返します。 返される位置情報オブジェクトは、 この位置履歴エントリが保持しているオブジェクトのシャローコピーです。
概要  パッケージ   クラス  階層ツリー  非推奨 API  索引  ヘルプ 
 前のクラス   次のクラス フレームあり    フレームなし    
概要:  入れ子 | フィールド | コンストラクタ | メソッド 詳細:  フィールド | コンストラクタ | メソッド

NTT DOCOMO,INC.

本製品または文書は著作権法により保護されており、その使用、複製、再頒布および逆コンパイルを制限するライセンスのもとにおいて頒布されます。NTTドコモ（その他に許諾者がある場合は当該許諾者も含めて）の書面による事前の許可なく、本製品および関連する文書のいかなる部分も、いかなる方法によっても複製することが禁じられます。フォントを含む第三者のソフトウェアは、著作権法により保護されており、その提供者からライセンスを受けているものです。

Sun、Sun Microsystems、Java、J2MEおよびJ2SEは、米国およびその他の国における米国 Sun Microsystems,Inc.の商標または登録商標です。サンのロゴマークは、米国 Sun Microsystems, Inc.の登録商標です。

FeliCaは、ソニー株式会社が開発した非接触ICカードの技術方式です。FeliCaは、ソニー株式会社の登録商標です。

「ｉモード」、「ｉアプリ／アイアプリ」、「ｉ-αppli」ロゴ、「DoJa」はNTTドコモの商標または登録商標です。

その他記載された会社名、製品名などは該当する各社の商標または登録商標です。