Location Update

Use this endpoint to send GPS location updates during a trip.

POST https://api.vectorcare.com/openapi/v1.0/requests/{request_id}/locations/

Note: URLs must include the trailing slash.

Request Body

Send an array of location objects (max 200 per request):

[
  {
    "lat": 37.8577747,
    "lng": -122.49209,
    "alt": 20.23,
    "speed": 10.3,
    "timestamp": 1575497090.131
  }
]

Field	Type	Description
`lat`	number	Latitude
`lng`	number	Longitude
`alt`	number	Altitude in meters
`speed`	number	Speed (optional)
`timestamp`	number	Unix epoch timestamp (seconds, float)

Responses

Success (200 OK)

{}

Missing Fields (400)

[
  {
    "lat": [{"message": "This field is required.", "code": "common:required"}],
    "lng": [{"message": "This field is required.", "code": "common:required"}],
    "alt": [{"message": "This field is required.", "code": "common:required"}],
    "timestamp": [{"message": "This field is required.", "code": "common:required"}]
  }
]

Batching

Send up to 200 locations per request for batch uploads or after connectivity issues.