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 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.029.

Coordinates API reference

Scalar API Reference
v1.0
OpenAPI 3.1.0

MapTiler API

Support
Terms of Service
Server:https://api.maptiler.com

MapTiler API

Client Libraries
Shell Curl

Coordinates

​
Coordinates Operations

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
Request Example for get/coordinates/search/{query}.json
curl 'https://api.maptiler.com/coordinates/search/finland deprecated:* kind:*.json?key=YOUR_SECRET_TOKEN'

{
  "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
}

Transform coordinates

​
Path Parameters
  • coordinates
    Type: string
    required

    List of coordinate pairs seperated by ; delimeter (Max 50 pairs).

Query Parameters
  • s_srs
    Type: integer

    Source CRS

  • t_srs
    Type: integer

    Target CRS

  • ops
    Type: string

    List of codes of operations seperated by a | (pipe) operator

Responses
  • application/json
Request Example for get/coordinates/transform/{coordinates}.json
curl 'https://api.maptiler.com/coordinates/transform/17,50;17,50,300.json?key=YOUR_SECRET_TOKEN'

{
  "results": [
    {
      "x": 1,
      "y": 1,
      "z": 1
    }
  ],
  "transformer_selection_strategy": "string"
}
Using the OpenAPI Specification?
Get the openapi.yaml
Was this helpful?
MapTiler API
Coordinates API with EPSG support
Coordinates API (EPSG)