@situm/cordova 3.4.4 → 3.5.0

package/CHANGELOG_UNRELEASED.md

@@ -0,0 +1,2 @@
+
+

package/example/package-lock.json

@@ -68,7 +68,7 @@
     },
     "..": {
       "name": "@situm/cordova",
-      "version": "3.3.3",
+      "version": "3.4.2",
       "engines": [
         {
           "name": "cordova-android",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@situm/cordova",
-  "version": "3.4.4",
+  "version": "3.5.0",
   "description": "Situm Wayfinding for Capacitor and Cordova. Integrate plug&play indoor navigation experience with floorplans, POIs, routes and turn-by-turn directions in no time. With the power of Situm.",
   "private": false,
   "repository": "https://github.com/situmtech/cordova",

package/plugin.xml

@@ -2,7 +2,7 @@
 
 <plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
     id="@situm/cordova"
-    version="3.4.4">
+    version="3.5.0">
     <name>Situm Cordova plugin Official</name>
     <description>This is the stable branch.</description>
     <license>MIT</license>
@@ -89,7 +89,7 @@
             <config>
             </config>
             <pods use-frameworks="false">
-                <pod name="SitumSDK" spec="~> 3.9.0"/>
+                <pod name="SitumSDK" spec="~> 3.10.0"/>
             </pods>
         </podspec>
 

package/src/android/app/src/main/java/es/situm/plugin/PluginHelper.java

@@ -106,10 +106,16 @@ public class PluginHelper {
         nmInstance = navigationManager;
     }
 
+    public void getDeviceId(CordovaInterface cordova, CordovaWebView webView, JSONArray args,
+            final CallbackContext callbackContext) {
+        String deviceId = String.valueOf(SitumSdk.getDeviceID());
+        callbackContext.sendPluginResult(new PluginResult(Status.OK, deviceId));
+    }
+
     public void fetchBuildings(CordovaInterface cordova, CordovaWebView webView, JSONArray args,
             final CallbackContext callbackContext) {
         try {
-           getCommunicationManagerInstance().fetchBuildings(new Handler<Collection<Building>>() {
+            getCommunicationManagerInstance().fetchBuildings(new Handler<Collection<Building>>() {
                 public void onSuccess(Collection<Building> buildings) {
                     try {
                         Log.d(PluginHelper.TAG, "onSuccess: Buildings fetched successfully.");

package/src/android/app/src/main/java/es/situm/plugin/SitumMapper.java

@@ -20,6 +20,7 @@ import java.util.Collection;
 import java.util.List;
 import java.util.Locale;
 import java.util.Map;
+import java.util.Arrays;
 
 import es.situm.sdk.directions.DirectionsRequest;
 import es.situm.sdk.location.LocationRequest;
@@ -216,6 +217,8 @@ class SitumMapper {
   public static final String UPDATED_AT = "updatedAt";
   public static final String NAME = "name";
   public static final String ACCESSIBILITY_MODE = "accessibilityMode";
+  public static final String INCLUDED_TAGS = "includedTags";
+  public static final String EXCLUDED_TAGS = "excludedTags";
   public static final String POLYGON_POINTS = "polygonPoints";
   public static final String CODE = "code";
   public static final String BUILDING = "building";
@@ -926,8 +929,25 @@ static JSONObject buildingInfoToJsonObject(BuildingInfo buildingInfo) throws JSO
     DirectionsRequest.AccessibilityMode accessibilityMode = DirectionsRequest.AccessibilityMode.CHOOSE_SHORTEST;
     Boolean minimizeFloorChanges = false;
     double startingAngle = 0.0;
+    List<String> includedTags = null;
+    List<String> excludedTags = null;
 
     if ( joOptions != null) {
+      if (joOptions.has(SitumMapper.INCLUDED_TAGS) && joOptions.get(SitumMapper.INCLUDED_TAGS) != null) {
+        includedTags = new ArrayList<String>();
+        JSONArray jsonArray = joOptions.getJSONArray(SitumMapper.INCLUDED_TAGS);
+        for (int i = 0; i < jsonArray.length(); i++) {
+          includedTags.add(jsonArray.get(i).toString());
+        }
+      }
+
+      if (joOptions.has(SitumMapper.EXCLUDED_TAGS) && joOptions.get(SitumMapper.EXCLUDED_TAGS) != null) {
+        excludedTags = new ArrayList<String>();
+        JSONArray jsonArray = joOptions.getJSONArray(SitumMapper.EXCLUDED_TAGS);
+        for (int i = 0; i < jsonArray.length(); i++) {
+          excludedTags.add(jsonArray.get(i).toString());
+        }
+      }
       if (joOptions.has(SitumMapper.ACCESSIBILITY_MODE)) {
         String mode = joOptions.getString(SitumMapper.ACCESSIBILITY_MODE);
         if (mode.equals(DirectionsRequest.AccessibilityMode.ONLY_ACCESSIBLE.name())) {
@@ -947,6 +967,6 @@ static JSONObject buildingInfoToJsonObject(BuildingInfo buildingInfo) throws JSO
         minimizeFloorChanges = joOptions.getBoolean(SitumMapper.MINIMIZE_FLOOR_CHANGES);
       }
     }
-    return new DirectionsRequest.Builder().from(from, Angle.fromDegrees(startingAngle)).to(to).accessibilityMode(accessibilityMode).minimizeFloorChanges(minimizeFloorChanges).build();
+    return new DirectionsRequest.Builder().from(from, Angle.fromDegrees(startingAngle)).to(to).accessibilityMode(accessibilityMode).minimizeFloorChanges(minimizeFloorChanges).includedTags(includedTags).excludedTags(excludedTags).build();
   }
 }

package/src/android/app/src/main/java/es/situm/plugin/SitumPlugin.java

@@ -56,6 +56,8 @@ public class SitumPlugin extends CordovaPlugin {
       Integer cacheAge = args.getInt(0);
       Log.d(TAG,"Setting cache max age to " + cacheAge + " seconds");
       es.situm.sdk.SitumSdk.configuration().setCacheMaxAge(cacheAge, TimeUnit.SECONDS);
+    } else if (action.equalsIgnoreCase("getDeviceId")) {    
+      getPluginInstance().getDeviceId(cordova, webView, args, callbackContext);
     } else if (action.equalsIgnoreCase("fetchBuildings")) {
       getPluginInstance().fetchBuildings(cordova, webView, args, callbackContext);
     } else if (action.equalsIgnoreCase("fetchBuildingInfo")) {

package/src/ios/Podfile

@@ -1,5 +1,5 @@
 target 'SitumCordovaPlugin' do
   use_frameworks!
   platform :ios, '9.0'
-  pod 'SitumSDK', '3.9.0'
+  pod 'SitumSDK', '3.10.0'
 end

package/src/ios/situmcordovaplugin/SitumLocationWrapper.m

@@ -691,6 +691,8 @@ static SitumLocationWrapper *singletonSitumLocationWrapperObj;
     NSNumber *accessible;
     BOOL minimizeFloorChanges = false;
     NSString *accessibilityModeValue = nil;
+    NSArray *includedTags = nil;
+    NSArray *excludedTags = nil; 
     if(options) {
         accessible = (NSNumber*)[options valueForKey: @"accessible"];
         if (accessible == nil) {
@@ -698,6 +700,15 @@ static SitumLocationWrapper *singletonSitumLocationWrapperObj;
         }
         accessibilityModeValue = options[@"accessibilityMode"];
         minimizeFloorChanges = [(NSNumber*)[options valueForKey: @"minimizeFloorChanges"] boolValue];
+
+        if (options[@"includedTags"] != nil && ![options[@"includedTags"] isEqual:[NSNull null]]) {
+             includedTags = options[@"includedTags"];
+             [directionsRequest setIncludedTags:includedTags];
+         }
+         if (options[@"excludedTags"] != nil && ![options[@"excludedTags"] isEqual:[NSNull null]]) {
+             excludedTags = options[@"excludedTags"];
+             [directionsRequest setExcludedTags:excludedTags];
+         }
     }
     
     if (accessibilityModeValue != nil) {

package/src/ios/situmcordovaplugin/SitumPlugin.h

@@ -17,6 +17,7 @@
 // The hooks for our plugin commands
 - (void)setApiKey:(CDVInvokedUrlCommand *)command;
 - (void)setUserPass:(CDVInvokedUrlCommand *)command;
+- (void)getDeviceId:(CDVInvokedUrlCommand *)command;
 - (void)startPositioning:(CDVInvokedUrlCommand *)command;
 - (void)setUseRemoteConfig:(CDVInvokedUrlCommand *)command;
 - (void)stopPositioning:(CDVInvokedUrlCommand *)command;

package/src/ios/situmcordovaplugin/SitumPlugin.m

@@ -62,6 +62,11 @@ static NSString *DEFAULT_SITUM_LOG = @"SitumSDK >>: ";
     }
 }
 
+-(void)getDeviceId:(CDVInvokedUrlCommand *)command {
+    CDVPluginResult *pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:[SITServices deviceID]];
+    [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+}
+
 - (void)fetchBuildingInfo:(CDVInvokedUrlCommand *)command
 {
     // TODO:

package/www/Interfaces.js

@@ -31,9 +31,9 @@ var Building = {
   rotation,
   userIdentifier,
   customFields
-}
+};
 
-module.exports = Building
+module.exports = Building;
 
 /** @name
  * BuildingInfo
@@ -52,9 +52,9 @@ var BuildingInfo = {
   indoorPois,
   outdoorPois,
   events
-}
+};
 
-module.exports = BuildingInfo
+module.exports = BuildingInfo;
 
 /**
  * @name
@@ -77,9 +77,9 @@ var Floor = {
   mapUrl,
   scale,
   floorIdentifier
-}
+};
 
-module.exports = Floor
+module.exports = Floor;
 
 /** @name
  * Dimensions
@@ -92,9 +92,9 @@ module.exports = Floor
 var Dimensions = {
   width,
   height
-}
+};
 
-module.exports = Dimensions
+module.exports = Dimensions;
 
 /** @name
  * Bounds
@@ -111,9 +111,9 @@ var Bounds = {
   northWest,
   southEast,
   southWest
-}
+};
 
-module.exports = Bounds
+module.exports = Bounds;
 
 /**
  * @name
@@ -127,9 +127,9 @@ module.exports = Bounds
 var Coordinate = {
   latitude,
   longitude
-}
+};
 
-module.exports = Coordinate
+module.exports = Coordinate;
 
 /**
  * @name
@@ -143,9 +143,9 @@ module.exports = Coordinate
 var CartesianCoordinate = {
   x,
   y
-}
+};
 
-module.exports = CartesianCoordinate
+module.exports = CartesianCoordinate;
 
 /**
  * @name
@@ -179,9 +179,9 @@ var Poi = {
   category,
   infoHtml,
   customFields
-}
+};
 
-module.exports = Poi
+module.exports = Poi;
 
 /**
  * @name
@@ -204,9 +204,9 @@ var Geofence = {
   infoHtml,
   polygonPoints,
   customFields
-}
+};
 
-module.exports = Geofence
+module.exports = Geofence;
 
 /**
  * @name
@@ -220,16 +220,15 @@ module.exports = Geofence
  * @property {boolean} public - Whether the category is public or not
  */
 
- 
 var PoiCategory = {
   poiCategoryCode,
   poiCategoryName,
   icon_selected,
   icon_unselected,
   public
-}
+};
 
-module.exports = PoiCategory
+module.exports = PoiCategory;
 
 /**
  * @name
@@ -251,9 +250,9 @@ var Point = {
   floorIdentifier,
   isIndoor,
   isOutdoor
-}
+};
 
-module.exports = Point
+module.exports = Point;
 
 /**
  * @name
@@ -297,9 +296,9 @@ var Location = {
   isIndoor,
   isOutdoor,
   deviceId
-}
+};
 
-module.exports = Location
+module.exports = Location;
 
 /**
  * @name
@@ -313,9 +312,9 @@ module.exports = Location
 var LocationStatus = {
   statusName,
   statusOrdinal
-}
+};
 
-module.exports = LocationStatus
+module.exports = LocationStatus;
 
 /**
  * @name
@@ -333,9 +332,9 @@ var Angle = {
   degreesClockwise,
   radians,
   radiansMinusPiPi
-}
+};
 
-module.exports = Angle
+module.exports = Angle;
 
 /**
  * @name
@@ -365,9 +364,9 @@ var Route = {
   to,
   steps,
   segments
-}
+};
 
-module.exports = Route
+module.exports = Route;
 
 /**
  * @name
@@ -391,9 +390,9 @@ var RouteStep = {
   to,
   isFirst,
   isLast
-}
+};
 
-module.exports = RouteStep
+module.exports = RouteStep;
 
 /**
  * @name
@@ -407,9 +406,9 @@ module.exports = RouteStep
 var RouteSegment = {
   floorIdentifier,
   points
-}
+};
 
-module.exports = RouteSegment
+module.exports = RouteSegment;
 
 /**
  * @name
@@ -435,10 +434,9 @@ var Indication = {
   stepIdxDestination,
   stepIdxOrigin,
   neededLevelChange
-}
-
-module.exports = Indication
+};
 
+module.exports = Indication;
 
 /**
  * @name
@@ -474,10 +472,9 @@ var NavigationProgress = {
   routeStep,
   points,
   segments
-}
-
-module.exports = NavigationProgress
+};
 
+module.exports = NavigationProgress;
 
 /**
  * @name
@@ -509,9 +506,9 @@ var SitumEvent = {
   name,
   x,
   y
-}
+};
 
-module.exports = SitumEvent
+module.exports = SitumEvent;
 
 /**
  * @name
@@ -530,10 +527,10 @@ var SitumConversionArea = {
   topLeft,
   topRight,
   bottomLeft,
-  bottomRight,
-}
+  bottomRight
+};
 
-module.exports = Circle
+module.exports = Circle;
 
 /**
  * @name
@@ -546,10 +543,10 @@ module.exports = Circle
 
 var Circle = {
   center,
-  radius,
-}
+  radius
+};
 
-module.exports = SitumConversionArea
+module.exports = SitumConversionArea;
 
 /**
  * @name
@@ -587,7 +584,7 @@ var LocationRequest = {
   beaconFilters,
   smallestDisplacement,
   realtimeUpdateInterval,
-  autoEnableBleDuringPositioning,
+  autoEnableBleDuringPositioning
 };
 
 module.exports = LocationRequest;
@@ -601,7 +598,7 @@ module.exports = LocationRequest;
  */
 var LocationOptions = LocationRequest;
 
-module.exports = LocationOptions
+module.exports = LocationOptions;
 
 /**
  * @name
@@ -629,9 +626,9 @@ var NavigationRequest = {
   timeToFirstIndication,
   roundIndicationsStep,
   timeToIgnoreUnexpectedFloorChanges
-}
+};
 
-module.exports = NavigationRequest
+module.exports = NavigationRequest;
 
 /**
  * @name
@@ -649,9 +646,9 @@ var DirectionsRequest = {
   from,
   to,
   options
-}
+};
 
-module.exports = DirectionsRequest
+module.exports = DirectionsRequest;
 
 /**
  * @name
@@ -663,15 +660,19 @@ module.exports = DirectionsRequest
  * @property {boolean} accessible - Defines wheter or not the route has to be suitable for wheel chairs (true) or not (false). @deprecated, use accessibilityMode
  * @property {string} accessibilityMode - Defines the accessibility mode of the route. Possible values are: CHOOSE_SHORTEST, ONLY_NOT_ACCESSIBLE_FLOOR_CHANGES, ONLY_ACCESSIBLE
  * @property {number} startingAngle - Current user's orientation in degrees.
+ * @property {stting[]} includedTags - List of tags that you want to use when calculating a route. Only the tags added here will be used. If there are other tags in the graph they won't be used. The edges without a tag will be used. If you don't set nothing all the graph will be used to calculate the route. You can learn more about this topic on https://situm.com/docs/cartography-management/#tags
+ * @property {stting[]} excludedTags - List of tags that you want your route to avoid. If you exclude a tag the route will never pass through an edge that have this tag. If the route can only be generated passing through an edge with this tag the route calculation will fail. You can learn more about this topic on https://situm.com/docs/cartography-management/#tags.
  */
 
 var DirectionsOptions = {
   minimizeFloorChanges,
   accessibleRoute,
-  startingAngle
-}
+  startingAngle,
+  includedTags,
+  excludedTags
+};
 
-module.exports = DirectionsOptions
+module.exports = DirectionsOptions;
 
 /**
  * @name
@@ -687,9 +688,9 @@ var OutdoorLocationOptions = {
   userDefinedThreshold,
   computeInterval,
   averageSnrThreshold
-}
+};
 
-module.exports = OutdoorLocationOptions
+module.exports = OutdoorLocationOptions;
 
 /**
  * @name
@@ -701,9 +702,9 @@ module.exports = OutdoorLocationOptions
 
 var BeaconFilter = {
   uuid
-}
+};
 
-module.exports = BeaconFilter
+module.exports = BeaconFilter;
 
 /**
  * @name
@@ -716,10 +717,10 @@ module.exports = BeaconFilter
 
 var RealTimeRequest = {
   building,
-  pollTime,
-}
+  pollTime
+};
 
-module.exports = RealTimeRequest
+module.exports = RealTimeRequest;
 
 /**
  * @name
@@ -730,10 +731,10 @@ module.exports = RealTimeRequest
  */
 
 var RealTimeData = {
-  locations,
-}
+  locations
+};
 
-module.exports = RealTimeData
+module.exports = RealTimeData;
 
 /**
  * @name
@@ -747,8 +748,8 @@ module.exports = RealTimeData
 var PoiSelectedResult = {
   poi: {
     identifier,
-    buildingIdentifier,
-  },
+    buildingIdentifier
+  }
 };
 
 module.exports = PoiSelectedResult;
@@ -765,8 +766,8 @@ module.exports = PoiSelectedResult;
 var PoiDeselectedResult = {
   poi: {
     identifier,
-    buildingIdentifier,
+    buildingIdentifier
   }
 };
 
-module.exports = PoiDeselectedResult;
+module.exports = PoiDeselectedResult;

package/www/map-view-controller.js

@@ -1,4 +1,4 @@
-const Situm = require('@situm/cordova.situm')
+const Situm = require('@situm/cordova.situm');
 
 /**
  * Here's an example on how to use this controller class:
@@ -46,35 +46,35 @@ const Situm = require('@situm/cordova.situm')
  * @name MapViewController
  */
 class MapViewControllerImpl {
-  _onLoadCallback = undefined
-  _onPoiSelectedCallback = undefined
-  _onPoiDeselectedCallback = undefined
-  _buildings = undefined
-  _mapView = undefined
-  _isNavigating = false
+  _onLoadCallback = undefined;
+  _onPoiSelectedCallback = undefined;
+  _onPoiDeselectedCallback = undefined;
+  _buildings = undefined;
+  _mapView = undefined;
+  _isNavigating = false;
 
   constructor() {
-    Situm.internalSetEventDelegate(this._handleSdkNativeEvents.bind(this))
+    Situm.internalSetEventDelegate(this._handleSdkNativeEvents.bind(this));
   }
 
   _prepare(mapView) {
-    this._mapView = mapView
+    this._mapView = mapView;
   }
 
   _setOnLoadCallback(callback) {
-    this._onLoadCallback = callback
+    this._onLoadCallback = callback;
   }
 
   _sendMessageToViewer(type, payload) {
     let message = {
       type: type,
-      payload: payload,
-    }
+      payload: payload
+    };
     if (this._mapView && this._mapView.firstElementChild) {
       this._mapView.firstElementChild.contentWindow.postMessage(
         message,
         this._mapView._getViewerDomain()
-      )
+      );
     }
   }
 
@@ -88,16 +88,16 @@ class MapViewControllerImpl {
         // 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)
+          this._handleOnLocationUpdate(payload);
         } else if (payload.statusName) {
-          this._handleOnLocationStatus(payload)
+          this._handleOnLocationStatus(payload);
         }
-        break
+        break;
     }
   }
 
   _handleOnLocationUpdate(payload) {
-    this._sendMessageToViewer('location.update', payload)
+    this._sendMessageToViewer('location.update', payload);
     if (this._isNavigating) {
       Situm.updateNavigationWithLocation(
         [payload],
@@ -105,16 +105,16 @@ class MapViewControllerImpl {
           // Do nothing.
         },
         () => {
-          console.error('Error at updateNavigationWithLocation')
+          console.error('Error at updateNavigationWithLocation');
         }
-      )
+      );
     }
   }
 
   _handleOnLocationStatus(payload) {
     this._sendMessageToViewer('location.update_status', {
-      status: payload.statusName,
-    })
+      status: payload.statusName
+    });
   }
 
   // ==================================================
@@ -128,41 +128,41 @@ class MapViewControllerImpl {
           this._onLoadCallback &&
           typeof this._onLoadCallback === 'function'
         ) {
-          this._onLoadCallback(this)
-          console.debug('Map is ready!')
+          this._onLoadCallback(this);
+          console.debug('Map is ready!');
         }
-        break
+        break;
       case 'cartography.poi_selected':
-        console.debug(`poi (${m.payload.identifier}) was selected`)
+        console.debug(`poi (${m.payload.identifier}) was selected`);
         const poiSelectedResult = {
           poi: {
             identifier: m.payload.identifier,
-            buildingIdentifier: m.payload.buildingIdentifier,
-          },
-        }
-        this._onPoiSelectedCallback(poiSelectedResult)
-        break
+            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
+            buildingIdentifier: m.payload.buildingIdentifier
+          }
+        };
+        this._onPoiDeselectedCallback(poiDeselectedResult);
+        break;
       case 'directions.requested':
