//Set your API key
[ISInitProvider setAPIKey:@"MY-API-KEY"];

//And start the API
id<ISPCancelable> initTask = [[ISInitProvider instance] startAPIWithServerUrl:SERVER_URL andSiteId:SITE_ID andApplicationVersion:APPLICATION_VERSION andLanguage:LANGUAGE andForceDownload:NO andInitListener:aListener andServerType:PROD_SERVER andAnalyticsAutoStart:YES];

//The initTask object could be used to cancel the API initialization (see ISPCancelable protocol documentation).

(...)

//In your init listener:
- (void)onInitDone:(ISEInitAPIResult)result andError:(ISInsiteoError *)error {
    switch(result){
    case SUCCESS :
      //Init is ok
      break;
    case SUCCESS_NEW_DATA :
      //Init is ok and new packages are available
      break;
    case FAIL :
      //Init failed.
      //More information in error (see ISInsiteoError documentation)
      break;
    default:
      break;
    }
}

                    

//Notifications will be sent through following callbacks
id<ISPCancelable> initTask = [[ISInitProvider instance] updatePackagesWithInitListener:aListener];

//The initTask object could be used to cancel the API update (see ISPCancelable protocol documentation)

(...)

//Notifications will be sent to the listener through following callbacks:
- (void)onDownloadProgressWithProgress:(int)progress andTotal:(int)total {
    (...)
}
- (void)onInstallProgressWithProgress:(int)progress andTotal:(int)total {
    (...)
}
- (void)onDownloadPackageWillStart:(ISPackageType)packageType {
    (...)
}
- (void)onDataUpdateDone:(Boolean)success andError:(ISInsiteoError *)error {
    (...)
}

                    

//ISMapViewController initialization
ISMapViewController * mapViewController = [[ISMapViewController alloc] initWithMapListener:aListener andContentView:aContentView];

                    

//How to add a custom renderer
[mapViewController addRenderer:aRenderer]];

                    

//The method you will need to override in order to manually manage your object rendering
- (void)invalidateWithLayer:(ISLayer *)layer andRatio:(double)ratio andOffset:(CGPoint)offset andAngle:(float)angle andPriority:(int)priority;

                    

//The method you will need to override in order to manually manage touch down events
- (ISETouchObjectResult)onTouchDown:(ISTouch *)touch;

                    

//Methods you will need to call in order to add an RTO on the map
- (Boolean)addRTO:(id<ISPRTO>)rto;
- (Boolean)addRTO:(id<ISPRTO>)rto inZone:(int)zoneId;

                    

//The method you will need to override handle touch events on interactive zones
- (void)onZoneClickedWithZone:(int)idZone andActionType:(int)actionType andActionParameter:(NSString *)actionParameter;

                    

//Get all Zone/POI assocations for a given external identifier
NSArray * zonesPois = [ISDBHelperMap getExternalZonePoisForExtIdPoi:externalPoiId];

                    

//Get all external Zone/POI assocations for a given zone identifier
NSArray * zonesPois = [ISDBHelperMap getZonePoisForIdZone:zoneId andExternal:YES];

                    

//Add an RTO in the zone center
[mapViewController addRTO:myRto inZone:zonePoi.zoneId];

                    

//Cocos2d
- (void)applicationDidEnterBackground:(UIApplication *)application {
    [[CCDirector sharedDirector] stopAnimation];
}

- (void)applicationWillEnterForeground:(UIApplication *)application {
    [[CCDirector sharedDirector] startAnimation];
}

- (void)applicationWillResignActive:(UIApplication *)application {
    [[CCDirector sharedDirector] pause];
}

- (void)applicationDidBecomeActive:(UIApplication *)application {
    [[CCDirector sharedDirector] resume];
}

//Insiteo
- (void)viewDidAppear:(BOOL)animated {
    [super viewDidAppear:animated];
    [mapViewController startRendering];
}

- (void)viewDidDisappear:(BOOL)animated {
    [super viewDidDisappear:animated];
    [mapViewController stopRendering];
}

                    

//Instanciate the location provider
ISGfxLocationProvider * locProvider = [[ISGfxLocationProvider alloc] init];

//And start it
[locProvider startLocation:(COMPASS|BLE|MEMS) andLocationListener:aListener];

//Add location renderer to the ISMapViewController, thus location is displayed on map
[mapViewController addRenderer:[locProvider renderer]];

                    

//Get the itinerary provider
ISGfxItineraryProvider * itineraryProvider = (ISGfxItineraryProvider *)[locProvider getLbsModule:LBS_MODULE_ITINERARY];

//Get itinerary renderer linked to provider
ISItineraryRenderer * itineraryRenderer = [itineraryProvider renderer];

//Register for itinerary rendering user interaction (such as clicks).
[itineraryRenderer setRenderListener:listener];

//Add renderer so itinerary is displayed on map
[map2DView addRenderer:itineraryRenderer];

                    

//Request an itinerary between two points (A on map "1", the other on map "2")
ISItineraryRequest * request = [itineraryProvider requestItineraryWithStartPoint:CGPointMake(50, 50) andStartMapId:1 andEndPoint:CGPointMake(200, 100) andEndMapId:2 andListener:itineraryListener andPMR:NO];

                    

//Request an itinerary from the user location to a point A
ISItineraryRequest * request = [itineraryProvider requestItineraryFromCurrentLocationWithEndPoint:CGPointMake(200, 100) andEndMapId:2 andListener:itineraryListener andPMR:NO];

                    

//Request an optimized route between several waypoints (an ISItineraryOptimizedRequest is returned)
ISItineraryOptimizedRequest * optimizedRequest = [itineraryProvider requestOptimizedItineraryWithWaypoints:waypoints andOptimMode:ISEOptimizationModeNearestNeighbourShortestPath andKeepFirstPosition:YES andKeepLastPosition:NO andListener:itineraryListener andPMR:NO];

                    

//Method called on the main thread
- (void)mainRecomputeItinerary {
    //Request an itinerary from the user current location
    [itineraryProvider requestItineraryFromCurrentLocationWithEndPoint:CGPointMake(200, 100) andEndMapId:2 andListener:itineraryListener andPMR:NO];
}

//Method called when the user position changed
- (void)onItineraryChangedWithRequest:(ISItineraryBaseRequest *)request andDistanceToItinerary:(float)distanceToItinerary {
    //You can check if the distance between the user location and the computed itineray needs a recomputation
    if (distanceToItinerary > MAX_RECOMPUTATION_DISTANCE) {
        //The recomputation needs to be done on the main thread
        [self performSelectorOnMainThread:@selector(mainRecomputeItinerary) withObject:nil waitUntilDone:NO];
    }
}

                    

//Get the geofencing module from the location provider
ISGeofenceProvider * geofenceProvider = [[m_locationProvider getLbsModule:LBS_MODULE_GEOFENCING] retain];
    
//"Start" geofencing
[geofenceProvider setListener:listener];

                    

//Method alled when geofencing module has new data available
- (void)onGeofenceDataUpdateWithEnteredZones:(NSArray *)enteredZones andStayedZones:(NSArray *)stayedZones andLeftZones:(NSArray *)leftZones {
    //Entered zones
    for (ISGeofenceZone * geoZone in enteredZones) {
        NSLog(@"User entered zone %@", geoZone.GUID);
    }

    //Stayed zones
    for (ISGeofenceZone * geoZone in stayedZones) {
        NSLog(@"User still is in zone %@", geoZone.GUID);
    }

    //Left zones
    for (ISGeofenceZone * geoZone in leftZones) {
        NSLog(@"User has left zone %@", geoZone.GUID);
    }
}