Skip to content

User Location

The UserLocationLayer shows the location of the user as a dot with an accuracy circle and a heading, and can move the camera with it. It works the same on every platform.

The layer takes a Stream<UserLocation> and doesn't read the location or ask for permissions itself, so you can use any location source. The maplibre_geolocator package turns the positions of geolocator into such a stream.

Setup

Add both packages:

flutter pub add maplibre_geolocator geolocator

Set up each platform as the geolocator documentation describes, for example the location permissions in AndroidManifest.xml and the usage descriptions in Info.plist.

Show the user location

Ask for the location permission, then put a UserLocationLayer in the children of the map:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
class _MapScreenState extends State<MapScreen> {
  Stream<UserLocation>? _locations;

  @override
  void initState() {
    super.initState();
    _requestPermission();
  }

  Future<void> _requestPermission() async {
    final permission = await Geolocator.requestPermission();
    if (permission == LocationPermission.denied ||
        permission == LocationPermission.deniedForever) return;
    if (!mounted) return;
    setState(() => _locations = geolocatorUserLocations());
  }

  @override
  Widget build(BuildContext context) {
    final locations = _locations;
    return MapLibreMap(
      options: MapOptions(
        initCamera: CameraUpdate.position(zoom: 1),
      ),
      children: [
        if (locations != null)
          UserLocationLayer(locations: locations),
      ],
    );
  }
}

On Windows, geolocator reports positions only after the app asked for the permission, and permission_handler doesn't ask there, so use Geolocator.requestPermission().

To use another location source, create UserLocations with a position and an optional accuracy in meters, heading in degrees and timestamp.

Tracking

tracking moves the camera with the location:

  • UserLocationTracking.none: the camera stays where it is.
  • UserLocationTracking.position: the camera centers on the location.
  • UserLocationTracking.positionAndHeading: the camera also turns with the heading.

When the user drags or zooms the map, the layer stops tracking and calls onTrackingChanged with UserLocationTracking.none. MapControlButtons shows a location button for it when you set onTrackingPressed:

UserLocationTracking _tracking = UserLocationTracking.position;

@override
Widget build(BuildContext context) {
  return MapLibreMap(
    children: [
      UserLocationLayer(
        locations: locations,
        tracking: _tracking,
        trackingZoom: 15,
        onTrackingChanged: (tracking) => setState(() => _tracking = tracking),
      ),
      MapControlButtons(
        tracking: _tracking,
        onTrackingPressed: () =>
            setState(() => _tracking = UserLocationTracking.position),
      ),
    ],
  );
}

trackingZoom is the zoom the camera moves to when tracking starts, and trackingDuration how long it takes to follow a new location.

Style

style changes how the location looks, with a UserLocationStyle:

UserLocationLayer(
  locations: locations,
  style: const UserLocationStyle(
    color: Color(0xFF2E7D32),
    radius: 10,
    showAccuracy: false,
  ),
  // Below the labels of the style.
  anchor: const LayerAnchor.below('place_label'),
  onClick: (location) => print('Tapped my location'),
)
  • color and radius set the dot, and the accuracy circle and the heading take the color too.
  • showAccuracy and showHeading hide the accuracy circle and the heading cone.
  • icon replaces the dot, for example with an arrow. While rotateIcon is set, it turns with the heading and shows it instead of the cone; otherwise it stays upright on the screen.

The location is drawn with style layers of the map, so the map draws it in the same frame as everything else and it never trails the camera. It moves from one location to the next without an animation in between. The accuracy circle and the heading lie flat on a tilted map. anchor places the layers among those of the style, and onClick reports taps on the location.

Check out the example app for a full implementation.