# @ionic-native/geolocation

> Ionic Native - Native plugins for ionic apps

Latest version **5.36.0** (published 2021-08-20) · MIT license · 0 weekly downloads

## Install

```sh
npm install @ionic-native/geolocation
pnpm add @ionic-native/geolocation
yarn add @ionic-native/geolocation
bun add @ionic-native/geolocation
```

## Health

**Score 40/100 (D)** — status: abandoned.

Positive: has types; esm support; no vulnerabilities; high maintenance score.

Warnings: low downloads.

Negative: abandoned.

## Facts

| | |
|---|---|
| Version | 5.36.0 |
| Published | 2021-08-20 |
| First published | 2017-02-07 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 1 |
| Unpacked size | 43.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2452 |
| Author | ionic |
| Maintainers | danielsogl, mhartington, wf9a5m75, ionicjs, maxlynch, ihadeed, elylucas |

## Links

- npm: https://www.npmjs.com/package/@ionic-native/geolocation
- Repository: https://github.com/ionic-team/ionic-native
- Homepage: https://github.com/ionic-team/ionic-native#readme
- Issues: https://github.com/ionic-team/ionic-native/issues
- npm.io page: https://npm.io/package/@ionic-native/geolocation

## Dependencies (1)

- [@types/cordova](https://npm.io/package/@types/cordova.md) latest

## Recent versions

- 5.36.0 (latest) — 2021-08-20
- 5.22.0-beta-1 (beta) — 2020-02-11
- 5.0.0-alpha.3 (alpha) — 2017-12-08
- 3.1.0-rc.1 (rc) — 2017-03-07
- 5.35.0 — 2021-08-02
- 5.34.0 — 2021-06-29
- 5.33.1 — 2021-05-28
- 5.33.0 — 2021-05-11
- 5.32.1 — 2021-04-15
- 5.32.0 — 2021-04-05
- 5.31.1 — 2021-01-23
- 5.30.0 — 2020-11-20
- 5.29.0 — 2020-10-16
- 5.28.0 — 2020-08-14
- 5.27.0 — 2020-06-23
- … 151 more at https://npm.io/package/@ionic-native/geolocation/versions

## README

<a style="float:right;font-size:12px;" href="http://github.com/ionic-team/ionic-native/edit/master/src/@ionic-native/plugins/geolocation/index.ts#L104">
  Improve this doc
</a>

# Geolocation

```
$ ionic cordova plugin add cordova-plugin-geolocation --variable GEOLOCATION_USAGE_DESCRIPTION="To locate you"
$ npm install @ionic-native/geolocation
```

## [Usage Documentation](https://ionicframework.com/docs/native/geolocation/)

Plugin Repo: [https://github.com/apache/cordova-plugin-geolocation](https://github.com/apache/cordova-plugin-geolocation)

This plugin provides information about the device's location, such as latitude and longitude. Common sources of location information include Global Positioning System (GPS) and location inferred from network signals such as IP address, RFID, WiFi and Bluetooth MAC addresses, and GSM/CDMA cell IDs.

 This API is based on the W3C Geolocation API Specification, and only executes on devices that don't already provide an implementation.

For iOS you have to add this configuration to your configuration.xml file
```xml
<edit-config file="*-Info.plist" mode="merge" target="NSLocationWhenInUseUsageDescription">
   <string>We use your location for full functionality of certain app features.</string>
</edit-config>
```

## Supported platforms

- Amazon Fire OS
  - Android
  - Browser
  - iOS
  - Windows

---
_Source: https://npm.io/package/@ionic-native/geolocation · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._