@situm/cordova 3.0.0

package/www/android/situm.js

@@ -0,0 +1,296 @@
+var exec = require('cordova/exec');
+
+var PLUGIN_NAME = 'Situm';
+let _internalEventDelegate = undefined;
+
+/** 
+ * @namespace Situm
+ */
+
+var Situm = {
+  /**
+   * An internal method.
+   * @param {internalEventDelegate} callback.
+   */
+  internalSetEventDelegate: function (callback) {
+    _internalEventDelegate = callback;
+  },
+  /**
+   * Provides your API key to the Situm SDK.
+   * @description Provides your API key to the Situm SDK. This key is generated for your application in the Dashboard. Old credentials will be removed.
+   * @param {string} email Email that identifies the account. Can't be empty.
+   * @param {string} apiKey Key obtained at situm.es. Can't be empty.
+   * @param {function} cb Cordova native callback to recive data.
+   * @param {function} error Cordova native callback to recive errors.
+   * @return {boolean} success True if operation finished successfully, otherwise false
+   */
+  setApiKey: function (email, apiKey, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'setApiKey', [email, apiKey]);
+  },
+  setUseRemoteConfig: function (useRemoteConfig, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'setUseRemoteConfig', [useRemoteConfig]);
+  },
+  /**
+   * Provides user's email and password.
+   * @description Provides user's email and password. This credentials will be used to obtain a valid user token to authenticate the server request, when necessary. Token obtaining is not necessary done when this method is executed. Old credentials will be removed.
+   * @param {string} email User's email. Can't be empty.
+   * @param {string} password User's password. Can't be empty.
+   * @param {function} cb Cordova native callback to recive data.
+   * @param {function} error Cordova native callback to recive errors.
+   * @return {boolean} success True if operation finished successfully, otherwise false
+   */
+  setUserPass: function (email, password, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'setUserPass', [email, password]);
+  },
+  /**
+   * Sets the maximum age of a cached response.
+   * @description Sets the maximum age of a cached response. If the cache response's age exceeds maxAge, it will not be used and a network request will be made.
+   * @param {number} cacheAge A non-negative integer
+   * @param {function} cb Cordova native callback to recive data.
+   * @param {function} error Cordova native callback to recive errors.
+   * @return {void}
+   */
+  setCacheMaxAge: function (cacheAge, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'setCacheMaxAge', [cacheAge]);
+  },
+  /**
+   * Set callback and starts listen onLocationChanged event.
+   * @param {LocationRequest} request Location Request.
+   * @param {function} cb Cordova native callback to recive data.
+   * @param {function} error Cordova native callback to recive errors.
+   * @return {Location} position Current position of device.
+   */
+  startPositioning: function (request, cb, error) {
+    let internalCallback = (res) => {
+      _internalEventDelegate('onLocationUpdate', res);
+      cb(res);
+    };
+    exec(internalCallback, error, PLUGIN_NAME, 'startPositioning', request);;
+  },
+    /**
+   * Stop locationListener on current active listener.
+   * @description Stop locationListener on current active listener.
+   * @param {function} cb Cordova native callback to recive data.
+   * @param {function} error Cordova native callback to recive errors.
+   * @return {void}
+   */
+  stopPositioning: function (cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'stopPositioning', []);
+  },
+  /**
+   * Get notified about users entering geofences. Take into account:
+   * * This method must be called before the positioning is started.
+   * * Positioning geofences (with `trainer_metadata` custom field configured in the dashboard (https://situm.com/docs/special-custom-fields/#activating-the-uncalibrated-indoor-geolocation-mode)) won't be notified.
+   * * This callback works only with indoor locations. Any outdoor location will produce a call to onExitGeofences with the last positioned geofences as argument.
+   * @description Set the geofence listener to receive updates when you enter or exit one of them.
+   * @param {function} cb Cordova native callback to recive data. The data is an array of geofences.
+   * @param {function} error Cordova native callback to recive errors.
+   * @return {Geofence[]}
+   */
+  onEnterGeofences: function (cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'onEnterGeofences', []);
+  },
+  /**
+   * Get notified about exiting geofences. Take into account the considerations described at onEnterGeofences
+   * @description Set the geofence listener to receive updates when you enter or exit one of them.
+   * @param {function} cb Cordova native callback to recive data. The data is an array of geofences.
+   * @param {function} error Cordova native callback to recive errors.
+   * @return {Geofence[]}
+   */
+  onExitGeofences: function (cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'onExitGeofences', []);
+  },
+  /**
+   * Download all the buildings for the current user.
+   * @description Download all the buildings for the current user
+   * @param {function} cb Cordova native callback to recive data.
+   * @param {function} error Cordova native callback to recive errors.
+   * @return {Building[]} buildings Array of buildings.
+   */
+  fetchBuildings: function (cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'fetchBuildings', []);
+  },
+  /**
+   * Download all the floors of a building.
+   * @description Download all the floors of a building
+   * @param {Building} building The building. Not null.
+   * @param {function} cb Cordova native callback to recive data.
+   * @param {function} error Cordova native callback to recive errors.
+   * @return {Floor[]} floors Array of floors.
+   */
+  fetchFloorsFromBuilding: function (building, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'fetchFloorsFromBuilding', [building]);
+  },
+  /**
+   * Download the indoor POIs of a building.
+   * @description Download the indoor POIs of a building
+   * @param {Building} building The building. Not null.
+   * @param {function} cb Cordova native callback to recive data.
+   * @param {function} error Cordova native callback to recive errors.
+   * @return {Poi[]} pois Array of POIs
+   */
+  fetchIndoorPOIsFromBuilding: function (building, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'fetchIndoorPOIsFromBuilding', [building]);
+  },
+  /**
+   * Download the outdoor POIs of a building.
+   * @description Download the outdoor POIs of a building
+   * @param {Building} building The building. Not null.
+   * @param {function} cb Cordova native callback to recive data.
+   * @param {function} error Cordova native callback to recive errors.
+   * @return {Poi[]} pois Array of POIs
+   */
+  fetchOutdoorPOIsFromBuilding: function (building, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'fetchOutdoorPOIsFromBuilding', [building]);
+  },
+  /**
+   * Download the events of a building.
+   * @description Download the events of a building
+   * @param {Building} building The building. Not null.
+   * @param {function} cb Cordova native callback to recive data.
+   * @param {function} error Cordova native callback to recive errors.
+   * @return {event[]} events The events of a building
+   */
+  fetchEventsFromBuilding: function (building, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'fetchEventsFromBuilding', [building]);
+  },
+  /**
+   * Get all POI categories, download and cache their icons asynchronously.
+   * @description Get all POI categories, download and cache their icons asynchronously. To get some of those icons from local storage @see {@link fetchPoiCategoryIconNormal(PoiCategory)} or {@link fetchPoiCategoryIconSelected(PoiCategory)}
+   * @param {function} cb Cordova native callback to recive data.
+   * @param {function} error Cordova native callback to recive errors.
+   * @return {PoiCategory[]} poiCategories The poiCategories array
+   */
+  fetchPoiCategories: function (cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'fetchPoiCategories');
+  },
+  /**
+   * Download the map image of a floor
+   * @description Download the map image of a floor
+   * @param {Floor} floor The floor. Not null.
+   * @param {function} cb Cordova native callback to recive data.
+   * @param {function} error Cordova native callback to recive errors.
+   * @return {bitmap} map The map image
+   */
+  fetchMapFromFloor: function (floor, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'fetchMapFromFloor', [floor]);
+  },
+  /**
+   * Get the normal category icon for a category.
+   * @description Get the normal category icon for a category
+   * @param {PoiCategory} category The category. Not null.
+   * @param {function} cb Cordova native callback to recive data.
+   * @param {function} error Cordova native callback to recive errors.
+   * @return {bitmap} icon The category icon
+   */
+  fetchPoiCategoryIconNormal: function (category, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'fetchPoiCategoryIconNormal', [category]);
+  },
+  /**
+   * Get the selected category icon for a category.
+   * @description Get the selected category icon for a category
+   * @param {PoiCategory} category The category. Not null.
+   * @param {function} cb Cordova native callback to recive data.
+   * @param {function} error Cordova native callback to recive errors.
+   * @return {bitmap} icon The category icon
+   */
+  fetchPoiCategoryIconSelected: function (category, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'fetchPoiCategoryIconSelected', [category]);
+  },
+  /**
+   * Download all the information of a building.
+   * @description Download the information of a building (floors, pois, basic information, ...)
+   * @param {Building} building The building identifier. Not null.
+   * @param {function} cb Cordova native callback to recive data.
+   * @param {function} error Cordova native callback to recive errors.
+   * @return {BuildingInfo} buildingInfo structure
+   */
+  fetchBuildingInfo: function (building, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'fetchBuildingInfo', [building]);
+  },
+  /**
+   * Download all the information of a building.
+   * @description Download the indoor POIs of a building
+   * @param {Int} buildingIdentifier The building identifier. Not null.
+   * @param {function} cb Cordova native callback to recive data.
+   * @param {function} error Cordova native callback to recive errors.
+   * @return {Building[]} pois Array of POIs
+   */
+  fetchGeofencesFromBuilding: function (building, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'fetchGeofencesFromBuilding', [building]);
+  },
+  /**
+   * Invalidate all the resources in the cache.
+   * @description Invalidate all the resources in the cache
+   * @param {function} cb Cordova native callback to recive data.
+   * @param {function} error Cordova native callback to recive errors.
+   * @return {void}
+   */
+  invalidateCache: function (cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'invalidateCache');
+  },
+  /**
+   * Calculates a route between two points.
+   * @description Calculates a route between two points.
+   * @param {DirectionsRequest} directionsRequest Request - non-null search parameters.
+   * @param {function} cb Cordova native callback to recive data.
+   * @param {function} error Cordova native callback to recive errors.
+   * @return {Route} route The route between provided points
+   */
+  requestDirections: function (directionsRequest, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'requestDirections', directionsRequest);
+  },
+  /**
+   * Set the navigation params, and the listener that receives the updated navigation progress.
+   * @description Set the navigation params, and the listener that receives the updated navigation progress. Can only exist one navigation with one listener at a time. If this method was previously invoked, but removeUpdates() wasn't, removeUpdates() is called internally.
+   * @param {NavigationRequest} navigationRequest Request non-null search parameters.
+   * @param {function} cb Cordova native callback to recive data. See {@link NavigationProgress}
+   * @param {function} error Cordova native callback to recive errors.
+   * @return {void}
+   */
+  requestNavigationUpdates: function (navigationRequest, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'requestNavigationUpdates', navigationRequest);
+  },
+  /**
+   * Informs NavigationManager object the change of the user's location.
+   * @description Informs NavigationManager object the change of the user's location.
+   * @param {Location} location New Location of the user. If null, nothing is done.
+   * @param {function} cb Cordova native callback to recive data.
+   * @param {function} error Cordova native callback to recive errors.
+   * @return {boolean} success True if there is a listener to which notify progress update. False if there isn't, so this method do nothing.
+   */
+  updateNavigationWithLocation: function (location, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'updateNavigationWithLocation', [location]);
+  },
+  /**
+   * Removes all location updates.
+   * @description Removes all location updates. This removes the internal state of the manager, including the listener provided in requestNavigationUpdates(NavigationRequest, NavigationListener), so it won't receive more progress updates.
+   * @param {function} cb Cordova native callback to recive data.
+   * @param {function} error Cordova native callback to recive errors.
+   * @return {boolean} success True if a listener was removed. False if there was no listener.
+   */
+  removeNavigationUpdates: function (cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'removeNavigationUpdates', []);
+  },
+  // Realtime
+
+  /**
+   * Set the realtime params and listener that receives realtime location updates
+   * @param {RealTimeRequest} request Request - non-null search parameters.
+   * @param {fuction} cb Cordova native callback to recive data.
+   * @param {function} error Cordova native callback to recive errors.
+   */
+  requestRealTimeUpdates: function (request, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'requestRealTimeUpdates', [request]);
+  },
+
+  /**
+   * Stops receiving updates in realtime about user location.
+   * @param {function} cb Cordova native callback to recive data.
+   * @param {function} error Cordova native callback to recive errors.
+   */
+  removeRealTimeUpdates: function(cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'removeRealTimeUpdates', []);
+  }
+};
+module.exports = Situm;

