Class GeoRegion

地理的空間を表現するクラス

経度、緯度、標高それぞれ最小値、最大値によって定義される空間を表現します。地理的空間を表現するほか、空間の拡張や結合などの操作をサポートします。

空間の状態は、空、全域、それ以外の3つのいずれかです。 is_empty, is_whole, is_longitude_whole により確認することができます。

経度の値は、次の条件を満たすように保持されます。

min_lon < max_lon
max_lon - min_lon <= 360

min_lon, max_lon それぞれの値は -180 〜 180 でない可能性がある点に注意してください。

経度値の計算方法について、東経180°と西経180°が同一の点となるため、拡張や結合を行う際に特別な計算お行います。拡張や結合を行う際はできるだけ拡張量が小さくなるように拡張されます。例えば、東経170°付近の空間に、西経170°(-170)付近の点を含むように拡張する場合、計算結果の経度領域が -170°〜170° ではなく 170° 〜 190° になります。

Constructors

constructor

new GeoRegion(region?): GeoRegion
Parameters
- Optional region: RegionData2D | RegionData3D
Returns GeoRegion
- Defined in packages/mapray/src/GeoRegion.ts:39

Properties

`Private` _max_alt

_max_alt: number = 0

`Private` _max_lat

_max_lat: number = 0

`Private` _max_lon

_max_lon: number = 0

`Private` _min_alt

_min_alt: number = 0

`Private` _min_lat

_min_lat: number = 0

`Private` _min_lon

_min_lon: number = 0

`Private` _status

_status: Status = Status.EMPTY

Accessors

is_empty

get is_empty(): boolean
空であるかを取得します。

Returns boolean
- Defined in packages/mapray/src/GeoRegion.ts:48

is_longitude_whole

get is_longitude_whole(): boolean
経度方向の空間が全区間であるかを取得します。

Returns boolean
- Defined in packages/mapray/src/GeoRegion.ts:66

is_whole

get is_whole(): boolean
水平方向の空間が全区間であるかを取得します。

Returns boolean
- Defined in packages/mapray/src/GeoRegion.ts:57

Methods

`Private` _add

_add(lon, lat, alt?): void
Pointを追加
- 条件 this._min_lon < this._max_lon
- 条件 this._max_lon - this._min_lon <= 360
Parameters
- lon: number
  地理空間位置 longitude
- lat: number
  地理空間位置 latitude
- Optional alt: number
  地理空間位置 altitude
Returns void
- Defined in packages/mapray/src/GeoRegion.ts:217

`Private` _calcRightPosition

_calcRightPosition(base_lon, lon): number
base_lon より右となる最小の longitude を算出
Parameters
- base_lon: number
  基準となるlongitude
- lon: number
  確認したいlongitude
Returns number
最小longitude
- Defined in packages/mapray/src/GeoRegion.ts:269

`Private` _setWholeLongitudeRegion

_setWholeLongitudeRegion(): void
経度方向について全領域に設定します（経度方向の値のみ更新されます）。 Empty 時にこの関数が呼ばれた際に、緯度が 0 になるため混乱を防ぐため非公開とする。この関数を使う場合は latitude も指定すること（標高はデフォルト値0が代入されても良いと思われる）。

Returns void
- Defined in packages/mapray/src/GeoRegion.ts:174

addPoint

addPoint(point): void
GeoPointを追加
Parameters
- point: GeoPoint
  地理空間位置
Returns void
- Defined in packages/mapray/src/GeoRegion.ts:282

addPoints

addPoints(...points): void
GeoPointを追加
Parameters
- Rest ...points: GeoPoint[]
  地理空間位置
Returns void
- Defined in packages/mapray/src/GeoRegion.ts:293

addPointsAsArray

addPointsAsArray(pointsArray): void
PointArrayを追加
Parameters
- pointsArray: number[] | Float64Array
  地理空間位置Array
Returns void
- Defined in packages/mapray/src/GeoRegion.ts:306

assign

assign(src): GeoRegion
インスタンスを代入

src を this に代入する。
Parameters
- src: GeoRegion
  代入元
Returns GeoRegion
this
- Defined in packages/mapray/src/GeoRegion.ts:95

clear

clear(): void
領域を初期化し空にします。

Returns void
- Defined in packages/mapray/src/GeoRegion.ts:75

clone

clone(): GeoRegion
インスタンスを複製

this の複製を生成して返す。

Returns GeoRegion
this の複製
- Defined in packages/mapray/src/GeoRegion.ts:115

