NavigineSdkExample.java

Go to the documentation of this file.

package com.navigine.examples;
 
import com.navigine.idl.java.*;
 
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;

public class NavigineSdkExample {
 
    private NavigineSdk sdk;
    private LocationManager locationManager;
    private NavigationManager navigationManager;
    private ZoneManager zoneManager;
    private RouteManager routeManager;
    private AsyncRouteManager asyncRouteManager;
    private NotificationManager notificationManager;
    private MeasurementManager measurementManager;
    private LocationListManager locationListManager;
    private StorageManager storageManager;
    private MqttSession mqttSession;
    private LocationWindow locationWindow;
    private RouteLayer routeLayer;
    private GuidanceCamera guidanceCamera;
 
    public NavigineSdkExample() {
        initializeSdk();
    }

    private void initializeSdk() {
        try {
            // [java_NavigineSdk_getInstance]
            // Get SDK instance
            sdk = NavigineSdk.getInstance();
            // [java_NavigineSdk_getInstance]
 
            // [java_NavigineSdk_getVersion]
            // Get SDK version
            System.out.println("Navigine SDK Version: " + NavigineSdk.getVersion());
            // [java_NavigineSdk_getVersion]
 
            // [java_NavigineSdk_getDeviceId]
            // Get device ID
            System.out.println("Device ID: " + NavigineSdk.getDeviceId());
            // [java_NavigineSdk_getDeviceId]
 
            // [java_NavigineSdk_getRelativeTime]
            // Get relative time
            System.out.println("Relative Time: " + NavigineSdk.getRelativeTime());
            // [java_NavigineSdk_getRelativeTime]
 
            // [java_NavigineSdk_setUserHash]
            // Set user hash (authorization token)
            sdk.setUserHash("XXXX-XXXX-XXXX-XXXX");
            // [java_NavigineSdk_setUserHash]
 
 
            // [java_NavigineSdk_getUserAgent]
            System.out.println("User-Agent: " + NavigineSdk.getUserAgent());
            // [java_NavigineSdk_getUserAgent]
 
            // [java_NavigineSdk_reset]
            sdk.reset();
            System.out.println("SDK reset to initial state");
            // [java_NavigineSdk_reset]
 
            // [java_NavigineSdk_setServer]
            // Set server URL (optional)
            sdk.setServer("https://custom.navigine.com");
            // [java_NavigineSdk_setServer]
 
            // Initialize managers
            initializeManagers();
 
        } catch (Exception e) {
            System.err.println("SDK initialization error: " + e.getMessage());
        }
    }

