//A sample configuration of the outdoor positioning options
OutdoorLocationOptions outdoorLocationOptions = new OutdoorLocationOptions.Builder(). 
buildingDetector(OutdoorLocationOptions.BuildingDetector.WIFI_AND_BLE). 
scansBasedDetectorAlwaysOn(false).
enableOpenSkyDetector(false).
useGeofencesInBuildingSelector(true). 
build();        

LocationRequest locationRequest = new 
LocationRequest.Builder().outdoorLocationOptions(outdoorLocationOptions).build();

1. Building detector

One of the many outdoor positioning options that we may configure relates to how Situm SDK detects whether we are inside or outside a building configured with Situm. This is achieved through the OutdoorLocationOptions.Builder().buildingDetector method, as explained in detail in the Building vs Global Mode section.

2. Enable/Disable outdoor positioning

For a number of reasons, you may want to disable outdoor positioning while using Global Mode. For instance, you may want to enable indoor positioning with automatic building detection, but without allowing Situm SDK to compute outdoor positions when you are not in a known building.  This is common, for example, if you want to make sure that users are not tracked outside the buildings' surroundings.

You may achieve this by using the OutdoorLocationOptions.Builder().enableOutdoorPositions method, as shown on the following snippet. Note that if you disable outdoor positioning, the GPS based building detector will not work. Therefore, you should set a different building detector (e.g. WiFi & BLE as in the following snippet, or any other). 

//Outdoor Positioning is enabled by default
OutdoorLocationOptions outdoorLocationOptions = new OutdoorLocationOptions.Builder().build();
 
//You may disable it by setting enableOutdoorPositions to false
OutdoorLocationOptions outdoorLocationOptions = new OutdoorLocationOptions.Builder().
                enableOutdoorPositions(false).
                buildingDetector(OutdoorLocationOptions.BuildingDetector.WIFI_AND_BLE).
               .build();

3. Compute and Update Intervals

Situm SDK allows you to control de frequency with which:

1. Outdoor positions are computed, using the OutdoorLocationOptions.Builder().computeInterval method.
2. Outdoor positions are delivered via the LocationListener.onLocationChanged callback, using the OutdoorLocationOptions.Builder().updateInterval method.

Both methods are described in detail (including code snippets) in this section. 

4. Minimum Outdoor Accuracy

In addition to controlling the outdoor positioning frequency parameters (see previous section), Situm SDK allows you to filter out outdoor positioning that do not meet a certain accuracy criteria. You may do this by using the OutdoorLocationOptions.Builder().minimumOutdoorLocationAccuracy method. See this section for details and code examples.

5. Open Sky Detector (not recommended)

//By default the OpenSky detector is disabled
OutdoorLocationOptions outdoorLocationOptions = new OutdoorLocationOptions.Builder().build();        

//You may also disable it explicitly
OutdoorLocationOptions outdoorLocationOptions = new OutdoorLocationOptions.Builder(). 
enableOpenSkyDetector(false).
build();        

//Enables the OpenSky detector and sets the SNR threshold to 17dBms (above this value, the smartphone will be considered to be under "open sky"

OutdoorLocationOptions outdoorLocationOptions = new OutdoorLocationOptions.Builder(). 
enableOpenSkyDetector(true).
averageSnrThreshold(17.0).
build();