# epsg-index

> A machine-readable index of all EPSG coordinate systems.

Latest version **2.0.0** (published 2023-11-07) · ISC license · 0 weekly downloads

## Install

```sh
npm install epsg-index
pnpm add epsg-index
yarn add epsg-index
bun add epsg-index
```

## Health

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

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types; large bundle.

Negative: abandoned.

## Facts

| | |
|---|---|
| Version | 2.0.0 |
| Published | 2023-11-07 |
| First published | 2017-08-29 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Node | >=18 |
| Dependencies | 0 |
| Unpacked size | 15.4 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 22 |
| Author | Jannis R |
| Maintainers | derhuerst |
| Keywords | epsg, coordinate system, reference system, wgs 84, wgs84, index, list |

## Links

- npm: https://www.npmjs.com/package/epsg-index
- Repository: https://github.com/derhuerst/epsg-index
- Issues: https://github.com/derhuerst/epsg-index/issues
- npm.io page: https://npm.io/package/epsg-index

## Recent versions

- 2.0.0 (latest) — 2023-11-07
- 1.3.0 — 2023-04-18
- 1.2.0 — 2021-11-19
- 1.1.0 — 2021-02-17
- 1.0.0 — 2019-08-18
- 0.29.0 — 2019-07-28
- 0.28.0 — 2019-06-28
- 0.27.0 — 2019-05-28
- 0.26.0 — 2019-04-28
- 0.25.0 — 2019-03-28
- 0.24.0 — 2019-02-28
- 0.23.0 — 2019-02-25
- 0.22.0 — 2019-01-28
- 0.21.0 — 2018-12-28
- 0.20.0 — 2018-12-12
- … 20 more at https://npm.io/package/epsg-index/versions

## README

# epsg-index

**A machine-readable index of [all EPSG coordinate systems](https://epsg.io/?q=).** Similar to [`epsg`](https://github.com/stevage/epsg) and [`node-proj4js-defs`](https://github.com/yuletide/node-proj4js-defs), but kept up to date (so far). Like [`python-epsg`](https://github.com/geo-data/python-epsg#python-epsg), but in JavaScript/JSON.

[![npm version](https://img.shields.io/npm/v/epsg-index.svg)](https://www.npmjs.com/package/epsg-index)
![ISC-licensed](https://img.shields.io/github/license/derhuerst/epsg-index.svg)
![minimum Node.js version](https://img.shields.io/node/v/epsg-index.svg)
[![support me via GitHub Sponsors](https://img.shields.io/badge/support%20me-donate-fa7664.svg)](https://github.com/sponsors/derhuerst)
[![chat with me on Twitter](https://img.shields.io/badge/chat%20with%20me-on%20Twitter-1da1f2.svg)](https://twitter.com/derhuerst)


## Installing

```shell
npm install epsg-index
```


## Usage

```js
// use import assertions once they're supported by Node.js & ESLint
// https://github.com/tc39/proposal-import-assertions
import {createRequire} from 'module'
const require = createRequire(import.meta.url)

const epsg4326 = require('epsg-index/s/4326.json')

console.log(epsg4326)
```

```js
{
	code: '4326',
	kind: 'CRS-GEOGCRS',
	name: 'WGS 84',
	wkt: 'GEOGCS["WGS 84",DATUM["WGS_1984",SPHEROID["WGS 84",6378137,298.257223563,AUTHORITY["EPSG","7030"]],AUTHORITY["EPSG","6326"]],PRIMEM["Greenwich",0,AUTHORITY["EPSG","8901"]],UNIT["degree",0.0174532925199433,AUTHORITY["EPSG","9122"]],AUTHORITY["EPSG","4326"]]',
	proj4: '+proj=longlat +datum=WGS84 +no_defs',
	bbox: [90, -180, -90, 180],
	unit: 'degree (supplier to define representation)',
	area: 'World.',
	accuracy: null
}
```

You can also load all coordinate systems (`5mb` of data):

```js
const all = require('epsg-index/all.json')

console.log(all['4326'])
```


## Related

- [`transform-coordinates`](https://github.com/derhuerst/transform-coordinates) – Transform coordinates from one coordinate system to another. Built on top of `epsg-index`.
- [python-epsg](https://github.com/geo-data/python-epsg) – A Python API to the EPSG Geodetic Parameter Dataset.


## Contributing

If you have a question or have difficulties using `epsg-index`, please double-check your code and setup first. If you think you have found a bug or want to propose a feature, refer to [the issues page](https://github.com/derhuerst/epsg-index/issues).

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