# @nativescript-community/geocoding

> Provides access to native geocoding APIs for NativeScript apps (android.location.Geocoder for Android, CLGeocoder for iOS).

Latest version **3.2.1** (published 2024-02-28) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @nativescript-community/geocoding
pnpm add @nativescript-community/geocoding
yarn add @nativescript-community/geocoding
bun add @nativescript-community/geocoding
```

## Health

**Score 30/100 (F)** — status: abandoned.

Positive: has types; no vulnerabilities.

Warnings: low downloads; no esm support.

Negative: abandoned.

## Facts

| | |
|---|---|
| Version | 3.2.1 |
| Published | 2024-02-28 |
| First published | 2021-01-29 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 20.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 8 |
| Author | Tim Doege |
| Maintainers | dgmachado, classicoldsong, mayerlench, jcassidyav, sebjean, cjohn001, edusperoni, asharghi, farfromrefuge, triniwiz, eddyverbruggen, rigor789, walkerrunpdx, dnr, keerl, cvietor, bradmartin, rdlabo, tralves |
| Keywords | NativeScript, JavaScript, Android, iOS, Angular, React, Svelte, Vue |

## Links

- npm: https://www.npmjs.com/package/@nativescript-community/geocoding
- Repository: https://github.com/nativescript-community/geocoding
- Homepage: https://github.com/nativescript-community/geocoding#readme
- Issues: https://github.com/nativescript-community/geocoding/issues
- npm.io page: https://npm.io/package/@nativescript-community/geocoding

## Alternatives

- [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads
- [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads
- [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads
- [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads
- [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads

## Recent versions

- 3.2.1 (latest) — 2024-02-28
- 3.1.0 — 2021-10-21
- 3.0.2 — 2021-03-11
- 3.0.1 — 2021-01-29

## README

<!-- ⚠️ This README has been generated from the file(s) "blueprint.md" ⚠️-->{{ load:packages/geocoding/README.md }}

[](#demos-and-development)

## Demos and Development


### Repo Setup

The repo uses submodules. If you did not clone with ` --recursive` then you need to call
```
git submodule update --init
```

The package manager used to install and link dependencies must be `pnpm` or `yarn`. `npm` wont work.

To develop and test:
if you use `yarn` then run `yarn`
if you use `pnpm` then run `pnpm i`

**Interactive Menu:**

To start the interactive menu, run `npm start` (or `yarn start` or `pnpm start`). This will list all of the commonly used scripts.

### Build

```bash
npm run build.all
```
WARNING: it seems `yarn build.all` wont always work (not finding binaries in `node_modules/.bin`) which is why the doc explicitly uses `npm run`

### Demos

```bash
npm run demo.[ng|react|svelte|vue].[ios|android]

npm run demo.svelte.ios # Example
```

Demo setup is a bit special in the sense that if you want to modify/add demos you dont work directly in `demo-[ng|react|svelte|vue]`
Instead you work in `demo-snippets/[ng|react|svelte|vue]`
You can start from the `install.ts` of each flavor to see how to register new demos 


[](#contributing)

## Contributing

### Update repo 

You can update the repo files quite easily

First update the submodules

```bash
npm run update
```

Then commit the changes
Then update common files

```bash
npm run sync
```
Then you can run `yarn|pnpm`, commit changed files if any

### Update readme 
```bash
npm run readme
```

### Update doc 
```bash
npm run doc
```

### Publish

The publishing is completely handled by `lerna` (you can add `-- --bump major` to force a major release)
Simply run 
```shell
npm run publish
```

### modifying submodules

The repo uses https:// for submodules which means you won't be able to push directly into the submodules.
One easy solution is t modify `~/.gitconfig` and add
```
[url "ssh://git@github.com/"]
	pushInsteadOf = https://github.com/
```

[](#questions)

## Questions

If you have any questions/issues/comments please feel free to create an issue or start a conversation in the [NativeScript Community Discord](https://nativescript.org/discord).

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