-        this._onDirectionsRequested(m.payload)
-        break
+        this._onDirectionsRequested(m.payload);
+        break;
       case 'navigation.requested':
-        this._onNavigationRequested(m.payload)
-        break
+        this._onNavigationRequested(m.payload);
+        break;
       case 'navigation.stopped':
-        this._onNavigationCancel()
-        break
+        this._onNavigationCancel();
+        break;
       default:
-        console.debug('Got unmanaged message: ', m)
-        break
+        console.debug('Got unmanaged message: ', m);
+        break;
     }
   }
 
@@ -171,35 +171,35 @@ class MapViewControllerImpl {
     if (this._buildings) {
       let building = this._buildings.find(
         (b) => b.buildingIdentifier == buildingId
-      )
-      callback(building)
+      );
+      callback(building);
     } else {
       // Fetch buildings and calculate route.
       cordova.plugins.Situm.fetchBuildings(
         (res) => {
-          this._buildings = res
+          this._buildings = res;
           let building = this._buildings.find(
             (b) => b.buildingIdentifier == buildingId
-          )
-          callback(building)
+          );
+          callback(building);
         },
         (err) => {
-          callback(undefined)
+          callback(undefined);
         }
-      )
+      );
     }
   }
 
   // DIRECTIONS:
 
   _onDirectionsRequested(payload) {
-    let directionsRequest = payload.directionsRequest
+    let directionsRequest = payload.directionsRequest;
     let mapViewerData = {
       identifier: payload.identifier,
       originIdentifier: payload.originIdentifier,
       destinationIdentifier: payload.destinationIdentifier,
-      type: directionsRequest.accessibilityMode,
-    }
+      type: directionsRequest.accessibilityMode
+    };
     this._ensureBuilding(payload.buildingIdentifier, (building) => {
       if (building) {
         Situm.requestDirections(
@@ -207,41 +207,41 @@ class MapViewControllerImpl {
             building,
             directionsRequest.from,
             directionsRequest.to,
-            directionsRequest,
+            directionsRequest
           ],
           (route) => {
             this._sendMessageToViewer('directions.update', {
               ...route,
-              ...mapViewerData,
-            })
+              ...mapViewerData
+            });
           },
           (error) => {
             this._sendMessageToViewer('directions.update', {
               error: -1,
-              identifier: mapViewerData.identifier,
-            })
+              identifier: mapViewerData.identifier
+            });
           }
