This endpoint is in preview and may be modified or removed at any time.
To use this endpoint, add preview=true
to the request query parameters.
Writes Observations directly to Geotime. Returns the Observations that could not be written to Geotime with the reason for why they could not be written. Any Observations not in the response are guaranteed to have been written successfully to Geotime's backing data store.
boolean
Represents a boolean value that restricts an endpoint to preview mode when set to true.
list<Observation>
The list of Observations to write to Geotime.
object
A geotemporal object along a Geotime Track (SSID, CID, SpecID, TrackID quadruplet).
list<InvalidObservation>
Response with information about any Observations that failed to be written.
object
1
2
3
4
5
curl -X POST \
-H "Content-type: application/json" \
-H "Authorization: Bearer $TOKEN" \
"https://$HOSTNAME/api/gotham/v1/observations?preview=true" \
-d '[{"sourceSystemId":"foo","collectionId":"bar","observationSpecId":"baz","trackId":"track0","position":{"longitude":-122.16219,"latitude":37.44274},"timestamp":"2023-01-01T22:00:00Z","name":"name0","staticProperties":[],"liveProperties":[]},{"sourceSystemId":"foo","collectionId":"bar","observationSpecId":"baz","trackId":"track1","position":{"longitude":-122.16165,"latitude":37.44215},"timestamp":"fakeInvalidTimestamp","name":"name1","staticProperties":[],"liveProperties":[]}]'
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
[
{
"observation": {
"sourceSystemId": "foo",
"collectionId": "bar",
"observationSpecId": "baz",
"trackId": "track1",
"position": {
"longitude": -122.16165,
"latitude": 37.44215
},
"timestamp": "fakeInvalidTimestamp",
"name": "name1",
"staticProperties": [],
"liveProperties": [],
"style": {}
},
"reason": "Invalid timestamp."
}
]