flutter_z_location
Flutter开源免费定位插件
- 现如今几乎每一个 App 都存在定位的逻辑,方便更好的推荐产品或服务,获取当前设备的经纬度、所在城市几乎是必备的功能了!iOS定位经纬度及反向地理编码原生均能很好实现。然而Android由于系统原因,反向地理编码获取地址信息需要使用谷歌服务。大多需要依赖高德/百度三方定位库实现该功能。
- 本项目是Flutter定位插件,支持获取经纬度及经纬度、ip反向地理编码获取地址信息(省、市、区),纯原生获取GPS定位信息。反向地理编码获取地址信息均来自本地,没有并发限制、次数限制且无收费。
- 这里尤其感谢pikaz-18大佬的数据源。js定位大家可使用pikaz-location。
- 请大佬们多多指教,给个 Star,你的支持就是我不断前进的动力,谢谢。
特性
- 单次获取经纬度信息
- 经纬度、ip反向地理编码获取地址信息(省、市、区),精确度到区/县
- 资源文件目前仅支持本地,尚未实现远程按需下载使用。后续将会完善此功能
安装
在 pubspec.yaml
中添加
dependencies:
# 最新版本
flutter_z_location: ^0.0.7
Android端配置
在AndroidManifest.xml
文件中添加定位权限
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
iOS端配置
在info.plist
文件中添加定位权限
<!-- 在使用期间访问位置 -->
<key>NSLocationWhenInUseUsageDescription</key>
<string>App需要您的同意, APP才能在使用期间访问位置</string>
使用
- 将
example/assets
目录下的资源文件添加到自己的项目的assets
中,并在pubspec.yaml
中加入如下配置。
assets:
- assets/province/
- assets/ip/
- assets/city/
- assets/district/
- assets/areaList/
目前五个文件夹必须在同一级目录,如果您的资源目录结构不一致,对应设置pathHead
参数即可
- 详细使用请参考项目
example
用例,下面只列出常用方法
import 'package:flutter_z_location/flutter_z_location.dart';
import 'package:permission_handler/permission_handler.dart';
// 获取GPS定位经纬度
final coordinate = await FlutterZLocation().getCoordinate();
// 经纬度反向地理编码获取地址信息(省、市、区)
final res1 = await FlutterZLocation().geocodeCoordinate(coordinate.latitude, coordinate.longitude, pathHead: 'assets/');
// 获取ip地址
final ipStr = await FlutterZLocation().getIp();
// 经纬度反向地理编码获取地址信息(省、市、区)
final res2 = await FlutterZLocation.geocodeIp(ipStr, pathHead: 'assets/');