Flutter Mappls GL

This Flutter plugin allows to show embedded interactive Mappls maps inside a Flutter widget. For the Android and iOS integration. This project only supports a subset of the API exposed by these libraries.

Getting Started

To work with Mappls Map in flutter add this to your package's pubspec.yaml file:

 mappls_gl: ^1.0.1  

Now in your dart code you need to import this package:

import 'package:mappls_gl/mappls_gl.dart';  

Adding Mappls Keys

You must provide your keys through the MapplsAccountManager class:


Add Mappls Map to your application

Add MapplsMap widget

   initialCameraPosition: CameraPosition(    
     target: LatLng(25.321684, 82.987289),    
     zoom: 14.0,    
   onMapCreated: (map) =>    
     mapController = map,  

Map Interactions

The Mappls Maps Flutter SDK allows you to define interactions that you can activate on the map to enable gestures and click events. The following interactions are supported –

Zoom Controls

The map supports the familiar two-finger pinch and zooms to change zoom level as well as double tap to zoom in. Set zoom to 4 for country level display and 18 for house number display. In this SDK the camera position plays an important role

And following operations can be performed using the CameraPosition


The target is single latitude and longitude coordinate that the camera centers it on. Changing the camera's target will move the camera to the inputted coordinates. The target is a LatLng object. The target coordinate is always at the center of the viewport.


Tilt is the camera's angle from the nadir (directly facing the Earth) and uses unit degrees. The camera's minimum (default) tilt is 0 degrees, and the maximum tilt is 60. Tilt levels use six decimal point of precision, which enables you to restrict/set/lock a map's bearing with extreme precision.

The map camera tilt can also adjust by placing two fingertips on the map and moving both fingers up and down in parallel at the same time or


Bearing represents the direction that the camera is pointing in and measured in degrees clockwise from north.

The camera's default bearing is 0 degrees (i.e. "true north") causing the map compass to hide until the camera bearing becomes a non-zero value. Bearing levels use six decimal point precision, which enables you to restrict/set/lock a map's bearing with extreme precision. In addition to programmatically adjusting the camera bearing, the user can place two fingertips on the map and rotate their fingers.


Zoom controls scale of the map and consumes any value between 0 and 22. At zoom level 0, viewport shows continents and other world features. A middle value of 11 will show city level details.At a higher zoom level, map will begin to show buildings and points of interest. Camera can zoom in following ways:

  • Pinch motion two fingers to zoom in and out.
  • Quickly tap twice on the map with a single finger to zoom in.
  • Quickly tap twice on the map with a single finger and hold your finger down on the screen after the second tap.
  • Then slide the finger up to zoom out and down to zoom out.
Sdk allows various method to Move, ease,animate Camera to a particular location :
mapController.moveCamera(CameraUpdate.newLatLngZoom(LatLng(22.553147478403194, 77.23388671875), 14));  
mapController.easeCamera(CameraUpdate.newLatLngZoom(LatLng(28.704268, 77.103045), 14));  
mapController.animateCamera(CameraUpdate.newLatLngZoom(LatLng(28.698791, 77.121243), 14));  

Map Events

Map Click/Long click

If you want to respond to a user tapping on a point on the map, you can use a onMapClick callback.

It sets a callback that's invoked when the user clicks on the map:

  initialCameraPosition: _kInitialPosition,    
  onMapClick: (point, latlng) =>{    
 }, )  
Sets a callback that's invoked when the user long clicks on the map view.
  initialCameraPosition: _kInitialPosition,    
  onMapLongClick: (point, latlng) =>{    
 }, )  

Map Overlays

Add a Marker

Add marker on the map by following these steps:

Symbol symbol = await controller.addSymbol(SymbolOptions(geometry: LatLng(25.321684, 82.987289)));  

Customize a marker

/// Adds an asset image to the currently displayed style
Future<void> addImageFromAsset(String name, String assetName) async {    
  final ByteData bytes = await rootBundle.load(assetName);    
  final Uint8List list = bytes.buffer.asUint8List();    
  return controller.addImage(name, list); 
await addImageFromAsset("icon", "assets/symbols/custom-icon.png");  
Symbol symbol = await controller.addSymbol(SymbolOptions(geometry: LatLng(25.321684, 82.987289), iconImage: "icon"));  

Remove a Marker

To remove a marker from map


Add a Polyline

Draw a polyline on Map

Line line = await controller.addLine(LineOptions(geometry: latlng, lineColor: "#3bb2d0", lineWidth: 4));  

Remove a Polyline

To remove polyline from Map


Add a Polygon

Draw a polygon on the map:

Fill fill = await controller.addFill(FillOptions(geometry: latlng, fillColor: "#3bb2d0"));   

Remove a Polygon


Show User location

To show user current location on the map

  initialCameraPosition: _kInitialPosition,    
  myLocationEnabled: true,    
  myLocationTrackingMode: MyLocationTrackingMode.NONE_COMPASS,    
  onUserLocationUpdated: (location) => {    
      print("Position: ${location.position.toString()}, Speed: ${location.speed}, Altitude: ${location.altitude}")    
}, )  

For any queries and support, please contact:

Email us at apisupport@mappls.com

Support Need support? contact us!

@ Copyright 2023 CE Info Systems Ltd. All Rights Reserved.
Terms & Conditions | Privacy Policy | Supplier Sustainability Policy | Health & Safety Policy | Environmental Policy & CSR Report
Customer Care: +91-9999333223