API version 4

Runtime.GetLastKnownLocationメソッド

iOSAndroidWindows

説明

指定したロケーションプロバイダで最後に測位された位置情報を取得します。

現在の位置情報を取得したい場合は、StartLocationMeasureメソッドを使用して下さい。

利用上の注意

一部OS,機種によっては、本メソッドを呼び出した際に位置情報の再測位を行うことがありますが、これは本メソッドを呼び出した際に必ず再測位が行われることを保証するものではありませんのでご注意下さい。

iOS版
ロケーションプロバイダの指定は無視されます。

呼出形式

iOS版
var result = Runtime.GetLastKnownLocation( [unused] )

Android版
var result = Runtime.GetLastKnownLocation( provider )

戻り値

指定したロケーションプロバイダに位置情報が存在すればその位置情報が、存在しない場合はnullが返ります。

位置情報の形式は下記のとおりです。

Record {
	Number provider;		/* この位置情報を取得したロケーションプロバイダを取得します。 */
	 
   	Number latitude;		/* 経度を取得します。 単位は度(deg)です。 */
	 
	Number longitude;		/* 緯度を取得します。 単位は度(deg)です。 */
	 
	Date time;		/* この位置情報を取得した時刻が格納されます */
	 
	Number hasAccuracy;	/* 計測精度を取得できた場合は$TRUE、そうでなければ$FALSEが格納されます */
				/* 下記の子オブジェクトはhasAccuracy=$TRUEの時のみ存在します */
	 
	Number accuracy;		/* 計測精度を取得します。単位はメートル(m)です。 */
}

引数

Number provider

測位を行うロケーションプロバイダーを一つ指定します。

指定できる値は下記のとおりです。

定数	値	説明
Runtime.LOCATION_PROV_GPS	1	GPS(全地球測位システム)を用いて測位します
Runtime.LOCATION_PROV_NETWORK	2	モバイルネットワークやWiFiを用いて測位します。

String unused

引数は無視されます。

例外

なし

使用例

var location = Runtime.GetLastKnownLocation(Runtime.LOCATION_PROV_GPS);