Singular responses are a single item, like Crime #123 or User #567.
Collection responses are a set of multiple items. These responses have two guaranteed attributes:
meta attribute is an object that contains metadata about the results data. This can include pagination information, api limits, query information, data types, display hints, and other useful information about the data. This object will always contain
total counts to help with pagination.
results attribute is an array of objects representing the data you requested from the API.
Reminder: GeoJSON positions are
[ longitude, latitude, elevation ] (you can learn more about that here).
All timestamps are represented as ISO-8601 strings.
The ISO-8601 format is
September 14th, 2016 at 6:05:30PM is represented as
All measurements are stored using the metric system for maximum accuracy and accessibility. If your data source is using non-metric measurements you'll need to convert it to metric.
Empty fields are included as
null instead of being omitted from the response. While this may increase bandwidth slightly, it provides more context and information about the data available.