mapping_library 0.0.6

Basic Mapping engine for Flutter #

This library supplies a basic implementation of a tiled mapping engine for flutter. There is a basic openstreetmap widget available which can be set on a specific geographic location. Basic gestures are implemented to pan and zoom this map. More advanced options are available for adding markers and vector based object like lines, polylines, circles and polygons. Also a basic Marker implementation is available.

This library actually consists of two project, mapping_library and mapping_library_extentions. For use on a IOS or Android device these both needs to be added to the dependencies. The mapping_library_extentions library adds extra IOS and Android specific code. When using Flutter-web only add the mapping_library to the dependencies (not tested yet!).

  • Version: 0.0.6

Disclaimer: This version is far from finished. Most of the options just supply very basic functionality which might still holds many bugs. We are continuesly adding and improving options. Use at your own risk

Installation #

dependencies:
     mapping_library: any
     mapping_library_extentions: any

Examples #

Checkout the github repository for a full example off all the options and how to use them!!!

Basic Example

Create an instance of the OsmMap object in the contructor of your App widget as the map needs to be in persistent memory. Add this instance to the Build function.. Do not add it directly to the build method!!

        
    import 'package:mapping_library/mapping_library.dart';
        
    class MyApp extends StatelessWidget {
      MyApp() : super() {
        // It is important that the widget is pre-created in the constructor
        // of this parent widget as it needs to be persistant in memory
        // So do not add the directly to the build method. 
        _osmMap = _createOsmMapWidget();
      }
        
        OsmMap _osmMap;
        
        Widget _createOsmMapWidget() {
            return OsmMap(
                mapPosition: new MapPosition.Create(
                  geoPoint: new GeoPoint(52.45657243868931, 5.52041338863477),
                  zoomLevel: 11,
                )
            );
        }
        
        @override  
        Widget build(BuildContext context) {  
            return MaterialApp(  
                title: 'Flutter Demo',  
                theme: ThemeData(  
                    primarySwatch: Colors.blue,  
                ),  
                home: Container(   
                    child: _osmMap,
                )  
            );  
        }
    }
        

There are three callback methods:

  • mapReady (Fired when the map initially is created, needed when you want to add more layers)
  • mapPositionChanged (Fired as soon as the position or zoom of the map is changed)
    Return: Viewport object, this holds both the current MapPosition as the visual BoundingBox of the current map
  • mapTabbed (Fired when you tab on the map)
    Return: GeoPoint object, this holds the geographic location of the position tabbed.

Advanced examples

If you want to do more advanced stuff you need to create all the objects in the contructor of the Widget like this:

Define a MapView variable, Create this new object in the apps constructor and add the mapReady event handler.


class MyApp extends StatelessWidget {
  MyApp() : super() {
    _mapView = new mapview.MapView(_mapReady);
  }

  // Define a Mapview
  mapview.MapView _mapView;

  _mapReady(mapview.MapView mapView) {
  }
  
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: Container(
        child: _mapView
      )
    );
  }
}

Continue by adding code to the mapReady callback function. First create a base Layer. This normally should be a TileLayer. Define a http source where the tiles are served from, Create a new HttpTileSource and finally create a new TileLayer using this source.

_mapReady(mapview.MapView mapView) {
    final _url = "http://c.tile.openstreetmap.org/##Z##/##X##/##Y##.png";
    HttpTileSource osmTileSource = new HttpTileSource(_url); TileLayer
    tileLayer = new TileLayer(osmTileSource); _mapView.AddLayer(tileLayer);
    //
    //
    }

Create a new MapPosition to initially more and zoom the map to a chosen default location. Create a new GeoPoint with the chosen geographic location and use this with the desired zoomlevel to create a new MapPosition. Set the mapview to this new MapPosition.

GeoPoint s = new GeoPoint(52.45657243868931, 5.52041338863477);
MapPosition _initialPosition = MapPosition.fromGeopointScale(s, 11);
_mapView.SetMapPosition(_initialPosition);

[0.0.6] 25 Oktober 2019

  • Broken release Fix

[0.0.5] 25 Oktober 2019

  • Added fixed objects layer
  • Added a basic scalebar as Fixed object
  • Some bugfixes and example changes

[0.0.4] 22 Oktober 2019

  • Some bugfixes
  • Code formatting
  • path naming changes in the lib
  • Comment and documentation additions and changes

