The "seismicfindclosesttrace" web service provides an information about the trace closest to the specified position within a distance.

A typical URL is http://myserver.mycompany.com:8080/INTGeoServer/api/ds/{datasourcetype}/v1/sources/{datasource}/seismic/{seismicuniqueid}/tracenumber

where

datasourcetype: type of a datasource, i.e. geofiles, s3, etc.

datasource: unique id of a datasource

seismicuniqueid: unique id of a seismic

The following parameters are available:

xposition: specifies X position being queried. This is a required parameter.

yposition: specifies Y position being queried. This is a required parameter.

maxdistance: Maximum distance around the specified position. This is a required parameter.

positioncrsuniqueid: specifies an unique id of a coordinate reference system for the specified position. This is an optional parameter.

Here is an example response. This response has been formatted to improve readability.

{

"from":{

"actor":"akka://DefaultActorSystemControllerActorSystem:FindClosestTraceJsonActor:FindClosestTraceEntitlementCheckResponse for FindClosestTraceEntitlementCheckRequest of FindClosestTraceRequest:FindClosestTraceRequest{klass=AbstractSeismicGeometryFinder, sourceName=0e704862-738a-4b07-9aba-09922ff13d94, uniqueId=b2dhL01OU0gvRklOQUxfUFNUTV9GVUxML1dHMTUyRDAwMDItMDAwMDFDOTA0LVBTVE1fRklOQUxfRklMVEVSRUQtRlVMTF9TVEstMjQ5Nzc1MzkxLnhneQ==, sourceType=geofiles, xPosition=188249.85073321272, yPosition=6217831.810537169, precision=10.0, toCrsUniqueId=null}"

},

"data":{

"content":{

"traceNumber":1

}

}

}

The traceNumber entry denotes the number of the found trace.

If the specified seismicuniqueid doesn't match a valid seismic dataset, no JSON response will be provided. The HTTP response will only show a "InvalidUniqueId" (error 404) in its headers.