-        )
+        );
       } else {
         this._sendMessageToViewer('directions.update', {
           error: -1,
-          identifier: payload.identifier,
-        })
+          identifier: payload.identifier
+        });
       }
-    })
+    });
   }
 
   // NAVIGATION
 
   _onNavigationRequested(payload) {
-    let directionsRequest = payload.directionsRequest
+    let directionsRequest = payload.directionsRequest;
     let mapViewerData = {
       identifier: payload.identifier,
       originIdentifier: payload.originIdentifier,
       destinationIdentifier: payload.destinationIdentifier,
-      type: directionsRequest.accessibilityMode,
-    }
-    let navigationRequest = payload.navigationRequest
+      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(
@@ -249,62 +249,62 @@ class MapViewControllerImpl {
           building,
           directionsRequest.from,
           directionsRequest.to,
-          directionsRequest,
+          directionsRequest
         ],
         (route) => {
-          this._isNavigating = true
+          this._isNavigating = true;
           this._sendMessageToViewer('navigation.start', {
             ...route,
-            ...mapViewerData,
-          })
+            ...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)
+                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
+                  type: 'DESTINATION_REACHED'
+                });
+                this._isNavigating = false;
               } else if (progress.type == 'userOutsideRoute') {
                 this._sendMessageToViewer('navigation.update', {
-                  type: 'OUT_OF_ROUTE',
-                })
+                  type: 'OUT_OF_ROUTE'
+                });
               }
             },
             (error) => {
               this._sendMessageToViewer('directions.update', {
                 error: -1,
-                identifier: mapViewerData.identifier,
-              })
-              this._isNavigating = false
+                identifier: mapViewerData.identifier
+              });
+              this._isNavigating = false;
             }
