Dart pub

 

flutter_map 0.8.2

Published Jan 7, 2020
33 likes
flutter
android
ios
  • Readme
  • Changelog
  • Example
  • Installing
  • Versions
  • 97

BuildStatus Pub

flutter_map #

A Dart implementation of Leaflet for Flutter apps.

Usage #

Add flutter_map to your pubspec:

dependencies:
  flutter_map: any # or the latest version on Pub

Configure the map using MapOptions and layer options:

  Widget build(BuildContext context) {
    return new FlutterMap(
      options: new MapOptions(
        center: new LatLng(51.5, -0.09),
        zoom: 13.0,
      ),
      layers: [
        new TileLayerOptions(
          urlTemplate: "https://api.tiles.mapbox.com/v4/"
              "{id}/{z}/{x}/{y}@2x.png?access_token={accessToken}",
          additionalOptions: {
            'accessToken': '<PUT_ACCESS_TOKEN_HERE>',
            'id': 'mapbox.streets',
          },
        ),
        new MarkerLayerOptions(
          markers: [
            new Marker(
              width: 80.0,
              height: 80.0,
              point: new LatLng(51.5, -0.09),
              builder: (ctx) =>
              new Container(
                child: new FlutterLogo(),
              ),
            ),
          ],
        ),
      ],
    );
  }

Configure the map to use Azure Maps by using the following MapOptions and layer options:

Widget build(BuildContext context) {
    return new FlutterMap(
      options: new MapOptions(
        center: new LatLng(51.5, -0.09),
        zoom: 13.0,
      ),
      layers: [
        new TileLayerOptions(
          urlTemplate: "https://atlas.microsoft.com/map/tile/png?api-version=1&layer=basic&style=main&tileSize=256&view=Auto&zoom={z}&x={x}&y={y}&subscription-key={subscriptionKey}",
          additionalOptions: {
            'subscriptionKey': '<YOUR_AZURE_MAPS_SUBSCRIPTON_KEY>'
          },
        ),
        new MarkerLayerOptions(
          markers: [
            new Marker(
              width: 80.0,
              height: 80.0,
              point: new LatLng(51.5, -0.09),
              builder: (ctx) =>
              new Container(
                child: new FlutterLogo(),
              ),
            ),
          ],
        ),
      ],
    );
  }

To use Azure Maps you will need to setup an account and get a subscription key

Run the example #

See the example/ folder for a working example app.

To run it, in a terminal cd into the folder. Then execute ulimit -S -n 2048 (ref). Then execute flutter run with a running emulator.

Offline maps #

Follow this guide to grab offline tiles
Once you have your map exported to .mbtiles, you can use mbtilesToPng to unpack into /{z}/{x}/{y}.png. Move this to Assets folder and add asset directories to pubspec.yaml. Minimum required fields for offline maps are:

Widget build(ctx) {
  return FlutterMap(
    options: MapOptions(
      center: LatLng(56.704173, 11.543808),
      zoom: 13.0,
      swPanBoundary: LatLng(56.6877, 11.5089),
      nePanBoundary: LatLng(56.7378, 11.6644),
    ),
    layers: [
      TileLayerOptions(
        tileProvider: AssetTileProvider(),
        urlTemplate: "assets/offlineMap/{z}/{x}/{y}.png",
      ),
    ],
  );
}

Make sure PanBoundaries are within offline map boundary to stop missing asset errors.
See the flutter_map_example/ folder for a working example.

Note that there is also FileTileProvider(), which you can use to load tiles from the filesystem.

Plugins #

Roadmap #

For the latest roadmap, please see the Issue Tracker

