@situm/cordova 3.17.4 → 3.17.6

package/docs/JSDoc/map-view-controller.js.html

@@ -40,7 +40,7 @@
         <ul></ul>
     </div>
     
-    <div class="lnb-api hidden"><h3>Namespaces</h3><ul><li><a href="MapView.html">MapView</a><button type="button" class="hidden toggle-subnav btn btn-link">  <span class="glyphicon glyphicon-plus"></span></button><div class="hidden" id="MapView_sub"><div class="member-type">Methods</div><ul class="inner"><li><a href="MapView.html#.onLoad">onLoad</a></li></ul></div></li><li><a href="MapViewController.html">MapViewController</a><button type="button" class="hidden toggle-subnav btn btn-link">  <span class="glyphicon glyphicon-plus"></span></button><div class="hidden" id="MapViewController_sub"><div class="member-type">Methods</div><ul class="inner"><li><a href="MapViewController.html#.navigateToPoi">navigateToPoi</a></li><li><a href="MapViewController.html#.onPoiDeselected">onPoiDeselected</a></li><li><a href="MapViewController.html#.onPoiSelected">onPoiSelected</a></li><li><a href="MapViewController.html#.selectPoi">selectPoi</a></li><li><a href="MapViewController.html#.setDirectionsOptions">setDirectionsOptions</a></li><li><a href="MapViewController.html#.setLanguage">setLanguage</a></li></ul></div></li><li><a href="Situm.html">Situm</a><button type="button" class="hidden toggle-subnav btn btn-link">  <span class="glyphicon glyphicon-plus"></span></button><div class="hidden" id="Situm_sub"><div class="member-type">Methods</div><ul class="inner"><li><a href="Situm.html#.configureUserHelper">configureUserHelper</a></li><li><a href="Situm.html#.disableUserHelper">disableUserHelper</a></li><li><a href="Situm.html#.enableUserHelper">enableUserHelper</a></li><li><a href="Situm.html#.fetchBuildingInfo">fetchBuildingInfo</a></li><li><a href="Situm.html#.fetchBuildings">fetchBuildings</a></li><li><a href="Situm.html#.fetchEventsFromBuilding">fetchEventsFromBuilding</a></li><li><a href="Situm.html#.fetchFloorsFromBuilding">fetchFloorsFromBuilding</a></li><li><a href="Situm.html#.fetchGeofencesFromBuilding">fetchGeofencesFromBuilding</a></li><li><a href="Situm.html#.fetchIndoorPOIsFromBuilding">fetchIndoorPOIsFromBuilding</a></li><li><a href="Situm.html#.fetchMapFromFloor">fetchMapFromFloor</a></li><li><a href="Situm.html#.fetchOutdoorPOIsFromBuilding">fetchOutdoorPOIsFromBuilding</a></li><li><a href="Situm.html#.fetchPoiCategories">fetchPoiCategories</a></li><li><a href="Situm.html#.fetchPoiCategoryIconNormal">fetchPoiCategoryIconNormal</a></li><li><a href="Situm.html#.fetchPoiCategoryIconSelected">fetchPoiCategoryIconSelected</a></li><li><a href="Situm.html#.getDeviceId">getDeviceId</a></li><li><a href="Situm.html#.internalSetEventDelegate">internalSetEventDelegate</a></li><li><a href="Situm.html#.invalidateCache">invalidateCache</a></li><li><a href="Situm.html#.onEnterGeofences">onEnterGeofences</a></li><li><a href="Situm.html#.onExitGeofences">onExitGeofences</a></li><li><a href="Situm.html#.onLocationError">onLocationError</a></li><li><a href="Situm.html#.onLocationStatus">onLocationStatus</a></li><li><a href="Situm.html#.onLocationUpdate">onLocationUpdate</a></li><li><a href="Situm.html#.removeNavigationUpdates">removeNavigationUpdates</a></li><li><a href="Situm.html#.removeRealTimeUpdates">removeRealTimeUpdates</a></li><li><a href="Situm.html#.removeUpdates">removeUpdates</a></li><li><a href="Situm.html#.requestDirections">requestDirections</a></li><li><a href="Situm.html#.requestLocationUpdates">requestLocationUpdates</a></li><li><a href="Situm.html#.requestNavigationUpdates">requestNavigationUpdates</a></li><li><a href="Situm.html#.requestRealTimeUpdates">requestRealTimeUpdates</a></li><li><a href="Situm.html#.setApiKey">setApiKey</a></li><li><a href="Situm.html#.setCacheMaxAge">setCacheMaxAge</a></li><li><a href="Situm.html#.setUserPass">setUserPass</a></li><li><a href="Situm.html#.startPositioning">startPositioning</a></li><li><a href="Situm.html#.stopPositioning">stopPositioning</a></li><li><a href="Situm.html#.updateNavigationState">updateNavigationState</a></li><li><a href="Situm.html#.updateNavigationWithLocation">updateNavigationWithLocation</a></li></ul></div></li></ul></div><div class="lnb-api hidden"><h3>Global</h3><ul><li><a href="global.html#Angle">Angle</a></li><li><a href="global.html#BeaconFilter">BeaconFilter</a></li><li><a href="global.html#Bounds">Bounds</a></li><li><a href="global.html#Building">Building</a></li><li><a href="global.html#BuildingInfo">BuildingInfo</a></li><li><a href="global.html#CartesianCoordinate">CartesianCoordinate</a></li><li><a href="global.html#Circle">Circle</a></li><li><a href="global.html#Coordinate">Coordinate</a></li><li><a href="global.html#Dimensions">Dimensions</a></li><li><a href="global.html#DirectionsOptions">DirectionsOptions</a></li><li><a href="global.html#DirectionsRequest">DirectionsRequest</a></li><li><a href="global.html#ExternalNavigation">ExternalNavigation</a></li><li><a href="global.html#Floor">Floor</a></li><li><a href="global.html#ForegroundServiceNotificationOptions">ForegroundServiceNotificationOptions</a></li><li><a href="global.html#Geofence">Geofence</a></li><li><a href="global.html#Indication">Indication</a></li><li><a href="global.html#Location">Location</a></li><li><a href="global.html#LocationOptions">LocationOptions</a></li><li><a href="global.html#LocationRequest">LocationRequest</a></li><li><a href="global.html#LocationStatus">LocationStatus</a></li><li class="hidden"><a href="global.html#MapViewDirectionsOptions">MapViewDirectionsOptions</a></li><li><a href="global.html#NavigationProgress">NavigationProgress</a></li><li><a href="global.html#NavigationRequest">NavigationRequest</a></li><li class="hidden"><a href="global.html#OnLocationErrorCallback">OnLocationErrorCallback</a></li><li class="hidden"><a href="global.html#OnLocationStatusCallback">OnLocationStatusCallback</a></li><li class="hidden"><a href="global.html#OnLocationUpdateCallback">OnLocationUpdateCallback</a></li><li><a href="global.html#OutdoorLocationOptions">OutdoorLocationOptions</a></li><li><a href="global.html#POI">POI</a></li><li><a href="global.html#PoiCategory">PoiCategory</a></li><li><a href="global.html#PoiDeselectedResult">PoiDeselectedResult</a></li><li><a href="global.html#Point">Point</a></li><li><a href="global.html#PoiSelectedResult">PoiSelectedResult</a></li><li><a href="global.html#RealTimeData">RealTimeData</a></li><li><a href="global.html#RealTimeRequest">RealTimeRequest</a></li><li><a href="global.html#Route">Route</a></li><li><a href="global.html#RouteSegment">RouteSegment</a></li><li><a href="global.html#RouteStep">RouteStep</a></li><li><a href="global.html#SitumConversionArea">SitumConversionArea</a></li><li><a href="global.html#SitumEvent">SitumEvent</a></li><li><a href="global.html#UserHelperColorScheme">UserHelperColorScheme</a></li><li><a href="global.html#UserHelperOptions">UserHelperOptions</a></li></ul></div>
+    <div class="lnb-api hidden"><h3>Namespaces</h3><ul><li><a href="MapView.html">MapView</a><button type="button" class="hidden toggle-subnav btn btn-link">  <span class="glyphicon glyphicon-plus"></span></button><div class="hidden" id="MapView_sub"><div class="member-type">Methods</div><ul class="inner"><li><a href="MapView.html#.onLoad">onLoad</a></li></ul></div></li><li><a href="MapViewController.html">MapViewController</a><button type="button" class="hidden toggle-subnav btn btn-link">  <span class="glyphicon glyphicon-plus"></span></button><div class="hidden" id="MapViewController_sub"><div class="member-type">Methods</div><ul class="inner"><li><a href="MapViewController.html#.navigateToPoi">navigateToPoi</a></li><li><a href="MapViewController.html#.onPoiDeselected">onPoiDeselected</a></li><li><a href="MapViewController.html#.onPoiSelected">onPoiSelected</a></li><li><a href="MapViewController.html#.selectPoi">selectPoi</a></li><li><a href="MapViewController.html#.setDirectionsOptions">setDirectionsOptions</a></li><li><a href="MapViewController.html#.setLanguage">setLanguage</a></li></ul></div></li><li><a href="Situm.html">Situm</a><button type="button" class="hidden toggle-subnav btn btn-link">  <span class="glyphicon glyphicon-plus"></span></button><div class="hidden" id="Situm_sub"><div class="member-type">Methods</div><ul class="inner"><li><a href="Situm.html#.configureUserHelper">configureUserHelper</a></li><li><a href="Situm.html#.disableUserHelper">disableUserHelper</a></li><li><a href="Situm.html#.enableUserHelper">enableUserHelper</a></li><li><a href="Situm.html#.fetchBuildingInfo">fetchBuildingInfo</a></li><li><a href="Situm.html#.fetchBuildings">fetchBuildings</a></li><li><a href="Situm.html#.fetchEventsFromBuilding">fetchEventsFromBuilding</a></li><li><a href="Situm.html#.fetchFloorsFromBuilding">fetchFloorsFromBuilding</a></li><li><a href="Situm.html#.fetchGeofencesFromBuilding">fetchGeofencesFromBuilding</a></li><li><a href="Situm.html#.fetchIndoorPOIsFromBuilding">fetchIndoorPOIsFromBuilding</a></li><li><a href="Situm.html#.fetchMapFromFloor">fetchMapFromFloor</a></li><li><a href="Situm.html#.fetchOutdoorPOIsFromBuilding">fetchOutdoorPOIsFromBuilding</a></li><li><a href="Situm.html#.fetchPoiCategories">fetchPoiCategories</a></li><li><a href="Situm.html#.fetchPoiCategoryIconNormal">fetchPoiCategoryIconNormal</a></li><li><a href="Situm.html#.fetchPoiCategoryIconSelected">fetchPoiCategoryIconSelected</a></li><li><a href="Situm.html#.getDeviceId">getDeviceId</a></li><li><a href="Situm.html#.internalHandleMapViewMessage">internalHandleMapViewMessage</a></li><li><a href="Situm.html#.internalSetEventDelegate">internalSetEventDelegate</a></li><li><a href="Situm.html#.invalidateCache">invalidateCache</a></li><li><a href="Situm.html#.onEnterGeofences">onEnterGeofences</a></li><li><a href="Situm.html#.onExitGeofences">onExitGeofences</a></li><li><a href="Situm.html#.onLocationError">onLocationError</a></li><li><a href="Situm.html#.onLocationStatus">onLocationStatus</a></li><li><a href="Situm.html#.onLocationUpdate">onLocationUpdate</a></li><li><a href="Situm.html#.removeNavigationUpdates">removeNavigationUpdates</a></li><li><a href="Situm.html#.removeRealTimeUpdates">removeRealTimeUpdates</a></li><li><a href="Situm.html#.removeUpdates">removeUpdates</a></li><li><a href="Situm.html#.requestDirections">requestDirections</a></li><li><a href="Situm.html#.requestLocationUpdates">requestLocationUpdates</a></li><li><a href="Situm.html#.requestNavigationUpdates">requestNavigationUpdates</a></li><li><a href="Situm.html#.requestRealTimeUpdates">requestRealTimeUpdates</a></li><li><a href="Situm.html#.setApiKey">setApiKey</a></li><li><a href="Situm.html#.setCacheMaxAge">setCacheMaxAge</a></li><li><a href="Situm.html#.setToken">setToken</a></li><li><a href="Situm.html#.setUserPass">setUserPass</a></li><li><a href="Situm.html#.startPositioning">startPositioning</a></li><li><a href="Situm.html#.stopPositioning">stopPositioning</a></li><li><a href="Situm.html#.updateNavigationState">updateNavigationState</a></li><li><a href="Situm.html#.updateNavigationWithLocation">updateNavigationWithLocation</a></li></ul></div></li></ul></div><div class="lnb-api hidden"><h3>Global</h3><ul><li><a href="global.html#Angle">Angle</a></li><li><a href="global.html#BeaconFilter">BeaconFilter</a></li><li><a href="global.html#Bounds">Bounds</a></li><li><a href="global.html#Building">Building</a></li><li><a href="global.html#BuildingInfo">BuildingInfo</a></li><li><a href="global.html#CartesianCoordinate">CartesianCoordinate</a></li><li><a href="global.html#Circle">Circle</a></li><li><a href="global.html#Coordinate">Coordinate</a></li><li><a href="global.html#Dimensions">Dimensions</a></li><li><a href="global.html#DirectionsOptions">DirectionsOptions</a></li><li><a href="global.html#DirectionsRequest">DirectionsRequest</a></li><li><a href="global.html#ExternalNavigation">ExternalNavigation</a></li><li><a href="global.html#Floor">Floor</a></li><li><a href="global.html#ForegroundServiceNotificationOptions">ForegroundServiceNotificationOptions</a></li><li><a href="global.html#Geofence">Geofence</a></li><li><a href="global.html#Indication">Indication</a></li><li><a href="global.html#Location">Location</a></li><li><a href="global.html#LocationOptions">LocationOptions</a></li><li><a href="global.html#LocationRequest">LocationRequest</a></li><li><a href="global.html#LocationStatus">LocationStatus</a></li><li class="hidden"><a href="global.html#MapViewDirectionsOptions">MapViewDirectionsOptions</a></li><li><a href="global.html#NavigationProgress">NavigationProgress</a></li><li><a href="global.html#NavigationRequest">NavigationRequest</a></li><li class="hidden"><a href="global.html#OnLocationErrorCallback">OnLocationErrorCallback</a></li><li class="hidden"><a href="global.html#OnLocationStatusCallback">OnLocationStatusCallback</a></li><li class="hidden"><a href="global.html#OnLocationUpdateCallback">OnLocationUpdateCallback</a></li><li><a href="global.html#OutdoorLocationOptions">OutdoorLocationOptions</a></li><li><a href="global.html#POI">POI</a></li><li><a href="global.html#PoiCategory">PoiCategory</a></li><li><a href="global.html#PoiDeselectedResult">PoiDeselectedResult</a></li><li><a href="global.html#Point">Point</a></li><li><a href="global.html#PoiSelectedResult">PoiSelectedResult</a></li><li><a href="global.html#RealTimeData">RealTimeData</a></li><li><a href="global.html#RealTimeRequest">RealTimeRequest</a></li><li><a href="global.html#Route">Route</a></li><li><a href="global.html#RouteSegment">RouteSegment</a></li><li><a href="global.html#RouteStep">RouteStep</a></li><li><a href="global.html#SitumConversionArea">SitumConversionArea</a></li><li><a href="global.html#SitumEvent">SitumEvent</a></li><li><a href="global.html#UserHelperColorScheme">UserHelperColorScheme</a></li><li><a href="global.html#UserHelperOptions">UserHelperOptions</a></li></ul></div>
 </nav>
 <div id="resizer"></div>
 
