获取高德App Key

为了使用高德 SDK，你需要准备高德 App Key，获取方法参考高德地图 SDK 官方文档：

获取Android App Key

1、创建新应用
进入高德地图控制台，创建一个新应用。如果您之前已经创建过应用，可直接跳过这个步骤。

我的应用.png
新建应用.png
2、添加新Key
在创建的应用上点击"添加"按钮，在弹出的对话框中，依次：输入应用名名称，选择绑定的服务为“Android平台SDK”，输入发布版安全码 SHA1、调试版安全码 SHA1、以及 Package，如下图所示：

需要注意的是： 1个KEY只能用于一个应用（多渠道安装包属于多个应用），1个Key在多个应用上使用会出现服务调用失败。

添加Key.png

在阅读完高德地图API服务条款后，勾选此选项，点击“提交”，完成 Key 的申请，此时您可以在所创建的应用下面看到刚申请的 Key 了。

如何获取 SHA1

调试版本（debug）和发布版本（release）下的 SHA1 值是不同的，发布 apk 时需要根据发布 apk 对应的 keystore 重新配置 Key。
以下介绍使用Android Studio来获取对应的SHA1：

第一步、打开 Android Studio 的 Terminal 工具。
第二步、输入命令：keytool -list -v -keystore 文件路径。
第三步、输入 Keystore 密码

获取SHA1.png

如何获取 PackageName

Android Studio 可以通过 applicationId 配置包名，如果配置了 build.gradle 文件，PackageName 应该以 applicaionId 为准，防止 build.gradle 中的 applicationId 与 AndroidMainfest.xml 中的 PackageName 不同，导致 key 鉴权不过。

获取 PackageName.png

提交后即可生成Android App Key：

生成Android App Key.png

开始使用

安装

yarn add react-native-amap-geolocation
或
npm install react-native-amap-geolocation --save

自动配置（推荐）

react-native link react-native-amap-geolocation

手动配置

一般情况下 react-native link 即可完成配置，如果因特殊原因无法使用 react-native link 或 link 失败，则可参照以下步骤检查并进行手动配置。

Android端

1.编辑 android/settings.gradle，设置项目路径：

include ':react-native-amap-geolocation'
project(':react-native-amap-geolocation').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-amap-geolocation/lib/android')

2.编辑 android/app/build.gradle，新增依赖：

dependencies {
   implementation project(':react-native-amap-geolocation')
}

3.编辑 MainApplication.java：

import cn.qiuxiang.react.geolocation.AMapGeolocationPackage;

public class MainApplication extends Application implements ReactApplication {
  @Override
  protected List<ReactPackage> getPackages() {
         List<ReactPackage> packages = new PackageList(this).getPackages();
        /*rn0.62之后不用再手动添加，在link后会自动添加到PackageList里面*/
         packages.add(new AMapGeolocationPackage());
         return packages;
  }
}

iOS端

待续。。。。。。。。。。。

基本用法

import { PermissionsAndroid } from "react-native";
import { init, Geolocation ,setLocatingWithReGeocode} from "react-native-amap-geolocation";


  async componentDidMount() {
        if (Platform.OS === "android") {
            await PermissionsAndroid.request(PermissionsAndroid.PERMISSIONS.ACCESS_COARSE_LOCATION);
        }else{
            setLocatingWithReGeocode(true)
        }
        await init({
            ios: "9bd6c82e77583020a73ef35f59d0c759",
            android: "dd25bc60566f854254f77a4bfa4f9b55"
        });
        this.getCurrentPosition()
    }

getCurrentPosition = () => {
        Geolocation.getCurrentPosition(
            position => this.updateLocationState(position),
            error => this.updateLocationState(error)
        );
    };

    updateLocationState(location) {
        if (location) {
            location.updateTime = new Date().toLocaleString();
            let data = location.location
            this.setState({
                provinceName: data.province,
                cityName: data.city,
                areaName: data.district,
            });
        }
    }

回调数据：

回调数据.png

更多用法

该项目除了提供符合 Web 标准的 Geolocation API，同时为了最大程度的发挥高德定位 SDK 的功能， 会尽可能提供与原生 SDK 一致的接口封装。由于 iOS 和 Android SDK 提供的接口并不一致， 于是最终实现的接口大部分是并不通用的。这在接口文档或文档注释有注明， 比如 @platform android 表示该接口仅用于 Android。
以下是一些常用接口的用法说明以及示例代码，更多接口的具体用法请参考[接口文档]

直接使用原生接口

import { init, addLocationListener, start, stop } from "react-native-amap-geolocation";

// 添加定位监听函数
addLocationListener(location => console.log(location));

// 开始连续定位
start();

// 在不需要的时候停止定位
stop();

逆地理编码

Android 默认返回逆地理编码，而 iOS 需要手动设置。

import { setLocatingWithReGeocode, setNeedAddress } from "react-native-amap-geolocation";

// android
setNeedAddress(true);

// ios
setLocatingWithReGeocode(true);

定位回调频率限

import { setInterval, setDistanceFilter } from "react-native-amap-geolocation";

// android，5 秒请求一次定位
setInterval(5000);

// ios，设备移动超过 10 米才会更新位置信息
setDistanceFilter(10);