Query Images by Proximity

GeoCrew

The GeoView Server REST API enables querying imagery recordings by proximity. Spatial query filters feature data store by specified proximity circle, returning any image recordings contained in it. Accessing this method requires Read permissions.


Request API method URI definition:


HTTP GET http://api.geoview.be/geoservice/v1/images/proximity


Request HTTP URI parameters:


Parameter

Description

token

Access token (returned by this API method).

x

X ordinate value (longitude value in WGS84).

y

Y ordinate value (latitude value in WGS84).

dist

Maximum distance from specified coordinate (meters).

srs

Spatial reference system identifier (returned by this API method), being an EPSG code value. This parameter is optional. If omitted, default GeoView Server spatial reference system will be used.

maxcnt

Maximum number of records to return. This parameter is optional. If omitted, returns all records within given scope.


Example HTTP request URI using default GeoView Server coordinate system:


HTTP GET http://api.geoview.be/geoservice/v1/images/proximity?x=107275.3792&y=195092.7299&dist=100&token=3dc718f2-ab20-4f41-86e1-72abcc1810c1


Example HTTP request URI using WGS84 coordinate system:


HTTP GET http://api.geoview.be/geoservice/v1/images/proximity?x=3.75926412683421&y=51.0644027174778&dist=100&token=3dc718f2-ab20-4f41-86e1-72abcc1810c1


Example HTTP request URI using default GeoView Server coordinate system and expecting KML file as result:


HTTP GET http://api.geoview.be/geoservice/v1/images/proximity/kml?x=107275.3792&y=195092.7299&dist=100&token=3dc718f2-ab20-4f41-86e1-72abcc1810c1


Possible resulting HTTP status codes:


Value

Description

200

API request succeeded and result(s) were returned.

204

API request succeeded but query didn't produce any results.

400

API request failed due to wrong parameter value(s).

401

Supplied API request access token not valid.


Response JSON structure for a single recording (please note that API method may return array of recordings):


Field

Description

id

Image unique identifier.

x

X-ordinate value of recording in specified SRS (longitude value in WGS84).

y

Y-ordinate value of recording in specified SRS (latitude value in WGS84).


Example JSON response using default GeoView Server coordinate system:


[

  {

     "id":"d0efae97-51ea-4942-861f-db2dc029da84",

     "x":107713.59649534024,

     "y":196639.8938722061

  },

  {

  ...

  }

]


Example JSON response using WGS84 coordinate system:


[

  {

     "id":"d0efae97-51ea-4942-861f-db2dc029da84",

     "x":3.7653361063984652,

     "y":51.078341671672753

  },

  {

  ...

  }

]


Circular range defined by X,Y coordinates and specified distance, and resulting selected features (red)