    private void initializeManagers() {
        // [java_NavigineSdk_getLocationManager]
        // Get LocationManager for working with locations
        locationManager = sdk.getLocationManager();
        if (locationManager != null) {
            System.out.println("LocationManager successfully initialized");
        }
        // [java_NavigineSdk_getLocationManager]
 
        // [java_NavigineSdk_getNavigationManager]
        // Get NavigationManager for navigation
        if (locationManager != null) {
            navigationManager = sdk.getNavigationManager(locationManager);
            if (navigationManager != null) {
                System.out.println("NavigationManager successfully initialized");
            }
        }
        // [java_NavigineSdk_getNavigationManager]
 
        // [java_NavigineSdk_getZoneManager]
        // Get ZoneManager for working with zones
        if (navigationManager != null) {
            zoneManager = sdk.getZoneManager(navigationManager);
            if (zoneManager != null) {
                System.out.println("ZoneManager successfully initialized");
            }
        }
        // [java_NavigineSdk_getZoneManager]
 
        // [java_NavigineSdk_getRouteManager]
        // Get RouteManager for building routes
        if (locationManager != null && navigationManager != null) {
            routeManager = sdk.getRouteManager(locationManager, navigationManager);
            if (routeManager != null) {
                System.out.println("RouteManager successfully initialized");
            }
        }
        // [java_NavigineSdk_getRouteManager]
 
        // [java_NavigineSdk_getAsyncRouteManager]
        // Get AsyncRouteManager for async route operations
        if (locationManager != null && navigationManager != null) {
            asyncRouteManager = sdk.getAsyncRouteManager(locationManager, navigationManager);
            if (asyncRouteManager != null) {
                System.out.println("AsyncRouteManager successfully initialized");
            }
        }
        // [java_NavigineSdk_getAsyncRouteManager]
 
        // [java_NavigineSdk_getNotificationManager]
        // Get NotificationManager for notifications
        if (locationManager != null) {
            notificationManager = sdk.getNotificationManager(locationManager);
            if (notificationManager != null) {
                System.out.println("NotificationManager successfully initialized");
            }
        }
        // [java_NavigineSdk_getNotificationManager]
 
        // [java_NavigineSdk_getMeasurementManager]
        // Get MeasurementManager for measurements
        if (locationManager != null) {
            measurementManager = sdk.getMeasurementManager(locationManager);
            if (measurementManager != null) {
                System.out.println("MeasurementManager successfully initialized");
            }
        }
        // [java_NavigineSdk_getMeasurementManager]
 
        // [java_NavigineSdk_getLocationListManager]
        // Get LocationListManager for location list operations
        locationListManager = sdk.getLocationListManager();
        if (locationListManager != null) {
            System.out.println("LocationListManager successfully initialized");
        }
        // [java_NavigineSdk_getLocationListManager]
 
        // [java_NavigineSdk_getStorageManager]
        // Get StorageManager for working with storages
        storageManager = sdk.getStorageManager();
        if (storageManager != null) {
            System.out.println("StorageManager successfully initialized");
        }
        // [java_NavigineSdk_getStorageManager]
 
        // [java_NavigineSdk_getRouteLayer]
        // Create RouteLayer for building and drawing routes on the map
        if (locationWindow != null) {
            routeLayer = sdk.getRouteLayer(locationWindow);
            if (routeLayer != null) {
                System.out.println("RouteLayer successfully initialized");
            }
        }
        // [java_NavigineSdk_getRouteLayer]
 
        // [java_NavigineSdk_getGuidanceCamera]
        if (locationWindow != null && routeLayer != null) {
            guidanceCamera = sdk.getGuidanceCamera(locationWindow, routeLayer);
            // [java_GuidanceCamera_setMode]
            guidanceCamera.setMode(GuidanceCameraMode.FOLLOWING);
            // [java_GuidanceCamera_setMode]
            // [java_GuidanceCamera_set2DMode]
            guidanceCamera.set2DMode(false);
            // [java_GuidanceCamera_set2DMode]
            // [java_GuidanceCamera_mode]
            System.out.println("Guidance mode: " + guidanceCamera.mode());
            // [java_GuidanceCamera_mode]
            // [java_GuidanceCamera_instruction]
            RouteInstruction next = guidanceCamera.instruction();
            if (next != null) {
                System.out.println("Next instruction: " + next.getTitle() + " " + next.getDistance() + " m");
            }
            // [java_GuidanceCamera_instruction]
            // [java_GuidanceCamera_addListener]
            guidanceCamera.addListener(new GuidanceListener() {
                @Override
                public void onCameraModeChanged(GuidanceCameraMode mode) {
                    System.out.println("Guidance camera mode: " + mode);
                }
 
                @Override
                public void onInstructionChanged(RouteInstruction instruction) {
                    System.out.println("Next: " + (instruction == null ? "none" : instruction.getTitle()));
                }
            });
            // [java_GuidanceCamera_addListener]
        }
        // [java_NavigineSdk_getGuidanceCamera]
 
        // [java_NavigineSdk_getRouteSimulator]
        if (locationWindow != null) {
            RouteSimulator routeSimulator = sdk.getRouteSimulator(locationWindow);
            // [java_RouteSimulator_setGeometry]
            List<GlobalPoint> walkPoints = new ArrayList<>();
            walkPoints.add(new GlobalPoint(55.751, 37.618));
            walkPoints.add(new GlobalPoint(55.752, 37.618));
            routeSimulator.setGeometry(Collections.singletonList(new LocationPolyline(walkPoints, null)));
            // [java_RouteSimulator_setGeometry]
            // [java_RouteSimulator_setSpeed]
            routeSimulator.setSpeed(1.4f);
            // [java_RouteSimulator_setSpeed]
            // [java_RouteSimulator_start]
            boolean started = routeSimulator.start();
            System.out.println("Route walk started: " + started);
            // [java_RouteSimulator_start]
            // [java_RouteSimulator_sample]
            RouteSimulatorSample sample = routeSimulator.sample();
            if (sample != null) {
                System.out.println("Walk advance: " + sample.getAdvance() + " m");
            }
            // [java_RouteSimulator_sample]
        }
        // [java_NavigineSdk_getRouteSimulator]
 
        // [java_NavigineSdk_getMqttSession]
        // Get MqttSession for publishing position data via MQTT
        if (navigationManager != null) {
            mqttSession = sdk.getMqttSession(navigationManager);
            if (mqttSession != null) {
                System.out.println("MqttSession successfully initialized");
            }
        }
        // [java_NavigineSdk_getMqttSession]
    }

