// Required for global API use
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WAKE_LOCK"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
	
// Required for Location purposes (GPS, WIFI and BLE scan)
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/>
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />

					

// CAUTION: make sure to declare the location service.
<service android:name="com.insiteo.lbs.location.LocationService" />

					

			
				
private void initAPI() {
	InitProvider initProvider = InitProvider.getInstance(); 

	// Make sure to provide your API key before initializing our API 
	initProvider.setAPIKey(InsiteoConf.API_KEY);

	// Start Insiteo API initialization (asynchronous), and get the running initialization task
	initProvider.start(Activity.this, InsiteoConf.SERVER, InsiteoConf.SITE_ID, InsiteoConf.LANG, this, InsiteoConf.RENDER_MODE);
}
				
/** 
Callback received on API server initialization. 
Caution: This callback is not alway triggered on the UI thread. 
*/
@Override
public Stack onInitDone(InsiteoError aError, Stack packageToUpdate) {

	/* If the error is different from null then it means that the initialization has failed. Most likely this comes from a wrong API key or no network access. A failure in the API initialization does not mean that our services are unavailable. As we work with data package this only mean that you might not be using the last version of the server data. Nevertheless if you have old data you can still take advantage of our services (only some services such as Meetme won't be available as they request server interaction). 
Caution: Be sure to check that you have the required package data before using our services. */
	if(aError != null) {
		// Handle error cases.
		return null;
	} 
	
	/* The error is null and the stack of packages to update is empty, this means that your application is already using the most up to date set of data. You can use all the services normally. */
	else if(packageToUpdate.isEmpty()) {
		// Use Location Based Services.
		return null;
	} 
	
	/* Initialization succeeded and new data are available. If the application is launched for the first time the data will be required for the application to work (for example to download the map tiles, the location data and so on) so the download process must be triggered. Otherwise those data are optional and can still work with old values. If you want to automatically start the download process you can return a stack of package to download (it is up to you to filter the list at your convenience), otherwise you can trigger the download later, after a specific user interaction for example. */	
	else {
		return (AUTOMATIC_DOWNLOAD) ? packageToUpdate : null;
	}
}

/**
Packages are being updated, you can, for example, use this callback to display a progress bar 
*/
@Override
public void onPackageUpdateProgress(EPackageType packageType, boolean download, long progress, long total) {	
	if(download) {
		/** For the download process the progress is given in bytes */
	} else {
		/** For the install process the progress is given in number of files */
	}
}

/**
Callback received when the entire process of data update is done.
*/
@Override
public void onDataUpdateDone(boolean aSuccess, InsiteoError aError) {
		
}
			 
		

			
//Map2DView initialization in JAVA
Map2DView mMapView = new Map2DView(getActivity()); 

// or in xml 
<com.insiteo.map.Map2DView
    android:id="@+id/insiteo_map"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent" />
			
        

			
/* This method will add the rto at the map center */
GenericRto genericRTO = new GenericRTO(mapView.getScreenCenter(), "MyRTO");
mapView.addRTO(genericRTO);

/* And to remove it */
mapView.removeRTO(genericRTO);

/* This method will add the rto to the given zone */
GenericRto genericRTO = new GenericRTO(mapView.getScreenCenter(), "MyRTO");
genericRTO.setLabel("MyRTO");
mapView.addRTOInZone(zoneId, genericRTO);

/* And to remove it */
mapView.removeRTOFromZone(zoneId, genericRTO);

/* Add a listener for this type of IRTO */
mMapView.setRTOListener(listener, GfxRto.class);
			
        

			
/* How to add a custom renderer */
mapView.addRenderer(myCustomRenderer);
			
        

			
/* The method you will need to override in order to manually manage your object 2D rendering */
public void render2D(Canvas aCanvas, double aRatio, Point aOffset, float aAngle) {
}

/* The method you will need to override in order to manually manage your object 3D rendering */
public void render3D(ISWorld world, FrameBuffer frameBuffer, Map map, double ratio, float angle) {
}

/* Because once added to the world a 3D object will always be drawn it is up to you to remove the object from the world when required */
public void remove3DObject(ISWorld world) {
}

/* Method that gets called when the IRTO have to handle a touch down event */
public ETouchObjectResult onTouchDown(Touch aTouch) {
}
			
        

			
// Get all Zone/POI assocations for a given external identifier
List<ZonePoi> zonePois = MapDBHelper.getZoneAssocFromExtPoi(extPoiID);
			
        

			
//Get all external Zone/POI assocations for a given zone identifier
List<ZonePoi> zonePois = MapDBHelper.getPoiAssocFromZone(zoneId, isExternal);
			
        

// Retrieve the LocationProvider singleton
LocationProvider locProvider = LocationProvider.getInstance();

// And start the location process with the required flags.
locProvider.start(getActivity(), this, InsiteoConf.LOCATION_FLAGS); 

// Add location renderer to the MapView so that location is automatically displayed.
mMapView.addRenderer((LocationRenderer)LocationProvider.getInstance().getRenderer(getResources()););

                    

