Flutter Map Smart

A plug-and-play OpenStreetMap widget for Flutter that handles:

📍 Clustering: Efficiently manages thousands of markers.
🖼️ Image Markers: Easily use asset or network images as markers.
🌍 User Location: Shows current location with an animated radius.
📏 Nearby Filtering: Automatically filters visible items based on user location.
🔍 Search & Pick: Built-in address search and location picker.
🎨 Custom Layers: Support for Polylines, Polygons, and Circles.

Installation

dependencies:
  flutter_map_smart: ^1.1.0

Quick Start

1. Basic Usage (Display Markers)

import 'package:flutter_map_smart/flutter_map_smart.dart';

FlutterMapSmart.simple(
  items: myPlaces,
  latitude: (place) => place.lat,
  longitude: (place) => place.lng,
  markerImage: (place) => place.imageUrl,
  onTap: (place) => print('Tapped: ${place.name}'),
);

2. Controllable Map (Move & Zoom)

You can allow programmatic control by passing a MapController.

final mapController = MapController();

FlutterMapSmart.simple(
  items: items,
  // ...
  mapController: mapController, // Pass the controller
  onMapTap: (pos, latLng) => print('Tapped map at: $latLng'),
);

// Later:
mapController.move(LatLng(51.5, -0.09), 15.0);

3. Custom Layers (Polylines)

Draw routes or areas by adding children layers.

FlutterMapSmart.simple(
  items: items,
  // ...
  children: [
    PolylineLayer(
      polylines: [
        Polyline(points: [startPos, endPos], color: Colors.blue, strokeWidth: 4),
      ],
    ),
  ],
);

4. Search Address

Use the built-in SmartOSMSearch utility to find coordinates.

final location = await SmartOSMSearch.search("Paris, France");
if (location != null) {
  mapController.move(location, 13.0);
}

5. Location Picker

Let users pick a location with a center pin.

SmartLocationPicker(
  initialCenter: LatLng(28.61, 77.23),
  onLocationChanged: (latLng) {
    print("Picking: $latLng");
  },
)

Features

Feature	Description
Simple API	No boilerplate. Just pass your list of objects.
Clustering	Uses `flutter_map_marker_cluster` for high performance.
Location	Integrated `geolocator` and `latlong2`.
Animations	Smooth camera movement and radius animations.
Permissions	Handles permission states (granted, denied, disabled) for you.

Attribution

This package calls the OpenStreetMap Nominatim API for search. Usage Policy: You must abide by the Nominatim Usage Policy.

Limit your requests (max 1/sec).
Provide a valid User-Agent.