@@ -103,34 +103,23 @@ class MapViewControllerImpl {
   _onLoadCallback = undefined;
   _onPoiSelectedCallback = undefined;
   _onPoiDeselectedCallback = undefined;
-  _buildings = undefined;
   _mapView = undefined;
-  _isNavigating = false;
-  _navigationType = "";
+  _isWaitingForAuth = false;
 
   constructor() {
     Situm.internalSetEventDelegate(this._handleSdkNativeEvents.bind(this));
+    Situm.internalSetTokenCallback(this._handleTokenSet.bind(this));
   }
 
   _prepare(mapView) {
     this._mapView = mapView;
-    let useViewerNavigation = mapView.getAttribute('use-viewer-navigation')
-      ? mapView.getAttribute('use-viewer-navigation')
-      : null;
-    if (useViewerNavigation != null) {
-      this._setNavigationType(useViewerNavigation);
-    }
-  }
 
-  _setNavigationType(useViewerNavigation) {
-    if (useViewerNavigation) {
-      if (useViewerNavigation === "true") {
-        this._navigationType = 'webAssembly';
-      } else {
-        this._navigationType = 'sdk';
-      }
+    if (mapView.hasAttribute('use-viewer-navigation')) {
+      console.warn(
+        'Situm> MapView> [!] The "use-viewer-navigation" attribute is deprecated and ignored. ' +
+        'The MapView always uses its own routing and navigation library.'
+      );
     }
-     
   }
 
   _setOnLoadCallback(callback) {
@@ -180,17 +169,6 @@ class MapViewControllerImpl {
 
   _handleOnLocationUpdate(payload) {
     this._sendMessageToViewer('location.update', payload);
-    if (this._isNavigating) {
-      Situm.updateNavigationWithLocation(
-        [payload],
-        () => {
-          // Do nothing.
-        },
-        () => {
-          console.error('Error at updateNavigationWithLocation');
-        }
-      );
-    }
   }
 
   _handleOnLocationStatus(payload) {
@@ -206,16 +184,10 @@ class MapViewControllerImpl {
   _handleMapViewMessages(m) {
     switch (m.type) {
       case 'app.map_is_ready':
-        if (
-          this._onLoadCallback &amp;&amp;
-          typeof this._onLoadCallback === 'function'
-        ) {
-          this._onLoadCallback(this);
-          console.debug('Map is ready!');
-        }
-        if (this._navigationType) {
-          this._sendNavigationConfig(this._navigationType);
-        }
+        this._handleMapIsReady();
+        break;
+      case 'app.ready_for_auth':
+        this._handleReadyForAuth();
         break;
       case 'cartography.poi_selected':
         console.debug(`poi (${m.payload.identifier}) was selected`);
@@ -236,15 +208,6 @@ class MapViewControllerImpl {
         };
         this._onPoiDeselectedCallback(poiDeselectedResult);
         break;
-      case 'directions.requested':
-        this._onDirectionsRequested(m.payload);
-        break;
-      case 'navigation.requested':
-        this._onNavigationRequested(m.payload);
-        break;
-      case 'navigation.stopped':
-        this._onNavigationCancel();
-        break;
       case 'viewer.navigation.started':
         this._onViewerNavigationStarted(m.payload);
         break;
@@ -254,191 +217,83 @@ class MapViewControllerImpl {
       case 'viewer.navigation.stopped':
         this._onViewerNavigationStopped(m.payload);
         break;
+      case 'ui.speak_aloud_text': 
+      // case ...: Add here any other message that must be delegated to the native side.
+        this._internalHandleMapViewMessage(m.type, m.payload);
+        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);
-        }
-      );
+  _handleMapIsReady() {
+    if (this._onLoadCallback &amp;&amp;
+        typeof this._onLoadCallback === 'function') {
+      this._onLoadCallback(this);
+      console.debug('Map is ready!');
     }
+    this._sendMessageToViewer('app.set_config_item', [
+      {key: "internal.tts.engine", value: "mobile"},
+      // Any other config item here...
+    ]);
   }
 
-  // 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
-        });
-      }
-    });
+  _handleReadyForAuth() {
+    this._isWaitingForAuth = true;
+    this._sendTokenToViewer(Situm.internalGetToken());
   }
 
-  // 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;
-        }
-      );
-    });
+  _handleTokenSet(token) {
+    if (this._isWaitingForAuth) {
+      this._sendTokenToViewer(token);
+    }
   }
 