    public void printSdkInfo() {
        System.out.println("=== Navigine SDK Information ===");
        System.out.println("SDK Version: " + NavigineSdk.getVersion());
        System.out.println("Device ID: " + NavigineSdk.getDeviceId());
        System.out.println("Relative Time: " + NavigineSdk.getRelativeTime());
        System.out.println("LocationManager: " + (locationManager != null ? "available" : "unavailable"));
        System.out.println("NavigationManager: " + (navigationManager != null ? "available" : "unavailable"));
        System.out.println("ZoneManager: " + (zoneManager != null ? "available" : "unavailable"));
        System.out.println("RouteManager: " + (routeManager != null ? "available" : "unavailable"));
        System.out.println("AsyncRouteManager: " + (asyncRouteManager != null ? "available" : "unavailable"));
        System.out.println("NotificationManager: " + (notificationManager != null ? "available" : "unavailable"));
        System.out.println("MeasurementManager: " + (measurementManager != null ? "available" : "unavailable"));
        System.out.println("LocationListManager: " + (locationListManager != null ? "available" : "unavailable"));
        System.out.println("StorageManager: " + (storageManager != null ? "available" : "unavailable"));
        System.out.println("MqttSession: " + (mqttSession != null ? "available" : "unavailable"));
    }

    public void demonstrateManagersUsage() {
        System.out.println("=== Manager Usage Demonstration ===");
 
        // LocationManager usage example
        if (locationManager != null) {
            System.out.println("LocationManager ready for location operations");
            // Add code here for loading locations, working with them, etc.
        }
 
        // NavigationManager usage example
        if (navigationManager != null) {
            System.out.println("NavigationManager ready for positioning");
            // Add code here for getting position, setting up listeners, etc.
        }
 
        // ZoneManager usage example
        if (zoneManager != null) {
            System.out.println("ZoneManager ready for zone operations");
            // Add code here for setting up zones, handling enter/exit events, etc.
        }
 
        // RouteManager usage example
        if (routeManager != null) {
            System.out.println("RouteManager ready for route building");
            // Add code here for building routes, setting destination points, etc.
        }
 
        // AsyncRouteManager usage example
        if (asyncRouteManager != null) {
            System.out.println("AsyncRouteManager ready for async route operations");
            // Add code here for creating routing sessions, etc.
        }
 
        // NotificationManager usage example
        if (notificationManager != null) {
            System.out.println("NotificationManager ready for notifications");
            // Add code here for setting up beacon notifications, etc.
        }
 
        // MeasurementManager usage example
        if (measurementManager != null) {
            System.out.println("MeasurementManager ready for measurements");
            // Add code here for managing measurement generators, etc.
        }
 
        // LocationListManager usage example
        if (locationListManager != null) {
            System.out.println("LocationListManager ready for location list operations");
            // Add code here for getting available locations list, etc.
        }
 
        // StorageManager usage example
        if (storageManager != null) {
            System.out.println("StorageManager ready for storage operations");
            // Add code here for creating storages, managing data, etc.
        }
 
        // MqttSession usage example
        if (mqttSession != null) {
            System.out.println("MqttSession ready for publishing position data via MQTT");
            // Add code here for connecting to MQTT broker, publishing positions, etc.
        }
    }

    public static void main(String[] args) {
        NavigineSdkExample example = new NavigineSdkExample();
        example.printSdkInfo();
        example.demonstrateManagersUsage();
    }
}