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

new GeoRegion()

new GeoRegion(region?): GeoRegion

Parameters

Parameter	Type
region?	RegionData2D | RegionData3D

Returns

GeoRegion

Accessors

is_empty

get is_empty(): boolean

空であるかを取得します。

Returns

boolean

---

is_longitude_whole

get is_longitude_whole(): boolean

経度方向の空間が全区間であるかを取得します。

Returns

boolean

---

is_whole

get is_whole(): boolean

水平方向の空間が全区間であるかを取得します。

Returns

boolean

Methods

addPoint()

addPoint(point): void

GeoPointを追加

Parameters

Parameter	Type	Description
point	GeoPoint	地理空間位置

Returns

void

---

addPoints()

addPoints(...points): void

GeoPointを追加

Parameters

Parameter	Type	Description
...points	GeoPoint[]	地理空間位置

Returns

void

---

addPointsAsArray()

addPointsAsArray(pointsArray): void

PointArrayを追加

Parameters

Parameter	Type	Description
pointsArray	number[] | Float64Array<ArrayBufferLike>	地理空間位置Array

Returns

void

---

assign()

assign(src): GeoRegion

インスタンスを代入

src を this に代入する。

Parameters

Parameter	Type	Description
src	GeoRegion	代入元

Returns

GeoRegion

this

---

clear()

clear(): void

領域を初期化し空にします。

Returns

void

---

clone()

clone(): GeoRegion

インスタンスを複製

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

Returns

GeoRegion

this の複製

---

getCenter()

getCenter(): GeoPoint

中心位置のGeopointを返却

Returns

GeoPoint

中心(center)のGeoPoint

---

getLatitudeDistance()

getLatitudeDistance(): number

RegionのLatitude方向 の地表面距離を算出

Returns

number

Latitude方向の地表面距離

---

getLongitudeDistance()

getLongitudeDistance(): number

RegionのLongitude方向 の地表面距離を算出

Returns

number

Longitude方向の地表面距離

---

getNorthEast()

getNorthEast(): GeoPoint

NorthEastのGeopointを返却

Returns

GeoPoint

北東(max)のGeoPoint

---

getPoint()

getPoint(lon_pos, lat_pos, alt_pos): 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

Parameter	Type	Default value	Description
lon_pos	number	undefined	longitude位置割合
lat_pos	number	undefined	latitude位置割合
alt_pos	number	0	anlitude位置割合

Returns

GeoPoint

GeoPoint

---

getSouthWest()

getSouthWest(): GeoPoint

SouthWestのGeopointを返却

Returns

GeoPoint

南西(min)のGeoPoint

---

intersects()

intersects(region): boolean

共通領域が存在するかを判定します。

Parameters

Parameter	Type
region	GeoRegion | RegionData2D | RegionData3D

Returns

boolean

---

merge()

merge(region): void

GeoRegionを結合

Parameters

Parameter	Type	Description
region	GeoRegion	地理空間Region

Returns

void

---

setRegion()

setRegion(region): void

領域を設定します。

Parameters

Parameter	Type
region	RegionData2D | RegionData3D

Returns

void

---

setWholeRegion()

setWholeRegion(vertical_region?): void

水平方向について全領域に設定します。

Parameters

Parameter	Type
vertical_region?	[number, number]

Returns

void