@situm/cordova 3.0.1 → 3.1.0

package/www/map-view-controller.js

@@ -5,6 +5,8 @@ const Situm = require("@situm/cordova.situm");
  */
 class MapViewControllerImpl {
   _onLoadCallback = undefined;
+  _onPoiSelectedCallback = undefined;
+  _onPoiDeselectedCallback = undefined;
   _buildings = undefined;
   _mapView = undefined;
   _isNavigating = false;
@@ -26,22 +28,22 @@ class MapViewControllerImpl {
       type: type,
       payload: payload,
     };
-    if (this._mapView && this._mapView.firstElementChild){
+    if (this._mapView && this._mapView.firstElementChild) {
       this._mapView.firstElementChild.contentWindow.postMessage(
         message,
         this._mapView._getViewerDomain()
-      )
-    };
+      );
+    }
   }
 
   // ==================================================
-  // SDK MESSAGES: 
+  // SDK MESSAGES:
   // ==================================================
 
   _handleSdkNativeEvents(eventName, payload) {
     switch (eventName) {
       case "onLocationUpdate":
-        // TODO: iOS is sending messages here not related to Location. Check 
+        // TODO: iOS is sending messages here not related to Location. Check
         // some fields to avoid assuming that we receive an object of type Location.
         if (payload.buildingIdentifier && payload.position) {
           this._handleOnLocationUpdate(payload);
@@ -61,30 +63,51 @@ class MapViewControllerImpl {
           // Do nothing.
         },
         () => {
-          console.error("Error at updateNavigationWithLocation")
+          console.error("Error at updateNavigationWithLocation");
         }
       );
     }
   }
 
   _handleOnLocationStatus(payload) {
-    this._sendMessageToViewer("location.update_status", {status: payload.statusName});
+    this._sendMessageToViewer("location.update_status", {
+      status: payload.statusName,
+    });
   }
 
   // ==================================================