-  _onNavigationCancel() {
-    this._isNavigating = false;
-    Situm.removeNavigationUpdates(
-      () => {
-        // Do nothing.
-      },
-      () => {
-        console.error('Error removing navigation updates.');
-      }
+  _sendTokenToViewer(token) {
+    if (!token) {
+      return;
+    }
+    this._sendMessageToViewer('app.set_auth', 
+      {jwt: token}
     );
   }
 
+  // NAVIGATION
+
   _onViewerNavigationStarted(webPayload) {
-    if (this._isNavigating) {
-      return;
-    }
-    this._isNavigating = true;
     let externalNavigation = { messageType: "NavigationStarted", payload: webPayload};
     Situm.updateNavigationState(externalNavigation,  () => {}, () => {});
   }
 
   _onViewerNavigationUpdated(webPayload) {
-    if (!this._isNavigating) {
-      return;
-    }
-    if (webPayload.type == "PROGRESS") {
-      let externalNavigation = { messageType: "NavigationUpdated", payload: webPayload};
-      Situm.updateNavigationState(externalNavigation,  () => {}, () => {});
-    } else if (webPayload.type == "DESTINATION_REACHED") {
-      let externalNavigation = { messageType: "DestinationReached", payload: webPayload};
-      Situm.updateNavigationState(externalNavigation,  () => {}, () => {});
-      this._isNavigating = false;
-    } else if (webPayload.type == "OUT_OF_ROUTE") {
-      let externalNavigation = { messageType: "OutsideRoute", payload: webPayload};
-      Situm.updateNavigationState(externalNavigation,  () => {}, () => {});
-      this._isNavigating = false;
+    let messageType;
+    switch (webPayload.type) {
+      case 'PROGRESS':
+        messageType = 'NavigationUpdated';
+        break;
+      case 'DESTINATION_REACHED':
+        messageType = 'DestinationReached';
+        break;
+      case 'OUT_OF_ROUTE':
+        messageType = 'OutsideRoute';
+        break;
+      default:
+        return;
     }
-    
+
+    const externalNavigation = { messageType, payload: webPayload };
+    Situm.updateNavigationState(externalNavigation, () => { }, () => { });
   }
 
   _onViewerNavigationStopped(webPayload) {
-    if (!this._isNavigating) {
-      return;
-    }
-    this._isNavigating = false;
     let externalNavigation = { messageType: "NavigationCancelled", payload: webPayload};
     Situm.updateNavigationState(externalNavigation,  () => {}, () => {});
   }
 
-
+  _internalHandleMapViewMessage(message, webPayload) {
+    Situm.internalHandleMapViewMessage(message, webPayload);
+  }
 
   // ==================================================
   // ACTIONS
@@ -458,10 +313,6 @@ class MapViewControllerImpl {
     });
   }
 
-  _sendNavigationConfig(navigationType) {
-    this._sendMessageToViewer('app.set_config_item', [{key:'internal.navigationLibrary',value:navigationType}]);
-  }
-
   /**
    * Allows you to navigate to a {@link POI} programmatically in your venue. This will cause the {@link MapView} to start navigation mode displaying the route between the user's location and the POI specified by parameters.
    *

package/docs/JSDoc/map-view.js.html

@@ -40,7 +40,7 @@
         <ul></ul>
     </div>
     
-    <div class="lnb-api hidden"><h3>Namespaces</h3><ul><li><a href="MapView.html">MapView</a><button type="button" class="hidden toggle-subnav btn btn-link">  <span class="glyphicon glyphicon-plus"></span></button><div class="hidden" id="MapView_sub"><div class="member-type">Methods</div><ul class="inner"><li><a href="MapView.html#.onLoad">onLoad</a></li></ul></div></li><li><a href="MapViewController.html">MapViewController</a><button type="button" class="hidden toggle-subnav btn btn-link">  <span class="glyphicon glyphicon-plus"></span></button><div class="hidden" id="MapViewController_sub"><div class="member-type">Methods</div><ul class="inner"><li><a href="MapViewController.html#.navigateToPoi">navigateToPoi</a></li><li><a href="MapViewController.html#.onPoiDeselected">onPoiDeselected</a></li><li><a href="MapViewController.html#.onPoiSelected">onPoiSelected</a></li><li><a href="MapViewController.html#.selectPoi">selectPoi</a></li><li><a href="MapViewController.html#.setDirectionsOptions">setDirectionsOptions</a></li><li><a href="MapViewController.html#.setLanguage">setLanguage</a></li></ul></div></li><li><a href="Situm.html">Situm</a><button type="button" class="hidden toggle-subnav btn btn-link">  <span class="glyphicon glyphicon-plus"></span></button><div class="hidden" id="Situm_sub"><div class="member-type">Methods</div><ul class="inner"><li><a href="Situm.html#.configureUserHelper">configureUserHelper</a></li><li><a href="Situm.html#.disableUserHelper">disableUserHelper</a></li><li><a href="Situm.html#.enableUserHelper">enableUserHelper</a></li><li><a href="Situm.html#.fetchBuildingInfo">fetchBuildingInfo</a></li><li><a href="Situm.html#.fetchBuildings">fetchBuildings</a></li><li><a href="Situm.html#.fetchEventsFromBuilding">fetchEventsFromBuilding</a></li><li><a href="Situm.html#.fetchFloorsFromBuilding">fetchFloorsFromBuilding</a></li><li><a href="Situm.html#.fetchGeofencesFromBuilding">fetchGeofencesFromBuilding</a></li><li><a href="Situm.html#.fetchIndoorPOIsFromBuilding">fetchIndoorPOIsFromBuilding</a></li><li><a href="Situm.html#.fetchMapFromFloor">fetchMapFromFloor</a></li><li><a href="Situm.html#.fetchOutdoorPOIsFromBuilding">fetchOutdoorPOIsFromBuilding</a></li><li><a href="Situm.html#.fetchPoiCategories">fetchPoiCategories</a></li><li><a href="Situm.html#.fetchPoiCategoryIconNormal">fetchPoiCategoryIconNormal</a></li><li><a href="Situm.html#.fetchPoiCategoryIconSelected">fetchPoiCategoryIconSelected</a></li><li><a href="Situm.html#.getDeviceId">getDeviceId</a></li><li><a href="Situm.html#.internalSetEventDelegate">internalSetEventDelegate</a></li><li><a href="Situm.html#.invalidateCache">invalidateCache</a></li><li><a href="Situm.html#.onEnterGeofences">onEnterGeofences</a></li><li><a href="Situm.html#.onExitGeofences">onExitGeofences</a></li><li><a href="Situm.html#.onLocationError">onLocationError</a></li><li><a href="Situm.html#.onLocationStatus">onLocationStatus</a></li><li><a href="Situm.html#.onLocationUpdate">onLocationUpdate</a></li><li><a href="Situm.html#.removeNavigationUpdates">removeNavigationUpdates</a></li><li><a href="Situm.html#.removeRealTimeUpdates">removeRealTimeUpdates</a></li><li><a href="Situm.html#.removeUpdates">removeUpdates</a></li><li><a href="Situm.html#.requestDirections">requestDirections</a></li><li><a href="Situm.html#.requestLocationUpdates">requestLocationUpdates</a></li><li><a href="Situm.html#.requestNavigationUpdates">requestNavigationUpdates</a></li><li><a href="Situm.html#.requestRealTimeUpdates">requestRealTimeUpdates</a></li><li><a href="Situm.html#.setApiKey">setApiKey</a></li><li><a href="Situm.html#.setCacheMaxAge">setCacheMaxAge</a></li><li><a href="Situm.html#.setUserPass">setUserPass</a></li><li><a href="Situm.html#.startPositioning">startPositioning</a></li><li><a href="Situm.html#.stopPositioning">stopPositioning</a></li><li><a href="Situm.html#.updateNavigationState">updateNavigationState</a></li><li><a href="Situm.html#.updateNavigationWithLocation">updateNavigationWithLocation</a></li></ul></div></li></ul></div><div class="lnb-api hidden"><h3>Global</h3><ul><li><a href="global.html#Angle">Angle</a></li><li><a href="global.html#BeaconFilter">BeaconFilter</a></li><li><a href="global.html#Bounds">Bounds</a></li><li><a href="global.html#Building">Building</a></li><li><a href="global.html#BuildingInfo">BuildingInfo</a></li><li><a href="global.html#CartesianCoordinate">CartesianCoordinate</a></li><li><a href="global.html#Circle">Circle</a></li><li><a href="global.html#Coordinate">Coordinate</a></li><li><a href="global.html#Dimensions">Dimensions</a></li><li><a href="global.html#DirectionsOptions">DirectionsOptions</a></li><li><a href="global.html#DirectionsRequest">DirectionsRequest</a></li><li><a href="global.html#ExternalNavigation">ExternalNavigation</a></li><li><a href="global.html#Floor">Floor</a></li><li><a href="global.html#ForegroundServiceNotificationOptions">ForegroundServiceNotificationOptions</a></li><li><a href="global.html#Geofence">Geofence</a></li><li><a href="global.html#Indication">Indication</a></li><li><a href="global.html#Location">Location</a></li><li><a href="global.html#LocationOptions">LocationOptions</a></li><li><a href="global.html#LocationRequest">LocationRequest</a></li><li><a href="global.html#LocationStatus">LocationStatus</a></li><li class="hidden"><a href="global.html#MapViewDirectionsOptions">MapViewDirectionsOptions</a></li><li><a href="global.html#NavigationProgress">NavigationProgress</a></li><li><a href="global.html#NavigationRequest">NavigationRequest</a></li><li class="hidden"><a href="global.html#OnLocationErrorCallback">OnLocationErrorCallback</a></li><li class="hidden"><a href="global.html#OnLocationStatusCallback">OnLocationStatusCallback</a></li><li class="hidden"><a href="global.html#OnLocationUpdateCallback">OnLocationUpdateCallback</a></li><li><a href="global.html#OutdoorLocationOptions">OutdoorLocationOptions</a></li><li><a href="global.html#POI">POI</a></li><li><a href="global.html#PoiCategory">PoiCategory</a></li><li><a href="global.html#PoiDeselectedResult">PoiDeselectedResult</a></li><li><a href="global.html#Point">Point</a></li><li><a href="global.html#PoiSelectedResult">PoiSelectedResult</a></li><li><a href="global.html#RealTimeData">RealTimeData</a></li><li><a href="global.html#RealTimeRequest">RealTimeRequest</a></li><li><a href="global.html#Route">Route</a></li><li><a href="global.html#RouteSegment">RouteSegment</a></li><li><a href="global.html#RouteStep">RouteStep</a></li><li><a href="global.html#SitumConversionArea">SitumConversionArea</a></li><li><a href="global.html#SitumEvent">SitumEvent</a></li><li><a href="global.html#UserHelperColorScheme">UserHelperColorScheme</a></li><li><a href="global.html#UserHelperOptions">UserHelperOptions</a></li></ul></div>
+    <div class="lnb-api hidden"><h3>Namespaces</h3><ul><li><a href="MapView.html">MapView</a><button type="button" class="hidden toggle-subnav btn btn-link">  <span class="glyphicon glyphicon-plus"></span></button><div class="hidden" id="MapView_sub"><div class="member-type">Methods</div><ul class="inner"><li><a href="MapView.html#.onLoad">onLoad</a></li></ul></div></li><li><a href="MapViewController.html">MapViewController</a><button type="button" class="hidden toggle-subnav btn btn-link">  <span class="glyphicon glyphicon-plus"></span></button><div class="hidden" id="MapViewController_sub"><div class="member-type">Methods</div><ul class="inner"><li><a href="MapViewController.html#.navigateToPoi">navigateToPoi</a></li><li><a href="MapViewController.html#.onPoiDeselected">onPoiDeselected</a></li><li><a href="MapViewController.html#.onPoiSelected">onPoiSelected</a></li><li><a href="MapViewController.html#.selectPoi">selectPoi</a></li><li><a href="MapViewController.html#.setDirectionsOptions">setDirectionsOptions</a></li><li><a href="MapViewController.html#.setLanguage">setLanguage</a></li></ul></div></li><li><a href="Situm.html">Situm</a><button type="button" class="hidden toggle-subnav btn btn-link">  <span class="glyphicon glyphicon-plus"></span></button><div class="hidden" id="Situm_sub"><div class="member-type">Methods</div><ul class="inner"><li><a href="Situm.html#.configureUserHelper">configureUserHelper</a></li><li><a href="Situm.html#.disableUserHelper">disableUserHelper</a></li><li><a href="Situm.html#.enableUserHelper">enableUserHelper</a></li><li><a href="Situm.html#.fetchBuildingInfo">fetchBuildingInfo</a></li><li><a href="Situm.html#.fetchBuildings">fetchBuildings</a></li><li><a href="Situm.html#.fetchEventsFromBuilding">fetchEventsFromBuilding</a></li><li><a href="Situm.html#.fetchFloorsFromBuilding">fetchFloorsFromBuilding</a></li><li><a href="Situm.html#.fetchGeofencesFromBuilding">fetchGeofencesFromBuilding</a></li><li><a href="Situm.html#.fetchIndoorPOIsFromBuilding">fetchIndoorPOIsFromBuilding</a></li><li><a href="Situm.html#.fetchMapFromFloor">fetchMapFromFloor</a></li><li><a href="Situm.html#.fetchOutdoorPOIsFromBuilding">fetchOutdoorPOIsFromBuilding</a></li><li><a href="Situm.html#.fetchPoiCategories">fetchPoiCategories</a></li><li><a href="Situm.html#.fetchPoiCategoryIconNormal">fetchPoiCategoryIconNormal</a></li><li><a href="Situm.html#.fetchPoiCategoryIconSelected">fetchPoiCategoryIconSelected</a></li><li><a href="Situm.html#.getDeviceId">getDeviceId</a></li><li><a href="Situm.html#.internalHandleMapViewMessage">internalHandleMapViewMessage</a></li><li><a href="Situm.html#.internalSetEventDelegate">internalSetEventDelegate</a></li><li><a href="Situm.html#.invalidateCache">invalidateCache</a></li><li><a href="Situm.html#.onEnterGeofences">onEnterGeofences</a></li><li><a href="Situm.html#.onExitGeofences">onExitGeofences</a></li><li><a href="Situm.html#.onLocationError">onLocationError</a></li><li><a href="Situm.html#.onLocationStatus">onLocationStatus</a></li><li><a href="Situm.html#.onLocationUpdate">onLocationUpdate</a></li><li><a href="Situm.html#.removeNavigationUpdates">removeNavigationUpdates</a></li><li><a href="Situm.html#.removeRealTimeUpdates">removeRealTimeUpdates</a></li><li><a href="Situm.html#.removeUpdates">removeUpdates</a></li><li><a href="Situm.html#.requestDirections">requestDirections</a></li><li><a href="Situm.html#.requestLocationUpdates">requestLocationUpdates</a></li><li><a href="Situm.html#.requestNavigationUpdates">requestNavigationUpdates</a></li><li><a href="Situm.html#.requestRealTimeUpdates">requestRealTimeUpdates</a></li><li><a href="Situm.html#.setApiKey">setApiKey</a></li><li><a href="Situm.html#.setCacheMaxAge">setCacheMaxAge</a></li><li><a href="Situm.html#.setToken">setToken</a></li><li><a href="Situm.html#.setUserPass">setUserPass</a></li><li><a href="Situm.html#.startPositioning">startPositioning</a></li><li><a href="Situm.html#.stopPositioning">stopPositioning</a></li><li><a href="Situm.html#.updateNavigationState">updateNavigationState</a></li><li><a href="Situm.html#.updateNavigationWithLocation">updateNavigationWithLocation</a></li></ul></div></li></ul></div><div class="lnb-api hidden"><h3>Global</h3><ul><li><a href="global.html#Angle">Angle</a></li><li><a href="global.html#BeaconFilter">BeaconFilter</a></li><li><a href="global.html#Bounds">Bounds</a></li><li><a href="global.html#Building">Building</a></li><li><a href="global.html#BuildingInfo">BuildingInfo</a></li><li><a href="global.html#CartesianCoordinate">CartesianCoordinate</a></li><li><a href="global.html#Circle">Circle</a></li><li><a href="global.html#Coordinate">Coordinate</a></li><li><a href="global.html#Dimensions">Dimensions</a></li><li><a href="global.html#DirectionsOptions">DirectionsOptions</a></li><li><a href="global.html#DirectionsRequest">DirectionsRequest</a></li><li><a href="global.html#ExternalNavigation">ExternalNavigation</a></li><li><a href="global.html#Floor">Floor</a></li><li><a href="global.html#ForegroundServiceNotificationOptions">ForegroundServiceNotificationOptions</a></li><li><a href="global.html#Geofence">Geofence</a></li><li><a href="global.html#Indication">Indication</a></li><li><a href="global.html#Location">Location</a></li><li><a href="global.html#LocationOptions">LocationOptions</a></li><li><a href="global.html#LocationRequest">LocationRequest</a></li><li><a href="global.html#LocationStatus">LocationStatus</a></li><li class="hidden"><a href="global.html#MapViewDirectionsOptions">MapViewDirectionsOptions</a></li><li><a href="global.html#NavigationProgress">NavigationProgress</a></li><li><a href="global.html#NavigationRequest">NavigationRequest</a></li><li class="hidden"><a href="global.html#OnLocationErrorCallback">OnLocationErrorCallback</a></li><li class="hidden"><a href="global.html#OnLocationStatusCallback">OnLocationStatusCallback</a></li><li class="hidden"><a href="global.html#OnLocationUpdateCallback">OnLocationUpdateCallback</a></li><li><a href="global.html#OutdoorLocationOptions">OutdoorLocationOptions</a></li><li><a href="global.html#POI">POI</a></li><li><a href="global.html#PoiCategory">PoiCategory</a></li><li><a href="global.html#PoiDeselectedResult">PoiDeselectedResult</a></li><li><a href="global.html#Point">Point</a></li><li><a href="global.html#PoiSelectedResult">PoiSelectedResult</a></li><li><a href="global.html#RealTimeData">RealTimeData</a></li><li><a href="global.html#RealTimeRequest">RealTimeRequest</a></li><li><a href="global.html#Route">Route</a></li><li><a href="global.html#RouteSegment">RouteSegment</a></li><li><a href="global.html#RouteStep">RouteStep</a></li><li><a href="global.html#SitumConversionArea">SitumConversionArea</a></li><li><a href="global.html#SitumEvent">SitumEvent</a></li><li><a href="global.html#UserHelperColorScheme">UserHelperColorScheme</a></li><li><a href="global.html#UserHelperOptions">UserHelperOptions</a></li></ul></div>
 </nav>
 <div id="resizer"></div>
 
@@ -120,16 +120,18 @@ class MapView extends HTMLElement {
   connectedCallback() {
     MapViewController._prepare(this);
     MapViewController._getDeviceId((deviceId) => {
-      this.innerHTML = `
-        &lt;iframe
-          id="map-view-iframe"
-          src="${this._getViewerURL(deviceId)}"
-          width="100%"
-          height="100%"
-          style="border: none; box-shadow: none;"
-        />
-      `;
+      const iframe = document.createElement('iframe');
+      iframe.setAttribute('id', 'map-view-iframe');
+      iframe.setAttribute('src', this._getViewerURL(deviceId));
+      iframe.setAttribute('width', '100%');
+      iframe.setAttribute('height', '100%');
+      iframe.style.border = 'none';
+      iframe.style.boxShadow = 'none';
+
+      this.innerHTML = '';
+      this.appendChild(iframe);
     });
+
     window.addEventListener('message', this._messageReceivedCallback);
   }
 
@@ -151,13 +153,13 @@ class MapView extends HTMLElement {
       ? this.getAttribute('language')
       : '';
 
-    let situmApiKeyQP = situmApiKey.length > 0 ? `apikey=${situmApiKey}` : '';
+    let authQP = situmApiKey.length > 0 ? `apikey=${situmApiKey}` : 'wait_for_auth=true';
     let buildingIdentifierQP =
       buildingIdentifier.length > 0 ? `&amp;buildingid=${buildingIdentifier}` : '';
     let languageQP = language.length > 0 ? `&amp;lng=${language}` : '';
     let deviceIdQP = deviceId ? `&amp;deviceId=${deviceId}` : '';
 
-    let query = `${situmApiKeyQP}${buildingIdentifierQP}${languageQP}${deviceIdQP}&amp;mode=embed`;
+    let query = `${authQP}${buildingIdentifierQP}${languageQP}${deviceIdQP}&amp;mode=embed`;
 
     let remoteIdentifier = this.getAttribute('remote-identifier');
     if (remoteIdentifier &amp;&amp; remoteIdentifier.length > 0) {

package/docs/JSDoc/situm.js.html

@@ -40,7 +40,7 @@
         <ul></ul>
     </div>
     
-    <div class="lnb-api hidden"><h3>Namespaces</h3><ul><li><a href="MapView.html">MapView</a><button type="button" class="hidden toggle-subnav btn btn-link">  <span class="glyphicon glyphicon-plus"></span></button><div class="hidden" id="MapView_sub"><div class="member-type">Methods</div><ul class="inner"><li><a href="MapView.html#.onLoad">onLoad</a></li></ul></div></li><li><a href="MapViewController.html">MapViewController</a><button type="button" class="hidden toggle-subnav btn btn-link">  <span class="glyphicon glyphicon-plus"></span></button><div class="hidden" id="MapViewController_sub"><div class="member-type">Methods</div><ul class="inner"><li><a href="MapViewController.html#.navigateToPoi">navigateToPoi</a></li><li><a href="MapViewController.html#.onPoiDeselected">onPoiDeselected</a></li><li><a href="MapViewController.html#.onPoiSelected">onPoiSelected</a></li><li><a href="MapViewController.html#.selectPoi">selectPoi</a></li><li><a href="MapViewController.html#.setDirectionsOptions">setDirectionsOptions</a></li><li><a href="MapViewController.html#.setLanguage">setLanguage</a></li></ul></div></li><li><a href="Situm.html">Situm</a><button type="button" class="hidden toggle-subnav btn btn-link">  <span class="glyphicon glyphicon-plus"></span></button><div class="hidden" id="Situm_sub"><div class="member-type">Methods</div><ul class="inner"><li><a href="Situm.html#.configureUserHelper">configureUserHelper</a></li><li><a href="Situm.html#.disableUserHelper">disableUserHelper</a></li><li><a href="Situm.html#.enableUserHelper">enableUserHelper</a></li><li><a href="Situm.html#.fetchBuildingInfo">fetchBuildingInfo</a></li><li><a href="Situm.html#.fetchBuildings">fetchBuildings</a></li><li><a href="Situm.html#.fetchEventsFromBuilding">fetchEventsFromBuilding</a></li><li><a href="Situm.html#.fetchFloorsFromBuilding">fetchFloorsFromBuilding</a></li><li><a href="Situm.html#.fetchGeofencesFromBuilding">fetchGeofencesFromBuilding</a></li><li><a href="Situm.html#.fetchIndoorPOIsFromBuilding">fetchIndoorPOIsFromBuilding</a></li><li><a href="Situm.html#.fetchMapFromFloor">fetchMapFromFloor</a></li><li><a href="Situm.html#.fetchOutdoorPOIsFromBuilding">fetchOutdoorPOIsFromBuilding</a></li><li><a href="Situm.html#.fetchPoiCategories">fetchPoiCategories</a></li><li><a href="Situm.html#.fetchPoiCategoryIconNormal">fetchPoiCategoryIconNormal</a></li><li><a href="Situm.html#.fetchPoiCategoryIconSelected">fetchPoiCategoryIconSelected</a></li><li><a href="Situm.html#.getDeviceId">getDeviceId</a></li><li><a href="Situm.html#.internalSetEventDelegate">internalSetEventDelegate</a></li><li><a href="Situm.html#.invalidateCache">invalidateCache</a></li><li><a href="Situm.html#.onEnterGeofences">onEnterGeofences</a></li><li><a href="Situm.html#.onExitGeofences">onExitGeofences</a></li><li><a href="Situm.html#.onLocationError">onLocationError</a></li><li><a href="Situm.html#.onLocationStatus">onLocationStatus</a></li><li><a href="Situm.html#.onLocationUpdate">onLocationUpdate</a></li><li><a href="Situm.html#.removeNavigationUpdates">removeNavigationUpdates</a></li><li><a href="Situm.html#.removeRealTimeUpdates">removeRealTimeUpdates</a></li><li><a href="Situm.html#.removeUpdates">removeUpdates</a></li><li><a href="Situm.html#.requestDirections">requestDirections</a></li><li><a href="Situm.html#.requestLocationUpdates">requestLocationUpdates</a></li><li><a href="Situm.html#.requestNavigationUpdates">requestNavigationUpdates</a></li><li><a href="Situm.html#.requestRealTimeUpdates">requestRealTimeUpdates</a></li><li><a href="Situm.html#.setApiKey">setApiKey</a></li><li><a href="Situm.html#.setCacheMaxAge">setCacheMaxAge</a></li><li><a href="Situm.html#.setUserPass">setUserPass</a></li><li><a href="Situm.html#.startPositioning">startPositioning</a></li><li><a href="Situm.html#.stopPositioning">stopPositioning</a></li><li><a href="Situm.html#.updateNavigationState">updateNavigationState</a></li><li><a href="Situm.html#.updateNavigationWithLocation">updateNavigationWithLocation</a></li></ul></div></li></ul></div><div class="lnb-api hidden"><h3>Global</h3><ul><li><a href="global.html#Angle">Angle</a></li><li><a href="global.html#BeaconFilter">BeaconFilter</a></li><li><a href="global.html#Bounds">Bounds</a></li><li><a href="global.html#Building">Building</a></li><li><a href="global.html#BuildingInfo">BuildingInfo</a></li><li><a href="global.html#CartesianCoordinate">CartesianCoordinate</a></li><li><a href="global.html#Circle">Circle</a></li><li><a href="global.html#Coordinate">Coordinate</a></li><li><a href="global.html#Dimensions">Dimensions</a></li><li><a href="global.html#DirectionsOptions">DirectionsOptions</a></li><li><a href="global.html#DirectionsRequest">DirectionsRequest</a></li><li><a href="global.html#ExternalNavigation">ExternalNavigation</a></li><li><a href="global.html#Floor">Floor</a></li><li><a href="global.html#ForegroundServiceNotificationOptions">ForegroundServiceNotificationOptions</a></li><li><a href="global.html#Geofence">Geofence</a></li><li><a href="global.html#Indication">Indication</a></li><li><a href="global.html#Location">Location</a></li><li><a href="global.html#LocationOptions">LocationOptions</a></li><li><a href="global.html#LocationRequest">LocationRequest</a></li><li><a href="global.html#LocationStatus">LocationStatus</a></li><li class="hidden"><a href="global.html#MapViewDirectionsOptions">MapViewDirectionsOptions</a></li><li><a href="global.html#NavigationProgress">NavigationProgress</a></li><li><a href="global.html#NavigationRequest">NavigationRequest</a></li><li class="hidden"><a href="global.html#OnLocationErrorCallback">OnLocationErrorCallback</a></li><li class="hidden"><a href="global.html#OnLocationStatusCallback">OnLocationStatusCallback</a></li><li class="hidden"><a href="global.html#OnLocationUpdateCallback">OnLocationUpdateCallback</a></li><li><a href="global.html#OutdoorLocationOptions">OutdoorLocationOptions</a></li><li><a href="global.html#POI">POI</a></li><li><a href="global.html#PoiCategory">PoiCategory</a></li><li><a href="global.html#PoiDeselectedResult">PoiDeselectedResult</a></li><li><a href="global.html#Point">Point</a></li><li><a href="global.html#PoiSelectedResult">PoiSelectedResult</a></li><li><a href="global.html#RealTimeData">RealTimeData</a></li><li><a href="global.html#RealTimeRequest">RealTimeRequest</a></li><li><a href="global.html#Route">Route</a></li><li><a href="global.html#RouteSegment">RouteSegment</a></li><li><a href="global.html#RouteStep">RouteStep</a></li><li><a href="global.html#SitumConversionArea">SitumConversionArea</a></li><li><a href="global.html#SitumEvent">SitumEvent</a></li><li><a href="global.html#UserHelperColorScheme">UserHelperColorScheme</a></li><li><a href="global.html#UserHelperOptions">UserHelperOptions</a></li></ul></div>
+    <div class="lnb-api hidden"><h3>Namespaces</h3><ul><li><a href="MapView.html">MapView</a><button type="button" class="hidden toggle-subnav btn btn-link">  <span class="glyphicon glyphicon-plus"></span></button><div class="hidden" id="MapView_sub"><div class="member-type">Methods</div><ul class="inner"><li><a href="MapView.html#.onLoad">onLoad</a></li></ul></div></li><li><a href="MapViewController.html">MapViewController</a><button type="button" class="hidden toggle-subnav btn btn-link">  <span class="glyphicon glyphicon-plus"></span></button><div class="hidden" id="MapViewController_sub"><div class="member-type">Methods</div><ul class="inner"><li><a href="MapViewController.html#.navigateToPoi">navigateToPoi</a></li><li><a href="MapViewController.html#.onPoiDeselected">onPoiDeselected</a></li><li><a href="MapViewController.html#.onPoiSelected">onPoiSelected</a></li><li><a href="MapViewController.html#.selectPoi">selectPoi</a></li><li><a href="MapViewController.html#.setDirectionsOptions">setDirectionsOptions</a></li><li><a href="MapViewController.html#.setLanguage">setLanguage</a></li></ul></div></li><li><a href="Situm.html">Situm</a><button type="button" class="hidden toggle-subnav btn btn-link">  <span class="glyphicon glyphicon-plus"></span></button><div class="hidden" id="Situm_sub"><div class="member-type">Methods</div><ul class="inner"><li><a href="Situm.html#.configureUserHelper">configureUserHelper</a></li><li><a href="Situm.html#.disableUserHelper">disableUserHelper</a></li><li><a href="Situm.html#.enableUserHelper">enableUserHelper</a></li><li><a href="Situm.html#.fetchBuildingInfo">fetchBuildingInfo</a></li><li><a href="Situm.html#.fetchBuildings">fetchBuildings</a></li><li><a href="Situm.html#.fetchEventsFromBuilding">fetchEventsFromBuilding</a></li><li><a href="Situm.html#.fetchFloorsFromBuilding">fetchFloorsFromBuilding</a></li><li><a href="Situm.html#.fetchGeofencesFromBuilding">fetchGeofencesFromBuilding</a></li><li><a href="Situm.html#.fetchIndoorPOIsFromBuilding">fetchIndoorPOIsFromBuilding</a></li><li><a href="Situm.html#.fetchMapFromFloor">fetchMapFromFloor</a></li><li><a href="Situm.html#.fetchOutdoorPOIsFromBuilding">fetchOutdoorPOIsFromBuilding</a></li><li><a href="Situm.html#.fetchPoiCategories">fetchPoiCategories</a></li><li><a href="Situm.html#.fetchPoiCategoryIconNormal">fetchPoiCategoryIconNormal</a></li><li><a href="Situm.html#.fetchPoiCategoryIconSelected">fetchPoiCategoryIconSelected</a></li><li><a href="Situm.html#.getDeviceId">getDeviceId</a></li><li><a href="Situm.html#.internalHandleMapViewMessage">internalHandleMapViewMessage</a></li><li><a href="Situm.html#.internalSetEventDelegate">internalSetEventDelegate</a></li><li><a href="Situm.html#.invalidateCache">invalidateCache</a></li><li><a href="Situm.html#.onEnterGeofences">onEnterGeofences</a></li><li><a href="Situm.html#.onExitGeofences">onExitGeofences</a></li><li><a href="Situm.html#.onLocationError">onLocationError</a></li><li><a href="Situm.html#.onLocationStatus">onLocationStatus</a></li><li><a href="Situm.html#.onLocationUpdate">onLocationUpdate</a></li><li><a href="Situm.html#.removeNavigationUpdates">removeNavigationUpdates</a></li><li><a href="Situm.html#.removeRealTimeUpdates">removeRealTimeUpdates</a></li><li><a href="Situm.html#.removeUpdates">removeUpdates</a></li><li><a href="Situm.html#.requestDirections">requestDirections</a></li><li><a href="Situm.html#.requestLocationUpdates">requestLocationUpdates</a></li><li><a href="Situm.html#.requestNavigationUpdates">requestNavigationUpdates</a></li><li><a href="Situm.html#.requestRealTimeUpdates">requestRealTimeUpdates</a></li><li><a href="Situm.html#.setApiKey">setApiKey</a></li><li><a href="Situm.html#.setCacheMaxAge">setCacheMaxAge</a></li><li><a href="Situm.html#.setToken">setToken</a></li><li><a href="Situm.html#.setUserPass">setUserPass</a></li><li><a href="Situm.html#.startPositioning">startPositioning</a></li><li><a href="Situm.html#.stopPositioning">stopPositioning</a></li><li><a href="Situm.html#.updateNavigationState">updateNavigationState</a></li><li><a href="Situm.html#.updateNavigationWithLocation">updateNavigationWithLocation</a></li></ul></div></li></ul></div><div class="lnb-api hidden"><h3>Global</h3><ul><li><a href="global.html#Angle">Angle</a></li><li><a href="global.html#BeaconFilter">BeaconFilter</a></li><li><a href="global.html#Bounds">Bounds</a></li><li><a href="global.html#Building">Building</a></li><li><a href="global.html#BuildingInfo">BuildingInfo</a></li><li><a href="global.html#CartesianCoordinate">CartesianCoordinate</a></li><li><a href="global.html#Circle">Circle</a></li><li><a href="global.html#Coordinate">Coordinate</a></li><li><a href="global.html#Dimensions">Dimensions</a></li><li><a href="global.html#DirectionsOptions">DirectionsOptions</a></li><li><a href="global.html#DirectionsRequest">DirectionsRequest</a></li><li><a href="global.html#ExternalNavigation">ExternalNavigation</a></li><li><a href="global.html#Floor">Floor</a></li><li><a href="global.html#ForegroundServiceNotificationOptions">ForegroundServiceNotificationOptions</a></li><li><a href="global.html#Geofence">Geofence</a></li><li><a href="global.html#Indication">Indication</a></li><li><a href="global.html#Location">Location</a></li><li><a href="global.html#LocationOptions">LocationOptions</a></li><li><a href="global.html#LocationRequest">LocationRequest</a></li><li><a href="global.html#LocationStatus">LocationStatus</a></li><li class="hidden"><a href="global.html#MapViewDirectionsOptions">MapViewDirectionsOptions</a></li><li><a href="global.html#NavigationProgress">NavigationProgress</a></li><li><a href="global.html#NavigationRequest">NavigationRequest</a></li><li class="hidden"><a href="global.html#OnLocationErrorCallback">OnLocationErrorCallback</a></li><li class="hidden"><a href="global.html#OnLocationStatusCallback">OnLocationStatusCallback</a></li><li class="hidden"><a href="global.html#OnLocationUpdateCallback">OnLocationUpdateCallback</a></li><li><a href="global.html#OutdoorLocationOptions">OutdoorLocationOptions</a></li><li><a href="global.html#POI">POI</a></li><li><a href="global.html#PoiCategory">PoiCategory</a></li><li><a href="global.html#PoiDeselectedResult">PoiDeselectedResult</a></li><li><a href="global.html#Point">Point</a></li><li><a href="global.html#PoiSelectedResult">PoiSelectedResult</a></li><li><a href="global.html#RealTimeData">RealTimeData</a></li><li><a href="global.html#RealTimeRequest">RealTimeRequest</a></li><li><a href="global.html#Route">Route</a></li><li><a href="global.html#RouteSegment">RouteSegment</a></li><li><a href="global.html#RouteStep">RouteStep</a></li><li><a href="global.html#SitumConversionArea">SitumConversionArea</a></li><li><a href="global.html#SitumEvent">SitumEvent</a></li><li><a href="global.html#UserHelperColorScheme">UserHelperColorScheme</a></li><li><a href="global.html#UserHelperOptions">UserHelperOptions</a></li></ul></div>
 </nav>
 <div id="resizer"></div>
 
@@ -57,6 +57,8 @@ const common = require('@situm/cordova.common-utils');
 
 var PLUGIN_NAME = 'SitumPlugin';
 let _internalEventDelegate = undefined;
+let _internalTokenCallback = undefined;
+let _token = String;
 
 let _clientLocationUpdateCallback;
 let _clientLocationStatusCallback;
@@ -94,6 +96,20 @@ var Situm = {
   internalSetEventDelegate: function (callback) {
     _internalEventDelegate = callback;
   },
+  /**
+   * An internal method.
+   * @param {string} message MapView message key.
+   * @param {object} payload MapView message payload.
+   */
+  internalHandleMapViewMessage: function(message, payload) {
+    exec(() => {}, () => {}, PLUGIN_NAME, 'internalHandleMapViewMessage', [message, payload]);
+  },
+  internalGetToken: function() {
+    return _token;
+  },
+  internalSetTokenCallback: function(callback) {
+    _internalTokenCallback = 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.
@@ -109,6 +125,36 @@ var Situm = {
   setUseRemoteConfig: function (useRemoteConfig, cb, error) {
     exec(cb, error, PLUGIN_NAME, 'setUseRemoteConfig', [useRemoteConfig]);
   },
+  /**
+   * Provides your token to the Situm SDK. Any previously configured credentials will be replaced.
+   * &lt;p>The SDK does not cryptographically validate the token signature, nor does it verify the
+   * token against Situm servers when this method is called. The token is parsed locally only to
+   * obtain the account information needed by the SDK, and it will be sent as a Bearer token in
+   * subsequent authenticated network requests.&lt;/p>
+   * 
+   * &lt;p>If the provided token is expired, has an invalid signature, or is otherwise rejected by
+   * Situm servers, network operations that require server authentication will fail. However,
+   * features that can operate with already cached local data may continue to work, such as
+   * visualizing cached resources or positioning with previously downloaded positioning data.&lt;/p>
+   * 
+   * &lt;p>User-provided tokens cannot be renewed automatically by the SDK. To recover from an
+   * expired or rejected token, provide a new token by calling this method again.&lt;/p>
+   * 
+   * @description Provides your token to the Situm SDK. Any previously configured credentials will be replaced.
+   * @param {string} base64Token String representing the token used for authentication; must not be {@code null} or empty.
+   *                             The expected format is a base64-encoded JWT with header, payload and signature sections.
+   *                             This token can be retrieved from &lt;a href="https://developers.situm.com/pages/rest/openapi/#tag/jwt/POST/api/v1/auth/access_tokens">a REST endpoint&lt;/a>.
+   * @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
+   */
+  setToken: function (base64Token, cb, error) {
+    _token = base64Token;
+    if (_internalTokenCallback) {
+      _internalTokenCallback(base64Token);
+    }
+    exec(cb, error, PLUGIN_NAME, 'setToken', [base64Token]);
+  },
   /**
    * 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.

package/example/.browserslistrc

@@ -8,9 +8,9 @@
 # You can see what browsers were selected by your queries by running:
 #   npx browserslist
 
-Chrome >=79
-ChromeAndroid >=79
-Firefox >=70
-Edge >=79
-Safari >=14
-iOS >=14
+last 2 Chrome versions
+last 1 Firefox version
+last 2 Edge major versions
+last 2 Safari major versions
+last 2 iOS major versions
+Firefox ESR