Jump to content

Extension:EPSG

From mediawiki.org
MediaWiki extensions manual
EPSG
Release status: stable
Implementation Parser function , Special page
Description Allows the conversion of coordinates to various coordinate systems using the EPSG Geodetic Parameter Dataset
Author(s) Wouter Rademaker (Egeltalk)
Latest version 1.1 (2022-12-11)
MediaWiki
License BSD 2-clause "Simplified" License
Download
Example Scoutpedia.nl - nl.scoutwiki.org

The EPSG extension allows the conversion of coordinates to various coordinate systems using the EPSG Geodetic Parameter Dataset.

This extension is a MediaWiki front end for the conversion done by epsg.io.

Common EPSG codes

[edit]
  • EPSG:4326 - WGS 84, latitude/longitude coordinate system based on the Earth's center of mass, used by the Global Positioning System among others.
  • EPSG:3857 - Web Mercator projection used for display by many web-based mapping tools, including Google Maps and OpenStreetMap.
  • EPSG:7789 - International Terrestrial Reference Frame 2014 (ITRF2014), an Earth-fixed system that is independent of continental drift.
  • EPSG:7415 - Amersfoort / RD New + NAP height

Other codes can be found on epsg.org, epsg.io and other sites.

Usage

[edit]
  • {{#epsg:x,y,z|source coordinate reference system|target coordinate reference system}} - Conversion from coordinates x,y,z to an other coordinate reference system
  • {{#epsg_2wgs84:x,y,z|source coordinate reference system}} - Conversion from other coordinate reference system to WGS84 Latitude, Longitude, Height
  • {{#wgs84_2epsg:latitude , longitude , height|target coordinate reference system}} - Conversion from WGS84 Latitude, Longitude, Height to an other coordinate reference system

Default coordinate reference system is EPSG:4326 - WGS 84.

  • {{#epsg:4.88352559,52.37453253,0||7415}}
  • {{#epsg:4.88352559,52.37453253,0|4326|7415}}
  • {{#epsg:4.88352559,52.37453253||7415}}
  • {{#epsg:4.88352559,52.37453253|4326|7415}}
  • {{#wgs84_2epsg:52.37453253,4.88352559,0|7415}}
  • {{#wgs84_2epsg:52.37453253,4.88352559|7415}}

All give the same values, approximately: 120701,487525,-43

  • {{#epsg:120701,487525,-43|7415}} gives, approximately: 4.88351, 52.3745, 0
  • {{#epsg_2wgs84:120701,487525,-43|7415}} gives, approximately: 52.3745, 4.88351, 0

The extension is not dependent, but works best with the Semantic MediaWiki, Maps and Arrays extensions.

There is a special page "EPSGTest" (Special:EPSGTest) provided by this extension to give an overview of example use cases and their expected results.

Installation

[edit]
  • Download and place the file(s) in a directory called EPSG in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php file:
    wfLoadExtension( 'EPSG' );
    
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Configuration

[edit]

Optionally, you can set the base URL used for the conversion.

$wgEPSG_URL= ''; default: "https://epsg.io/trans"

You can use a server that runs the code from github.com/maptiler/epsg.io.