applican

マイページに戻る

GEOLocation

端末のGPS センサーの情報を取得します。緯度や経度といった端末の位置情報が取得可能です。主にGPSから位置情報を取得しますが、IP アドレスや RFID, WiFi, Bluetooh, MAC アドレス, 基地局 ID などの情報からも現在位置を推測します。ただし正確な位置を特定する保証はありません。

機能

端末の現在位置を取得する 【 getCurrentPosition 】

端末の現在の位置情報の変化を監視する 【 watchPosition 】

位置情報の監視を停止する 【 clearWatch 】

利用用途

GPS センサーを利用し、位置情報をコンテンツに反映させる機能を実装したい場合、こちらの機能をご利用ください。

【対応ランタイムバージョン】

ランタイムのバージョン毎に最適化したサンプルをダウンロードしてご使用ください。

サンプル GEOLocation
サンプル GEOLocation
サンプル GEOLocation

メソッド

getCurrentPosition

メソッド説明

getCurrentPosition(Function<GEOLocationResult> successCallback, Function errorCallback, GEOLocationOptions options)

端末の現在位置を取得します。

パラメータ

successCallback : Function<GEOLocationResult> GPSセンサーより位置情報を取得出来た場合にCallbackされます。
errorCallback : Function GPSセンサーより位置情報を取得出来なかった場合にCallbackされます。
option : GEOLocationOptions 位置情報取得する際のオプション項目です。

Return

void

サンプルコード

//位置情報を取得
function getCurrentPosition(){
	var options = { maximumAge: 10000, timeout: 30000, enableHighAccuracy: false};
	applican.geolocation.getCurrentPosition(currentPositionSuccess, currentPositionError, options);
}
function currentPositionSuccess(res){
	var dump = "currentPositionSuccess\n";
	dump += "latitude:"+res.coords.latitude+"\n";
	dump += "longitude:"+res.coords.longitude+"\n";
	dump += "altitude:"+res.coords.altitude+"\n";
	dump += "accuracy:"+res.coords.accuracy+"\n";
	dump += "altitudeAccuracy:"+res.coords.altitudeAccuracy+"\n";
	dump += "heading:"+res.coords.heading+"\n";
	dump += "speed:"+res.coords.speed+"\n";
	dump += "timestamp:"+res.timestamp+"\n";
	document.getElementById("dumpAreaGeolocation").value =dump;
}
function currentPositionError(error){
	var dump = "currentPositionError\n";
	dump += "code:"+error.code+"\n";
	document.getElementById("dumpAreaGeolocation").value =dump;
}

watchPosition

メソッド説明

watchPosition(Function<GEOLocationResult>successCallback, Function errorCallback, GEOLocationOptions options) : Number

端末の現在の位置情報の変化を監視します。

パラメータ

ssuccessCallback : Function<GEOLocationResult> GPSセンサーより位置情報を取得出来た場合にCallbackされます。
errorCallback : Function GPSセンサーより位置情報を取得出来なかった場合にCallbackされます。
option : GEOLocationOptions 位置情報取得する際のオプション項目です。

Return

Number clearWatchメソッドの引数で指定すべき intervalIDを返却します。

サンプルコード

var _geolocationWatchID;
	//位置情報を一定の時間間隔で取得
	function watchPosition(){
		var options = { maximumAge: 0, timeout: 20000, enableHighAccuracy: false, frequency: 3000 };
		_geolocationWatchID = applican.geolocation.watchPosition(watchPositionSuccess, watchPositionError, options);
	}
	function watchPositionSuccess(res){
		var dump = "watchPositionSuccess\n";
		dump += "latitude:"+res.coords.latitude+"\n";
		dump += "longitude:"+res.coords.longitude+"\n";
		dump += "altitude:"+res.coords.altitude+"\n";
		dump += "accuracy:"+res.coords.accuracy+"\n";
		dump += "altitudeAccuracy:"+res.coords.altitudeAccuracy+"\n";
		dump += "heading:"+res.coords.heading+"\n";
		dump += "speed:"+res.coords.speed+"\n";
		dump += "timestamp:"+res.timestamp+"\n";
		document.getElementById("dumpAreaGeolocation").value =dump;
	}
	function watchPositionError(e){
		var dump = "watchPositionError\n";
		dump += "code:"+e.code+"\n";
		document.getElementById("dumpAreaGeolocation").value =dump;
	}

clearWatch

メソッド説明

clearWatch(Number intervalId)

位置情報の監視を停止します。

パラメータ

intervalId : Number watchPositionメソッドの返却値を指定します。

Return

void

サンプルコード

	var _geolocationWatchID;
	//位置情報の監視を停止
	function clearWatchPosition(){
		applican.geolocation.clearWatch(_geolocationWatchID);
		document.getElementById("dumpAreaGeolocation").value+"\nStop!!"
	}