<p align="center">
  <h1 align="center">Cordova HMS Location</h1>
</p>

<p align="center">
  <a href="https://www.npmjs.com/package/@hmscore/cordova-plugin-hms-location"><img src="https://img.shields.io/npm/dm/@hmscore/cordova-plugin-hms-location?color=%23007EC6&style=for-the-badge" alt="downloads"></a>
  <a href="https://www.npmjs.com/package/@hmscore/cordova-plugin-hms-location"><img src="https://img.shields.io/npm/v/@hmscore/cordova-plugin-hms-location?color=%23ed2a1c&style=for-the-badge" alt="NPM version"></a>
  <a href="./LICENSE"><img src="https://img.shields.io/npm/l/@hmscore/react-native-hms-location.svg?color=%3bcc62&style=for-the-badge" alt="License"></a>
</p>

----

This plugin enables communication between Huawei Location SDK and Cordova platform. It exposes all
functionality provided by Huawei Location SDK.

[> Learn More](https://developer.huawei.com/consumer/en/doc/development/HMS-Plugin-Guides/introduction-0000001050140246?ha_source=hms1)

---

## Installation

### Cordova

```bash
$ cordova plugin add @hmscore/cordova-plugin-hms-location
```

### With Cordova Runtime

```bash
$ ionic-native cordova plugin add @hmscore/cordova-plugin-hms-location
```

### With Capacitor Runtime

```bash
$ npm install @hmscore/cordova-plugin-hms-location
```

## Documentation

- [Quick Start](https://developer.huawei.com/consumer/en/doc/development/HMS-Plugin-Guides/preparedevenv-0000001050140250?ha_source=hms1)
- [Reference](https://developer.huawei.com/consumer/en/doc/development/HMS-Plugin-References-V1/overview-0000001050140386-V1?ha_source=hms1)

## Additional Topics

- [Fused Location Service](https://developer.huawei.com/consumer/en/doc/development/HMS-Plugin-Guides-V1/fusedlocation-0000001050142203-V1?ha_source=hms1)
- [Activity Identification Service](https://developer.huawei.com/consumer/en/doc/development/HMS-Plugin-Guides-V1/activityidentify-0000001050140254-V1?ha_source=hms1)
- [Geofence Service](https://developer.huawei.com/consumer/en/doc/development/HMS-Plugin-Guides-V1/geofence-0000001050142205-V1?ha_source=hms1)

## Questions or Issues

If you have questions about how to use HMS samples, try the following options:

- [Stack Overflow](https://stackoverflow.com/questions/tagged/huawei-mobile-services) is the best
  place for any programming questions. Be sure to tag your question
  with **`huawei-mobile-services`**.
- [GitHub](https://github.com/HMS-Core/hms-cordova-plugin) is the official repository for these
  plugins, You can open an issue or submit your ideas.
- [Huawei Developer Forum](https://forums.developer.huawei.com/forumPortal/en/home?fid=0101187876626530001&ha_source=hms1)
  HMS Core Module is great for general questions, or seeking recommendations and opinions.
- [Huawei Developer Docs](https://developer.huawei.com/consumer/en/doc/overview/HMS-Core-Plugin?ha_source=hms1)
  is place to official documentation for all HMS Core Kits, you can find detailed documentations in
  there.

If you run into a bug in our samples, please submit an issue to
the [GitHub repository](https://github.com/HMS-Core/hms-cordova-plugin).

---

## 7. Licensing and Terms

HMS Location Cordova Plugin is licensed under the [Apache 2.0 license](LICENSE).