Abstract Class: AbstractNearestSubscription<T, TAdded, TRemoved>

Defined in: src/sdk/navigation/NearestSubscription.ts:67

A class for tracking a nearest facility session and making it available as a subscribable array of facilities.

Extends

• AbstractSubscribableArray<T>

Type Parameters

Type Parameter
T extends Facility
TAdded
TRemoved

Implements

• NearestSubscription<T>

Constructors

Constructor

new AbstractNearestSubscription<T, TAdded, TRemoved>(facilityClient, type): AbstractNearestSubscription<T, TAdded, TRemoved>

Defined in: src/sdk/navigation/NearestSubscription.ts:87

Creates a new instance of AbstractNearestSubscription.

Parameters

Parameter	Type	Description
facilityClient	FacilityClient	The client from which to retrieve facilities.
type	All | Airport | Intersection | Vor | Ndb | User | Visual | AllExceptVisual	The type of facility to search for.

Returns

AbstractNearestSubscription<T, TAdded, TRemoved>

Overrides

AbstractSubscribableArray.constructor

Properties

facilities

protected readonly facilities: T[] = []

Defined in: src/sdk/navigation/NearestSubscription.ts:70

---

facilityClient

protected readonly facilityClient: FacilityClient

Defined in: src/sdk/navigation/NearestSubscription.ts:88

The client from which to retrieve facilities.

---

facilityIndex

protected readonly facilityIndex: Map<string, T>

Defined in: src/sdk/navigation/NearestSubscription.ts:71

---

initialNotifyFunc()

protected readonly initialNotifyFunc: (sub) => void

Defined in: src/sdk/sub/AbstractSubscribableArray.ts:20

A function which sends initial notifications to subscriptions.

Notifies a subscription of this array's current state.

Parameters

Parameter	Type	Description
sub	HandlerSubscription<SubscribableArrayHandler<T>>	The subscription to notify.

Returns

void

Inherited from

AbstractSubscribableArray.initialNotifyFunc

---

notifyDepth

protected notifyDepth: number = 0

Defined in: src/sdk/sub/AbstractSubscribableArray.ts:17

Inherited from

AbstractSubscribableArray.notifyDepth

---

onSubDestroyedFunc()

protected readonly onSubDestroyedFunc: (sub) => void

Defined in: src/sdk/sub/AbstractSubscribableArray.ts:23

A function which responds to when a subscription to this subscribable is destroyed.

Responds to when a subscription to this array is destroyed.

Parameters

Parameter	Type	Description
sub	HandlerSubscription<SubscribableArrayHandler<T>>	The destroyed subscription.

Returns

void

Inherited from

AbstractSubscribableArray.onSubDestroyedFunc

---

session

protected session: NearestSearchSession<TAdded, TRemoved> | undefined

Defined in: src/sdk/navigation/NearestSubscription.ts:73

---

singletonSub?

protected optional singletonSub: HandlerSubscription<SubscribableArrayHandler<T>>

Defined in: src/sdk/sub/AbstractSubscribableArray.ts:14

Inherited from

AbstractSubscribableArray.singletonSub

---

startPromiseResolves

protected readonly startPromiseResolves: () => void[] = []

Defined in: src/sdk/navigation/NearestSubscription.ts:75

Returns

void

---

subs?

protected optional subs: HandlerSubscription<SubscribableArrayHandler<T>>[]

Defined in: src/sdk/sub/AbstractSubscribableArray.ts:16

Inherited from

AbstractSubscribableArray.subs

---

type

protected readonly type: All | Airport | Intersection | Vor | Ndb | User | Visual | AllExceptVisual

Defined in: src/sdk/navigation/NearestSubscription.ts:89

The type of facility to search for.

---

updatePromiseResolves

protected readonly updatePromiseResolves: () => void[] = []

Defined in: src/sdk/navigation/NearestSubscription.ts:76

Returns

void

Accessors

length

Get Signature

get length(): number

Defined in: src/sdk/navigation/NearestSubscription.ts:95

The length of this array.

Returns

number

The length of this array.

Implementation of

NearestSubscription.length

Overrides

AbstractSubscribableArray.length

---

started

Get Signature

get started(): boolean

Defined in: src/sdk/navigation/NearestSubscription.ts:103

Whether or not this subscription has been started.

Returns

boolean

True if started, false otherwise.

Whether this search has started.

Implementation of

NearestSubscription.started

Methods

addFacility()

protected addFacility(facility, key): void

Defined in: src/sdk/navigation/NearestSubscription.ts:198

Adds a facility to the collection.

Parameters

Parameter	Type	Description
facility	T	The facility to add.
key	string	The key to track this facility by.

Returns

void

---

addSubscription()

protected addSubscription(sub): void

Defined in: src/sdk/sub/AbstractSubscribableArray.ts:29

Adds a subscription to this array.

Parameters

Parameter	Type	Description
sub	HandlerSubscription<SubscribableArrayHandler<T>>	The subscription to add.

Returns

void

Inherited from

AbstractSubscribableArray.addSubscription

---

awaitStart()

awaitStart(): Promise<void>

Defined in: src/sdk/navigation/NearestSubscription.ts:113

Waits until this search has started.

Returns

Promise<void>

