com.docomostar.system
クラス CityInfoStore

Object
  com.docomostar.system.CityInfoStore

public final class CityInfoStore
extends Object

[iアプリオプションAPI]

携帯電話のネイティブの都市情報データベースにアクセスする手段を提供します。 このクラスのインスタンスは、携帯電話のネイティブの都市情報の1つのエントリを表しますが、インスタンスを取得する手段はありません。

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

ローミングアウト時に、都市情報のエントリ ID を LocationProvider.getLocation(int, int) や LocationProvider.setTrackingListener(TrackingListener, int, int, int) メソッドの引数に指定することにより、 都市に合わせたアシストデータを取得して GPS 測位を行うことができます。

導入されたバージョン:

Star-1.1

メソッドの概要

static int

selectEntryId() ユーザ操作により都市情報のエントリIDを取得します。

クラス Object から継承されたメソッド

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

メソッドの詳細

selectEntryId

public static int selectEntryId()
                         throws InterruptedOperationException,
                                StoreException

ユーザ操作により都市情報のエントリIDを取得します。

このメソッドで得られたエントリIDを LocationProvider.getLocation(int, int) メソッドの引数に指定することにより、 都市にあわせたアシストデータを取得し GPS 測位を行うことができます。

パーミッションとして位置情報APIの利用が許可されているトラステッド Star アプリのみ、 このメソッドを呼び出すことができます。 パーミッションとして位置情報APIの利用が許可されていない場合、Star アプリは強制終了します。

上記以外の動作の詳細については、com.docomostar.system パッケージに記載されている説明を参照して下さい。

端末によっては、 位置情報取得機能をサポートしていない場合があります。 その場合には、例外 UnsupportedOperationException が発生します。

戻り値:

取得した都市情報のエントリ ID を返します。ユーザが選択操作をキャンセルすると -1 を返します。 また、選択可能なエントリが存在しない場合も -1 を返します。

例外:

UnsupportedOperationException -
端末が位置情報取得機能をサポートしていない場合に発生します。

IllegalStateException -
ミニアプリ実行時の Focused または Unfocused 状態で呼び出された場合に発生します。

InterruptedOperationException -
競合条件などにより、選択操作が異常終了した場合に発生します。

SecurityException -
ロック機能等のネイティブ独自のセキュリティ設定により、都市情報のエントリを取得できない場合に発生します。

SecurityException -
パーミッションとして位置情報APIの利用が許可されているが、 Star アプリ個別のユーザ設定により許可されない場合に発生します。

StoreException -
(UNDEFINED)
上記以外の理由で、都市選択に失敗した場合に発生します。