Search packages, repositories and app categories

flutter_map_line_editor cover
Package detailsv8.0.0

flutter_map_line_editor

A basic Line and Polygon editor for `flutter_map` using drag markers

AndroidiOSWebmacOSWindowsLinux
30-day downloads
6K
Likes
32
Pub points
130

Install package

flutter pub add flutter_map_line_editor

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

A Flutter package that enables interactive editing of lines and polygons within the flutter_map widget. It provides draggable markers for adjusting vertices, allowing users to create or modify vector shapes directly on a map. Designed for geolocation applications requiring user input on map geometry, it integrates seamlessly with flutter_map's existing features. The editor supports both line and polygon shapes, offering intuitive point manipulation through touch or mouse interactions across all supported platforms.

Use cases

  • Map-based shape creation
  • Interactive route planning
  • Geospatial data annotation
  • Polygon boundary editing
  • Real-time map drawing
  • User-driven map geometry input

Key features

  • Draggable vertex markers
  • Support for lines and polygons
  • Seamless integration with flutter_map
  • Cross-platform compatibility
  • Real-time shape updates
  • Simple API for initialization and event handling

Suitable for

  • GIS applications
  • Mapping tools with user input
  • Interactive map dashboards
  • Field data collection apps
  • Educational mapping software
  • Prototyping map interaction features

Considerations

  • Requires flutter_map dependency
  • Limited to basic shape editing
  • No built-in snapping or alignment
  • May need custom styling for markers
  • Performance impact with many vertices
  • Not suitable for complex geometry operations

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

Line & Polygon Editor for flutter_map

pub package License: MIT Support me on Ko-fi

A basic line and polygon editor that works with flutter_map, relying on DragMarker from flutter_map_dragmarker.

Demo

Demo

Getting started

To use this package, first add flutter_map_line_editor as a dependency in your pubspec.yaml file:

dependencies:
  flutter_map_line_editor: <latest version>

See the example directory for a complete example app demonstrating the usage of this package, here are the most important features:

  • Tap the map to add a marker, add as many as you want.
  • Drag the main points to move them.
  • Drag the intermediate points to create a new point there and drag to where you want.
  • Long press to delete a point.

Usage

Once the package is installed, make sure to import the package in the file that you are going to need it, you may also need to import flutter_map_dragmarker:

import 'package:flutter_map_dragmarker/flutter_map_dragmarker.dart';
import 'package:flutter_map_line_editor/flutter_map_line_editor.dart';

Set up a new editor instance, tipically inside initState():

var polyEditor = PolyEditor(
  points: testPolyline.points,
  pointIcon: Icon(Icons.crop_square, size: 23),
  intermediateIcon: Icon(Icons.lens, size: 15, color: Colors.grey),
  callbackRefresh: () => { this.setState(() {})},
  addClosePathMarker: false, // set to true if polygon
);

The PolyEditor takes a list of LatLng points that are used to put DragMarker's over these locations. PolyEditor does not care if the given list of points is a polyline, it could be something else. This list will be edited in place so that when the build method is triggered it will use updated points.

You must also pass a Widget (tipically an Icon) using the pointIcon parameter that will be used to represent each DragMarker.

You may also pass the optional parameter intermediateIconto display another DragMarker halfway between the main points. Dragging this marker will create another main point and the line will be split.

The screen needs to be updated during a drag, so callbackRefresh takes a function that will get called each drag frame.

For polygons or “closed paths” set the parameter addClosePathMarker to true so that the end auto-returns to the start. Otherwise, if you just want a basic polyline, set this to false.

You can add a point programmatically using the onTap callback in MapOptions:

onTap: (ll) {
  polyEditor.add(testPolyline.points, ll);
},

Add the correspondent layers as FlutterMap childrens:

FlutterMap(
  options: MapOptions(
    onTap: (_, ll) {
      polyEditor.add(testPolyline.points, ll);
    },
  ),
  children: [
    // .....
    PolylineLayer(polylines: polyLines),
    DragMarkers(markers: polyEditor.edit()),
  ],
),

Report issues or feature requests in the GitHub repository, Pull Requests are welcome!

License

This package is licensed under the permissive MIT License. See the LICENSE file in this repository to get a full copy.

Categories

Dependencies

Dependency list 2 items

Source repository

Projects using this package