|
|
# CRS Conversion Service
|
|
|
|
|
|
|
|
|
<a name="overview"></a>
|
|
|
## Overview
|
|
|
Provides conversion/transformation services from a source to a target CRS. A coordinate operation is a conversion if the source and target CRS share the same datum; the operation is called transformation if datum transformations are involved, i.e. source and target CRS do not share the same datum.
|
|
|
|
|
|
|
|
|
### Version information
|
|
|
*Version* : 1.0.0
|
|
|
|
|
|
|
|
|
### Contact information
|
|
|
*Contact* : DELFI support
|
|
|
*Contact Email* : DELFI-DevPortal-Help@slb.com
|
|
|
|
|
|
|
|
|
### URI scheme
|
|
|
*Host* : api.evq.csp.slb.com
|
|
|
*BasePath* : /de/crs-converter/v1
|
|
|
*Schemes* : HTTPS
|
|
|
|
|
|
|
|
|
### Tags
|
|
|
|
|
|
* CRS Point Conversion
|
|
|
* Trajectory Computation and Conversion
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<a name="paths"></a>
|
|
|
## Paths
|
|
|
|
|
|
<a name="convertpoint"></a>
|
|
|
### Convert a list of points
|
|
|
```
|
|
|
POST /convert
|
|
|
```
|
|
|
|
|
|
|
|
|
#### Description
|
|
|
Convert a list of points
|
|
|
|
|
|
|
|
|
#### Parameters
|
|
|
|
|
|
|Type|Name|Schema|
|
|
|
|---|---|---|
|
|
|
|**Body**|**body** <br>*optional*|[ConvertPointsRequest](#convertpointsrequest)|
|
|
|
|
|
|
|
|
|
#### Responses
|
|
|
|
|
|
|HTTP Code|Description|Schema|
|
|
|
|---|---|---|
|
|
|
|**200**|Conversion performed successfully|[ConvertPointsResponse](#convertpointsresponse)|
|
|
|
|**400**|Bad input format|[ErrorResponse](#errorresponse)|
|
|
|
|**503**|CRS-converter overloaded; try again later. See HttpHeader 'Retry-After'.|[ErrorResponse](#errorresponse)|
|
|
|
|
|
|
|
|
|
#### Consumes
|
|
|
|
|
|
* `application/json`
|
|
|
|
|
|
|
|
|
#### Produces
|
|
|
|
|
|
* `application/json`
|
|
|
|
|
|
|
|
|
#### Tags
|
|
|
|
|
|
* CRS Point Conversion
|
|
|
|
|
|
|
|
|
#### Security
|
|
|
|
|
|
|Type|Name|
|
|
|
|---|---|
|
|
|
|**apiKey**|**[bearer](#bearer)**|
|
|
|
|**apiKey**|**[appkey](#appkey)**|
|
|
|
|
|
|
|
|
|
#### Example HTTP request
|
|
|
|
|
|
##### Request body
|
|
|
```json
|
|
|
{
|
|
|
"fromCRS" : "{\"lateBoundCRS\":{\"wkt\":\"GEOGCS[\\\"GCS_Provisional_S_American_1956\\\",DATUM[\\\"D_Provisional_S_American_1956\\\",SPHEROID[\\\"International_1924\\\",6378388.0,297.0]],PRIMEM[\\\"Greenwich\\\",0.0],UNIT[\\\"Degree\\\",0.0174532925199433],AUTHORITY[\\\"EPSG\\\",4248]]\",\"ver\":\"PE_10_3_1\",\"name\":\"GCS_Provisional_S_American_1956\",\"authCode\":{\"auth\":\"EPSG\",\"code\":\"4248\"},\"type\":\"LBC\"},\"singleCT\":{\"wkt\":\"GEOGTRAN[\\\"PSAD_1956_To_WGS_1984_9\\\",GEOGCS[\\\"GCS_Provisional_S_American_1956\\\",DATUM[\\\"D_Provisional_S_American_1956\\\",SPHEROID[\\\"International_1924\\\",6378388.0,297.0]],PRIMEM[\\\"Greenwich\\\",0.0],UNIT[\\\"Degree\\\",0.0174532925199433]],GEOGCS[\\\"GCS_WGS_1984\\\",DATUM[\\\"D_WGS_1984\\\",SPHEROID[\\\"WGS_1984\\\",6378137.0,298.257223563]],PRIMEM[\\\"Greenwich\\\",0.0],UNIT[\\\"Degree\\\",0.0174532925199433]],METHOD[\\\"Geocentric_Translation\\\"],PARAMETER[\\\"X_Axis_Translation\\\",-295.0],PARAMETER[\\\"Y_Axis_Translation\\\",173.0],PARAMETER[\\\"Z_Axis_Translation\\\",-371.0],AUTHORITY[\\\"EPSG\\\",1209]]\",\"ver\":\"PE_10_3_1\",\"name\":\"PSAD_1956_To_WGS_1984_9\",\"authCode\":{\"auth\":\"EPSG\",\"code\":\"1209\"},\"type\":\"ST\"},\"ver\":\"PE_10_3_1\",\"name\":\"PSAD56 * DMA-Ven [4248,1209]\",\"authCode\":{\"auth\":\"SLB\",\"code\":\"4248009\"},\"type\":\"EBC\"}",
|
|
|
"toCRS" : "{\"lateBoundCRS\":{\"wkt\":\"PROJCS[\\\"Trinidad_1903_Trinidad_Grid\\\",GEOGCS[\\\"GCS_Trinidad_1903\\\",DATUM[\\\"D_Trinidad_1903\\\",SPHEROID[\\\"Clarke_1858\\\",6378293.64520876,294.260676369]],PRIMEM[\\\"Greenwich\\\",0.0],UNIT[\\\"Degree\\\",0.0174532925199433]],PROJECTION[\\\"Cassini\\\"],PARAMETER[\\\"False_Easting\\\",430000.0],PARAMETER[\\\"False_Northing\\\",325000.0],PARAMETER[\\\"Central_Meridian\\\",-61.3333333333333],PARAMETER[\\\"Scale_Factor\\\",1.0],PARAMETER[\\\"Latitude_Of_Origin\\\",10.4416666666667],UNIT[\\\"Link_Clarke\\\",0.201166195164],AUTHORITY[\\\"EPSG\\\",30200]]\",\"ver\":\"PE_10_3_1\",\"name\":\"Trinidad_1903_Trinidad_Grid\",\"authCode\":{\"auth\":\"EPSG\",\"code\":\"30200\"},\"type\":\"LBC\"},\"singleCT\":{\"wkt\":\"GEOGTRAN[\\\"Trinidad_1903_To_WGS_1984_2\\\",GEOGCS[\\\"GCS_Trinidad_1903\\\",DATUM[\\\"D_Trinidad_1903\\\",SPHEROID[\\\"Clarke_1858\\\",6378293.64520876,294.260676369]],PRIMEM[\\\"Greenwich\\\",0.0],UNIT[\\\"Degree\\\",0.0174532925199433]],GEOGCS[\\\"GCS_WGS_1984\\\",DATUM[\\\"D_WGS_1984\\\",SPHEROID[\\\"WGS_1984\\\",6378137.0,298.257223563]],PRIMEM[\\\"Greenwich\\\",0.0],UNIT[\\\"Degree\\\",0.0174532925199433]],METHOD[\\\"Geocentric_Translation\\\"],PARAMETER[\\\"X_Axis_Translation\\\",-61.0],PARAMETER[\\\"Y_Axis_Translation\\\",285.2],PARAMETER[\\\"Z_Axis_Translation\\\",471.6],AUTHORITY[\\\"EPSG\\\",10085]]\",\"ver\":\"PE_10_3_1\",\"name\":\"Trinidad_1903_To_WGS_1984_2\",\"authCode\":{\"auth\":\"EPSG\",\"code\":\"10085\"},\"type\":\"ST\"},\"ver\":\"PE_10_3_1\",\"name\":\"Trinidad 1903 * EOG-Tto Trin / Trinidad Grid [30200,10085]\",\"authCode\":{\"auth\":\"SLB\",\"code\":\"30200002\"},\"type\":\"EBC\"}",
|
|
|
"points" : [ {
|
|
|
"x" : -61.04340628871454,
|
|
|
"y" : 10.673103179456877,
|
|
|
"z" : 0
|
|
|
} ]
|
|
|
}
|
|
|
```
|
|
|
|
|
|
|
|
|
<a name="converttrajectory"></a>
|
|
|
### Convert trajectory stations
|
|
|
```
|
|
|
POST /convertTrajectory
|
|
|
```
|
|
|
|
|
|
|
|
|
#### Description
|
|
|
Convert a list of trajectory stations, given the unit and spatial context and a reference point in 3D where MD==0.
|
|
|
|
|
|
|
|
|
#### Parameters
|
|
|
|
|
|
|Type|Name|Schema|
|
|
|
|---|---|---|
|
|
|
|**Body**|**body** <br>*optional*|[ConvertTrajectoryRequest](#converttrajectoryrequest)|
|
|
|
|
|
|
|
|
|
#### Responses
|
|
|
|
|
|
|HTTP Code|Description|Schema|
|
|
|
|---|---|---|
|
|
|
|**200**|Trajectory conversion performed successfully|[ConvertTrajectoryResponse](#converttrajectoryresponse)|
|
|
|
|**400**|Bad input format|[ErrorResponse](#errorresponse)|
|
|
|
|**503**|CRS-converter overloaded; try again later. See HttpHeader 'Retry-After'.|[ErrorResponse](#errorresponse)|
|
|
|
|
|
|
|
|
|
#### Consumes
|
|
|
|
|
|
* `application/json`
|
|
|
|
|
|
|
|
|
#### Produces
|
|
|
|
|
|
* `application/json`
|
|
|
|
|
|
|
|
|
#### Tags
|
|
|
|
|
|
* Trajectory Computation and Conversion
|
|
|
|
|
|
|
|
|
#### Security
|
|
|
|
|
|
|Type|Name|
|
|
|
|---|---|
|
|
|
|**apiKey**|**[bearer](#bearer)**|
|
|
|
|**apiKey**|**[appkey](#appkey)**|
|
|
|
|
|
|
|
|
|
#### Example HTTP request
|
|
|
|
|
|
##### Request body
|
|
|
```json
|
|
|
{
|
|
|
"trajectoryCRS" : "{\"wkt\":\"PROJCS[\\\"WGS_1984_UTM_Zone_31N\\\",GEOGCS[\\\"GCS_WGS_1984\\\",DATUM[\\\"D_WGS_1984\\\",SPHEROID[\\\"WGS_1984\\\",6378137.0,298.257223563]],PRIMEM[\\\"Greenwich\\\",0.0],UNIT[\\\"Degree\\\",0.0174532925199433]],PROJECTION[\\\"Transverse_Mercator\\\"],PARAMETER[\\\"False_Easting\\\",500000.0],PARAMETER[\\\"False_Northing\\\",0.0],PARAMETER[\\\"Central_Meridian\\\",3.0],PARAMETER[\\\"Scale_Factor\\\",0.9996],PARAMETER[\\\"Latitude_Of_Origin\\\",0.0],UNIT[\\\"Meter\\\",1.0],AUTHORITY[\\\"EPSG\\\",32631]]\",\"ver\":\"PE_10_3_1\",\"name\":\"WGS_1984_UTM_Zone_31N\",\"authCode\":{\"auth\":\"EPSG\",\"code\":\"32631\"},\"type\":\"LBC\"}",
|
|
|
"azimuthReference" : "TN",
|
|
|
"unitXY" : "{\"scaleOffset\":{\"scale\":1.0,\"offset\":0.0},\"symbol\":\"m\",\"baseMeasurement\":{\"ancestry\":\"Length\",\"type\":\"UM\"},\"type\":\"USO\"}",
|
|
|
"unitZ" : "{\"scaleOffset\":{\"scale\":1.0,\"offset\":0.0},\"symbol\":\"m\",\"baseMeasurement\":{\"ancestry\":\"Length\",\"type\":\"UM\"},\"type\":\"USO\"}",
|
|
|
"referencePoint" : {
|
|
|
"x" : 400000,
|
|
|
"y" : 6500000,
|
|
|
"z" : 0
|
|
|
},
|
|
|
"inputKind" : "MD_Incl_Azim",
|
|
|
"interpolate" : true,
|
|
|
"inputStations" : [ {
|
|
|
"md" : 0,
|
|
|
"inclination" : 0,
|
|
|
"azimuth" : 0
|
|
|
}, {
|
|
|
"md" : 1000,
|
|
|
"inclination" : 0,
|
|
|
"azimuth" : 0
|
|
|
}, {
|
|
|
"md" : 2000,
|
|
|
"inclination" : 90,
|
|
|
"azimuth" : 0
|
|
|
}, {
|
|
|
"md" : 3000,
|
|
|
"inclination" : 90,
|
|
|
"azimuth" : 0
|
|
|
}, {
|
|
|
"md" : 5000,
|
|
|
"inclination" : 90,
|
|
|
"azimuth" : 90
|
|
|
}, {
|
|
|
"md" : 6000,
|
|
|
"inclination" : 90,
|
|
|
"azimuth" : 90
|
|
|
} ],
|
|
|
"method" : "AzimuthalEquidistant"
|
|
|
}
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<a name="definitions"></a>
|
|
|
## Definitions
|
|
|
|
|
|
<a name="convertpointsrequest"></a>
|
|
|
### ConvertPointsRequest
|
|
|
Request to convert a set of points from a source CRS to a target CRS.
|
|
|
|
|
|
|
|
|
|Name|Description|Schema|
|
|
|
|---|---|---|
|
|
|
|**fromCRS** <br>*required*|Source CRS as persistable reference string <br>**Example** : `"{\"lateBoundCRS\":{\"wkt\":\"GEOGCS[\\\"GCS_Provisional_S_American_1956\\\",DATUM[\\\"D_Provisional_S_American_1956\\\",SPHEROID[\\\"International_1924\\\",6378388.0,297.0]],PRIMEM[\\\"Greenwich\\\",0.0],UNIT[\\\"Degree\\\",0.0174532925199433],AUTHORITY[\\\"EPSG\\\",4248]]\",\"ver\":\"PE_10_3_1\",\"name\":\"GCS_Provisional_S_American_1956\",\"authCode\":{\"auth\":\"EPSG\",\"code\":\"4248\"},\"type\":\"LBC\"},\"singleCT\":{\"wkt\":\"GEOGTRAN[\\\"PSAD_1956_To_WGS_1984_9\\\",GEOGCS[\\\"GCS_Provisional_S_American_1956\\\",DATUM[\\\"D_Provisional_S_American_1956\\\",SPHEROID[\\\"International_1924\\\",6378388.0,297.0]],PRIMEM[\\\"Greenwich\\\",0.0],UNIT[\\\"Degree\\\",0.0174532925199433]],GEOGCS[\\\"GCS_WGS_1984\\\",DATUM[\\\"D_WGS_1984\\\",SPHEROID[\\\"WGS_1984\\\",6378137.0,298.257223563]],PRIMEM[\\\"Greenwich\\\",0.0],UNIT[\\\"Degree\\\",0.0174532925199433]],METHOD[\\\"Geocentric_Translation\\\"],PARAMETER[\\\"X_Axis_Translation\\\",-295.0],PARAMETER[\\\"Y_Axis_Translation\\\",173.0],PARAMETER[\\\"Z_Axis_Translation\\\",-371.0],AUTHORITY[\\\"EPSG\\\",1209]]\",\"ver\":\"PE_10_3_1\",\"name\":\"PSAD_1956_To_WGS_1984_9\",\"authCode\":{\"auth\":\"EPSG\",\"code\":\"1209\"},\"type\":\"ST\"},\"ver\":\"PE_10_3_1\",\"name\":\"PSAD56 * DMA-Ven [4248,1209]\",\"authCode\":{\"auth\":\"SLB\",\"code\":\"4248009\"},\"type\":\"EBC\"}"`|string|
|
|
|
|**points** <br>*required*|List of points to be converted|< [Point](#point) > array|
|
|
|
|**toCRS** <br>*required*|Target CRS as persistable reference string <br>**Example** : `"{\"lateBoundCRS\":{\"wkt\":\"PROJCS[\\\"Trinidad_1903_Trinidad_Grid\\\",GEOGCS[\\\"GCS_Trinidad_1903\\\",DATUM[\\\"D_Trinidad_1903\\\",SPHEROID[\\\"Clarke_1858\\\",6378293.64520876,294.260676369]],PRIMEM[\\\"Greenwich\\\",0.0],UNIT[\\\"Degree\\\",0.0174532925199433]],PROJECTION[\\\"Cassini\\\"],PARAMETER[\\\"False_Easting\\\",430000.0],PARAMETER[\\\"False_Northing\\\",325000.0],PARAMETER[\\\"Central_Meridian\\\",-61.3333333333333],PARAMETER[\\\"Scale_Factor\\\",1.0],PARAMETER[\\\"Latitude_Of_Origin\\\",10.4416666666667],UNIT[\\\"Link_Clarke\\\",0.201166195164],AUTHORITY[\\\"EPSG\\\",30200]]\",\"ver\":\"PE_10_3_1\",\"name\":\"Trinidad_1903_Trinidad_Grid\",\"authCode\":{\"auth\":\"EPSG\",\"code\":\"30200\"},\"type\":\"LBC\"},\"singleCT\":{\"wkt\":\"GEOGTRAN[\\\"Trinidad_1903_To_WGS_1984_2\\\",GEOGCS[\\\"GCS_Trinidad_1903\\\",DATUM[\\\"D_Trinidad_1903\\\",SPHEROID[\\\"Clarke_1858\\\",6378293.64520876,294.260676369]],PRIMEM[\\\"Greenwich\\\",0.0],UNIT[\\\"Degree\\\",0.0174532925199433]],GEOGCS[\\\"GCS_WGS_1984\\\",DATUM[\\\"D_WGS_1984\\\",SPHEROID[\\\"WGS_1984\\\",6378137.0,298.257223563]],PRIMEM[\\\"Greenwich\\\",0.0],UNIT[\\\"Degree\\\",0.0174532925199433]],METHOD[\\\"Geocentric_Translation\\\"],PARAMETER[\\\"X_Axis_Translation\\\",-61.0],PARAMETER[\\\"Y_Axis_Translation\\\",285.2],PARAMETER[\\\"Z_Axis_Translation\\\",471.6],AUTHORITY[\\\"EPSG\\\",10085]]\",\"ver\":\"PE_10_3_1\",\"name\":\"Trinidad_1903_To_WGS_1984_2\",\"authCode\":{\"auth\":\"EPSG\",\"code\":\"10085\"},\"type\":\"ST\"},\"ver\":\"PE_10_3_1\",\"name\":\"Trinidad 1903 * EOG-Tto Trin / Trinidad Grid [30200,10085]\",\"authCode\":{\"auth\":\"SLB\",\"code\":\"30200002\"},\"type\":\"EBC\"}"`|string|
|
|
|
|
|
|
|
|
|
<a name="convertpointsresponse"></a>
|
|
|
### ConvertPointsResponse
|
|
|
Response of a CRS conversion/transformation operation
|
|
|
|
|
|
|
|
|
|Name|Description|Schema|
|
|
|
|---|---|---|
|
|
|
|**points** <br>*optional*|Converted points; length and order of the array is the same as in the request. Points, which failed to convert, are returned as NaN.|< [Point](#point) > array|
|
|
|
|**successCount** <br>*optional*|Number of points successfully converted. If the number is less than the request array length conversion/transformation failures occurred.|integer (int32)|
|
|
|
|
|
|
|
|
|
<a name="converttrajectoryrequest"></a>
|
|
|
### ConvertTrajectoryRequest
|
|
|
Input trajectory data structure; contains the context (crs, units, azimuth reference, method)
|
|
|
|
|
|
|
|
|
|Name|Description|Schema|
|
|
|
|---|---|---|
|
|
|
|**azimuthReference** <br>*required*|Azimuth reference for the input trajectory station azimuth values (TrueNorth or GridNorth) <br>**Example** : `"TrueNorth"`|string|
|
|
|
|**inputKind** <br>*optional*|The kind of input; one of MD_Incl_Azim (default), MD_X_Y_Z, MD_dX_dY_dZ, X_Y_Z, dX_dY_dZ. MD stands for measured depth; MD_X_Y_Z/X_Y_Z stand for absolute coordinates in the reference CRS, MD_dX_dY_dZ/dX_dY_dZ stand for deviations relative to the reference point. <br>**Example** : `"MD_Incl_Azim"`|string|
|
|
|
|**inputStations** <br>*required*|The array of input trajectory stations|< [TrajectoryStationIn](#trajectorystationin) > array|
|
|
|
|**interpolate** <br>*optional*|Perform trajectory interpolation on demand; default is true.|boolean|
|
|
|
|**method** <br>*required*|The computation method - 'AzimuthalEquidistant' (default) or 'LMP' (Lee's modified proposal SPE96813) <br>**Example** : `"AzimuthalEquidistant"`|string|
|
|
|
|**referencePoint** <br>*required*|The 3D reference point in the 'trajectoryCRS' where MD==0.|[Point](#point)|
|
|
|
|**trajectoryCRS** <br>*required*|Coordinate reference system for the reference point; typically the CRS is a projected CRS; if a geographic CRS is provided, the unitXY must be defined and the azimuthReference must be TrueNorth. <br>**Example** : `"{\"lateBoundCRS\":{\"wkt\":\"PROJCS[\\\"Trinidad_1903_Trinidad_Grid\\\",GEOGCS[\\\"GCS_Trinidad_1903\\\",DATUM[\\\"D_Trinidad_1903\\\",SPHEROID[\\\"Clarke_1858\\\",6378293.64520876,294.260676369]],PRIMEM[\\\"Greenwich\\\",0.0],UNIT[\\\"Degree\\\",0.0174532925199433]],PROJECTION[\\\"Cassini\\\"],PARAMETER[\\\"False_Easting\\\",430000.0],PARAMETER[\\\"False_Northing\\\",325000.0],PARAMETER[\\\"Central_Meridian\\\",-61.3333333333333],PARAMETER[\\\"Scale_Factor\\\",1.0],PARAMETER[\\\"Latitude_Of_Origin\\\",10.4416666666667],UNIT[\\\"Link_Clarke\\\",0.201166195164],AUTHORITY[\\\"EPSG\\\",30200]]\",\"ver\":\"PE_10_3_1\",\"name\":\"Trinidad_1903_Trinidad_Grid\",\"authCode\":{\"auth\":\"EPSG\",\"code\":\"30200\"},\"type\":\"LBC\"},\"singleCT\":{\"wkt\":\"GEOGTRAN[\\\"Trinidad_1903_To_WGS_1984_2\\\",GEOGCS[\\\"GCS_Trinidad_1903\\\",DATUM[\\\"D_Trinidad_1903\\\",SPHEROID[\\\"Clarke_1858\\\",6378293.64520876,294.260676369]],PRIMEM[\\\"Greenwich\\\",0.0],UNIT[\\\"Degree\\\",0.0174532925199433]],GEOGCS[\\\"GCS_WGS_1984\\\",DATUM[\\\"D_WGS_1984\\\",SPHEROID[\\\"WGS_1984\\\",6378137.0,298.257223563]],PRIMEM[\\\"Greenwich\\\",0.0],UNIT[\\\"Degree\\\",0.0174532925199433]],METHOD[\\\"Geocentric_Translation\\\"],PARAMETER[\\\"X_Axis_Translation\\\",-61.0],PARAMETER[\\\"Y_Axis_Translation\\\",285.2],PARAMETER[\\\"Z_Axis_Translation\\\",471.6],AUTHORITY[\\\"EPSG\\\",10085]]\",\"ver\":\"PE_10_3_1\",\"name\":\"Trinidad_1903_To_WGS_1984_2\",\"authCode\":{\"auth\":\"EPSG\",\"code\":\"10085\"},\"type\":\"ST\"},\"ver\":\"PE_10_3_1\",\"name\":\"Trinidad 1903 * EOG-Tto Trin / Trinidad Grid [30200,10085]\",\"authCode\":{\"auth\":\"SLB\",\"code\":\"30200002\"},\"type\":\"EBC\"}"`|string|
|
|
|
|**unitXY** <br>*optional*|The horizontal unit of the dx, dy in the input trajectory stations; the unit must be a length unit in 'persistable reference' format, see example. <br>**Example** : `"{\"scaleOffset\":{\"scale\":1.0,\"offset\":0.0},\"symbol\":\"m\",\"baseMeasurement\":{\"ancestry\":\"Length\",\"type\":\"UM\"},\"type\":\"USO\"}"`|string|
|
|
|
|**unitZ** <br>*required*|The vertical unit of the dz in the input trajectory stations; the unit must be a length unit in 'persistable reference' format, see example. <br>**Example** : `"{\"scaleOffset\":{\"scale\":1.0,\"offset\":0.0},\"symbol\":\"m\",\"baseMeasurement\":{\"ancestry\":\"Length\",\"type\":\"UM\"},\"type\":\"USO\"}"`|string|
|
|
|
|
|
|
|
|
|
<a name="converttrajectoryresponse"></a>
|
|
|
### ConvertTrajectoryResponse
|
|
|
Trajectory response data structure; contains the context (crs, units).
|
|
|
|
|
|
|
|
|
|Name|Description|Schema|
|
|
|
|---|---|---|
|
|
|
|**localCRS** <br>*required*|Coordinate Reference System for the local, True North oriented, true distance, engineering CRS with origin at the well's surface location. <br>**Example** : `"{\"lateBoundCRS\":{\"wkt\":\"PROJCS[\\\"Trinidad_1903_Trinidad_Grid\\\",GEOGCS[\\\"GCS_Trinidad_1903\\\",DATUM[\\\"D_Trinidad_1903\\\",SPHEROID[\\\"Clarke_1858\\\",6378293.64520876,294.260676369]],PRIMEM[\\\"Greenwich\\\",0.0],UNIT[\\\"Degree\\\",0.0174532925199433]],PROJECTION[\\\"Cassini\\\"],PARAMETER[\\\"False_Easting\\\",430000.0],PARAMETER[\\\"False_Northing\\\",325000.0],PARAMETER[\\\"Central_Meridian\\\",-61.3333333333333],PARAMETER[\\\"Scale_Factor\\\",1.0],PARAMETER[\\\"Latitude_Of_Origin\\\",10.4416666666667],UNIT[\\\"Link_Clarke\\\",0.201166195164],AUTHORITY[\\\"EPSG\\\",30200]]\",\"ver\":\"PE_10_3_1\",\"name\":\"Trinidad_1903_Trinidad_Grid\",\"authCode\":{\"auth\":\"EPSG\",\"code\":\"30200\"},\"type\":\"LBC\"},\"singleCT\":{\"wkt\":\"GEOGTRAN[\\\"Trinidad_1903_To_WGS_1984_2\\\",GEOGCS[\\\"GCS_Trinidad_1903\\\",DATUM[\\\"D_Trinidad_1903\\\",SPHEROID[\\\"Clarke_1858\\\",6378293.64520876,294.260676369]],PRIMEM[\\\"Greenwich\\\",0.0],UNIT[\\\"Degree\\\",0.0174532925199433]],GEOGCS[\\\"GCS_WGS_1984\\\",DATUM[\\\"D_WGS_1984\\\",SPHEROID[\\\"WGS_1984\\\",6378137.0,298.257223563]],PRIMEM[\\\"Greenwich\\\",0.0],UNIT[\\\"Degree\\\",0.0174532925199433]],METHOD[\\\"Geocentric_Translation\\\"],PARAMETER[\\\"X_Axis_Translation\\\",-61.0],PARAMETER[\\\"Y_Axis_Translation\\\",285.2],PARAMETER[\\\"Z_Axis_Translation\\\",471.6],AUTHORITY[\\\"EPSG\\\",10085]]\",\"ver\":\"PE_10_3_1\",\"name\":\"Trinidad_1903_To_WGS_1984_2\",\"authCode\":{\"auth\":\"EPSG\",\"code\":\"10085\"},\"type\":\"ST\"},\"ver\":\"PE_10_3_1\",\"name\":\"Trinidad 1903 * EOG-Tto Trin / Trinidad Grid [30200,10085]\",\"authCode\":{\"auth\":\"SLB\",\"code\":\"30200002\"},\"type\":\"EBC\"}"`|string|
|
|
|
|**method** <br>*required*|The computation method used - 'AzimuthalEquidistant' (default) or 'LMP' (Lee's modified proposal SPE96813). <br>**Example** : `"AzimuthalEquidistant"`|string|
|
|
|
|**stations** <br>*required*|Computed trajectory stations.|< [TrajectoryStationOut](#trajectorystationout) > array|
|
|
|
|**trajectoryCRS** <br>*required*|Coordinate reference system for the reference point; typically the CRS is a projected CRS; if a geographic CRS is provided, the unitXY must be defined and the azimuthReference must be TrueNorth. <br>**Example** : `"{\"lateBoundCRS\":{\"wkt\":\"PROJCS[\\\"Trinidad_1903_Trinidad_Grid\\\",GEOGCS[\\\"GCS_Trinidad_1903\\\",DATUM[\\\"D_Trinidad_1903\\\",SPHEROID[\\\"Clarke_1858\\\",6378293.64520876,294.260676369]],PRIMEM[\\\"Greenwich\\\",0.0],UNIT[\\\"Degree\\\",0.0174532925199433]],PROJECTION[\\\"Cassini\\\"],PARAMETER[\\\"False_Easting\\\",430000.0],PARAMETER[\\\"False_Northing\\\",325000.0],PARAMETER[\\\"Central_Meridian\\\",-61.3333333333333],PARAMETER[\\\"Scale_Factor\\\",1.0],PARAMETER[\\\"Latitude_Of_Origin\\\",10.4416666666667],UNIT[\\\"Link_Clarke\\\",0.201166195164],AUTHORITY[\\\"EPSG\\\",30200]]\",\"ver\":\"PE_10_3_1\",\"name\":\"Trinidad_1903_Trinidad_Grid\",\"authCode\":{\"auth\":\"EPSG\",\"code\":\"30200\"},\"type\":\"LBC\"},\"singleCT\":{\"wkt\":\"GEOGTRAN[\\\"Trinidad_1903_To_WGS_1984_2\\\",GEOGCS[\\\"GCS_Trinidad_1903\\\",DATUM[\\\"D_Trinidad_1903\\\",SPHEROID[\\\"Clarke_1858\\\",6378293.64520876,294.260676369]],PRIMEM[\\\"Greenwich\\\",0.0],UNIT[\\\"Degree\\\",0.0174532925199433]],GEOGCS[\\\"GCS_WGS_1984\\\",DATUM[\\\"D_WGS_1984\\\",SPHEROID[\\\"WGS_1984\\\",6378137.0,298.257223563]],PRIMEM[\\\"Greenwich\\\",0.0],UNIT[\\\"Degree\\\",0.0174532925199433]],METHOD[\\\"Geocentric_Translation\\\"],PARAMETER[\\\"X_Axis_Translation\\\",-61.0],PARAMETER[\\\"Y_Axis_Translation\\\",285.2],PARAMETER[\\\"Z_Axis_Translation\\\",471.6],AUTHORITY[\\\"EPSG\\\",10085]]\",\"ver\":\"PE_10_3_1\",\"name\":\"Trinidad_1903_To_WGS_1984_2\",\"authCode\":{\"auth\":\"EPSG\",\"code\":\"10085\"},\"type\":\"ST\"},\"ver\":\"PE_10_3_1\",\"name\":\"Trinidad 1903 * EOG-Tto Trin / Trinidad Grid [30200,10085]\",\"authCode\":{\"auth\":\"SLB\",\"code\":\"30200002\"},\"type\":\"EBC\"}"`|string|
|
|
|
|**unitDls** <br>*required*|The unit of the dog leg severity (DLS) in the output trajectory stations. <br>**Example** : `"{\"scaleOffset\":{\"scale\":5.72614583987641E-4,\"offset\":0.0},\"symbol\":\"deg/100ft\",\"baseMeasurement\":{\"ancestry\":\"Rotation_Per_Length\",\"type\":\"UM\"},\"type\":\"USO\"}"`|string|
|
|
|
|**unitXY** <br>*optional*|The horizontal unit of the dx, dy in the output trajectory stations. <br>**Example** : `"{\"scaleOffset\":{\"scale\":1.0,\"offset\":0.0},\"symbol\":\"m\",\"baseMeasurement\":{\"ancestry\":\"Length\",\"type\":\"UM\"},\"type\":\"USO\"}"`|string|
|
|
|
|**unitZ** <br>*required*|The vertical unit of the dz in the output trajectory stations. <br>**Example** : `"{\"scaleOffset\":{\"scale\":1.0,\"offset\":0.0},\"symbol\":\"m\",\"baseMeasurement\":{\"ancestry\":\"Length\",\"type\":\"UM\"},\"type\":\"USO\"}"`|string|
|
|
|
|
|
|
|
|
|
<a name="errorresponse"></a>
|
|
|
### ErrorResponse
|
|
|
Response resulting of a failed CRS convertion operation
|
|
|
|
|
|
|
|
|
|Name|Description|Schema|
|
|
|
|---|---|---|
|
|
|
|**error** <br>*optional*|Error message|string|
|
|
|
|
|
|
|
|
|
<a name="point"></a>
|
|
|
### Point
|
|
|
Point representation for CRS operations
|
|
|
|
|
|
|
|
|
|Name|Description|Schema|
|
|
|
|---|---|---|
|
|
|
|**x** <br>*required*|x coordinate or longitude <br>**Example** : `-61.04340628871454`|number (double)|
|
|
|
|**y** <br>*required*|y coordinate or latitude <br>**Example** : `10.673103179456877`|number (double)|
|
|
|
|**z** <br>*required*|z coordinate <br>**Example** : `0.0`|number (double)|
|
|
|
|
|
|
|
|
|
<a name="trajectorystationin"></a>
|
|
|
### TrajectoryStationIn
|
|
|
Input trajectory station record; context is provided by the container.
|
|
|
|
|
|
|
|
|
|Name|Description|Schema|
|
|
|
|---|---|---|
|
|
|
|**azimuth** <br>*required*|Azimuth angle in degrees of arc, 0.0/360.0 is North; reference given by azimuthReference (TrueNorth or GridNorth). <br>**Example** : `355.0`|number (double)|
|
|
|
|**dx** <br>*optional*|E-W deviation in the local Cartesian engineering CRS from the well reference point; unit is given by container's 'unitXY' or projected 'trajectoryCRS'. <br>**Example** : `55.9`|number (double)|
|
|
|
|**dy** <br>*optional*|N-S deviation in the local Cartesian engineering CRS from the well reference point; Y is aligned with azimuth reference (TrueNorth or projected GridNorth); unit is given by container's 'unitXY' or projected 'trajectoryCRS'. <br>**Example** : `-145.3`|number (double)|
|
|
|
|**dz** <br>*optional*|True vertical deviation in the local Cartesian engineering CRS from the well reference point; unit is given by container's unitZ; downwards positive. <br>**Example** : `1965.6`|number (double)|
|
|
|
|**inclination** <br>*required*|Inclination angle in degrees of arc, 0.0 is vertical, 90.0 is horizontal. <br>**Example** : `15.0`|number (double)|
|
|
|
|**md** <br>*required*|MD (measured depth) from vertical reference point in 'unitZ'. <br>**Example** : `2563.56`|number (double)|
|
|
|
|
|
|
|
|
|
<a name="trajectorystationout"></a>
|
|
|
### TrajectoryStationOut
|
|
|
Output trajectory station record; context is provided by the container.
|
|
|
|
|
|
|
|
|
|Name|Description|Schema|
|
|
|
|---|---|---|
|
|
|
|**azimuthGN** <br>*required*|Grid North azimuth angle in degrees of arc, 0.0/360.0 is North. <br>**Example** : `355.0`|number (double)|
|
|
|
|**azimuthTN** <br>*required*|True North azimuth angle in degrees of arc, 0.0/360.0 is North. <br>**Example** : `355.96`|number (double)|
|
|
|
|**dls** <br>*optional*|Curvature, Dog Leg Severity, measured in 'unitDls'.|number (double)|
|
|
|
|**dxTN** <br>*required*|True E-W deviation in the local Cartesian engineering CRS from the well reference point; unit is given by container's 'unitXY'. <br>**Example** : `55.9`|number (double)|
|
|
|
|**dyTN** <br>*required*|True N-S deviation in the local Cartesian engineering CRS from the well reference point; Y is aligned with TrueNorth; unit is given by container's 'unitXY'. <br>**Example** : `-145.3`|number (double)|
|
|
|
|**dz** <br>*optional*||number (double)|
|
|
|
|**inclination** <br>*required*|Inclination angle in degrees of arc, 0.0 is vertical, 90.0 is horizontal. <br>**Example** : `15.0`|number (double)|
|
|
|
|**md** <br>*required*|MD (measured depth) from vertical reference point in 'unitZ'. <br>**Example** : `2563.56`|number (double)|
|
|
|
|**original** <br>*optional*|Original trajectory station if true, interpolated trajectory station if false.|boolean|
|
|
|
|**point** <br>*required*|Trajectory station point in trajectoryCRS and vertical unit as defined in container's 'unitZ'.|[Point](#point)|
|
|
|
|**wgs84Latitude** <br>*optional*|WGS 84 latitude in dega|number (double)|
|
|
|
|**wgs84Longitude** <br>*optional*|WGS 84 longitude in dega|number (double)|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<a name="securityscheme"></a>
|
|
|
## Security
|
|
|
|
|
|
<a name="bearer"></a>
|
|
|
### bearer
|
|
|
*Type* : apiKey
|
|
|
*Name* : Authorization
|
|
|
*In* : HEADER
|
|
|
|
|
|
|
|
|
<a name="appkey"></a>
|
|
|
### appkey
|
|
|
*Type* : apiKey
|
|
|
*Name* : appkey
|
|
|
*In* : HEADER
|
|
|
|
|
|
|
|
|
|