NeshanMap class

A cross-platform widget that displays a Neshan map.

Supports iOS, Android, and Web:

• Mobile: renders the map inside a WebView.
• Web: renders the map inside an <iframe>.

Key Parameters

Basic Usage

import 'package:neshan_maps_flutter/map.dart';
import 'package:latlong2/latlong.dart';

NeshanMap(
  mapKey: 'your-neshan-api-key',
  config: NeshanMapConfig(
    initialCenter: LatLng(35.6892, 51.3890),
    initialZoom: 15.0,
  ),
  onLocationChanged: (lat, lng) {
    debugPrint('Centre: $lat, $lng');
  },
)

With Markers

Markers are passed directly to the widget, not via NeshanMapConfig. To add or remove markers after the map has loaded use NeshanMapController:

import 'package:flutter/material.dart';
import 'package:neshan_maps_flutter/map.dart';
import 'package:latlong2/latlong.dart';

final controller = NeshanMapController();

NeshanMap(
  mapKey: 'your-neshan-api-key',
  controller: controller,
  markers: [
    NeshanMarker(
      id: 'hq',
      position: LatLng(35.6892, 51.3890),
      title: 'HQ',
      color: Colors.red,
    ),
  ],
)

// Programmatically add another marker later:
await controller.ready;
controller.addMarker(
  NeshanMarker(id: 'branch', position: LatLng(35.70, 51.40)),
);

Platform Notes

• On mobile, the map is rendered in a WebView, which requires internet connectivity to load the Neshan SDK.
• On web, the map is rendered in an iframe, which may have different security restrictions depending on the browser.
• The NeshanMapController.ready future should be awaited before calling controller methods to ensure the map is fully loaded.