Implementation of

NearestSubscription.awaitStart

---

doUpdate()

protected doUpdate(lat, lon, radius, maxItems): Promise<void>

Defined in: src/sdk/navigation/NearestSubscription.ts:171

Executes an update of the nearest search subscription.

Parameters

Parameter	Type	Description
lat	number	The latitude of the current search position.
lon	number	The longitude of the current search position.
radius	number	The radius of the search, in meters.
maxItems	number	The maximum number of items to return in the search.

Returns

Promise<void>

---

get()

get(index): T

Defined in: src/sdk/sub/AbstractSubscribableArray.ts:64

Gets an item from the array.

Parameters

Parameter	Type	Description
index	number	Thex index of the item to get.

Returns

T

An item.

Throws

Implementation of

NearestSubscription.get

Inherited from

AbstractSubscribableArray.get

---

getArray()

getArray(): readonly T[]

Defined in: src/sdk/navigation/NearestSubscription.ts:108

Gets a read-only version of this array.

Returns

readonly T[]

a read-only version of this array.

Implementation of

NearestSubscription.getArray

Overrides

AbstractSubscribableArray.getArray

---

initialNotify()

protected initialNotify(sub): void

Defined in: src/sdk/sub/AbstractSubscribableArray.ts:163

Notifies a subscription of this array's current state.

Parameters

Parameter	Type	Description
sub	HandlerSubscription<SubscribableArrayHandler<T>>	The subscription to notify.

Returns

void

Inherited from

AbstractSubscribableArray.initialNotify

---

notify()

protected notify(index, type, modifiedItem?): void

Defined in: src/sdk/sub/AbstractSubscribableArray.ts:87

Notifies subscriptions of a change in the array.

Parameters

Parameter	Type	Description
index	number	The index that was changed.
type	SubscribableArrayEventType	The type of subject event.
modifiedItem?	T | readonly T[]	The item modified by the operation.

Returns

void

Inherited from

AbstractSubscribableArray.notify

---

onResults()

abstract protected onResults(results): Promise<void>

Defined in: src/sdk/navigation/NearestSubscription.ts:191

A callback called when results are received.

Parameters

Parameter	Type	Description
results	NearestSearchResults<TAdded, TRemoved>	The results that were received.

Returns

Promise<void>

---

onSubDestroyed()

protected onSubDestroyed(sub): void

Defined in: src/sdk/sub/AbstractSubscribableArray.ts:172

Responds to when a subscription to this array is destroyed.

Parameters

Parameter	Type	Description
sub	HandlerSubscription<SubscribableArrayHandler<T>>	The destroyed subscription.

Returns

void

Inherited from

AbstractSubscribableArray.onSubDestroyed

---

removeFacility()

protected removeFacility(key): void

Defined in: src/sdk/navigation/NearestSubscription.ts:213

Removes a facility from the collection.

Parameters

Parameter	Type	Description
key	string	The key of the facility to remove.

Returns

void

---

start()

start(): Promise<void>

Defined in: src/sdk/navigation/NearestSubscription.ts:122

Starts this search.

Returns

Promise<void>

Implementation of

NearestSubscription.start

---

startSearchSession()

abstract protected startSearchSession(): Promise<NearestSearchSession<TAdded, TRemoved>>

Defined in: src/sdk/navigation/NearestSubscription.ts:149

Starts this subscription's nearest search session.

Returns

Promise<NearestSearchSession<TAdded, TRemoved>>

A Promise which will be fulfilled with this subscription's nearest search session once it has been started.

---

sub()

sub(handler, initialNotify, paused): Subscription

Defined in: src/sdk/sub/AbstractSubscribableArray.ts:41

Subscribes to changes in this array's state.

Parameters

Parameter	Type	Default value	Description
handler	SubscribableArrayHandler<T>	undefined	A function which is called when this array's state changes.
initialNotify	boolean	false	Whether to immediately invoke the callback function with this array's current state. Defaults to false. This argument is ignored if the subscription is initialized as paused.
paused	boolean	false	Whether the new subscription should be initialized as paused. Defaults to false.

Returns

Subscription

The new subscription.

Implementation of

NearestSubscription.sub

Inherited from

AbstractSubscribableArray.sub

---

tryGet()

tryGet(index): T | undefined

Defined in: src/sdk/sub/AbstractSubscribableArray.ts:77

Tries to get the value from the array.

Parameters

Parameter	Type	Description
index	number	The index of the item to get.

Returns

T | undefined

The value or undefined if not found.

Implementation of

NearestSubscription.tryGet

Inherited from

AbstractSubscribableArray.tryGet

---

update()

update(lat, lon, radius, maxItems): Promise<void>

Defined in: src/sdk/navigation/NearestSubscription.ts:152

Updates this search with new parameters. If an update is already in progress, this method will wait until the existing update is finished and then fulfill its returned Promise immediately.

Parameters

Parameter	Type	Description
lat	number	The latitude, in degrees, of the center of the search.
lon	number	The longitude, in degrees, of the center of the search.
radius	number	The radius of the search, in meters.
maxItems	number	The maximum number of items to return from the search.

Returns

Promise<void>

A Promise which will be fulfilled when the update is complete.

Implementation of

NearestSubscription.update