// Retrieve the itinerary module from the LocationProvider
mItineraryProvider = (ItineraryProvider) LocationProvider.getInstance().getModule(ELocationModule.ITINERARY);

// get itinerary renderer linked to provider
mItineraryRenderer = (ItineraryRenderer) mItineraryProvider.getRenderer(getResources());
mItineraryRenderer.setPriority(10);

// Add this renderer to the map renderers list
mMapView.addRenderer(mItineraryRenderer);

// Register for itinerary rendering user interaction (such as clicks).
mItineraryRenderer.setListener(this);

                    

// Request an itinerary between two points.
Position departure = new Position(startMapId, 40, 40);
Position arrival = new Position(destMapId, 168, 100);
mItineraryProvider.requestItinerary(departure, arrival, this, PMR_ENABLED);

                    

// Request an itinerary from the user location to a point arrival.
// With USE_LAST_LOC, you can decide to use the last location or wait for a new one.
// With PMR_ENABLED, you can set the itinerary to use only path for disabled persons.
Position arrival = new Position(mapID, 168, 100);
mItineraryProvider.requestItineraryFromCurrentLocation(arrival, USE_LAST_LOC, this, PMR_ENABLED);

                    

// Request an optimized route between several positions (an OptimizeRequest is returned)
mItineraryProvider.requestOptimizedItinerary(pos, EOptimizationMode.EOptimizationModeNearestNeighbourShortestPath, true, false, this, false);

                    

/**
 * Callback fired when the itinerary of the last request changed (when location is updated for example). 
 * This method can be used to ask for a new itinerary if the user is now too far from the itinerary (we usually recompute
 * the itinerary over a distance of 5 meters).
 * @param aRequest the related request
 * @param aDistanceToIti the distance between the user location and the itinerary (in meter)
 */
@Override
public void onItineraryChanged(BaseRequest aRequest, float aDistanceToIti) {
	if (aRequest instanceof ItineraryRequest && LocationProvider.getInstance().isStarted()) {	
		if (aDistanceToIti > MAX_RECOMPUTATION_DISTANCE || aDistanceToIti == -1) {
			aRequest.recompute();
		}
	}
}

                    

// Retrieve the geofencing module
mGeofenceProvider = (GeofenceProvider) LocationProvider.getInstance().getModule(ELocationModule.GEOFENCING);

// Register as a IGeofenceListener
mGeofenceProvider.setListener(this);

                    

/**
 * Called when geofencing module has new data available.
 * @param aEnteredAreas list of areas that location has just entered  
 * @param aStayedAreas list of areas where location has stayed for a certain amount of time
 * @param aLeftAreas list of areas that location has just left
 */
@Override
public void onGeofenceUpdate(List aEnteredAreas, List aStayedAreas, List aLeftAreas) {
	Log.d("Geofencing", " onGeofenceUpdate: " + aEnteredAreas.size() + ", " 
 + aStayedAreas.size() + ", " + aLeftAreas.size()); 
}

                    

// For a Zone

public GeofenceArea addGeofenceArea(int zoneId, String content);

public GeofenceArea addGeofenceArea(int zoneId, String content, long eventTime);

public GeofenceArea addGeofenceArea(int zoneId, String content, boolean enteredEnabled, long enteredTime, boolean stayedEnabled, long stayedTime, boolean leaveEnabled, long leaveTime, float width);

// For a ZonePoi association

public GeofenceArea addGeofenceArea(ZonePoi zonePoi, String content);

public GeofenceArea addGeofenceArea(ZonePoi zonePoi, String content, long eventTime);

public GeofenceArea addGeofenceArea(ZonePoi zonePoi, String content, boolean enteredEnabled, long enteredTime, boolean stayedEnabled, long stayedTime, boolean leaveEnabled, long leaveTime, float width);

                    

public GeofenceArea addGeofenceArea(String guid, Position center, String content);

public GeofenceArea addGeofenceArea(String guid, Position center, String content, long eventTime);

public GeofenceArea addGeofenceArea(String guid, Position center, String content, boolean enteredEnabled, long enteredTime, boolean stayedEnabled, long stayedTime, boolean leaveEnabled, long leaveTime);

public GeofenceArea addGeofenceArea(String guid, Position center, float size, String content);

public GeofenceArea addGeofenceArea(String guid, Position center, float size, String content, long eventTime);

public GeofenceArea addGeofenceArea(String guid, Position center, float size, String content, boolean enteredEnabled, long enteredTime, boolean stayedEnabled, long stayedTime, boolean leaveEnabled, long leaveTime);

                    

public void removeGeofenceArea(String guid);

public void removeGeofenceArea(int zoneId);

public void removeGeofenceArea(ZonePoi zonePoi);

public void removeGeofenceArea(GeofenceArea area);

                    

AnalyticsGenericEvent event = new AnalyticsGenericEvent("generic_event");
zoneEvent.setString1("product a");
zoneEvent.setPos1(aLocation.getPosition());
AnalyticsManager.getInstance().addGenericEvent(event);