diff --git a/README.md b/README.md index 5242533..06c0035 100644 --- a/README.md +++ b/README.md @@ -1,126 +1,33 @@ -# EPSG.io -This service allows you to discover and transform coordinate systems from all over the world. Created and maintained by the [MapTiler team](https://www.maptiler.com/). +# EPSG.io -## Installation +![EPSG logo](./static/img/epsg-logo-small.png) -``` -$ virtualenv venv -$ source venv/bin/activate -$ pip install -r requirements.txt -``` -Copy the content of "index" directory from the .zip from the latest project release. +[EPSG.io](https://epsg.io/) is a tool for discovering and accessing global coordinate systems, finding their parameters, and selecting relevant transformations. Created and maintained by the [MapTiler team](https://www.maptiler.com/), it serves as a _custom_ interface to the [EPSG database](https://en.wikipedia.org/wiki/EPSG_Geodetic_Parameter_Dataset). -Start the server with: +The service offers a list of projections, coordinate systems, bounding boxes, and transformation options for improved precision in coordinate transformations. -``` -$ export FLASK_APP=app.py -$ export FLASK_ENV=development -$ flask run -``` +For detailed documentation, visit [epsg.io/docs](https://epsg.io/docs). -or use the gunicorn startup scripts (`./epsgio start`) +## Discovering coordinate systems, ellipsoids, transformations, units +Coordinate systems, ellipsoids, transformations, and units can be discovered directly via the search field at [EPSG.io](https://epsg.io/). The interface supports searching by EPSG codes (e.g., `3857`) or by part of the system's name (e.g., `pseudo-mercator`). Try [epsg.io/2056](https://epsg.io/2056) as an example. +## Export formats for all software +[EPSG.io](https://epsg.io/) offers coordinate reference system definitions in formats compatible with a wide range of geospatial software, including PROJ, GeoServer, Proj4.js, PostGIS, ESRI ArcGIS, and OGC WKT. For example, see [epsg.io/2056-1676.wkt2](https://epsg.io/2056-1676.wkt2). -## Create your own index from EPSG export +## EPSG.io endpoints +Using [EPSG.io](https://epsg.io/) endpoints allows users to discover coordinate systems, ellipsoids, units, and other objects, and retrieve specific coordinate definitions in various formats. For more details, visit [epsg.io/docs](https://epsg.io/docs). -Note: This is not required, as you can easily download the ready-to-use index from releases. +## Coordinates API -1. Download the newest EPSG database from [http://epsg-registry.org] - * a. After `login` it will able to `export registry` as `Export GML 3.2.1 with EPSG metadata` -2. Make sure that these files(folder) are in one folder - * a. folder `extra_codes_proj4_4.8.0.2` - * b. file `CRS_exceptions.csv` - * c. file `CRS_exceptions.py` - * d. file `gml_parser.py` - * e. file `GmlDictionary.xml` (downloaded EPSG database from http://epsg-registry.org) -3. Start indexing via `python gml_parser.py` -4. Move created `gml.sqlite` into `gml` folder +![MapTiler logo](./static/img/maptiler-logo-small.png) -## Types of URLs: - * [http://epsg.io/] > main page - * [http://epsg.io/1623] > transformation or crs - * [http://epsg.io/5514-1623] > crs with transformation - * [http://epsg.io/5514-1623.wkt] > page with wkt of crs 5514 with transformation 1623 - * [http://epsg.io/5514-1623/map] > page with map of crs 5514 with transformation 1623 - * [http://epsg.io/8901-primem] > other type then transformation or crs (prime meridia, datum,...) - * [http://epsg.io/ogp-op-1623] > gml:id from OGC XML - * [http://epsg.io/urn:ogc:def:coordinateOperation:EPSG::1623] > gml:identifier from OGC XML +[EPSG.io](https://epsg.io/) is a custom, open service provided by [MapTiler](https://www.maptiler.com/), free of charge. The **Coordinate transformation and search service** is powered by the [MapTiler Cloud Coordinates API](https://docs.maptiler.com/cloud/api/coordinates/). In addition to being compatible with [EPSG.io](https://epsg.io/), it introduces the [/transform](https://docs.maptiler.com/cloud/api/coordinates/#transform-coordinates) endpoint for coordinate transformations and [/search](https://docs.maptiler.com/cloud/api/coordinates/#search-coordinate-systems) API endpoint for searching through coordinate systems and its components. -CRS and Transformations are just codes (5514, 1623, 4326, 27700) -Other are codes with suffix like: - * for datums e.g. `9315-datum` - * for prime meridian e.g. `8901-primem` - * for ellipsoid e.g. `7004-ellipsoid` - * for method e.g. `9840-method` - * for coordinate system e.g. `6422-cs` - * for axis e.g. `106-axis` - * for area e.g. `1262-area` - * for units e.g. `9001-units` - -## API for results - -For result page exist a export in JSON and JSONP -for example - -[http://epsg.io/?q=czech&format=json&trans=1&callback=jsonpFunction] - -where: - * `format=json` for export in json **(obligatory)** - * `trans=1` for more detailed transformation in each coordinate reference system (optional) - * `callback=jsonpFunction` for jsonp where "jsonpFunction" is name of Javascript function (optional) - -## API for /trans - -### For one point -[http://epsg.io/trans?x=50&y=17&z=0&s_srs=4326&t_srs=5514&callback=jsonpFunction] - -where everything is optional: - * `x`, `y`, `z` are coordinates of point, which going to be transformed (default is 0,0,0) - * `s_srs` represent source coordinate reference system (default is EPSG:4326) - * `t_srs` represent target coordinate reference system (default is EPSG:4326) - * `callback=jsonpFunction` is for jsonp where "jsonpFunction" is name of JavaScript function - -e.g. [http://epsg.io/trans] will transform point on coordinates 0,0,0 from EPSG:4326 to EPSG:4326 - -### For many points -[http://epsg.io/trans?data=17,50;17,50,300;17.132,50.456&s_srs=4326&&t_srs=5514] - -Where -* data=x,y;x,y,z;x.x,y.y (for example) -* Delimiter between points is `;` -* Delimiter between x,y,z is `,` -* Delimiter between decimal is `.` - -## Types of queries - - * `kind:` - - value | meaning | value | meaning - --- | --- | --- | --- - CRS(default) | All coordinate reference systems | ELLIPSOID | Ellipsoid - PROJCRS | Projected coordinate systems | PRIMEM | Prime meridian - GEOGCRS|Geodetic coordinate systems|METHOD|Method - GEOG3DCRS|Geodetic 3D coordinate systems|CS|Coordinate systems - GCENCRS|Geocentric coordinate systems|VERTCS|Vertical coordinate system - VERTCRS|Vertical coordinate systems|SPHERCS|Spherical coordinate system - ENGCRS|Engineering coordinate systems|CARTESCS|Cartesian coordinate system - COMPOUNDCRS|Compound coordinate systems|ELLIPCS|Ellipsoidal coordinate system - COORDOP|All operations|AXIS|Axis - COPTRANS|Transformations|AREA|Area - COPCONOP|Compound operations|UNIT|Unit - COPCON|Conversions|ANGUNIT|Angle unit - DATUM|All datums|SCALEUNIT|Scale unit - VERTDAT|Vertical datums|LENUNIT|Length unit - ENGDAT|Engineering datums|TIMEUNIT|Time unit - GEODDAT|Geodetic datums|| - - - * `deprecated:` 0(default), 1 - * `code:` number of EPSG (5514, 4326,...) - * `name:` string of name (wgs 84, jtsk, s-jtks) - * `area:` string area of use (czech republic, world) - * `area_trans:` string area of use of transformation - * `alt_title:` alternative title (wgs84,...) - -combinations: 8901 kind:PRIMEM, 1623 kind:COORDOP, code:1625 kind:COORDOP deprecated:1,... +The **Coordinates API** from MapTiler offers: +* API for **coordinate transformations** +* API for **searching** and **discovering** coordinate reference systems +* **Stable, reliable service** for integration into applications +* Option to use a dedicated MapTiler API key, enabling cost management across **multiple apps** +* **Batch transformations** for up to 50 points +For detailed API documentation, visit [docs.maptiler.com/cloud/api/coordinates/](https://docs.maptiler.com/cloud/api/coordinates/). \ No newline at end of file diff --git a/static/img/epsg-logo-small.png b/static/img/epsg-logo-small.png new file mode 100644 index 0000000..1cce7eb Binary files /dev/null and b/static/img/epsg-logo-small.png differ diff --git a/static/img/maptiler-logo-small.png b/static/img/maptiler-logo-small.png new file mode 100644 index 0000000..58ffa5e Binary files /dev/null and b/static/img/maptiler-logo-small.png differ