Overview

Poilabs Visually Navigation SDK Implementation and Installation Guide. SDK support iOS and Android Native Applications. Besides, React or Flutter apps can use this SDK as a native library. For more information, see below.

To integrate and run the applications, the following variables are needed.

[tabby title=”iOS Native”]

iOS Native

pod 'PoilabsVdNavigation'

import PoilabsVdNavigationUI

let lang = Locale.current.languageCode ?? "tr"
let appId = APPLICATION_ID
let secret = APPLICATION_SECRET_KEY
let uniqueIdentifier = UNIQUE_ID

PoilabsVdNavigationUI(withApplicationID: appId, 
					withApplicationSecret: secret, 
					withUniqueIdentifier: uniqueIdentifier) { (controller) in
            //show controller
        }

    func poilabsVdNavigation(didUpdate userLocation: CLLocationCoordinate2D) {
    
    }

[tabby title=”Android Native”]

Android Native

allprojects {  
    repositories {  
  	  maven {  
  		   url "https://jitpack.io" 
  		   credentials { username = 'JITPACK_TOKEN' }  
  	  }  
    }  
}

  
dependencies {  
	 implementation 'com.github.poiteam:Android-VD-Navigation-SDK:7.0.8'  
 }  

   <uses-permission android:name="android.permission.BLUETOOTH" />
   <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
   <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
   <uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
   <uses-permission android:name="android.permission.INTERNET" />
   <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
   <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
   <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
   super.onViewCreated(view, savedInstanceState)

   PoiManager.init(
      activity,
      appId = APPLICATION_ID,
      secret = APPLICATION_SECRET_KEY,
      optionalUrl = "https://redirect.url",
      language = localeLanguage,
      title = "A title for your app",
      vdResponseListener =  object : VDResponseListener {
         override fun onSuccess() {
            PoiManager.setUniqueId("IGA test unique id")
            Intent(requireContext(), PoiVdNavigationActivity::class.java).also {
               startActivity(it)
            }
         }

         override fun onFail(throwable: Throwable?) {
            Toast.makeText(requireContext(), throwable?.message, Toast.LENGTH_SHORT).show()
         }
      },
      locationCallback = object : LocationCallback {
         override fun onLocation(latitude: Double, longitude: Double, floorLevel: Int?) {
            Log.i("TAG", "onLocation: $latitude, $longitude, $floorLevel")
         }

         override fun onStatusChanged(status: PLPStatus) {
            Log.i("TAG", "onStatusChanged: $status")
         }

      })
}

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
   super.onViewCreated(view, savedInstanceState)

   PoiManager.init(
      activity,
      appId = APPLICATION_ID,
      secret = APPLICATION_SECRET_KEY,
      language = localeLanguage,
      title = "A title for your app",
      vdResponseListener =  object : VDResponseListener {
         override fun onSuccess() {
            PoiManager.setUniqueId("IGA test unique id")
            Intent(requireContext(), PoiVdNavigationActivity::class.java).also {
               startActivity(it)
            }
         }

         override fun onFail(throwable: Throwable?) {
            Toast.makeText(requireContext(), throwable?.message, Toast.LENGTH_SHORT).show()
         }
      },
      locationCallback = object : LocationCallback {
         override fun onLocation(latitude: Double, longitude: Double, floorLevel: Int?) {
            Log.i("TAG", "onLocation: $latitude, $longitude, $floorLevel")
         }

         override fun onStatusChanged(status: PLPStatus) {
            Log.i("TAG", "onStatusChanged: $status")
         }

      })
}

-printmapping out.map
-keepparameternames
-renamesourcefileattribute SourceFile
-keepattributes Exceptions,InnerClasses,Signature,Deprecated,SourceFile,LineNumberTable,EnclosingMethod

# Preserve all annotations.

-keepattributes *Annotation*

# Preserve all public classes, and their public and protected fields and
# methods.

-keep public class * {
    public protected *;
}

# Preserve all .class method names.

-keepclassmembernames class * {
    java.lang.Class class$(java.lang.String);
    java.lang.Class class$(java.lang.String, boolean);
}

# Preserve all native method names and the names of their classes.

-keepclasseswithmembernames class * {
    native <methods>;
}

# Preserve the special static methods that are required in all enumeration
# classes.