-          )
+          );
         },
         (error) => {
           this._sendMessageToViewer('directions.update', {
             error: -1,
-            identifier: mapViewerData.identifier,
-          })
-          this._isNavigating = false
+            identifier: mapViewerData.identifier
+          });
+          this._isNavigating = false;
         }
-      )
-    })
+      );
+    });
   }
 
   _onNavigationCancel() {
-    this._isNavigating = false
+    this._isNavigating = false;
     Situm.removeNavigationUpdates(
       () => {
         // Do nothing.
       },
       () => {
-        console.error('Error removing navigation updates.')
+        console.error('Error removing navigation updates.');
       }
-    )
+    );
   }
 
   // ==================================================
@@ -321,8 +321,8 @@ class MapViewControllerImpl {
    * */
   selectPoi(identifier) {
     this._sendMessageToViewer('cartography.select_poi', {
-      identifier: identifier,
-    })
+      identifier: identifier
+    });
   }
 
   /**
@@ -344,8 +344,8 @@ class MapViewControllerImpl {
   navigateToPoi(identifier, accessibilityMode) {
     this._sendMessageToViewer('navigation.start', {
       navigationTo: Number.parseInt(identifier),
-      type: accessibilityMode,
-    })
+      type: accessibilityMode
+    });
   }
 
   /**
@@ -358,7 +358,31 @@ class MapViewControllerImpl {
    * @method
    */
   setLanguage(language) {
-    this._sendMessageToViewer('ui.set_language', language)
+    this._sendMessageToViewer('ui.set_language', language);
+  }
+
+  /**
+   * @typedef {Object} MapViewDirectionsOptions - Options to apply to directions requests
+   * @property {string[]} includedTags - List of tags that you want to use when calculating a route. Only the tags added here will be used. If there are other tags in the graph they won't be used. The edges without a tag will be used. If you don't set any tag, all the graph will be used to calculate the route. You can learn more about this topic on https://situm.com/docs/cartography-management/#tags
+   * @property {string[]} excludedTags - List of tags that you want your route to avoid. If you exclude a tag the route will never pass through an edge that have this tag. If the route can only be generated passing through an edge with this tag the route calculation will fail. You can learn more about this topic on https://situm.com/docs/cartography-management/#tags.
+   */
+
+  /**
+   * If you want to change the route calculated based on tags you can use this interface.
+   * Using this interface you can change all the routes that will be calculated including or excluding tags.
+   * Use the method this method after the MapView ends loading
+   * You can call this as many times you want and the mapviewer will use the last options that you set.
+   *
+   * @param {MapViewDirectionsOptions} directionsOptions the desired MapViewDirectionsOptions
+   * @memberof MapViewController
+   * @name setDirectionsOptions
+   * @method
+   */
+  setDirectionsOptions(directionsOptions) {
+    this._sendMessageToViewer('directions.set_options', {
+      includedTags: directionsOptions.includedTags,
+      excludedTags: directionsOptions.excludedTags
+    });
   }
 
   // ==================================================