package/www/ios/situm.js

@@ -0,0 +1,99 @@
+var exec = require('cordova/exec');
+
+var PLUGIN_NAME = 'SitumPlugin';
+let _internalEventDelegate = undefined;
+
+var Situm = {
+  internalSetEventDelegate: function (callback) {
+    _internalEventDelegate = callback;
+  },
+  setApiKey: function (email, apiKey, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'setApiKey', [email, apiKey]);
+  },
+  setUseRemoteConfig: function (useRemoteConfig, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'setUseRemoteConfig', [useRemoteConfig]);
+  },
+  setUserPass: function (email, password, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'setUserPass', [email, password]);
+  },
+  setCacheMaxAge: function (cacheAge, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'setCacheMaxAge', [cacheAge]);
+  },
+  startPositioning: function (request, cb, error) {
+    let internalCallback = (res) => {
+      _internalEventDelegate('onLocationUpdate', res);
+      cb(res);
+    };
+    exec(internalCallback, error, PLUGIN_NAME, 'startPositioning', request);
+  },
+  stopPositioning: function (cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'stopPositioning', []);
+  },
+  onEnterGeofences: function (cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'onEnterGeofences', []);
+  },
+  onExitGeofences: function (cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'onExitGeofences', []);
+  },
+  fetchBuildings: function (cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'fetchBuildings', []);
+  },
+  fetchFloorsFromBuilding: function (building, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'fetchFloorsFromBuilding', [building]);
+  },
+  fetchIndoorPOIsFromBuilding: function (building, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'fetchIndoorPOIsFromBuilding', [building]);
+  },
+  fetchOutdoorPOIsFromBuilding: function (building, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'fetchOutdoorPOIsFromBuilding', [building]);
+  },
+  fetchEventsFromBuilding: function (building, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'fetchEventsFromBuilding', [building]);
+  },
+  fetchPoiCategories: function (cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'fetchPoiCategories');
+  },
+  fetchMapFromFloor: function (floor, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'fetchMapFromFloor', [floor]);
+  },
+  fetchPoiCategoryIconNormal: function (category, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'fetchPoiCategoryIconNormal', [category]);
+  },
+  fetchPoiCategoryIconSelected: function (category, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'fetchPoiCategoryIconSelected', [category]);
+  },
+  fetchBuildingInfo: function(building, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'fetchBuildingInfo', [building]);
+  },
+  fetchGeofencesFromBuilding: function (building, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'fetchGeofencesFromBuilding', [building]);
+  },
+  invalidateCache: function (cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'invalidateCache');
+  },
+  requestDirections: function (args, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'requestDirections', args);
+  },
+  requestNavigationUpdates: function (args, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'requestNavigationUpdates', args);
+  },
+  updateNavigationWithLocation: function (args, cb, error) {
+    if (!args) {
+      args = []
+    } else if (!Array.isArray(args)) {
+      args = [args]
+    }
+
+    exec(cb, error, PLUGIN_NAME, 'updateNavigationWithLocation', args);
+  },
+  removeNavigationUpdates: function (cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'removeNavigationUpdates', []);
+  },
+  requestRealTimeUpdates: function (request, cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'requestRealTimeUpdates', [request]);
+  },
+  removeRealTimeUpdates: function(cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'removeRealTimeUpdates', []);
+  }
+};
+module.exports = Situm;

