搜索插件、代码仓与 APP 分类

flutter_map_location_marker 封面
插件详情v10.3.0

flutter_map_location_marker

一个用于显示设备当前位置的Flutter地图插件。

AndroidiOSWebmacOSWindowsLinux
近 30 天下载
5.2万
喜欢数
188
Pub 分数
150

安装插件

flutter pub add flutter_map_location_marker

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

一个 Flutter 插件,可使用 flutter_map 在地图上显示设备的当前位置。它提供了一种简单的方法,通过可自定义的标记实时可视化用户位置,从而增强基于地理位置的应用程序。该插件与 flutter_map 包无缝集成,并支持 Android、iOS、Web、macOS、Windows 和 Linux 等多个平台。适用于需要位置感知功能的应用程序,如导航工具、配送追踪或位置共享服务。

适合场景

  • 实时位置跟踪
  • 导航应用
  • 配送与物流
  • 基于位置的服务
  • 地图叠加层与用户位置

主要特点

  • 显示当前设备位置
  • 可自定义位置标记
  • 与 flutter_map 的无缝集成
  • 支持多个平台
  • 位置更改的自动更新

适合对象

  • 开发地图集成应用的开发者
  • 需要实时GPS跟踪的应用程序
  • 跨平台地理位置解决方案
  • 位置感知仪表板

使用建议

  • 需要位置权限
  • 激活时可能耗电
  • 依赖于已安装的 flutter_map
  • 准确性取决于设备的GPS
  • 需要对权限请求进行正确处理

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

flutter_map_location_marker

pub package github tag license

flutter_map_location_marker is a flutter_map plugin for displaying the device's current location on a map. It provides a simple and flexible way to add a customizable location marker to your map.
Interface preview

Join flutter_map Discord server to talk about flutter_map_location_marker, get help and help others in the #plugins channel.

Features

  • Simple: The only thing you need to do is to add a CurrentLocationLayer() to your map because all parameters have good default values.

  • Flexible: The default implementation receives the device's position from the geolocator package and the device's heading from the flutter_rotation_sensor package, but with type conversion, streams from other sources are also supported.

  • Auto-following: The map follows the new location when the location is updated. This feature is disabled by default.

  • Auto-rotating: The map can be rotated automatically in navigation mode. This feature is disabled by default.

  • Customization: The location marker can be fully customized, including the colors of the accuracy circle and heading sector.

Usage

  1. Add flutter_map_location_marker to your pubspec.yaml:

    dependencies:
      flutter_map_location_marker: any # or latest version
    
  2. Add permission by following the instructions from the geolocator package.

  3. Add the layer widget into FlutterMap:

    Widget build(BuildContext context) {
      return FlutterMap(
        children: [
          TileLayer(
            urlTemplate: 'https://tile.openstreetmap.org/{z}/{x}/{y}.png',
            maxZoom: 19,
          ),
          CurrentLocationLayer(), // <-- add layer here
        ],
      );
    }
    
  4. Discover more parameters in CurrentLocationLayer .

    Widget build() {
      return CurrentLocationLayer(
        alignPositionOnUpdate: AlignOnUpdate.always,
        alignDirectionOnUpdate: AlignOnUpdate.never,
        style: LocationMarkerStyle(
          marker: const DefaultLocationMarker(
            child: Icon(
              Icons.navigation,
              color: Colors.white,
            ),
          ),
          markerSize: const Size(40, 40),
          markerDirection: MarkerDirection.heading,
        ),
      );
    }
    
  5. Consider using either the AnimatedLocationMarkerLayer or the LocationMarkerLayer if multiple location markers need to be displayed.

Examples

  1. Marker Customization: Change the marker to any widget you want.

  2. Floating Action Button to Follow Current Location: Use a floating action button to move and zoom the map to the current location.

  3. Change Geolocator Settings: Define Geolocator settings yourself.

  4. Selectable Distance Filter: Change Geolocator settings at runtime.

  5. Custom Stream: Use your own stream, such as position stream from another library or predefined route, as the source.

  6. No Stream: Use Flutter setState() to update position and heading.

  7. Navigation Mode: Rotate the map to keep heading pointing upward.

  8. Default Stream: Share the default streams between your app and this plugin.

FAQ

Q: How can I get the positionStream , headingStream or their origin streams from a CurrentLocationLayer widget?

A: You should not get these streams from a CurrentLocationLayer widget. Instead, create your own streams with the same types and also pass them to all widgets that need them. CurrentLocationLayer doesn't own the streams; it just listens to them. You can use any implementation of position and heading streams, as long as the stream types are Stream<LocationMarkerPosition?> and Stream<LocationMarkerHeading?>, respectively. You may see this example to know about how to do this.

所属分类

依赖

依赖清单 4 项

源码仓库

使用此插件的项目