-keepclassmembers class * extends java.lang.Enum {
    public static **[] values();
    public static ** valueOf(java.lang.String);
}

# Explicitly preserve all serialization members. The Serializable interface
# is only a marker interface, so it wouldn't save them.
# You can comment this out if your library doesn't use serialization.
# If your code contains serializable classes that have to be backward
# compatible, please refer to the manual.

-keepclassmembers class * implements java.io.Serializable {
    static final long serialVersionUID;
    static final java.io.ObjectStreamField[] serialPersistentFields;
    private void writeObject(java.io.ObjectOutputStream);
    private void readObject(java.io.ObjectInputStream);
    java.lang.Object writeReplace();
    java.lang.Object readResolve();
}

-keep public interface com.poilabs.vd.nav.non.ui.jsonclient.ApiInterface
-keep public interface com.poilabs.vd.nav.non.ui.jsonclient.VDResponseListener



-keep class com.poilabs.vd.nav.non.ui.models.** { *; }
-keep class com.poilabs.vd.nav.non.ui.manager.VDCallbacks
-keep class com.poilabs.android.poilabsanalytics.model.** { *; }

-dontwarn   com.poilabs.vd.nav.non.ui.Utils.**

-keep public class * implements com.bumptech.glide.module.GlideModule
-keep class * extends com.bumptech.glide.module.AppGlideModule {
 <init>(...);
}
-keep public enum com.bumptech.glide.load.ImageHeaderParser$** {
  **[] $VALUES;
  public *;
}
-keep class com.bumptech.glide.load.data.ParcelFileDescriptorRewinder$InternalRewinder {
  *** rewind();
}

[tabby title=”React Native”]

React Native Implementation

use_frameworks!
.....
  use_react_native!(
    .....
  )
.....
pod 'PoilabsVdNavigation'

import UIKit
import PoilabsVdNavigationUI

@objc  class PoilabsVdNavigationManager: NSObject  {
    @objc func showPoilabsVdNavigation() {
        let appId = "applicationId"
        let secret = "applicationSecret"
        let uniqueIdentifier = "UNIQUE_ID"
    
        let _ = PoilabsVdNavigationUI(withApplicationID: appId, withApplicationSecret: secret, withUniqueIdentifier: uniqueIdentifier) { controller in
            DispatchQueue.main.async {
            let keyWindow = UIApplication.shared.windows.first(where: { $0.isKeyWindow }) ?? UIApplication.shared.windows.first
            let topController = keyWindow?.rootViewController
          topController?.show(controller, sender: self)
        }
      }
    }
}

#ifndef PoilabsNavigationBridge_h
#define PoilabsNavigationBridge_h

#import <React/RCTBridgeModule.h>

@interface PoilabsNavigationBridge : NSObject <RCTBridgeModule>

-(void) showPoilabsVdNavigation;

@end
#endif /* PoilabsNavigationBridge_h */

#import <Foundation/Foundation.h>
#import "PoilabsNavigationBridge.h"
#import "YOUR_PROJECT_NAME-Swift.h"

@implementation PoilabsNavigationBridge: NSObject


RCT_EXPORT_MODULE(PoilabsNavigationBridge);

RCT_EXPORT_METHOD(showPoilabsVdNavigation) {
  dispatch_async(dispatch_get_main_queue(), ^{
    PoilabsVdNavigationManager* vdManager = [[PoilabsVdNavigationManager alloc] init];
    [vdManager showPoilabsVdNavigation];
  });
}

@end

allprojects {  
      repositories {  
          maven {  
               url "https://jitpack.io" 
               credentials { username = 'JITPACK_TOKEN' }  
          }  
      }  
}

  
dependencies {  
     implementation 'com.github.poiteam:Android-VD-Navigation-SDK:7.0.6'  
 }  

   <uses-permission android:name="android.permission.BLUETOOTH" />
   <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
   <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
   <uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
   <uses-permission android:name="android.permission.INTERNET" />
   <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
   <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
   <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

import androidx.annotation.NonNull;

import com.facebook.react.ReactPackage;
import com.facebook.react.bridge.NativeModule;
import com.facebook.react.bridge.ReactApplicationContext;
import com.facebook.react.uimanager.ViewManager;

import java.util.Collections;
import java.util.List;

