# Reports

Reports service is a tool to collect and analyze historical data of all the assets of the project. In the report context an asset is a device. The reports are calculated based on event data generated by dwelling, detention or utilization rules.

Reports are created and managed via the reports endpoint.

The following sections contain some sample problem statements that can be addressed by a report creation, along with the combinations of parameters required for each report generation.

## Dwelling reports

An asset is dwelling when it has stayed inside a geofence for longer than the allowed period of time defined by the user.

• How much was an asset dwelling during each week and how does this compare to the assets' average dwelling?
• measure=duration, interval=week, trackingId
• measure=duration, interval=week, groupBy=asset, method=average
• Which assets were dwelling the most and the least?
• measure=duration, groupBy=asset
• measure=duration, groupBy=asset, sort=value:asc
• Inside which geofences did the assets dwell the most and the least?
• measure=duration, groupBy=geofence
• measure=duration, groupBy=geofence, sort=value:asc
• How does the assets' dwelling time in a specific geofence compare with the dwelling time in other geofences on weekly basis?
• measure=duration, interval=week, groupBy=asset, method=cumulative, geofenceId
• measure=duration, interval=week, groupBy=geofence, method=average
• How many assets were dwelling each day?
• measure=asset, interval=day

## Detention reports

An asset is in detention when it has stayed still for longer than the allowed period of time defined by the user. Such an asset might, for example, be lost or waiting for transportation for too long.

• Which assets were timewise in detention the most?
• measure=duration, groupBy=asset
• How many assets were in detention during each day?
• measure=asset, interval=day
• How many times an asset was in detention during each month? For how long?
• measure=occurrence, interval=month, trackingId
• measure=duration, interval=month, trackingId
• How many times assets were in detention during each month on average?
• measure=occurrence, interval=month, groupBy=asset, method=average
• How much time did all the assets of the project spend in detention during each day?
• measure=duration, interval=day, groupBy=asset, method=cumulative

## Utilization reports

An asset is utilized when it is moving or when it has been continuously stationary for no longer than the allowed period of time defined by the user.

• What percentage of all the assets was utilized during each day?
• measure=asset, interval=day, method=percentage
• What was the average utilization time of an asset during each week?
• measure=duration, interval=week, groupBy=asset, method=average
• Which assets were utilized timewise the most and the least?
• measure=occurrence, groupBy=asset
• measure=occurrence, groupBy=asset, sort=value:asc
• How many utilization days did the assets have during each week on average?
• measure=day, interval=week, groupBy=asset, method=average