GPS Simulator API

Utilisation de l'API

Envoyez une requête POST à /transferts pour démarrer une simulation GPS.

Exemple de requête

POST /transferts
Content-Type: application/json

{
    "mobileId": "vehicule-42",
	"polyline": "_p~iF~ps|U_ulLnnqC_mqNvxq`@",
	"vitesseMoyenne": 50,
	"probabiliteArret": 0.2,
	"tempsTotalArret": 3600,
    "reRouteStrategy": "random"
}

Champs acceptés

Champ	Type	Obligatoire	Description
mobileId	string	Oui	Identifiant unique pour le mobile simulé.
polyline	string ou array de {lat, lng}	Oui	Polyline encodé du trajet (format Google Maps) ou un tableau de points.
vitesseMoyenne	number	Oui	Vitesse moyenne en km/h.
probabiliteArret	number	Oui	Probabilité qu'un arrêt survienne (0-1).
tempsTotalArret	number	Oui	Durée totale des arrêts en secondes sur l'ensemble du trajet.
reRouteStrategy	string	Non (défaut: 'random')	Stratégie de reroutage ('start', 'middle', 'end', 'random').

Réponse (démarrage)

{
  "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
  "dureeInitiale": 3600,
  "mobileId": "vehicule-42"
}

Endpoints de Suivi et Annulation

Pour suivre le statut d'un transfert : GET /transferts/:id

Pour annuler un transfert : DELETE /transferts/:id

Exemple de réponse GET /transferts/:id

{
  "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
  "mobileId": "vehicule-42",
  "currentPosition": { "lat": -4.000038, "lng": 15.000013 },
  "currentSpeed": 50,
  "elapsedTime": 300,
  "estimatedRemainingTime": 3300,
  "initialDuration": 3600,
  "isStopped": false,
  "stopDurationLeft": 0,
  "reRouteStrategy": "random",
  "hasReRouted": true
}

Utilisation de l'API

Exemple de requête

Champs acceptés

Réponse (démarrage)

Endpoints de Suivi et Annulation

Exemple de réponse GET /transferts/:id

Utilisation de l'interface Web