Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update epsg.io info in README.md #38

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Update epsg.io info in README.md #38

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 19 additions & 13 deletions docs/modules/proj4/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,27 +36,32 @@ There are an infinite number of possible coordinate systems; therefore strict sy

There are thousands of named "EPSG" projections. This module only includes aliases for those in the section below by default. To use a different EPSG projection, you can use https://epsg.io. For example, https://epsg.io/4326 defines standard longitude-latitude coordinates and lists multiple projection strings. Choose one of the `OGC WKT`, `ESRI WKT`, or `PROJ.4` strings listed.

The epsg.io website also has a public API, e.g., for WGS 84: `https://epsg.io/?q=4326&format=json`
You can also use MapTiler Coordinates API: https://api.maptiler.com/coordinates/search/4326.json?key=YOUR_MAPTILER_KEY&exports=true
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For someone without a lot of context about this, it feels random for OpenJS / Open Visualization to promote one specific commercial, key-requiring API.

Can we add a header ## APIs and a sentence that mentions that the espg.io team has migrated their free API to MapTiler, and perhaps something about the special relation that MapTiler has with this service that makes it natural to call you out?


```json
{
"status": "ok",
"number_result": 1,
"results": [
{
"code": "4326",
"id": {
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we call out that the response format has changed with the new API?

"authority": "EPSG",
"code": 4326
},
"kind": "CRS-GEOGCRS",
"bbox": [90.0, -180.0, -90.0, 180.0],
"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\"]]",
"unit": "degree (supplier to define representation)",
"proj4": "+proj=longlat +datum=WGS84 +no_defs",
"name": "WGS 84",
"area": "World.",
"default_trans": 0,
"trans": [],
"accuracy": ""
"exports": {
"proj4": "+proj=longlat +datum=WGS84 +no_defs +type=crs",
"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\"]]"
},
"unit": "degree (supplier to define representation)",
"accuracy": null,
"area": "World",
"bbox": [-180, -90, 180, 90],
"deprecated": false,
"default_transformation": null,
"transformations": [3858, 3859, 8037, 9618, 9704, 9706, 9708, 10084, 15781]
}
]
],
"total": 1
}
```

Expand Down Expand Up @@ -87,6 +92,7 @@ Note that Proj4Projection allows aliases to be defined and comes with the follow
- [OGC WKT-CRS Specification](http://docs.opengeospatial.org/is/18-010r7/18-010r7.html) standards documentation.
- [spatialreference.org](https://spatialreference.org/) a catalog of coordinate system references.
- [espg.io](https://epsg.io/) Lets the user look up the definition of a coordinate system.
- [MapTiler Coordinates API](https://docs.maptiler.com/cloud/api/coordinates/) to search coordinate system

E.g. [https://epsg.io/4326](https://epsg.io/4326) provides the definition of WGS84 in WKT-CRS format:

Expand Down