{"id":13550766,"url":"https://github.com/tlserver/flutter_map_location_marker","last_synced_at":"2026-02-28T05:23:22.981Z","repository":{"id":38211240,"uuid":"287262184","full_name":"tlserver/flutter_map_location_marker","owner":"tlserver","description":"A flutter map plugin for displaying device current location.","archived":false,"fork":false,"pushed_at":"2025-12-20T09:33:45.000Z","size":609,"stargazers_count":120,"open_issues_count":1,"forks_count":106,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-02-06T13:44:01.143Z","etag":null,"topics":["current","device","flutter","location","map","position","real-time","user"],"latest_commit_sha":null,"homepage":"https://pub.dev/packages/flutter_map_location_marker","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tlserver.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"tlserver"}},"created_at":"2020-08-13T11:32:50.000Z","updated_at":"2025-12-20T09:33:49.000Z","dependencies_parsed_at":"2023-09-27T13:16:22.504Z","dependency_job_id":"7fefd2b5-1ba4-4770-b62f-22bb5ea5977d","html_url":"https://github.com/tlserver/flutter_map_location_marker","commit_stats":null,"previous_names":[],"tags_count":62,"template":false,"template_full_name":null,"purl":"pkg:github/tlserver/flutter_map_location_marker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tlserver%2Fflutter_map_location_marker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tlserver%2Fflutter_map_location_marker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tlserver%2Fflutter_map_location_marker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tlserver%2Fflutter_map_location_marker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tlserver","download_url":"https://codeload.github.com/tlserver/flutter_map_location_marker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tlserver%2Fflutter_map_location_marker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29925683,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-27T19:37:42.220Z","status":"online","status_checked_at":"2026-02-28T02:00:07.010Z","response_time":90,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["current","device","flutter","location","map","position","real-time","user"],"created_at":"2024-08-01T12:01:37.332Z","updated_at":"2026-02-28T05:23:22.955Z","avatar_url":"https://github.com/tlserver.png","language":"Dart","readme":"# flutter_map_location_marker\n\n[![pub package](https://img.shields.io/pub/v/flutter_map_location_marker)](https://pub.dev/packages/flutter_map_location_marker)\n[![github tag](https://img.shields.io/github/v/tag/tlserver/flutter_map_location_marker?include_prereleases\u0026sort=semver)](https://github.com/tlserver/flutter_map_location_marker)\n[![license](https://img.shields.io/github/license/tlserver/flutter_map_location_marker)](https://github.com/tlserver/flutter_map_location_marker/blob/main/LICENSE)\n\n`flutter_map_location_marker` is a [flutter_map](https://pub.dev/packages/flutter_map) plugin for\ndisplaying device's current location on a map. It provides a simple and flexible way to add a \ncustomizable location marker to your map.\n\u003cbr\u003e\n\u003cimg src=\"https://github.com/tlserver/flutter_map_location_marker/raw/main/assets/interface.jpg\" alt=\"Interface preview\" width=\"400\"\u003e\n\nJoin [flutter_map Discord server](https://discord.gg/BwpEsjqMAH) to talk\nabout `flutter_map_location_marker`, get help and help others in the #plugins channel.\n\n## Features\n\n- **Simple**: The only thing you need to do is to add a `CurrentLocationLayer()` in to your map\n  because all parameters have good default values.\n\n- **Flexible**: The default implementation receives the device's position from\n  the [geolocator](https://pub.dev/packages/geolocator) package and the device's heading from\n  the [flutter_compass](https://pub.dev/packages/flutter_compass) package, but with type conversion,\n  streams from other sources are also supported.\n\n- **Auto-following**: The map follows the new location when location is updated. This feature is\n  disabled by default.\n\n- **Auto-rotating**: The map can be rotated automatically as navigation mode. This feature is\n  disabled by default.\n\n- **Customization**: The location marker can be fully customized, including the colors of the\n  accuracy circle and header.\n\n## Usage\n\n1. Add `flutter_map_location_marker` to your `pubspec.yaml`:\n   ```yaml\n   dependencies:\n     flutter_map_location_marker: any # or latest version\n   ```\n\n2. Add permission by following the instructions from\n   the [geolocator](https://pub.dev/packages/geolocator#usage) package.\n\n3. Add the layer widget into `FlutterMap`:\n   ```dart\n   Widget build(BuildContext context) {\n     return FlutterMap(\n       children: [\n         TileLayer(\n           urlTemplate: 'https://tile.openstreetmap.org/{z}/{x}/{y}.png',\n           maxZoom: 19,\n         ),\n         CurrentLocationLayer(), // \u003c-- add layer here\n       ],\n     );\n   }\n   ```\n\n4. Discover more parameters\n   in [CurrentLocationLayer](https://pub.dev/documentation/flutter_map_location_marker/latest/flutter_map_location_marker/CurrentLocationLayer-class.html)\n   .\n\n   ```dart\n   Widget build() {\n     return CurrentLocationLayer(\n       alignPositionOnUpdate: AlignOnUpdate.always,\n       alignDirectionOnUpdate: AlignOnUpdate.never,\n       style: LocationMarkerStyle(\n         marker: const DefaultLocationMarker(\n           child: Icon(\n             Icons.navigation,\n             color: Colors.white,\n           ),\n         ),\n         markerSize: const Size(40, 40),\n         markerDirection: MarkerDirection.heading,\n       ),\n     );\n   }\n   ```\n\n5. Consider using either \n   the [AnimatedLocationMarkerLayer](https://pub.dev/documentation/flutter_map_location_marker/latest/flutter_map_location_marker/AnimatedLocationMarkerLayer-class.html)\n   or\n   the [LocationMarkerLayer](https://pub.dev/documentation/flutter_map_location_marker/latest/flutter_map_location_marker/LocationMarkerLayer-class.html)\n   if multiple location markers need to be displayed.\n\n## Examples\n\n1. [Marker Customization](https://github.com/tlserver/flutter_map_location_marker/blob/main/example/lib/page/customize_marker_example.dart) :\n   Change the marker to any widget you want.\n\n2. [Floating Action Button to Follow Current Location](https://github.com/tlserver/flutter_map_location_marker/blob/main/example/lib/page/center_fab_example.dart) :\n   Use a floating action button to move and zoom the map to the current location.\n\n3. [Change Geolocator Settings](https://github.com/tlserver/flutter_map_location_marker/blob/main/example/lib/page/geolocator_settings_example.dart) :\n   Define Geolocator settings yourself.\n\n4. [Selectable Distance Filter](https://github.com/tlserver/flutter_map_location_marker/blob/main/example/lib/page/selectable_distance_filter_example.dart) :\n   Change Geolocator settings at the runtime.\n\n5. [Custom Stream](https://github.com/tlserver/flutter_map_location_marker/blob/main/example/lib/page/custom_stream_example.dart) :\n   Use your own stream, such as position stream from another library or predefined route, as the\n   source.\n\n6. [No Stream](https://github.com/tlserver/flutter_map_location_marker/blob/main/example/lib/page/no_stream_example.dart) :\n   Use Flutter `setState()` to update position and heading.\n\n7. [Navigation Mode](https://github.com/tlserver/flutter_map_location_marker/blob/main/example/lib/page/navigation_example.dart) :\n   Rotate the map to keep heading pointing upward.\n\n8. [Default Stream](https://github.com/tlserver/flutter_map_location_marker/blob/main/example/lib/page/default_stream_example.dart) :\n   Share the default streams between your app and this plugin.\n\n## FAQ\n\n*Q*: How to get\nthe [positionStream](https://pub.dev/documentation/flutter_map_location_marker/5.1.0/flutter_map_location_marker/CurrentLocationLayer/positionStream.html)\n, [headingStream](https://pub.dev/documentation/flutter_map_location_marker/5.1.0/flutter_map_location_marker/CurrentLocationLayer/headingStream.html)\nor their origin streams from a CurrentLocationLayer widget?\n\n*A*: No, you should not get these streams from a CurrentLocationLayer widget. Instead, create you\nown streams with the the same types and also pass it to all the widgets which need them.\nCurrentLocationLayer doesn't own the streams; it just listens to them. You can use any\nimplementation of position and heading streams, as long as the stream types are\nStream\u0026lt;LocationMarkerPosition?\u0026gt; and Stream\u0026lt;LocationMarkerHeading?\u0026gt;, respectively. You\nmay\nsee [this example](https://github.com/tlserver/flutter_map_location_marker/blob/main/example/lib/page/default_stream_example.dart)\nto know about how to do this.\n","funding_links":["https://github.com/sponsors/tlserver"],"categories":["Dart"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftlserver%2Fflutter_map_location_marker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftlserver%2Fflutter_map_location_marker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftlserver%2Fflutter_map_location_marker/lists"}