-  // MAP-VIEWER MESSAGES: 
+  // MAP-VIEWER MESSAGES:
   // ==================================================
 
   _handleMapViewMessages(m) {
     switch (m.type) {
       case "app.map_is_ready":
-        if (this._onLoadCallback && typeof this._onLoadCallback === 'function') {
+        if (
+          this._onLoadCallback &&
+          typeof this._onLoadCallback === "function"
+        ) {
           this._onLoadCallback(this);
-          console.debug('Map is ready!');
+          console.debug("Map is ready!");
         }
         break;
       case "cartography.poi_selected":
         console.debug(`poi (${m.payload.identifier}) was selected`);
+        const poiSelectedResult = {
+          poi: {
+            identifier: m.payload.identifier,
+            buildingIdentifier: m.payload.buildingIdentifier,
+          },
+        };
+        this._onPoiSelectedCallback(poiSelectedResult);
+        break;
+      case "cartography.poi_deselected":
+        const poiDeselectedResult = {
+          poi: {
+            identifier: m.payload.identifier,
+            buildingIdentifier: m.payload.buildingIdentifier,
+          },
+        };
+        this._onPoiDeselectedCallback(poiDeselectedResult);
         break;
       case "directions.requested":
         this._onDirectionsRequested(m.payload);
@@ -104,14 +127,18 @@ class MapViewControllerImpl {
   // Fetch the given building and return it or undefined if not found.
   _ensureBuilding(buildingId, callback) {
     if (this._buildings) {
-      let building = this._buildings.find(b => b.buildingIdentifier == buildingId);
+      let building = this._buildings.find(
+        (b) => b.buildingIdentifier == buildingId
+      );
       callback(building);
     } else {
       // Fetch buildings and calculate route.
       cordova.plugins.Situm.fetchBuildings(
         (res) => {
           this._buildings = res;
-          let building = this._buildings.find(b => b.buildingIdentifier == buildingId);
+          let building = this._buildings.find(
+            (b) => b.buildingIdentifier == buildingId
+          );
           callback(building);
         },
         (err) => {
@@ -130,20 +157,34 @@ class MapViewControllerImpl {
       originIdentifier: payload.originIdentifier,
       destinationIdentifier: payload.destinationIdentifier,
       type: directionsRequest.accessibilityMode,
-    }
+    };
     this._ensureBuilding(payload.buildingIdentifier, (building) => {
-      if (building){
+      if (building) {
         Situm.requestDirections(
-          [building, directionsRequest.from, directionsRequest.to, directionsRequest],
+          [
+            building,
+            directionsRequest.from,
+            directionsRequest.to,
+            directionsRequest,
+          ],
           (route) => {
-            this._sendMessageToViewer("directions.update", { ...route, ...mapViewerData });
+            this._sendMessageToViewer("directions.update", {
+              ...route,
+              ...mapViewerData,
+            });
           },
           (error) => {
-            this._sendMessageToViewer("directions.update", { error: -1, identifier: mapViewerData.identifier });
+            this._sendMessageToViewer("directions.update", {
+              error: -1,
+              identifier: mapViewerData.identifier,
+            });
           }
         );
       } else {
-        this._sendMessageToViewer("directions.update", { error: -1, identifier: payload.identifier });
+        this._sendMessageToViewer("directions.update", {
+          error: -1,
+          identifier: payload.identifier,
+        });
       }
     });
   }
@@ -157,36 +198,55 @@ class MapViewControllerImpl {
       originIdentifier: payload.originIdentifier,
       destinationIdentifier: payload.destinationIdentifier,
       type: directionsRequest.accessibilityMode,
-    }
+    };
     let navigationRequest = payload.navigationRequest;
     this._ensureBuilding(payload.buildingIdentifier, (building) => {
       // Request directions again to update the calculated route on the native side.
       Situm.requestDirections(
-        [building, directionsRequest.from, directionsRequest.to, directionsRequest],
+        [
+          building,
+          directionsRequest.from,
+          directionsRequest.to,
+          directionsRequest,
+        ],
         (route) => {
           this._isNavigating = true;
-          this._sendMessageToViewer("navigation.start", { ...route, ...mapViewerData });
+          this._sendMessageToViewer("navigation.start", {
+            ...route,
+            ...mapViewerData,
+          });
           Situm.requestNavigationUpdates(
             [navigationRequest],
             (progress) => {
               // Navigation is working, handle different progress types:
               if (progress.type == "progress") {
-                progress.type = 'PROGRESS'; // The map-viewer waits for an upper case "type".
+                progress.type = "PROGRESS"; // The map-viewer waits for an upper case "type".
                 this._sendMessageToViewer("navigation.update", progress);
               } else if (progress.type == "destinationReached") {
-                this._sendMessageToViewer("navigation.update", {type: "DESTINATION_REACHED"});
+                this._sendMessageToViewer("navigation.update", {
+                  type: "DESTINATION_REACHED",
+                });
                 this._isNavigating = false;
               } else if (progress.type == "userOutsideRoute") {
-                this._sendMessageToViewer("navigation.update", {type: "OUT_OF_ROUTE"});
+                this._sendMessageToViewer("navigation.update", {
+                  type: "OUT_OF_ROUTE",
+                });
               }
             },
             (error) => {
-              this._sendMessageToViewer("directions.update", { error: -1, identifier: mapViewerData.identifier });
+              this._sendMessageToViewer("directions.update", {
+                error: -1,
+                identifier: mapViewerData.identifier,
+              });
               this._isNavigating = false;
-            });
+            }
+          );
         },
         (error) => {
-          this._sendMessageToViewer("directions.update", { error: -1, identifier: mapViewerData.identifier });
+          this._sendMessageToViewer("directions.update", {
+            error: -1,
+            identifier: mapViewerData.identifier,
+          });
           this._isNavigating = false;
         }
       );
@@ -214,9 +274,50 @@ class MapViewControllerImpl {
    * @param {number} identifier The unique identifier of the resource.
    * */
   selectPoi(identifier) {
-    this._sendMessageToViewer("cartography.select_poi", { identifier: identifier });
+    this._sendMessageToViewer("cartography.select_poi", {
+      identifier: identifier,
+    });
   }
 
+  /**
+   * Navigate to a {@link POI} of a building.
+   *
+   * The types of {@link accessibilityMode} you can use are:
+   * - 'CHOOSE_SHORTEST' : Calculates the shortest route to the destination {@link POI}.
+   * - 'ONLY_ACCESSIBLE' : Calculates the shortest route to the destination {@link POI} but avoiding stairs and prioritizing accessible floor changes such as lifts.
+   * - 'ONLY_NOT_ACCESSIBLE_FLOOR_CHANGES' : Calculates the shortest route to the destination {@link POI} but avoiding lifts and prioritizing non-accessible floor changes such as stairs.
+   *
+   * accessibilityMode defaults to CHOOSE_SHORTEST.
+   *
+   * @param {number} identifier The identifier of the poi.
+   * @param {'CHOOSE_SHORTEST' | 'ONLY_ACCESSIBLE' | 'ONLY_NOT_ACCESSIBLE_FLOOR_CHANGES' | undefined} accessibilityMode Choose the route type to calculate.
+   * */
+  navigateToPoi(identifier, accessibilityMode) {
+    this._sendMessageToViewer("navigation.start", {
+      navigationTo: identifier,
+      type: accessibilityMode,
+    });
+  }
+
+  // ==================================================
+  // EVENTS
+  // ==================================================
+
+  /**
+   * A {@link POI} was selected in your building.
+   * @param {Function} cb A callback that returns a {@link PoiSelectedResult} by its parameters.
+   * */
+  onPoiSelected(cb) {
+    this._onPoiSelectedCallback = cb;
+  }
+
+  /**
+   * A {@link POI} was deselected in your building.
+   * @param {Function} cb A callback that returns a {@link PoiDeselectedResult} by its parameters.
+   * */
+  onPoiDeselected(cb) {
+    this._onPoiDeselectedCallback = cb;
+  }
 }
 
 let MapViewController = new MapViewControllerImpl();

package/www/map-view.js

@@ -1,5 +1,4 @@
 const MapViewController = require('./map-view-controller');
-
 /**
  * @namespace MapView
  */
@@ -67,7 +66,7 @@ class MapView extends HTMLElement {
         MapViewController._handleMapViewMessages(msg);
       }
     } catch (error) {
-      console.warn(`Got unparseable message: ${m}`);
+      console.warn('Got unparseable message:', m);
     }
   }