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 - ダウンロード即起動アプリがこのメソッドを呼び出した場合に発生します。

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 で初期化されています。

戻り値:

測位結果を返します。 返される位置情報オブジェクトは、 この位置履歴エントリが保持しているオブジェクトのシャローコピーです。