[0.0.3] 21 Oktober 2019

  • Lots of changes and fixes
  • Added support library (extentions) for specific device support
  • Added Polyline
  • Updated example application

[0.0.2] 3 Oktober 2019

  • Format changes
  • Added sample
  • Started on API Documentation

[0.0.1] 2 Oktober 2019

  • TODO: Describe initial release.

example/README.md

Mapping Library example #

Check out the comments in the code!!

Use this package as a library

1. Depend on it

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


dependencies:
  mapping_library: ^0.0.6

2. Install it

You can install packages from the command line:

with Flutter:


$ flutter pub get

Alternatively, your editor might support flutter pub get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:


import 'package:mapping_library/mapping_library.dart';
  
Popularity:
Describes how popular the package is relative to other packages. [more]
20
Health:
Code health derived from static analysis. [more]
89
Maintenance:
Reflects how tidy and up-to-date the package is. [more]
85
Overall:
Weighted score of the above. [more]
54
Learn more about scoring.

We analyzed this package on Feb 13, 2020, and provided a score, details, and suggestions below. Analysis was completed with status completed using:

  • Dart: 2.7.1
  • pana: 0.13.5
  • Flutter: 1.12.13+hotfix.7

Health suggestions

Fix lib/src/core/values.dart. (-4.41 points)

Analysis of lib/src/core/values.dart reported 9 hints, including:

line 4 col 14: Name non-constant identifiers using lowerCamelCase.

line 8 col 14: Name non-constant identifiers using lowerCamelCase.

line 12 col 14: Name non-constant identifiers using lowerCamelCase.

line 16 col 14: Name non-constant identifiers using lowerCamelCase.

line 20 col 14: Name non-constant identifiers using lowerCamelCase.

Fix lib/src/utils/geopoint.dart. (-1.49 points)

Analysis of lib/src/utils/geopoint.dart reported 3 hints:

line 17 col 16: Name non-constant identifiers using lowerCamelCase.

line 18 col 16: Name non-constant identifiers using lowerCamelCase.

line 19 col 16: Name non-constant identifiers using lowerCamelCase.

Fix lib/src/layers/markers/markerbase.dart. (-1 points)

Analysis of lib/src/layers/markers/markerbase.dart reported 2 hints:

line 113 col 8: The declaration '_getBoundingBox' isn't referenced.

line 120 col 8: The declaration '_calcBoundingBoxByMapsize' isn't referenced.

Fix additional 13 files with analysis or formatting issues. (-4.50 points)

Additional issues in the following files:

  • lib/src/core/mapview.dart (1 hint)
  • lib/src/core/mapviewport.dart (1 hint)
  • lib/src/layers/layers.dart (1 hint)
  • lib/src/layers/markers/renderers/markerrenderer.dart (1 hint)
  • lib/src/layers/markers/simplemarker.dart (1 hint)
  • lib/src/layers/overlay/overlayimages.dart (1 hint)
  • lib/src/layers/vector/vectors.dart (1 hint)
  • lib/src/tiles/tilesource.dart (1 hint)
  • lib/src/utils/boundingbox.dart (1 hint)
  • lib/mapping_library.dart (Run flutter format to format lib/mapping_library.dart.)
  • lib/src/layers/fixedobject/fixedobject.dart (Run flutter format to format lib/src/layers/fixedobject/fixedobject.dart.)
  • lib/src/layers/fixedobjectslayer.dart (Run flutter format to format lib/src/layers/fixedobjectslayer.dart.)
  • lib/src/layers/vector/polyline.dart (Run flutter format to format lib/src/layers/vector/polyline.dart.)

Maintenance suggestions

Package is pre-v0.1 release. (-10 points)

While nothing is inherently wrong with versions of 0.0.*, it might mean that the author is still experimenting with the general direction of the API.

Homepage URL is insecure. (-5 points)

Update the homepage field and use a secure (https) URL.

Dependencies

Package Constraint Resolved Available
Direct dependencies
Dart SDK >=2.1.0 <3.0.0
flutter 0.0.0
http ^0.12.0+2 0.12.0+4
vector_math ^2.0.8 2.0.8
Transitive dependencies
async 2.4.0
charcode 1.1.3
collection 1.14.11 1.14.12
http_parser 3.1.3
meta 1.1.8
path 1.6.4
pedantic 1.9.0
sky_engine 0.0.99
source_span 1.6.0
string_scanner 1.0.5
term_glyph 1.1.0
typed_data 1.1.6
Dev dependencies
flutter_test