public class PoilabsPackage implements ReactPackage {
    @NonNull
    @Override
    public List<NativeModule> createNativeModules(@NonNull ReactApplicationContext reactContext) {
        return Collections.singletonList(new PoilabsNavigationBridge(reactContext));
    }

    @NonNull
    @Override
    public List<ViewManager> createViewManagers(@NonNull ReactApplicationContext reactContext) {
        return Collections.emptyList();
    }
}

import android.content.Intent
import com.facebook.react.bridge.ReactApplicationContext
import com.facebook.react.bridge.ReactContextBaseJavaModule
import com.facebook.react.bridge.ReactMethod
import com.getpoi.android_vd_nav_ui.view.PoiVdNavigationActivity
import com.poilabs.vd.nav.non.ui.jsonclient.VDResponseListener
import com.poilabs.vd.nav.non.ui.models.PoiManager

class PoilabsNavigationBridge internal constructor(context: ReactApplicationContext?) :
    ReactContextBaseJavaModule(context) {
    override fun getName(): String {
        return "PoilabsNavigationBridge"
    }
    @ReactMethod
    fun showPoilabsVdNavigation() {
        currentActivity?.let { activity ->
            PoiManager.init(
                context = activity.baseContext,
                appId = "APPLICATION_ID",
                secret = "APPLICATION_SECRET_KEY",
                language = "en",
                title = "PLACE_TITLE",
                vdResponseListener = object : VDResponseListener {
                    override fun onSuccess() {
                        Intent(activity.applicationContext, PoiVdNavigationActivity::class.java).also {
                            activity.startActivity(it)
                        }
                    }
                    override fun onFail(throwable: Throwable?) {

                    }
                })
        }
    }
}

    override fun getPackages(): List<ReactPackage> =
        PackageList(this).packages.apply {
          add(PoilabsPackage())
        }

import {
  NativeModules,
} from 'react-native';

NativeModules.PoilabsNavigationBridge.showPoilabsVdNavigation();

[tabby title=”Flutter”]

Flutter Implementation

PoilabsVdNavigation

Flutter apps integrate the VD Navigation SDK through MethodChannel, bridging to native iOS and Android SDKs. Each platform handles SDK initialization and UI natively, while Flutter triggers navigation via a shared channel.

Architecture

iOS Side

Installation

To integrate PoilabsVdNavigation into your iOS project using CocoaPods, add to your Podfile. The use_frameworks! directive must appear before any Flutter-related calls:

use_frameworks!

# Flutter pods
flutter_application_path = '../my_flutter_app'
load File.join(flutter_application_path, '.ios', 'Flutter', 'podhelper.rb')
install_all_flutter_pods(flutter_application_path)

pod 'PoilabsVdNavigation'

Then run:

$ pod install
$ open Runner.xcworkspace

Pre-Requirements

Add the following keys to your Info.plist:

+Privacy – Location Usage Description
+Privacy – Location When In Use Usage Description
+Privacy – Location Always Usage Description
+Privacy – Location Always and When In Use Usage Description
+Privacy – Bluetooth Peripheral Usage Description
+Privacy – Bluetooth Always Usage Description

Usage — AppDelegate.swift

Register a FlutterMethodChannel in your AppDelegate. When Flutter calls start, initialize PoilabsVdNavigationUI which returns a UIViewController:

import UIKit
import Flutter
import PoilabsVdNavigationUI

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
    override func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        GeneratedPluginRegistrant.register(with: self)

        let controller = window?.rootViewController as! FlutterViewController
        let channel = FlutterMethodChannel(
            name: "com.poilabs/vdNavigationChannel",
            binaryMessenger: controller.binaryMessenger
        )

        channel.setMethodCallHandler { [weak self] (call, result) in
            if call.method == "start" {
                self?.startVdNavigation(from: controller, result: result)
            } else {
                result(FlutterMethodNotImplemented)
            }
        }

        return super.application(application, didFinishLaunchingWithOptions: launchOptions)
    }

    private func startVdNavigation(from controller: UIViewController, result: @escaping FlutterResult) {
        let lang = Locale.current.languageCode ?? "tr"
        let appId = "APPLICATION_ID"
        let secret = "APPLICATION_SECRET_KEY"
        let uniqueId = "UNIQUE_ID"

        PoilabsVdNavigationUI(
            withApplicationID: appId,
            withApplicationSecret: secret,
            withUniqueIdentifier: uniqueId,
            lang: lang
        ) { navController in
            DispatchQueue.main.async {
                controller.present(navController, animated: true)
                result("NavigationStarted")
            }
        }
    }
}

