Embedded Files
The "findtransform" web service provides meta data about a transform.
A typical URL is: http://myserver.mycompany.com:8080/INTGeoServer/json/findtransform?json={"crsCode":"2278"}
The following parameters are available:
crsCode: the CRS code to find transforms for. All transforms available in the system matching the CRS will be returned . This is a required parameter. The following screenshot shows this functionality in INTViewer.
Here is an example response. This response has been formatted to improve readability.
{
"numberOfTransformations":3,
"transformations":[
{
"transformCode":1188,
"transformName":"NAD83 to WGS 84 (1)",
"sourceCrsCode":4269,
"targetCrsCode":4326,
"scope":"Accuracy 2m in each axis.",
"remarks":"Derived at 354 stations.",
"areaOfUse":"North America - Canada and USA (CONUS, Alaska mainland)",
"areaOfUseBBox":{
"northLat":86.46,
"southLat":23.81,
"westLon":-172.54,
"eastLon":-47.74
},
"accuracyM":4.0,
"deprecated":false,
"towgs84":"TOWGS84[0.000000, 0.000000, 0.000000, 0, 0, 0, 0]",
"isEmpty":false
},
{
"transformCode":1251,
"transformName":"NAD83 to WGS 84 (2)",
"sourceCrsCode":4269,
"targetCrsCode":4326,
"scope":"For military purposes only. Accuracy 5m, 2m and 5m in X, Y and Z axes.",
"remarks":"Derived at 4 stations.",
"areaOfUse":"USA - Alaska - Aleutian Islands",
"areaOfUseBBox":{
"northLat":54.34,
"southLat":51.3,
"westLon":172.42,
"eastLon":-164.84
},
"accuracyM":8.0,
"deprecated":false,
"towgs84":"TOWGS84[-2.000000, 0.000000, 4.000000, 0, 0, 0, 0]",
"isEmpty":false
},
{
"transformCode":1252,
"transformName":"NAD83 to WGS 84 (3)",
"sourceCrsCode":4269,
"targetCrsCode":4326,
"scope":"For military purposes only. Accuracy 2m in each axis.",
"remarks":"Derived at 6 stations.",
"areaOfUse":"USA - Hawaii - main islands",
"areaOfUseBBox":{
"northLat":25.58,
"southLat":15.56,
"westLon":-163.74,
"eastLon":-151.27
},
"accuracyM":4.0,
"deprecated":false,
"towgs84":"TOWGS84[1.000000, 1.000000, -1.000000, 0, 0, 0, 0]",
"isEmpty":false
}
]
}
The numberOfTransformations entry is the number of transformations found.
The transformations entry is an array containing all transformations matching the CRS.
The transformCode entry is the code of the transform that was found.
The transformName entry is the name of the transform matching that code.
The sourceCrsCode entry is the source CRS code for the transform that was requested. It should be the same as the CRS which was requested.
The targetCrsCode entry is the target CRS code for the transform. This is usually 4326, which is WGS 84
The scope entry gives information about the transform and how it is used.
The remarks entry shows any additional remarks about the transform. Usually this is blank, however it can contain information such as the company that created it, the reason for creating it, etc.
The areaOfUse entry is a short description describing where the transform is used.
The areaOfUseBBox entry contains the following four entries which define the area of use in latitude and longitude values.
The northLat entry is the northern latitude for the area of use.
The southLat entry is the southern latitude for the area of use.
The westLon entry is the western longitude for the area of use.
The eastLon entry is the eastern longitude for the area of use.
The accuracyM entry is the accuracy in meters of the transform.
The deprecated entry is true if this transform has been deprecated for any number of reasons. It can be useful to examine deprecated transforms to see what changes have been made on the fixed version.
The towgs84 entry is the transformation to the WGS84 CRS if it exists.
The isEmpty entry is true or false depending on if the transform is empty or not.
Report abuse