diff --git a/docs/modules/proj4/README.md b/docs/modules/proj4/README.md index ea483ccc..502155a1 100644 --- a/docs/modules/proj4/README.md +++ b/docs/modules/proj4/README.md @@ -36,30 +36,6 @@ 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` - -```json -{ - "status": "ok", - "number_result": 1, - "results": [ - { - "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": "" - } - ] -} -``` - If you already know the EPSG identifier, you can make the API request even simpler by adding the desired extension to your url: ``` @@ -72,6 +48,39 @@ GEOGCS["WGS 84",DATUM["WGS_1984",SPHEROID["WGS 84",6378137,298.257223563,AUTHORI +proj=longlat +datum=WGS84 +no_defs ``` +### API +For searching (without knowing the exact identifier) there was epsg.io API, which transitioned to MapTiler Coordinates API. This API requires obtaining a free API key to use. + +Example: `https://api.maptiler.com/coordinates/search/4326.json?key=YOUR_MAPTILER_KEY&exports=true` +Response (slightly different from the epsg.io API response): + +```json +{ + "results": [ + { + "id": { + "authority": "EPSG", + "code": 4326 + }, + "kind": "CRS-GEOGCRS", + "name": "WGS 84", + "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 +} +``` + ### Aliases Note that Proj4Projection allows aliases to be defined and comes with the following pre-installed aliases. @@ -87,6 +96,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://www.maptiler.com/cloud/coordinates-api/) to search coordinate system E.g. [https://epsg.io/4326](https://epsg.io/4326) provides the definition of WGS84 in WKT-CRS format: