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.

Key

You need a MapTiler API key to use this service. Get it here and learn how to secure 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 13.102.

Coordinates API reference

Configure your environment settings below to update code samples and live API tests:

Server – select where your requests go. Keep the default api.maptiler.com or use the EU-based endpoint.
Authentication – enter your API key. It will automatically populate code snippets and test requests (otherwise, placeholders are shown).
Client Libraries – select your preferred programming language of the code examples.

Scalar API Reference

v1.0

OpenAPI 3.1.0

MapTiler API reference

Support

Server

MapTiler API

Client Libraries

Shell Curl

Coordinates

Coordinates Operations

get/coordinates/search/{query}.json
get/coordinates/transform/{coordinates}.json

Search coordinate systems

Path Parameters

query
Type: string
required
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)

Query Parameters

limit
Type: integer
min:
1
max:
50

Maximum number of results returned
offset
Type: integer
min:
0

The starting position of returned list of results
transformations
Type: boolean

Show detailed transformations for each CRS
exports
Type: boolean

Show exports in WKT and Proj4 notations

Responses

application/json

get/coordinates/search/{query}.json

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

Show Schema

{
  "results": [
    {
      "accuracy": 1,
      "area": "string",
      "bbox": [
        1
      ],
      "default_transformation": {
        "authority": "string",
        "code": 1
      },
      "deprecated": true,
      "exports": {
        "proj4": "string",
        "wkt": "string"
      },
      "id": {
        "authority": "string",
        "code": 1
      },
      "kind": "string",
      "name": "string",
      "transformations": [
        {
          "accuracy": 1,
          "area": "string",
          "bbox": [
            1
          ],
          "deprecated": true,
          "exports": {
            "proj4": "string",
            "wkt": "string"
          },
          "grids": [
            {
              "path": "string"
            }
          ],
          "id": {
            "authority": "string",
            "code": 1
          },
          "name": "string",
          "reversible": true,
          "target_crs": {
            "authority": "string",
            "code": 1
          },
          "unit": "string",
          "usable": true
        }
      ],
      "unit": "string"
    }
  ],
  "total": 1
}

Coordinate systems matching the query.

Transform coordinates