// Required by CommonAPI_Lib 
<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 by LocationAPI_Lib for 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.location.LocationService" />

					

int SITE_ID = 356;
int VERSION = 1;
String LANG = "fr";

String SERVER_URL = "https://services.test.insiteo.com/v3/Insiteo.Dispatch.test/Insiteo.Dispatch.svc";
Server SERVER = Server.TEST;

boolean ANALYTICS_ENABLED = true;

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

	// Set the Insiteo API key in order to use the SDK
	initProvider.setAPIKey(MY-API-KEY);

	// Launch the initialization process, the returned ICancelable can be used to cancel 
	// the initialization task.
	ICancelable mInitTask = initProvider.startAPI(context, listener, SERVER_URL, SITE_ID, VERSION,
	LANGUAGE, Server.TEST, ANALYTICS_ENABLED);

	(...)
}



/**
 * Callback received on API server initialization
 */
@Override
public void onInitDone(final EInitResult aInitRes, final InsiteoError aError) {
	runOnUiThread(new Runnable() {
		@Override
		public void run() {

			mInitProgress.dismiss();

			switch (aInitRes) {

			case FAIL:
				/**
				 * Initialization failed, you can check the InsiteoError for further
				 * information. In this case the API can still be used if the packages 
				 * were already downloaded  but some services such as Meetme will not 
				 * be functional. 
				 */
				break;

			case SUCCESS:
				/**
				 * Initialization succeeded and no new data are required to be download. 
				 * The Application can use all the LBS services as they are.
				 */
				break;

			case SUCCESS_WITH_NEW_DATA:
				/**
				 * 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) so the download process must be triggered. 
				 * Otherwise those data are optional.
				 */					
				break;					
			}
		}
	});
}

                    

// Trigger the package update. Like the initialization the 
// ICancelable task can be used to be cancel the update. 
ICancelable mUpdateTask = InitProvider.getInstance().updatePackages(activity, listener, false);

// The following callbacks will be notified.

/**
 * Callback received when the download of new data is processing. 
 * Those data can be used to notified the user.
 */
@Override
public void onDownloadProgress(long aDownloadedBytes, long aTotalBytes) {
}

/**
 * Callback received when a new package is starting being downloaded
 */
@Override
public void onPackageDowloadBegin(EPackageType aPkgType) {
}

/**
 * Callback received when the installation of new data is processing.
 * Those data can be used to notified the user.
 */
@Override
public void onInstallProgress(long aCurrentFile, long aTotalFiles) {
}

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

                    

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

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

                    

//How to add a custom renderer
mMapView.getController().addRenderer(mCustomRenderer);

                    

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

                    

//The method you will need to override in order to manually manage touch down events
public ETouchObjectResult onTouchDown(Touch aTouch){
}

                    

//Methods you will need to call in order to add an RTO on the map
public boolean addRTO(IRTO aObject); 
public boolean addRTOInZone(int aZoneID, IRTO aObject);

                    

//The method you will need to override handle touch events on interactive zones
public void onZoneClicked(int aZoneID, EZoneAction aActionType, String aActionParam);

                    

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

                    

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

                    

// Add an RTO in the zone center
mMapView.addRTOInZone(zoneId, myRTO);