Namespace: geo

geo

※この関数はh5.dev.jsを読み込んだ場合のみ利用可能です。開発支援用機能のため、最終リリース物にh5.dev.jsやデバッグコードが混入しないよう十分ご注意ください。
dummyPosiitonsへ位置情報オブジェクトを格納して使用してください。位置情報はcreatePosition()で作成することができます。
Source:

Members

(static) dummyPositions :Array.<Object>

デバッグ用位置情報

位置情報オブジェクトを格納する配列です。 以下のようなオブジェクトを格納してください。

Name Type Argument Description
coords Object
Properties
Name Type Argument Default Description
latitude Number <optional>
 0 緯度
longitude Number <optional>
 0 経度
accuracy Number <optional>
 50 位置の誤差(m)
altitude Number <optional>
 null 高度(m)
altitudeAccuracy Number <optional>
 null 高度の誤差(m)
heading Number <optional>
 null 方角(0～360)(度)
speed Number <optional>
 null 速度 (m/s)
timestamp Number <optional>
 タイムスタンプ。省略時は取得時のタイムスタンプが自動で格納されます。 


	例１．
	h5.api.geo.dummyPositions.push({
		coords:{
			latitude: 35.45019435393257,
			longitude: 139.6305128879394,
			accuracy: 50,
			altitude: 100,
			altitudeAccuracy: 100,
			heading: 90,
			speed: 9
		}
	timestamp: 1331106454545
	})

省略したプロパティにはdefault値が入ります。timestampを省略すると、取得時に値が格納されます。 

	例２．
	h5.api.geo.dummyPositions.push({
		coords: {
			latitude: 35.45019435393257,
			longitude: 139.6305128879394,
		}
	})

coordsの中身だけを記述して格納することもできます。getPositionや_watchPositionでの取得時にcoordsプロパティに格納して返します。省略したプロパティにはdefault値が入ります。 timestampには取得時に値が格納されます。 

	例３．
	h5.api.geo.dummyPositions.push(
		latitude: 35.45019435393257,
		longitude: 139.6305128879394
	})

座標データ生成ツールを使うと地図から緯度と経度を求められます。

Type:
  • Array.<Object>
Source:

(static) forceError :Boolean

強制的にロケーションの取得に失敗させるかどうか
Type:
  • Boolean
Source:

(static) watchIntervalTime :Number

_watchPositionの座標の送信間隔(ms)
Type:
  • Number
Source:

Methods

(static) getCurrentPosition(optionopt) → {Promise}

dummyPositionsの先頭の位置情報を返します。dummyPositionsがオブジェクトの場合はdummyPositionsを返します。

このメソッドはh5.api.geo.getCurrentPosition()で呼びます。※ h5.dev.api.geo.getCurrentPosition()ではありません。

dummyPositionsに値が設定されていない場合は元のh5.api.geoのメソッドを実行します。

Parameters:
Name Type Attributes Description
option Object <optional>
 設定情報
Properties
Name Type Attributes Description
enableHighAccuracy Boolean <optional>
 正確な位置を取得するか (ただし消費電力の増加や応答が遅延する)
timeout Number <optional>
 位置情報を取得するまで待機する時間 (ミリ秒)
maximumAge Number <optional>
 キャッシュされた位置情報の有効期間を指定する (ミリ秒)
Returns:
Promiseオブジェクト
Type
Promise
Source:

(static) watchPosition(optionopt) → {WatchPositionPromise}

dummyPositionsの緯度・緯度を順番に返します。 dummyPositionsの末尾まで到達すると、末尾の要素を返し続けます。

このメソッドはh5.api.geo.watchPosition()で呼びます。※ h5.dev.api.geo.watchtPosition()ではありません。

dummyPositionsに値が設定されていない場合は元のh5.api.geoのメソッドを実行します。

Parameters:
Name Type Attributes Description
option Object <optional>
 設定情報
Properties
Name Type Attributes Description
enableHighAccuracy Boolean <optional>
 正確な位置を取得するか (ただし消費電力の増加や応答が遅延する)
timeout Number <optional>
 位置情報を取得するまで待機する時間 (ミリ秒)
maximumAge Number <optional>
 キャッシュされた位置情報の有効期間を指定する (ミリ秒)
Returns:
WatchPositionPromiseオブジェクト
Type
WatchPositionPromise
Source: