Coordinates API

The MapTiler Coordinates API makes it possible to search map coordinate systems and transform coordinates from one to another. See the intro to working with coordinate systems to learn about how it works and when it’s useful.

How to use the API

  • Directly from any application, CLI, backend, pipeline.
  • Via the Coordinates API client library, which wraps the API calls in ready-made functions for easier implementation in JavaScript.
You need a MapTiler API key to use this service. Get it here and learn how to protect it.

Getting started

For practical guidance and sample API calls, see:

The results provided by the Coordinates API are based on the EPSG database version 12.013.

Search coordinate systems

GET https://api.maptiler.com/coordinates/search/{query}.json

Request

You must include an API Key with every API request

Path Parameters

Parameters Type Description
query
 string
Query string used to search the catalog. It accepts plain terms such as names of locations and key:value pairs for filtering. Following parameter values can be used:
  • kind
    • * (All kinds)
    • CRS (All coordinate reference systems - default)
      • CRS-PROJCRS (Projected coordinate systems)
      • CRS-GEOGCRS (Geodetic coordinate systems)
      • CRS-GEOG3DCRS (Geodetic 3D coordinate systems)
      • CRS-GCENCRS (Geocentric coordinate systems)
      • CRS-VERTCRS (Vertical coordinate systems)
      • CRS-ENGCRS (Engineering coordinate systems)
      • CRS-COMPOUNDCRS (Compound coordinate systems)
      • CRS-DRVDCRS (Derived coordinate systems)
    • COORDOP (All operations)
      • COORDOP-COPTRAN (Transformations)
      • COORDOP-COPCONO (Compound operations)
      • COORDOP-POIMOTO (Point motion operations)
      • COORDOP-COPCON (Conversions)
    • DATUM (All datums)
      • DATUM-VERTDAT (Vertical datums)
      • DATUM-ENGDAT (Engineering datums)
      • DATUM-GEODDAT (Geodetic datums)
      • DATUM-DYNGEODDA (Dynamic geodetic datums)
      • DATUM-ENSEMDAT (Ensemble datum)
    • ELLIPSOID (Ellipsoid)
    • PRIMEM (Prime meridian)
    • METHOD (Method / Projection)
    • CS (Coordinate systems)
      • CS-VERTCS (Vertical coordinate system)
      • CS-SPHERCS (Spherical coordinate system)
      • CS-CARTESCS (Cartesian coordinate system)
      • CS-ELLIPCS (Ellipsoidal coordinate system)
      • CS-AFFINE (Affine coordinate system)
      • CS-ORDINAL (Ordinal coordinate system)
    • AXIS (Axis)
    • AREA (Area)
    • UNIT (Unit)
      • UNIT-ANGUNIT (Angle unit)
      • UNIT-SCALEUNIT (Scale unit)
      • UNIT-LENUNIT (Length unit)
      • UNIT-TIMEUNIT (Time unit)
  • code
    • Full code of the resource
  • trans
    • Code of the transformation
  • deprecated
    • * (Both active and deprecated)
    • 0 (active only - default)
    • 1 (deprecated only)
Examples:
finland deprecated:* kind:* - Finding all resources of Finland
United Kingdom - Basic example
mercator deprecated:1 - Finding deprecated mercator CRS
Finland kind:DATUM - Filtering resources using parameter(s)
code:4326 - Finding specific resource (WGS84) by code

Query Parameters

Parameters Type Description
limit
 integer
Maximum number of results returned
>= 1<= 50
Default: 10
offset
 integer
The starting position of returned list of results
>= 0
Default: 0
transformations
 boolean
Show detailed transformations for each CRS
Default: false
exports
 boolean
Show exports in WKT and Proj4 notations
Default: false
Request example

  https://api.maptiler.com/coordinates/search/finland deprecated:* kind:*.json?key=YOUR_MAPTILER_API_KEY

Get your FREE API key in your MapTiler account.

Responses

Code Content Description
200 application/json SearchResult

Transform coordinates

GET https://api.maptiler.com/coordinates/transform/{coordinates}.json

Request

You must include an API Key with every API request

Path Parameters

Parameters Type Description
coordinates
 string
List of coordinate pairs seperated by ; delimeter (Max 50 pairs).
Example: 17,50;17,50,300

Query Parameters

Parameters Type Description
s_srs
 integer
Source CRS
Default: 4326
t_srs
 integer
Target CRS
Default: 4326
ops
 string
List of codes of operations seperated by a | (pipe) operator
Example: 1623
Request example

  https://api.maptiler.com/coordinates/transform/17,50;17,50,300.json?key=YOUR_MAPTILER_API_KEY

Get your FREE API key in your MapTiler account.

Responses

Code Content Description
200 application/json TransformResult

SearchResult

Property Type Description
results
 array [ SearchItem ]
total
 integer

SearchItem

Property Type Description
accuracy
 number
area
 string
bbox
 array [number]
Bounding box of the resource in [min_lon, min_lat, max_lon, max_lat] order.
default_transformation
 Default Transformation
Most suitable transformation for this CRS.
deprecated
 boolean
exports
 ExportItem
id
 Id
kind
 string
name
 string
transformations
 array Any Of [TransformationItem , integer]
unit
 string

Id

Property Type Description
authority
 string
code
 integer

ExportItem

Property Type Description
proj4
 string
wkt
 string

TransformationItem

Property Type Description
accuracy
 number
area
 string
bbox
 array [number]
Bounding box of the resource in [min_lon, min_lat, max_lon, max_lat] order.
deprecated
 boolean
exports
 ExportItem
grids
 array [ GridFile ]
List of grids used in this operation.
id
 Id
name
 string
reversible
 boolean
Whether this operation can be used in reverse or not.
target_crs
 Id
unit
 string
usable
 boolean
Whether this operation can be used in online API or not.

GridFile

Property Type Description
path
 string

TransformResult

Property Type Description
results
 array [ XYZ ]
transformer_selection_strategy
 string
Transformations are selected using given ops parameter. If no parameter is given, auto strategy is used. If given, it may try to use a listed transformation, then fallback to towgs84 patching, and finally boundcrs.

XYZ

Property Type Description
x
 number
y
 number
z
 number

Default Transformation

Most suitable transformation for this CRS.

Property Type Description
authority
 string
code
 integer
Using the OpenAPI Specification?
Get the openapi.yaml