The service of providing a database of SAMPLE obstacles through REST API. Communication takes place between the client and the SAMPLE production server based on defined protocols, methods and mechanisms that allow the client to retrieve data. 

Communication takes place after client authorization on the SAMPLE server.

It is possible to retrieve data from at least one of the 3 database layers:

  • Bronze (raw data)
  • Silver (unclassified data, above the cut-off line)
  • Gold (classified data, above the cut-off line)

Ability to filter objects by attributes:

  • height range 
  • altitude range 
  • type of object (building, tree) 
  • precision of detected attributes in a given object 
  • the source of the object (satellite images, point cloud, data artifacts) 
  • filtering by 2D area (bounding box) 
  • filtering by a specific report in SAMPLE 
  • filtering by loaded bounding surface into the SAMPLE library

Each object has the following attributes available to the client:

  • SAMPLE ID of the object 
  • 2D centroid 
  • highest 3D point 
  • geometry defined as GeometryCollection 
  • relative altitude 
  • altitude 
  • precision / accuracy 
  • type of object 
  • source of origin 
  • date of creation 

Current version of SAMPLE API documentation: 

https://staging.sample.aero/api/docs/

Current JSON file format: 

https://staging.sample.aero/api/schema/?format=json