mobility-toolbox-js 3.0.0-beta.9 → 3.0.1-beta.0

package/ol/controls/RoutingControl.d.ts

@@ -1,37 +1,34 @@
 import { Feature } from 'ol';
-import type { Map, MapBrowserEvent } from 'ol';
+import Control, { Options } from 'ol/control/Control';
+import { EventsKey } from 'ol/events';
+import { GeoJSON } from 'ol/format';
 import { Geometry, LineString, Point } from 'ol/geom';
 import { Modify } from 'ol/interaction';
-import { GeoJSON } from 'ol/format';
-import type { Coordinate } from 'ol/coordinate';
-import type { StyleLike } from 'ol/style/Style';
-import { EventsKey } from 'ol/events';
 import { ModifyEvent } from 'ol/interaction/Modify';
 import VectorLayer from 'ol/layer/Vector';
-import VectorSource from 'ol/source/Vector';
-import Control, { Options } from 'ol/control/Control';
 import { RoutingAPI } from '../../api';
+import type { Map, MapBrowserEvent } from 'ol';
+import type { Coordinate } from 'ol/coordinate';
+import type { StyleLike } from 'ol/style/Style';
 import type { RoutingGraph, RoutingMot, RoutingParameters, RoutingViaPoint } from '../../types';
-export type RoutingControlOptions = Options & {
-    apiKey?: string;
+export type RoutingControlOptions = {
     active?: boolean;
-    stopsApiKey?: string;
-    stopsApiUrl?: string;
-    routingLayer?: VectorLayer<VectorSource<Feature<Geometry>>>;
+    apiKey?: string;
     graphs?: RoutingGraph[];
-    mot?: string;
     modify?: boolean;
+    mot?: string;
+    onRouteError?: () => void;
     routingApiParams?: RoutingParameters;
-    useRawViaPoints?: boolean;
+    routingLayer?: VectorLayer<Feature>;
     snapToClosestStation?: boolean;
+    stopsApiKey?: string;
+    stopsApiUrl?: string;
     style?: StyleLike;
-    onRouteError?: () => void;
-};
-export type AbotControllersByGraph = {
-    [key: string]: AbortController;
-};
+    useRawViaPoints?: boolean;
+} & Options;
+export type AbotControllersByGraph = Record<string, AbortController>;
 /**
- * Display a route of a specified mean of transport.
+ * This OpenLayers control allows the user to add and modifiy via points to a map and request a route from the [geOps Routing API](https://developer.geops.io/apis/routing/).
  *
  * @example
  * import { Map } from 'ol';
@@ -63,42 +60,30 @@ export type AbotControllersByGraph = {
  * @public
  */
 declare class RoutingControl extends Control {
-    map?: Map;
-    viaPoints: RoutingViaPoint[];
-    routingLayer?: VectorLayer<VectorSource<Feature<Geometry>>>;
-    graphs: RoutingGraph[];
-    routingApiParams?: RoutingParameters;
-    useRawViaPoints: boolean;
-    snapToClosestStation: boolean;
-    cacheStationData: {
-        [key: string]: Coordinate;
-    };
-    abortControllers: {
-        [key: string]: AbortController;
-    };
-    apiKey?: string;
-    stopsApiKey?: string;
-    segments: Feature<LineString>[];
-    stopsApiUrl?: string;
+    abortControllers: Record<string, AbortController>;
     api?: RoutingAPI;
+    apiKey?: string;
+    cacheStationData: Record<string, Coordinate>;
     format: GeoJSON;
+    graphs: RoutingGraph[];
     graphsResolutions?: [number, number][];
-    onRouteError: (error?: Error, control?: RoutingControl) => void;
-    onMapClickKey?: EventsKey;
-    modifyInteraction?: Modify;
     initialRouteDrag?: {
-        viaPoint?: Feature<Point>;
         oldRoute?: Feature<LineString>;
         segmentIndex?: number;
+        viaPoint?: Feature<Point>;
     };
-    get active(): boolean;
-    set active(newValue: boolean);
-    get loading(): boolean;
-    set loading(newValue: boolean);
-    get modify(): any;
-    set modify(newValue: any);
-    get mot(): RoutingMot;
-    set mot(newValue: RoutingMot);
+    map?: Map;
+    modifyInteraction?: Modify;
+    onMapClickKey?: EventsKey;
+    onRouteError: (error?: Error, control?: RoutingControl) => void;
+    routingApiParams?: RoutingParameters;
+    routingLayer?: VectorLayer<Feature>;
+    segments: Feature<LineString>[];
+    snapToClosestStation: boolean;
+    stopsApiKey?: string;
+    stopsApiUrl?: string;
+    useRawViaPoints: boolean;
+    viaPoints: RoutingViaPoint[];
     constructor(options?: RoutingControlOptions);
     /**
      * Calculate at which resolutions corresponds each generalizations.
@@ -107,10 +92,16 @@ declare class RoutingControl extends Control {
      */
     static getGraphsResolutions(graphs: RoutingGraph[], map: Map): [number, number][];
     /**
-     * Activet7deactivate the control when activ eproperty changes
+     * Aborts viapoint and route requests
      * @private
      */
-    onActiveChange(): void;
+    abortRequests(): void;
+    activate(): void;
+    /**
+     * Add click listener to map.
+     * @private
+     */
+    addListeners(): void;
     /**
      * Adds/Replaces a viaPoint to the viaPoints array and redraws route:
      *   Adds a viaPoint at end of array by default.
@@ -124,28 +115,17 @@ declare class RoutingControl extends Control {
      */
     addViaPoint(coordinatesOrString: RoutingViaPoint, index?: number, overwrite?: number): void;
     /**
-     * Removes a viaPoint at the passed array index and redraws route
-     * By default the last viaPoint is removed.
-     * @param {number} index Integer representing the index of the viaPoint to delete.
-     * @public
-     */
-    removeViaPoint(index?: number): void;
-    /**
-     * Replaces the current viaPoints with a new coordinate array.
-     * @param {Array<Array<number>>} coordinateArray Array of nested coordinates
-     * @public
-     */
-    setViaPoints(coordinateArray: Coordinate[]): void;
-    /**
-     * Removes all viaPoints, clears the source and triggers a change event
-     * @public
+     * Define a default element.
+     *
+     * @private
      */
-    reset(): void;
+    createDefaultElement(): void;
     /**
-     * Aborts viapoint and route requests
+     * Create the interaction used to modify vertexes of features.
      * @private
      */
-    abortRequests(): void;
+    createModifyInteraction(): void;
+    deactivate(): void;
     /**
      * Draws route on map using an array of coordinates:
      *   If a single coordinate is passed a single point feature is added to map.
@@ -160,6 +140,11 @@ declare class RoutingControl extends Control {
      * @private
      */
     drawViaPoint(viaPoint: RoutingViaPoint, idx: number, abortController: AbortController): Promise<void | Feature<Geometry>> | Promise<Feature<Geometry> | null>;
+    /**
+     * Activet7deactivate the control when activ eproperty changes
+     * @private
+     */
+    onActiveChange(): void;
     /**
      * Used on click on map while control is active:
      *   By default adds a viaPoint to the end of array.
@@ -167,12 +152,6 @@ declare class RoutingControl extends Control {
      * @private
      */
     onMapClick(evt: MapBrowserEvent<MouseEvent>): void;
-    /**
-     * Used on start of the modify interaction. Stores relevant data
-     * in this.initialRouteDrag object
-     * @private
-     */
-    onModifyStart(evt: ModifyEvent): void;
     /**
      * Used on end of the modify interaction. Resolves feature modification:
      *   Line drag creates new viaPoint at the final coordinate of drag.
@@ -181,29 +160,43 @@ declare class RoutingControl extends Control {
      */
     onModifyEnd(evt: ModifyEvent): void | Promise<never>;
     /**
-     * Define a default element.
-     *
+     * Used on start of the modify interaction. Stores relevant data
+     * in this.initialRouteDrag object
      * @private
      */
-    createDefaultElement(): void;
+    onModifyStart(evt: ModifyEvent): void;
     /**
-     * Create the interaction used to modify vertexes of features.
+     * Remove click listener from map.
      * @private
      */
-    createModifyInteraction(): void;
+    removeListeners(): void;
     /**
-     * Add click listener to map.
-     * @private
+     * Removes a viaPoint at the passed array index and redraws route
+     * By default the last viaPoint is removed.
+     * @param {number} index Integer representing the index of the viaPoint to delete.
+     * @public
      */
-    addListeners(): void;
+    removeViaPoint(index?: number): void;
+    render(): void;
     /**
-     * Remove click listener from map.
-     * @private
+     * Removes all viaPoints, clears the source and triggers a change event
+     * @public
      */
-    removeListeners(): void;
+    reset(): void;
     setMap(map: Map): void;
-    activate(): void;
-    deactivate(): void;
-    render(): void;
+    /**
+     * Replaces the current viaPoints with a new coordinate array.
+     * @param {Array<Array<number>>} coordinateArray Array of nested coordinates
+     * @public
+     */
+    setViaPoints(coordinateArray: Coordinate[]): void;
+    get active(): boolean;
+    set active(newValue: boolean);
+    get loading(): boolean;
+    set loading(newValue: boolean);
+    get modify(): any;
+    set modify(newValue: any);
+    get mot(): RoutingMot;
+    set mot(newValue: RoutingMot);
 }
 export default RoutingControl;