ZoneManager Directory Reference

Directories
	dart
	java
	kotlin
	objc
	swift

Detailed Description

This directory contains comprehensive examples demonstrating the usage of Navigine SDK's ZoneManager functionality across all supported platforms.

Overview

ZoneManager is used for detecting when users enter or leave specific zones within a location. It provides real-time notifications about zone events through a listener pattern.

Key Components

ZoneManager

• Purpose: Manages zone detection and event notifications
• Key Methods:
  • addZoneListener(ZoneListener listener) - Add a listener for zone events
  • removeZoneListener(ZoneListener listener) - Remove a previously added listener

ZoneListener

• Purpose: Interface for receiving zone event notifications
• Key Methods:
  • onZoneEvent(ZoneEvent zoneEvent) - Called when a zone event occurs

ZoneEvent

• Purpose: Contains information about a zone event
• Properties:
  • type - Type of event (ENTER/EXIT)
  • locationId - ID of the location
  • sublocationId - ID of the sublocation
  • id - ID of the zone
  • name - Name of the zone
  • alias - Alias of the zone

ZoneEventType

• Purpose: Enumeration of zone event types
• Values:
  • ENTER - User entered a zone
  • EXIT - User left a zone

Platform-Specific Files

Dart/Flutter

• File: dart/zone_manager_example.dart
• Key Tags:
  • [dart_NavigineSdk_getZoneManager]
  • [dart_ZoneManager_addZoneListener]
  • [dart_ZoneManager_removeZoneListener]
  • [dart_ZoneListener_onZoneEvent]
  • [dart_ZoneEvent_getType]
  • [dart_ZoneEvent_getLocationId]
  • [dart_ZoneEvent_getSublocationId]
  • [dart_ZoneEvent_getId]
  • [dart_ZoneEvent_getName]
  • [dart_ZoneEvent_getAlias]
  • [dart_ZoneEvent_constructor]
  • [dart_ZoneEventType_values]

Java

• File: java/ZoneManagerExample.java
• Key Tags:
  • [java_NavigineSdk_getZoneManager]
  • [java_ZoneManager_addZoneListener]
  • [java_ZoneManager_removeZoneListener]
  • [java_ZoneListener_onZoneEvent]
  • [java_ZoneEvent_getType]
  • [java_ZoneEvent_getLocationId]
  • [java_ZoneEvent_getSublocationId]
  • [java_ZoneEvent_getId]
  • [java_ZoneEvent_getName]
  • [java_ZoneEvent_getAlias]
  • [java_ZoneEvent_constructor]
  • [java_ZoneEventType_values]

Kotlin

• File: kotlin/ZoneManagerExample.kt
• Key Tags:
  • [kotlin_NavigineSdk_getZoneManager]
  • [kotlin_ZoneManager_addZoneListener]
  • [kotlin_ZoneManager_removeZoneListener]
  • [kotlin_ZoneListener_onZoneEvent]
  • [kotlin_ZoneEvent_getType]
  • [kotlin_ZoneEvent_getLocationId]
  • [kotlin_ZoneEvent_getSublocationId]
  • [kotlin_ZoneEvent_getId]
  • [kotlin_ZoneEvent_getName]
  • [kotlin_ZoneEvent_getAlias]
  • [kotlin_ZoneEvent_constructor]
  • [kotlin_ZoneEventType_values]

Objective-C

• Files:
  • objc/ZoneManagerExample.h
  • objc/ZoneManagerExample.m
• Key Tags:
  • [objc_NavigineSdk_getZoneManager]
  • [objc_ZoneManager_addZoneListener]
  • [objc_ZoneManager_removeZoneListener]
  • [objc_ZoneListener_onZoneEvent]
  • [objc_ZoneEvent_getType]
  • [objc_ZoneEvent_getLocationId]
  • [objc_ZoneEvent_getSublocationId]
  • [objc_ZoneEvent_getId]
  • [objc_ZoneEvent_getName]
  • [objc_ZoneEvent_getAlias]
  • [objc_ZoneEvent_constructor]
  • [objc_ZoneEventType_values]

Swift

• File: swift/ZoneManagerExample.swift
• Key Tags:
  • [swift_NavigineSdk_getZoneManager]
  • [swift_ZoneManager_addZoneListener]
  • [swift_ZoneManager_removeZoneListener]
  • [swift_ZoneListener_onZoneEvent]
  • [swift_ZoneEvent_getType]
  • [swift_ZoneEvent_getLocationId]
  • [swift_ZoneEvent_getSublocationId]
  • [swift_ZoneEvent_getId]
  • [swift_ZoneEvent_getName]
  • [swift_ZoneEvent_getAlias]
  • [swift_ZoneEvent_constructor]
  • [swift_ZoneEventType_values]

Common Usage Patterns

1. Basic Zone Detection

// Initialize SDK and get ZoneManager
final zoneManager = sdk.getZoneManager(locationManager, navigationManager);
 
// Create and add listener
final listener = ZoneListener(onZoneEvent: (event) {
  print('Zone event: ${event.type} - ${event.name}');
});
zoneManager.addZoneListener(listener);
 
// Remove listener when done
zoneManager.removeZoneListener(listener);

2. Multiple Listeners

// Add multiple listeners for different purposes
zoneManager.addZoneListener(analyticsListener);
zoneManager.addZoneListener(notificationListener);
zoneManager.addZoneListener(loggingListener);

3. Zone Event Handling

void onZoneEvent(ZoneEvent event) {
  switch (event.type) {
    case ZoneEventType.ENTER:
      print('Entered zone: ${event.name}');
       public brea k;
    case ZoneEventType.EXIT:
      print('Left zone: ${event.name}');
       public brea k;
  }
}

Running Examples

Dart/Flutter

cd dart
dart zone_manager_example.dart

Java

cd java
javac ZoneManagerExample.java
java ZoneManagerExample

Kotlin

cd kotlin
kotlinc ZoneManagerExample.kt -include-runtime -d ZoneManagerExample.jar
java -jar ZoneManagerExample.jar

Objective-C

cd objc
clang -framework Foundation ZoneManagerExample.m -o ZoneManagerExample
./ZoneManagerExample

Swift

cd swift
swift ZoneManagerExample.swift

Features Demonstrated

• SDK initialization and manager retrieval
• Zone listener setup and management
• Zone event handling and processing
• ZoneEvent property access
• ZoneEventType enumeration usage
• Multiple listener management
• Zone event simulation
• Resource cleanup

Notes

• All examples follow the same logical structure across platforms
• Error handling is implemented consistently across all platforms
• Async patterns are handled appropriately for each platform (Future, Thread, coroutines, etc.)
• Zone events are simulated to demonstrate functionality
• Proper cleanup is performed to prevent memory leaks