ip-location-api/browser/geocode-extra/README.md

Fast location lookup from IP address

# @iplookup/geocode-extra [![npm version](https://img.shields.io/npm/v/@iplookup/geocode-extra?color=success&style=flat-square&label=npm)](https://www.npmjs.com/package/@iplookup/geocode-extra)

This is an API created to make [ip-location-api](https://github.com/sapics/ip-location-api) available for browsers.
The database itself is large at 132MB, so it is splitted into over 4000 pieces for fast downloading in a browser.


## Synopsis

```html
<script src="https://cdn.jsdelivr.net/npm/@iplookup/geocode-extra/iplookup.min.js"></script>
<script type="text/javascript">
var ip = "51.210.219.22"
var location = await IpLookup(ip)
console.log(location)
// {
//   country: 'FR',
//   latitude: 50.9959,
//   longitude: 2.11757,
//   country_name: 'France',
//   country_native: 'France',
//   phone: [ 33 ],
//   continent: 'EU',
//   capital: 'Paris',
//   currency: [ 'EUR' ],
//   languages: [ 'fr' ],
//   continent_name: 'Europe'
// }
</script>
```

#### ESM

```javascript
import IpLookup from '@iplookup/geocode-extra'
await IpLookup("2402:b801:ea8b:23c0::")
```

#### CJS

```javascript
const IpLookup = require('@iplookup/geocode-extra')
await IpLookup("207.97.227.239")
```

If you do not need extra information about country, try to use [@iplookup/geocode](https://github.com/sapics/ip-location-api/tree/main/browser/geocode).


## License

The database for mapping ip to geocode is published under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) by [DB-IP](https://db-ip.com/db/download/ip-to-city-lite).

To get extra information about country, we use [Countries](https://github.com/annexare/Countries) which is published under MIT license by [Annexare Studio](https://annexare.com/).

The software itself is published under MIT license by [sapics](https://github.com/sapics).