Coordinates transformation

Basic principles

This web service transforms pairs of coordinates from one projection to another. For example, from wgs84 to Sphere Mercator.

Coordinates transformation example

{
        "url":"https://api.geoconcept.com/EU/GCW/geoconcept-web/api/lbs/srsTransform.json",
        "method":"POST",
        "body": {
        "inSrs": "epsg:4326",
        "outSrs": "epsg:3857",
        "points": [
        {
          "x": "31.137736",
          "y": "29.975256"
        },
        {
          "x": "103.866986",
          "y": "13.412490"
        },
        {
          "x": "-72.54583",
          "y": "-13.1639"
        }
      ]
    }
}

Parameters / properties

Input

parameter description optional default

inSrs

input projection (EPSG code such as epsg:4326 or wgs84)

no

outSrs

output projection (EPSG code such as epsg:4326 or wgs84)

no

points

Coordinates for points separated by “,”. Pair of XY coordinates are separated by “;”.

no

Output

Transformed points (srsTransformResult)

parameter type min/max description

points

array geographicPoint

0/unlimited

transformed points

Points(geographicPoint)

parameter type min/max description

x

double

1/1

first coordinate or longitude

y

double

1/1

second coordonnée or latitude

Possible returns

Case of an itinerary found (status is OK) 

{
  "message": null,
  "status": "OK",
  "points": [
    {
      "x": 3466236.915975383,
      "y": 3500369.6293757656
    },
    {
      "x": 11562419.991752075,
      "y": 1506897.9005721502
    },
    {
      "x": -8075764.854775389,
      "y": -1478463.6733575095
    }
  ]
}

Case of an empty start projection 

An error append : (500) Internal Server Error
InvalidParameterException: inSrs can't be null or empty

Case of an empty destination projection 

An error append : (500) Internal Server Error
InvalidParameterException: outSrs can't be null or empty

Case of an incorrect projection 

An error append : (500) Internal Server Error
CoordinateTransformEngineException: inSrs or outSrs do not exist

Case of a coordinate for an empty point 

An error append : (500) Internal Server Error
InvalidParameterException: points can't be null or empty

Case of a faulty typing entry on the coordinates for a series of points 

An error append : (500) Internal Server Error
NumberFormatException: For input string: "48.8degree"