Ola Maps Flutter Plugin #

A Flutter plugin for integrating Ola Maps SDK into your Flutter applications. This plugin provides a comprehensive set of features for displaying interactive maps with markers, polylines, circles, polygons, bezier curves, and marker clustering.

Features #

• ✅ Map Display - Interactive map view with gestures (zoom, pan, tilt, rotate)
• ✅ Markers - Add, remove, and update markers with custom icons, rotation, and anchors
• ✅ InfoWindows - Display information windows on markers
• ✅ Polylines - Draw routes and paths on the map
• ✅ Circles - Display circular overlays
• ✅ Polygons - Draw multi-sided shapes for area boundaries
• ✅ Bezier Curves - Smooth curved lines between points
• ✅ Marker Clustering - Group nearby markers automatically
• ✅ Camera Controls - Zoom to location, get current position
• ✅ Location Services - Show/hide current user location
• ✅ Routing API - Get directions and draw routes between locations

Screenshots #

Map View	Markers & Overlays	Clustering
	Interactive map with all features	Auto-grouped markers

Installation #

Add this to your package's pubspec.yaml file:

dependencies:
  ola_maps_flutter:
    path: path/to/ola_maps_flutter

Android Setup #

1. Add Ola Maps SDK (One-time setup) #

Download the Ola Maps SDK AAR from the plugin repository and place it in your app's android/app/libs/ directory.

Then add this to your android/app/build.gradle:

dependencies {
    // ... your other dependencies

    // Ola Maps SDK (required)
    implementation(files("libs/OlaMapSdk-1.8.4.aar"))
}

Note: Due to Android/Gradle limitations, AAR files cannot be auto-bundled with Flutter plugins. This is a one-time setup per project.

2. Permissions #

Add these permissions to your AndroidManifest.xml:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

3. Request Runtime Permissions #

Future

## Usage

### Basic Map

```dart
import 'package:ola_maps_flutter/ola_map_view_flutter.dart';

OlaMapView(
  apiKey: "YOUR_OLA_MAPS_API_KEY",
  onMapCreated: (id) {
    print("Map created with id: $id");
  },
  onControllerReady: (controller) {
    // Map is ready, controller is available
  },
  showZoomControls: true,
  showCompass: true,
  showMyLocationButton: true,
)

Add Markers #

OlaMapController? _controller;

// Add marker
final markerId = await _controller?.addMarker(
  position: OlaLatLng(18.5214, 73.9317),
  snippet: "Ola Campus",
  subSnippet: "Tap for more info",
);

// Remove marker
await _controller?.removeMarker(markerId);

// Update marker
await _controller?.updateMarker(
  markerId: markerId,
  position: OlaLatLng(18.5220, 73.9320),
  rotation: 45.0,
);

Add Polyline #

await _controller?.addPolyline(
  points: [
    OlaLatLng(18.5214, 73.9317),
    OlaLatLng(18.5234, 73.9337),
    OlaLatLng(18.5254, 73.9357),
  ],
  color: "#FF0000",
  width: 5.0,
);

Add Circle #

await _controller?.addCircle(
  center: OlaLatLng(18.5214, 73.9317),
  radius: 500.0,
  color: "#0000FF",
  opacity: 0.3,
);

Add Polygon #

await _controller?.addPolygon(
  points: [
    OlaLatLng(18.5214, 73.9317),
    OlaLatLng(18.5234, 73.9337),
    OlaLatLng(18.5254, 73.9357),
    OlaLatLng(18.5254, 73.9317),
  ],
  color: "#00FF00",
);

Add Bezier Curve #

await _controller?.addBezierCurve(
  startPoint: OlaLatLng(18.5214, 73.9317),
  endPoint: OlaLatLng(18.5254, 73.9357),
  color: "#FF00FF",
  width: 4.0,
);

Camera Controls #

// Zoom to specific location
await _controller?.zoomToLocation(
  OlaLatLng(18.5214, 73.9317),
  15.0, // zoom level
);

// Get current location
final location = await _controller?.getCurrentLocation();

// Show current location
await _controller?.showCurrentLocation();

Routing (Directions) #

import 'package:ola_maps_flutter/ola_routing_service.dart';

// Initialize routing service
final routingService = OlaRoutingService(apiKey: "YOUR_API_KEY");

// Fetch route between two points
final routePoints = await routingService.getDirections(
  originLat: 18.7603,
  originLng: 73.3814,
  destLat: 18.7335,
  destLng: 73.4459,
);

// Draw route as polyline
final olaPoints = routePoints.map((point) =>
  OlaLatLng(point['lat']!, point['lng']!)
).toList();

await _controller?.addPolyline(
  points: olaPoints,
  color: "#0000FF",
  width: 5.0,
);

Marker Clustering #

final geoJson = '''
{
  "type": "FeatureCollection",
  "features": [...]
}
''';

await _controller?.addClusteredMarkers(
  geoJson: geoJson,
  clusterRadius: 50,
  defaultMarkerColor: "#FF0000",
  defaultClusterColor: "#00FF00",
  textSize: 12.0,
  textColor: "#FFFFFF",
);

API Reference #

OlaMapController Methods #

Example App #

See the example directory for a complete working example demonstrating all features.

Requirements #

• Flutter SDK: >=3.0.0
• Android minSdkVersion: 21
• Ola Maps SDK: 1.8.4

License #

MIT License - see LICENSE file for details.

Issues and Feedback #

Please file issues on the GitHub repository.