{"id":13550986,"url":"https://github.com/Xennis/flutter_map_location","last_synced_at":"2025-04-03T01:30:49.718Z","repository":{"id":46977281,"uuid":"282961437","full_name":"Xennis/flutter_map_location","owner":"Xennis","description":"flutter_map plugin to request and display the users location and heading on the map","archived":true,"fork":false,"pushed_at":"2021-09-19T14:18:48.000Z","size":230,"stargazers_count":19,"open_issues_count":2,"forks_count":35,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-04T05:35:17.487Z","etag":null,"topics":["flutter","flutter-map","location","open-street-map"],"latest_commit_sha":null,"homepage":"https://pub.dev/packages/flutter_map_location","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Xennis.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null}},"created_at":"2020-07-27T16:59:37.000Z","updated_at":"2023-01-28T06:28:07.000Z","dependencies_parsed_at":"2022-07-26T00:32:09.254Z","dependency_job_id":null,"html_url":"https://github.com/Xennis/flutter_map_location","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xennis%2Fflutter_map_location","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xennis%2Fflutter_map_location/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xennis%2Fflutter_map_location/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xennis%2Fflutter_map_location/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Xennis","download_url":"https://codeload.github.com/Xennis/flutter_map_location/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246921965,"owners_count":20855339,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["flutter","flutter-map","location","open-street-map"],"created_at":"2024-08-01T12:01:40.753Z","updated_at":"2025-04-03T01:30:46.704Z","avatar_url":"https://github.com/Xennis.png","language":"Dart","readme":"**The plugin is discontinued.** Feel free to fork it or checkout [similar plugins](https://flutter-map.vercel.app/plugins/list).\n\n# Flutter Map – Location plugin\n\n[![Flutter](https://github.com/Xennis/flutter_map_location/workflows/Flutter/badge.svg?branch=main\u0026event=push)](https://github.com/Xennis/flutter_map_location/actions?query=workflow%3A%22Flutter%22+event%3Apush+branch%3Amain) [![Pub](https://img.shields.io/pub/v/flutter_map_location.svg)](https://pub.dev/packages/flutter_map_location)\n\nA [flutter_map](https://pub.dev/packages/flutter_map) plugin to request and display the users location and heading on the map. The core features of the plugin are:\n\n* Customization: The location button and marker can be completly customized.\n* Energy efficiency: The location service is turned off if the app runs in the background.\n* Usability: Developers are empowered to ensure a good [user experience](#User-experience).\n\n## User experience\n\nStatus\n\n* [x] The location button can be changed dependening on the location services status. For example also Google Maps shows a different icon if the location service is off.\n* [x] The marker icon can be changed depending on the location accuracy.\n* [x] It's possible to show the information (e.g. in form of a snackbar) to the user that the user location is outside of the map bounds.\n* [x] The location heading is also shown for devices without an gyroscope. We [patched flutter_compass](https://github.com/hemanthrajv/flutter_compass/pull/38) for that.\n\n## Installation\n\nAdd flutter_map to your pubspec:\n\n```yaml\ndependencies:\n  flutter_map_location: any # or the latest version on Pub\n```\n\n### Android\n\nEnsure the following permissions are present in `\u003cproject-root\u003e/android/app/src/main/AndroidManifest.xml`:\n\n```xml\n\u003cuses-permission android:name=\"android.permission.INTERNET\"/\u003e\n\u003cuses-permission android:name=\"android.permission.ACCESS_FINE_LOCATION\" /\u003e\n```\n\nSee [reference example code](https://github.com/Xennis/flutter_map_location/blob/f864b737cfe6371a297cee3be076b6bc117f572c/example/android/app/src/main/AndroidManifest.xml#L4-L5)\n\n### iOS\n\nEnsure the following permission is present in `\u003cproject-root\u003e/ios/Runner/Info.plist`:\n\n```xml\n\u003ckey\u003eNSLocationWhenInUseUsageDescription\u003c/key\u003e\n\u003cstring\u003eApp needs access to location and direction when open.\u003c/string\u003e\n```\n\nSee [reference example code](https://github.com/Xennis/flutter_map_location/blob/f864b737cfe6371a297cee3be076b6bc117f572c/example/ios/Runner/Info.plist#L5-L6)\n\n## Usage\n\nLook at the [default example](https://github.com/Xennis/flutter_map_location/blob/main/example/lib/pages/default.dart) and the notes inside the code. That's a working example.\n\n## Demo / example\n\nA working example can be found in the `example/` directory. It contains a page with the default settings:\n\n![Default example](https://raw.githubusercontent.com/Xennis/flutter_map_location/main/example/default.png)\n\n... and one with customized button and marker:\n\n![Custom example](https://raw.githubusercontent.com/Xennis/flutter_map_location/main/example/custom.png)\n\n(Map attribution: © [OpenStreetMap](https://www.openstreetmap.org/copyright) contributors)\n\n## Credits\n\nThe plugin is inspired by [user_location_plugin](https://github.com/igaurab/user_location_plugin) by [igaurab](https://github.com/igaurab).","funding_links":[],"categories":["Dart"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FXennis%2Fflutter_map_location","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FXennis%2Fflutter_map_location","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FXennis%2Fflutter_map_location/lists"}