Coordinates API

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
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 the MapTiler Cloud.

Responses

Code Content Description
200 application/json SearchResult Object

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 the MapTiler Cloud.

Responses

Code Content Description
200 application/json TransformResult Object

SearchResult Object

Property Type Description
results
array [SearchItem Object]
total
integer

SearchItem Object

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
All Of [Id Object]
Most suitable transformation for this CRS.
deprecated
boolean
exports
ExportItem Object
id
Id Object
kind
string
name
string
transformations
array Any of [TransformationItem Object, integer]
unit
string

ExportItem Object

Property Type Description
proj4
string
wkt
string

Id Object

Property Type Description
authority
string
code
integer

TransformationItem Object

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 Object
grids
array [GridFile Object]
List of grids used in this operation.
id
Id Object
name
string
reversible
boolean
Whether this operation can be used in reverse or not.
target_crs
Id Object
unit
string
usable
boolean
Whether this operation can be used in online API or not.

GridFile Object

Property Type Description
path
string

TransformResult Object

Property Type Description
results
array [object Object]
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.

object Object

Property Type Description
x
number
y
number
z
number