If you need to specify a custom redirect URL:

PoilabsVdNavigationUI(
    configUrl: "https://your-redirect-url.com",
    withApplicationID: appId,
    withApplicationSecret: secret,
    withUniqueIdentifier: uniqueId,
    lang: lang
) { navController in
    DispatchQueue.main.async {
        controller.present(navController, animated: true)
        result("NavigationStarted")
    }
}

Android Side

Installation

Add JitPack repository to your project-level build.gradle:

allprojects {
    repositories {
        maven {
            url "https://jitpack.io"
            credentials {
                username = 'JITPACK_TOKEN'
            }
        }
    }
}

Add the VD Navigation SDK dependency to your app-level build.gradle:

dependencies {
    implementation 'com.github.poiteam:Android-VD-Navigation-SDK:7.0.6'
}

Pre-Requirements

The following permissions are required in your AndroidManifest.xml:

<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

Minimum requirement: Android 5.0 (API level 21)

Usage — MainActivity.kt

Register a MethodChannel in your MainActivity. When Flutter calls start, initialize PoiManager (two-phase init):

import io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugin.common.MethodChannel
import android.content.Intent
import com.getpoi.android_vd_nav_ui.view.PoiVdNavigationActivity
import com.poilabs.vd.nav.non.ui.jsonclient.VDResponseListener
import com.poilabs.vd.nav.non.ui.models.PoiManager
import com.poilabs.vd.nav.non.ui.models.LocationCallback
import com.poilabs.positioning.model.PLPStatus

class MainActivity : FlutterActivity() {
    private val CHANNEL = "com.poilabs/vdNavigationChannel"

    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)

        MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL)
            .setMethodCallHandler { call, result ->
                if (call.method == "start") {
                    startVdNavigation(result)
                } else {
                    result.notImplemented()
                }
            }
    }

    private fun startVdNavigation(result: MethodChannel.Result) {
        PoiManager.init(
            context = this,
            appId = "APPLICATION_ID",
            secret = "APPLICATION_SECRET_KEY",
            language = "en",
            title = "Navigation",
            vdResponseListener = object : VDResponseListener {
                override fun onSuccess() {
                    PoiManager.setUniqueId("UNIQUE_ID")
                    Intent(this@MainActivity, PoiVdNavigationActivity::class.java).also {
                        startActivity(it)
                        result.success("NavigationStarted")
                    }
                }
                override fun onFail(throwable: Throwable?) {
                    result.error("VD_INIT_FAILED", throwable?.message, null)
                }
            },
            locationCallback = object : LocationCallback {
                override fun onLocation(latitude: Double, longitude: Double, floorLevel: Int?) {
                    // Handle location updates
                }
                override fun onStatusChanged(status: PLPStatus) {
                    // Handle status changes
                }
            }
        )
    }
}

Using SDK with a redirect URL — add the optionalUrl parameter:

PoiManager.init(
    context = this,
    appId = "APPLICATION_ID",
    secret = "APPLICATION_SECRET_KEY",
    optionalUrl = "https://your-redirect-url.com",
    language = "en",
    title = "Navigation",
    vdResponseListener = object : VDResponseListener { ... },
    locationCallback = object : LocationCallback { ... }
)

Dart / Flutter Side

Create a simple Flutter widget that triggers native VD Navigation via MethodChannel:

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';

class VdNavigationScreen extends StatelessWidget {
  static const _channel = MethodChannel('com.poilabs/vdNavigationChannel');

  const VdNavigationScreen({super.key});

  Future<void> _startNavigation() async {
    try {
      await _channel.invokeMethod('start');
    } on PlatformException catch (e) {
      debugPrint('VD Navigation error: ${e.message}');
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('VD Navigation')),
      body: Center(
        child: ElevatedButton(
          onPressed: _startNavigation,
          child: const Text('Start VD Navigation'),
        ),
      ),
    );
  }
}

Configuration

Callback Reference

iOS

Android

Common Errors

[tabbyending]

Resources And Useful Links

1. iOS Native Example App
2. Android Native Example App