Operations and response
The Cyclorama Rendering API is a REST service that uses basic authentication. The following operations are possible:
Render
Renders an image based on the ID of a recording.
RenderByLocation2D
Renders an image based on the recording nearest to a given 2D location.
RenderByLocation3D
Renders an image based on the recording nearest to a given 3D location.
RenderByAddress
Renders an image based on the recording nearest to a specified address.
RenderSurface
Returns an image of a flat surface as defined by a set of four coordinates. This is typically used for creating surfaces on 3D models.
ListByAddress
Lists the recordings nearest to a given address location, includes historical recordings.
ListByLocation2D
Lists the recordings nearest to a given 2D location, includes historical recordings.
ListByCoordinates
Lists the recordings nearest to a given list of coordinates, includes historical recordings.
Response format
The response of all methods is a JPG image for the runtime rendered image, if not specified otherwise. Metadata is returned in HTTP response headers, for example:
Recording-Id: 5D0G4E8O
Recording-Date: 2011-09-15T12:48:07.5900000+02:00
Render-Width: 1024
Render-Height: 786
Render-FocalLength: 512.000
Render-HFov: 90.000
Render-VFov: 75.018
Render-Yaw: 0.000
Render-Pitch: 0.000
Render-Roll: 0.000
RecordingLocation-SrsBase: EPSG:4258
RecordingLocation-Longitude: 5.089819277
RecordingLocation-LongitudePrecision: 0.008
RecordingLocation-Latitude: 52.109259974
RecordingLocation-LatitudePrecision: 0.004
RecordingLocation-Height: 46.918
RecordingLocation-HeightPrecision: 0.009
RecordingLocation-GroundLevelOffset: 2.01
RecordingLocation-YawPrecision: 0.0075