Get the user’s location at a specific point in time.
Returns a locations readings
GET https://api.humanapi.co/v1/human/locations
# Returns a json array of locations:
[{
"id": "54aa4c5623e093b72ba122ec",
"userId": "52e20cb2fff56aac62020001",
"startTime": "2015-03-23T16:48:37.000Z",
"endTime": "2015-03-23T17:15:40.000Z",
"tzOffset": "-07:00",
"name": "",
"source": "moves",
"location": {
"lon": 77.3092283085,
"lat": 28.5941775291
},
"createdAt": "2015-02-06T21:21:13.679Z",
"updatedAt": "2015-02-06T21:21:13.679Z",
"humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}, {
"id": "54c8681d94ae47d0702e8624",
"userId": "52e20cb2aaf56aac62000001",
"startTime": "2015-03-23T02:04:02.000Z",
"endTime": "2015-03-23T03:38:26.000Z",
"tzOffset": "-07:00",
"name": "Walmart",
"source": "moves",
"location": {
"lon": -87.06979948824468,
"lat": 20.63034803007769
},
"createdAt": "2015-01-31T22:32:58.332Z",
"updatedAt": "2015-01-31T22:32:58.332Z",
"humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}]
# Get locations measurement associated with the user
curl -H "Authorization: Bearer demo" "https://api.humanapi.co/v1/human/locations"
Property | Type | Description |
---|---|---|
id | String | The id of the resource. |
userId | String | [deprecated - use humanId] |
humanId | String | Unique user identifier |
startTime | Date | The start time of the activity in UTC time |
endTime | Date | The end time of the activity in UTC time |
tzOffset | String | The offset from UTC time in +/-hh:mm (e.g. -04:00) |
name | String | The name of the place |
source | String | The source service for the measurement, where it was created |
createdAt | Date | The time the measurement was created on the Human API server |
location | Object | The coordinate point with a lat/lon value |
updatedAt | Date | The time the measurement was updated on the Human API server |
Location Object
Property | Type | Description |
---|---|---|
lon | Number | Longitude |
lat | Number | Latitude |