- URL:
- https://<imageservice-url>/find
- Methods:
GET
- Required Capability:
- Catalog
- Version Introduced:
- 11.2
Description
The find
operation locates all images that contain to
and sort them accordingly. For example, in the image inspection workflow, in most cases, from
is the viewing camera position, and to
is the target point (where user clicked on the map). The images found are sorted in ascending order based on the angle between the vector from viewing camera position to target point, and that from the image camera GPS location to the target point, plus distance between the image center and the target point.
Request parameters
Parameter | Details |
---|---|
| The object ID of the raster item. This ID is obtained using the find operation. It is the "id" value of the find operation. Example
|
| A point geometry that defines the from location. The structure of the geometry is the same as the structure of the JSON geometry objects. The image inspection workflow, the from location is usually the viewing camera location. Example
|
| A point geometry that defines the to location. The structure of the geometry is the same as the structure of the JSON geometry objects. The image inspection workflow, the to location is usually the viewing camera location. Example
|
(optional) | The spatial reference of the |
(optional) | The object IDs of the raster catalog to be queried. Syntax
Example
|
(optional) | A where clause for the query filter. Any legal SQL where clause operating on the fields in the raster catalog is allowed. Example
|
(optional) | Specifies the maximum count of the returned images. |
|
The response format. The default response format is Values: |
Example usage
The following is a sample request URL for the find operation that will find the closet image that can view the specified to
:
https://machine.domain.com/webadaptor/rest/services/BrewertonTank_cloud/ImageServer/find?fromGeometry={"x":495428.9389,"y":3768341.5466,"z":851.3407}&toGeometry={"x":495393.0991,"y":3768363.7228,"z":825.8077}&inSR=&objectIds=&where=&maxCount=1&f=html
JSON Response syntax
{
"images": [
{
"id": <objectId>,
"uri": uri,
"acquisitionDate": <time>, //epoch time in millisecond
"cameraID": <value>,
"center": <centerPoint>
},
"perspectiveCenter": {
"x": <long>, //number
"y": <long>, //number
"z": <long>, //number
},
"orientation": {
"omega": <long>, //number
"phi": <long>, //number
"kappa": <long>, //number
"clockwise": <Boolean>
},
"make": <value>,
"model": <value>,
"focalLength": <long>, //number
"pixelSize": <long>, //number
"rows": <Int>, //number
"cols": <Int> //number
]
}
JSON Response example
{
"images": [
{
"id": 2,
"uri": "/vsis3/ortho-maker/BrewertonTank/BrewertonTank/DJI_0707.JPG",
"acquisitionDate": 1498639972000,
"cameraID": "ae79b3d7b6066db1cb57a9240cad530c_Unknown",
"center": {
"x": 407346.69986255,
"y": 4787426.66231584,
"z": 88.08833,
"spatialReference": {
"wkid": 32618,
"latestWkid": 32618,
"vcsWkid": 115700,
"latestVcsWkid": 115700
}
},
"perspectiveCenter": {
"x": 407306.5742,
"y": 4787327.8029,
"z": 146.1573
},
"orientation": {
"omega": 61.77050665236553,
"phi": -20.728491367643706,
"kappa": -11.411313741503262,
"clockwise": true
},
"make": "DJI",
"model": "FC6310",
"focalLength": 8.8493596,
"pixelSize": 0.0024000000000000002,
"rows": 3078,
"cols": 5472
}
]
}