getCenter

getCenter(): null | GeoPoint
中心位置のGeopointを返却

Returns null | GeoPoint
中心(center)のGeoPoint
- Defined in packages/mapray/src/GeoRegion.ts:462

getLatitudeDistance

getLatitudeDistance(): null | number
RegionのLatitude方向の地表面距離を算出

Returns null | number
Latitude方向の地表面距離
- Defined in packages/mapray/src/GeoRegion.ts:487

getLongitudeDistance

getLongitudeDistance(): null | number
RegionのLongitude方向の地表面距離を算出

Returns null | number
Longitude方向の地表面距離
- Defined in packages/mapray/src/GeoRegion.ts:474

getNorthEast

getNorthEast(): null | GeoPoint
NorthEastのGeopointを返却

Returns null | GeoPoint
北東(max)のGeoPoint
- Defined in packages/mapray/src/GeoRegion.ts:450

getPoint

getPoint(lon_pos, lat_pos, alt_pos?): null | GeoPoint
Region内の任意点の取得
- center ( 0.5, 0.5 )
- east ( 1, 0.5 )
- west ( 0, 0.5 )
- north ( 0.5, 1 )
- south ( 0.5, 0 )
- northEast ( 1, 1 )
- southWest ( 0, 0 )
Parameters
- lon_pos: number
  longitude位置割合
- lat_pos: number
  latitude位置割合
- alt_pos: number = 0
  anlitude位置割合
Returns null | GeoPoint
GeoPoint
- Defined in packages/mapray/src/GeoRegion.ts:422

getSouthWest

getSouthWest(): null | GeoPoint
SouthWestのGeopointを返却

Returns null | GeoPoint
南西(min)のGeoPoint
- Defined in packages/mapray/src/GeoRegion.ts:438

intersects

intersects(region): boolean
共通領域が存在するかを判定します。
Parameters
- region: GeoRegion | RegionData2D | RegionData3D
Returns boolean
- Defined in packages/mapray/src/GeoRegion.ts:185

merge

merge(region): void
GeoRegionを結合
Parameters
- region: GeoRegion
  地理空間Region
Returns void
- Defined in packages/mapray/src/GeoRegion.ts:319

setRegion

setRegion(region): void
領域を設定します。
Parameters
- region: RegionData2D | RegionData3D
Returns void
- Defined in packages/mapray/src/GeoRegion.ts:125

setWholeRegion

setWholeRegion(vertical_region?): void
水平方向について全領域に設定します。
Parameters
- Optional vertical_region: [min_alt: number, max_alt: number]
Returns void
- Defined in packages/mapray/src/GeoRegion.ts:157

Class GeoRegion

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Optional region: RegionData2D | RegionData3D

Returns GeoRegion

Properties

Private _max_alt

Private _max_lat

Private _max_lon

Private _min_alt

Private _min_lat

Private _min_lon

Private _status

Accessors

is_empty

Returns boolean

is_longitude_whole

Returns boolean

is_whole

Returns boolean

Methods

Private _add

Parameters

lon: number

lat: number

Optional alt: number

Returns void

Private _calcRightPosition

Parameters

base_lon: number

lon: number

Returns number

Private _setWholeLongitudeRegion

Returns void

addPoint

Parameters

point: GeoPoint

Returns void

addPoints

Parameters

Rest ...points: GeoPoint[]

Returns void

addPointsAsArray

Parameters

pointsArray: number[] | Float64Array

Returns void

assign

Parameters

src: GeoRegion

Returns GeoRegion

clear

Returns void

clone

Returns GeoRegion

getCenter

Returns null | GeoPoint

getLatitudeDistance

Returns null | number

getLongitudeDistance

Returns null | number

getNorthEast

Returns null | GeoPoint

getPoint

Parameters

lon_pos: number

lat_pos: number

alt_pos: number = 0

Returns null | GeoPoint

getSouthWest

Returns null | GeoPoint

intersects

Parameters

region: GeoRegion | RegionData2D | RegionData3D

Returns boolean

`Optional` region: RegionData2D | RegionData3D

`Private` _max_alt

`Private` _max_lat

`Private` _max_lon

`Private` _min_alt

`Private` _min_lat

`Private` _min_lon

`Private` _status

`Private` _add

`Optional` alt: number

`Private` _calcRightPosition

`Private` _setWholeLongitudeRegion

`Rest` ...points: GeoPoint[]

`Optional` vertical_region: [min_alt: number, max_alt: number]