[0.8.2] - 1/7/2019

  • add polyline with gradient (#452)

Thanks to @SebWojd for this release!

[0.8.1] - 1/3/2019

  • Add ZoomButtonsPlugin (#487)

Thanks to @moovida for this release!

[0.8.0] - 12/16/2019

Added Flutter 1.12 support

  • Polygon Culling (#449)
  • fix marker anchor sample (#448, #427)
  • upgrade imageloader for Flutter 1.12 (#478)
  • Tidying up project files (#469)

Thanks to @raacker, @Varuni-Punchihewa, @wmcshane, @domesticmouse, and @kimlet for this release!

[0.7.3] - 10/3/2019

  • Update changelog (#408)
  • Readability improvements (#410)
  • add double-tap-hold zoom (#393)
  • Fix Unsupported Operation and add missing onTap and onLongPress methods (#436)
  • Fix error when unproject bottomLeft or topRight and lat are < -90 or > 90 or lng are < -180 or > 180
  • Fix/transparent polyline (#407)

Thanks to @yywwuing, @GregorySech, @avimak, @kengu, @lpongetti, and @2ZeroSix for this release!

[0.7.2] - 8/30/2019

  • expose TileProvider.getTileUrl (#401)

Thanks to @kengu for this release!

[0.7.1] - 8/28/2019

  • upgrade to cached_network_image ^1.1.0 (#358)
  • documentation (#400)
  • remove isUserGesture (#389)
  • fix initialization exception (#379)

Thanks to @escamoteur, @wmcschane, and @GregorySech for this release!

[0.7.0+2] - 7/31/2019

  • Fix OverlayImage with transparency (#382)

Thanks to @4kssoft for this release!

[0.7.0+1] - 7/30/2019

  • update MapState options when FlutterMap widget options change (#380)

[0.7.0] - 7/27/2019

  • compatability with flutter's stable and master channels
  • add scalebar (#356)
  • add rotation (#359)
  • fix OverlayLayer bug (#360)
  • fix rotation pan issue (#363, #365)

Thanks to @kimlet, @escamoteur, @4kssoft for this release!

[0.5.6] - 7/9/2019

  • fix compatibility with flutter 1.7.8 (stable) (#296)

Thanks to @MichalMisiaszek for the heads up and @slightfoot for help with upgrading (#296)!

[0.6.x] - 6/7/2019

  • temporary releases compatable with early flutter releases

[0.5.4] - 6/7/2019

  • fix markers on edge of screen disappearing (#313)
  • dart analysis fixes (#300)
  • add border circle (#299)
  • add dotted line to polygon (#295)
  • fix example esri page (#292)
  • add flutter_map_marker_cluster package to README (#309)

Note: 0.5.x releases are compatable with Flutter's stable channel, currently v1.5.4-hotfix.2 and 0.6.x releases (also on the flutter_map dev branch) is a version of flutter_map compatible with Flutter's dev channel

Thanks to @lpongetti @FalkF @Victor-emil @lsaudon and @lorenzo for this release!

[0.5.3] - 5/21/2019

  • update dependencies (#288)

[0.5.2] - 5/20/2019

  • fix zooming issue (#281)

[0.5.1] - 5/17/2019

  • add mbtiles
  • add formatting and linter rules
  • Fix null pointer in isOutOfBounds (#274)
  • add isUserGesture (#237)
  • fix emulator pinching error

Thanks to @avbk, @OrKoN, @pintomic, @wmcshane, @manhluong for this release!

[0.5.0] - 2/21/2019

  • add cached network image support (#204)
  • Use PositionedTapDetector only in interactive mode (#207)
  • Allow defining CircleMarkerRadius in meters (#213)
  • support for tms tile coordinates (#214)
  • add moving markers example
  • add long press gesture for markers (#229)
  • add patreon badge to README
  • rename Point to CustomPoint (#187)
  • remove layers property from MapOptions (#193)

Thanks to @SamuelRioTz, @jecoz, @4kssoft, @bugWebDeveloper, @RaimundWege, @vinicentus, and @etzuk for this release!

[0.4.0] - 12/31/2018

  • Zoom to focal point on double tap and scale gestures (#121)
  • Make anchor field public (#172)
  • FitBoundsOptions now uses EdgeInsets padding
  • Add GroupLayer
  • Update README

Thanks to @tomwyr, @csjames, @kengu, @ocularrhythm for this release!

[0.3.0] - 11/1/2018

  • PositionCallback now has hasGesture #139

Thanks to @gimox for this release!

[0.2.0] - 10/25/2018

  • Use NetworkImageWithRetry for tile layers (#145)
  • Add rebuild capability to LayerOptions (#144)
  • Added Circle layer (#137)
  • Prevent Map Layer Excessive Rebuilds (#131)

Thanks to @kengu, @mortenboye, and @tomwyr for this release!

[0.1.4] - 9/24/2018

  • Polygon Support (#118)

Thanks to @JulianBerger for this release!

[0.1.3] - 9/18/2018

  • fix identical map position callbacks (#111)
  • Prune tiles bug fix (#112)

Thanks to @IhorKlimov and @tomwyr for this release!

[0.1.2] - 8/21/2018

  • Added polyline customisation options (#94)
  • Expose map bounds (#99)
  • Added onTap example (#103)
  • route bugfix (#104)
  • options is now required (#105)
  • Project refactor and changes to offline map #85

Thanks to @LJaraCastillo, @ubilabs, @xqwzts, @vinicentus, and @lsaudon for this release!

[0.1.0] - 8/21/2018

  • Set Dart SDK to 2

[0.0.11] - 8/2/2018

  • upgrade to latlong from 0.4.0 to 0.5.3

[0.0.11] - 7/31/2018

  • fix LICENSE spelling error
  • double-tap to zoom (#62)
  • Fix polyline overlap issue (#67)
  • Offline map example (#53)

Thanks to contributors @alfanhui, @avioli, @solid-software, and @vinicentus for this release!

[0.0.10] - 6/7/2018

  • update .gitignore (#40)
  • Applied constraints to zoom on gesture update if min or max options set (#46)
  • Pan Boundary with 2 new MapOptions variables: swPanBoundary and nePanBoundary (#47)
  • OfflineMode bool variable added to TileLayerOptions for AssetImage Widget use (#48)
  • remove quiver dep (#32)

Thanks to contributors @avioli, @bcko, and @alfanhui for this release!

[0.0.9] - 5/31/2018

  • add LatlngBounds.contains, avoid rendering out-of-view markers in MarkerLayer

[0.0.8] - 5/31/2018

  • bug: rendering far-away tiles was causing a GPU crash on the simulator. add tile pruning to TileLayer

[0.0.7] - 5/29/2018

  • bug: TileLayer not listening to onMoved events from MapController

[0.0.6] - 5/11/2018

  • fitBounds, onPositionChanged (#39)

[0.0.5] - 3/11/2018

  • make tile background customizable (#36)
  • use transparent_image as placeholder image (#37)

[0.0.4] - 4/18/2018

  • Add marker anchor support (#27, #30)

[0.0.3] - 4/18/2018

  • fixed Dart 2.0 type errors (#23)
  • add MapController API (#24 + #25)

[0.0.2] - 2/21/2018

  • subdomain support
  • move gesture detection into map widget
  • improved tile layer support
  • improved examples
  • Polyline layers
  • fix marker redraw on map rotation

[0.0.1] - 2/5/2018

  • inital release

example/README.md

leaflet_flutter_example #

A new Flutter project.

Getting Started #

For help getting started with Flutter, view our online documentation.

Use this package as a library

1. Depend on it

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


dependencies:
  flutter_map: ^0.8.2

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:flutter_map/flutter_map.dart';
Popularity:
Describes how popular the package is relative to other packages. [more]
98
Health:
Code health derived from static analysis. [more]
100
Maintenance:
Reflects how tidy and up-to-date the package is. [more]
89
Overall:
Weighted score of the above. [more]
97
Learn more about scoring.

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

  • Dart: 2.7.0
  • pana: 0.13.4
  • Flutter: 1.12.13+hotfix.5

Maintenance suggestions

The package description is too short. (-11 points)

Add more detail to the description field of pubspec.yaml. Use 60 to 180 characters to describe the package, what it does, and its target use case.

Dependencies

Package Constraint Resolved Available
Direct dependencies
Dart SDK >=2.6.0 <3.0.0
async ^2.1.0 2.4.0
cached_network_image ^2.0.0-rc 2.0.0
flutter 0.0.0
flutter_image ^3.0.0 3.0.0
latlong ^0.6.1 0.6.1
path_provider ^1.5.1 1.5.1
positioned_tap_detector ^1.0.2 1.0.3
sqflite ^1.1.5 1.2.0
transparent_image ^1.0.0 1.0.0
tuple ^1.0.2 1.0.3
vector_math ^2.0.0 2.0.8
Transitive dependencies
ansicolor 1.0.2
charcode 1.1.2
collection 1.14.11 1.14.12
console_log_handler 1.1.6
convert 2.1.1
crypto 2.1.4
flutter_cache_manager 1.1.3
http 0.12.0+4
http_parser 3.1.3
intl 0.16.1
logging 0.11.4
matcher 0.12.6
meta 1.1.8
path 1.6.4
platform 2.2.1
quiver 2.1.2+1
sky_engine 0.0.99
source_span 1.6.0
stack_trace 1.9.3
string_scanner 1.0.5
synchronized 2.2.0
term_glyph 1.1.0
typed_data 1.1.6
uuid 2.0.4
validate 1.7.0
Dev dependencies
flutter_test
pedantic ^1.8.0 1.9.0
test ^1.9.0