Cloud API Server API Style Engine

Coordinates API

Using the API from JavaScript?

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
 Default Transformation 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

Id Object

Property Type Description
authority
 string
code
 integer

ExportItem Object

Property Type Description
proj4
 string
wkt
 string

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 [ XYZ 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.

XYZ Object

Property Type Description
x
 number
y
 number
z
 number

Default Transformation Object

Most suitable transformation for this CRS.

Property Type Description
authority
 string
code
 integer