livemap 0.2.0 livemap: ^0.2.0 copied to clipboard
A map widget with live positions updates. Provides a controller to manage the map state.
Livemap #
A map widget with live position updates. Based on Flutter map and Geolocator. Provides a controller api to handle map state changes.
Controller api #
Api for the LiveMapController
class
Map controls #
Zoom
zoom
: get the current zoom value
zoomIn()
: increase the zoom level by 1
zoomOut()
: decrease the zoom level by 1
Center
center
: get the current center LatLng
value
centerOnPosition
(Position
position ): center the map on a Position
centerOnLiveMarker()
: recenter the map on the live position marker
toggleAutoCenter()
: toggle the value of autocenter
autoCenter
: get the current value of autocenter: used when the position updates are on
Position stream #
togglePositionStreamSubscription()
: enable or disable the live position stream
Markers #
addMarker
(String
name, Marker
marker): add a named marker on the map
removeMarker
(String
name, Marker
marker): remove a named marker from the map
On ready callback #
Execute code right after the map is ready:
@override
void initState() {
liveMapController.onReady.then((_) {
liveMapController.togglePositionStreamSubscription();
});
super.initState();
}
Example #
import 'package:flutter/material.dart';
import 'package:flutter_map/flutter_map.dart';
import 'package:geolocator/geolocator.dart';
import 'package:livemap/livemap.dart';
import 'package:latlong/latlong.dart';
class LiveMapPage extends StatelessWidget {
LiveMapPage() () {
mapController = MapController();
liveMapController = LiveMapController(mapController: mapController);
}
MapController mapController;
LiveMapController liveMapController;
@override
Widget build(BuildContext context) {
return Scaffold(
body: LiveMap(
mapController: mapController,
liveMapController: liveMapController,
mapOptions: MapOptions(
center: LatLng(51.0, 0.0),
zoom: 13.0,
),
titleLayer: TileLayerOptions(
urlTemplate: "https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png",
subdomains: ['a', 'b', 'c']),
),
bottomNavigationBar: LiveMapBottomNavigationBar(
liveMapController: liveMapController,
));
}
@override
void dispose() {
liveMapController.dispose();
super.dispose();
}
}
Changefeed #
A changefeed is available: it's a stream with all state changes from the map controller. Ex:
import 'dart:async';
StreamSubscription _changefeed;
int _myzoom;
liveMapController.onReady.then((_) {
_myzoom = liveMapController.zoom;
_changefeed = liveMapController.changeFeed.listen((change) {
if (change.name == "zoom") {
setState(() {
_myzoom = change.value;
});
}
});
}
// dispose: _changefeed.cancel();