@@ -373,7 +397,7 @@ class MapViewControllerImpl {
    * @method
    * */
   onPoiSelected(cb) {
-    this._onPoiSelectedCallback = cb
+    this._onPoiSelectedCallback = cb;
   }
 
   /**
@@ -384,9 +408,10 @@ class MapViewControllerImpl {
    * @method
    * */
   onPoiDeselected(cb) {
-    this._onPoiDeselectedCallback = cb
+    this._onPoiDeselectedCallback = cb;
   }
 }
 
-let MapViewController = new MapViewControllerImpl()
-module.exports = MapViewController
+let MapViewController = new MapViewControllerImpl();
+
+module.exports = MapViewController;

package/www/situm.js

@@ -79,6 +79,17 @@ var Situm = {
     exec(cb, error, PLUGIN_NAME, 'setCacheMaxAge', [cacheAge]);
   },
 
+  /**
+   * Get the device id.
+   * @description Gets the id of the device.
+   * @param {function} cb Cordova native callback to recive data.
+   * @param {function} error Cordova native callback to recive errors.
+   * @return {void}
+   */
+  getDeviceId: function (cb, error) {
+    exec(cb, error, PLUGIN_NAME, 'getDeviceId');
+  },
+
   /**
    * Set callback and starts listen onLocationChanged event.
    * @param {LocationRequest} request Location Request.