package/www/map-view-controller.js

@@ -0,0 +1,223 @@
+const Situm = require("@situm/cordova.situm");
+
+/**
+ * @namespace MapViewControllerImpl
+ */
+class MapViewControllerImpl {
+  _onLoadCallback = undefined;
+  _buildings = undefined;
+  _mapView = undefined;
+  _isNavigating = false;
+
+  constructor() {
+    Situm.internalSetEventDelegate(this._handleSdkNativeEvents.bind(this));
+  }
+
+  _prepare(mapView) {
+    this._mapView = mapView;
+  }
+
+  _setOnLoadCallback(callback) {
+    this._onLoadCallback = callback;
+  }
+
+  _sendMessageToViewer(type, payload) {
+    let message = {
+      type: type,
+      payload: payload,
+    };
+    if (this._mapView && this._mapView.firstElementChild){
+      this._mapView.firstElementChild.contentWindow.postMessage(
+        message,
+        this._mapView._getViewerDomain()
+      )
+    };
+  }
+
+  // ==================================================
+  // SDK MESSAGES: 
+  // ==================================================
+
+  _handleSdkNativeEvents(eventName, payload) {
+    switch (eventName) {
+      case "onLocationUpdate":
+        // 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);
+        } else if (payload.statusName) {
+          this._handleOnLocationStatus(payload);
+        }
+        break;
+    }
+  }
+
+  _handleOnLocationUpdate(payload) {
+    this._sendMessageToViewer("location.update", payload);
+    if (this._isNavigating) {
+      Situm.updateNavigationWithLocation(
+        [payload],
+        () => {
+          // Do nothing.
+        },
+        () => {
+          console.error("Error at updateNavigationWithLocation")
+        }
+      );
+    }
+  }
+
+  _handleOnLocationStatus(payload) {
+    this._sendMessageToViewer("location.update_status", {status: payload.statusName});
+  }
+
+  // ==================================================
+  // MAP-VIEWER MESSAGES: 
+  // ==================================================
+
+  _handleMapViewMessages(m) {
+    switch (m.type) {
+      case "app.map_is_ready":
+        if (this._onLoadCallback && typeof this._onLoadCallback === 'function') {
+          this._onLoadCallback(this);
+          console.debug('Map is ready!');
+        }
+        break;
+      case "cartography.poi_selected":
+        console.debug(`poi (${m.payload.identifier}) was selected`);
+        break;
+      case "directions.requested":
+        this._onDirectionsRequested(m.payload);
+        break;
+      case "navigation.requested":
+        this._onNavigationRequested(m.payload);
+        break;
+      case "navigation.stopped":
+        this._onNavigationCancel();
+        break;
+      default:
+        console.debug("Got unmanaged message: ", m);
+        break;
+    }
+  }
+
+  // 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);
+      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);
+          callback(building);
+        },
+        (err) => {
+          callback(undefined);
+        }
+      );
+    }
+  }
+
+  // DIRECTIONS:
+
+  _onDirectionsRequested(payload) {
+    let directionsRequest = payload.directionsRequest;
+    let mapViewerData = {
+      identifier: payload.identifier,
+      originIdentifier: payload.originIdentifier,
+      destinationIdentifier: payload.destinationIdentifier,
+      type: directionsRequest.accessibilityMode,
+    }
+    this._ensureBuilding(payload.buildingIdentifier, (building) => {
+      if (building){
+        Situm.requestDirections(
+          [building, directionsRequest.from, directionsRequest.to, directionsRequest],
+          (route) => {
+            this._sendMessageToViewer("directions.update", { ...route, ...mapViewerData });
+          },
+          (error) => {
+            this._sendMessageToViewer("directions.update", { error: -1, identifier: mapViewerData.identifier });
+          }
+        );
+      } else {
+        this._sendMessageToViewer("directions.update", { error: -1, identifier: payload.identifier });
+      }
+    });
+  }
+
+  // NAVIGATION
+
+  _onNavigationRequested(payload) {
+    let directionsRequest = payload.directionsRequest;
+    let mapViewerData = {
+      identifier: payload.identifier,
+      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],
+        (route) => {
+          this._isNavigating = true;
+          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".
+                this._sendMessageToViewer("navigation.update", progress);
+              } else if (progress.type == "destinationReached") {
+                this._sendMessageToViewer("navigation.update", {type: "DESTINATION_REACHED"});
+                this._isNavigating = false;
+              } else if (progress.type == "userOutsideRoute") {
+                this._sendMessageToViewer("navigation.update", {type: "OUT_OF_ROUTE"});
+              }
+            },
+            (error) => {
+              this._sendMessageToViewer("directions.update", { error: -1, identifier: mapViewerData.identifier });
+              this._isNavigating = false;
+            });
+        },
+        (error) => {
+          this._sendMessageToViewer("directions.update", { error: -1, identifier: mapViewerData.identifier });
+          this._isNavigating = false;
+        }
+      );
+    });
+  }
+
+  _onNavigationCancel() {
+    this._isNavigating = false;
+    Situm.removeNavigationUpdates(
+      () => {
+        // Do nothing.
+      },
+      () => {
+        console.error("Error removing navigation updates.");
+      }
+    );
+  }
+
+  // ==================================================
+  // ACTIONS
+  // ==================================================
+
+  /**
+   * Select a {@link POI} of a building.
+   * @param {number} identifier The unique identifier of the resource.
+   * */
+  selectPoi(identifier) {
+    this._sendMessageToViewer("cartography.select_poi", { identifier: identifier });
+  }
+
+}
+
+let MapViewController = new MapViewControllerImpl();
+module.exports = MapViewController;