Wikitude SDK APIリファレンス

バージョン: 8.1.0
表示:

RelativeLocationクラス

継承元: Location
モジュール: AR

RelativeLocationは、任意のLocationとの相対的なLocationを表します。

基準点とするLocationに対する北および東方向の距離を指定して定義します。altitudeDeltaもオプションとして指定できます。

例:
//a relative location being 12 meters south, 20 meters west and 13 meters lower than current position of the user
var location2 = new AR.RelativeLocation(null, -12, -20, -13);

var geoLoc = new AR.GeoLocation(47.77317, 13.069929, 320.);
//a relative location being 12 meters north, 20 meters east and 13 meters higher than geoLoc
var location1 = new AR.RelativeLocation(geoLoc, 12, 20, 13);

RelativeLocationは基準点とするLocationとともに変化します。

コンストラクター

RelativeLocation

(
  • location
  • northing
  • easting
  • altitudeDelta
)

パラメーター:

  • location Location

    基準点とするLocation。nullを指定すると、ユーザーの現在の位置が基準点として使用されます。

  • northing Number

    相対的なLocationが基準点から北に何メートル離れているかを指定します。負の値を指定すると、南方向のメートル数と見なされます。

  • easting Number

    相対的なLocationが基準点から東に何メートル離れているかを指定します。負の値を指定すると、西方向のメートル数と見なされます。

  • altitudeDelta（デフォルト値: 0）Number オプション

    相対的なLocationが基準点から何メートル高いかを指定します。負の値を指定すると、低さのメートル数と見なされます。これは基準点の高度が不明なときにも適用されます。

項目索引

メソッド

プロパティ

メソッド

destroy

()

継承元: ARchitectObject

オブジェクトを破棄します。

distanceTo

(
  • location
)
Number

継承元: Location

引数として渡したLocationへの最短距離を直線距離として返します。高度プロパティは無視されます。

例:
var location1 = new AR.GeoLocation(47.77317, 13.069929);
var location2 = new AR.GeoLocation(47.77317, 13.069929, 320.);
var location3 = new AR.GeoLocation(47.77317, 14.069929, 640.);
var dist = location2.distanceTo(location1); //dist = 0.
dist = location2.distanceTo(location3); //dist = 74730.

パラメーター:

  • location Location

    距離を計算する対象のLocation。

戻り値:

Number:

距離を表す数値（m単位）。

distanceToUser

() Number

継承元: Location

ユーザーの現在の位置への最短距離を直線距離として返します。高度プロパティは無視されます。

ユーザーの現在の位置が特定できない場合は、undefinedが返されます。

戻り値:

Number:

距離を表す数値（m単位）。

プロパティ

altitudeDelta

Number

相対的なLocationが基準点から何メートル高いかを指定します。負の値を指定すると、低さのメートル数と見なされます。これは基準点の高度が不明なときにも適用されます。このプロパティがnullに設定されている場合、altitudeDeltaとして0が適用されます。

destroyed

Boolean

継承元: ARchitectObject

オブジェクトがすでに破棄されているかどうかを示します。

easting

Number

相対的なLocationが基準点から東に何メートル離れているかを指定します。負の値を指定すると、西方向のメートル数と見なされます。

location

Location

基準点とするLocation。nullを指定すると、ユーザーの現在の位置が基準点として使用されます。

northing

Number

相対的なLocationが基準点から北に何メートル離れているかを指定します。負の値を指定すると、南方向のメートル数と見なされます。