Fonctionnalités
Ensuite
Quand la file devrait passer sous votre seuil, l’heure la plus calme, quand partir et une prévision heure par heure, dès qu’un lieu a assez d’historique pour le dire.
Ce qu’il indique
La réponse pour un lieu, GET /v1/places/{id} ou l’outil get_wait, a toujours un bloc next. La vue minimale garde under, under_status, under_by, best et summary ; la vue complète ajoute la confiance et la prévision horaire.
Demander
under | Le seuil en minutes. Par défaut : 30 pour les urgences, les soins urgents et les files frontalières, 20 pour les DMV, 15 pour les aéroports. |
travel_min | Minutes pour s’y rendre. Ajoute next.leave_by. |
date | Une date locale, d’aujourd’hui à 7 jours à l’avance, pour planifier ce jour-là au lieu des 24 prochaines heures. |
forecast | Avec la vue minimale, ajoute une prévision horaire compacte. |
curl "https://api.waity.ai/v1/places/pl_6e3znhb7h9?under=30&travel_min=20&view=full" \
-H "X-Api-Key: $WAITY_API_KEY"
Réponse
{
"next": {
"for_date": null,
"summary": null,
"based_on": "live",
"under": 30,
"under_status": "expected",
"under_by": "2026-10-30T16:45:00-06:00",
"best": {
"from": "2026-10-31T01:00:00-06:00",
"to": "2026-10-31T02:00:00-06:00",
"value": 6
},
"leave_by": "2026-10-30T16:25:00-06:00",
"confidence": "medium",
"days_of_history": 23,
"forecast": [
{
"at": "2026-10-30T14:00:00-06:00",
"open": true,
"open_minutes": 60,
"value": 48
},
{
Passera-t-elle sous le seuil ?
under_status répond, avec next.under_by quand une baisse est attendue :
already | L’attente en direct est au seuil ou en dessous maintenant. |
usually_under | Pas de mesure en direct, mais à cette heure elle est d’habitude en dessous. |
expected | La prévision passe sous le seuil ; next.under_by dit quand. |
not_expected | La prévision ne passe pas sous le seuil dans la fenêtre. |
not_now | L’attente en direct est au-dessus, et il n’y a pas encore de prévision pour dire quand elle baissera. |
no_data | Ni mesure en direct ni prévision. |
closed_all_day, closed_rest_of_day | Fermé toute la journée, ou pour le reste de la journée. |
not_published | Le lieu ne publie pas son attente. |
Prévision
next.forecast a un créneau par heure pour les 24 prochaines heures, ou pour le jour de date : at, s’il est open et pendant combien de minutes, et value. next.confidence est la plus faible sur les heures d’ouverture, et next.days_of_history compte les jours d’historique derrière elle.
next.based_on vaut live quand la dernière mesure est prise en compte, et usual quand la prévision est le schéma habituel seul.
Meilleur moment
next.best est l’heure la plus calme ouverte au moins 45 minutes, avec son attente prévue. Il vaut null pour les urgences et les soins urgents, car personne ne devrait planifier une urgence, et quand la journée est plate.
Heure de départ
Avec travel_min, next.leave_by vaut maintenant quand la file est déjà (ou d’habitude) courte, sinon l’heure à laquelle partir pour arriver quand elle baisse. Il vaut null quand aucune baisse n’est attendue, ou quand vous arriveriez après la fermeture ; un avertissement le signale.
Planifier une journée
Avec date, jusqu’à 7 jours à l’avance, next couvre ce jour local : next.for_date le nomme, et next.summary donne les horaires et le moment le plus calme, prêt à répéter. Un jour où le lieu est fermé indique closed_all_day.
D’abord assez d’historique
Les valeurs de prévision, next.under_by, next.best et l’attente habituelle n’apparaissent qu’avec une confiance moyenne ou élevée. Il faut pour cela au moins 10 jours d’historique pour l’heure, et des attentes assez stables d’une heure à l’autre. D’ici là, ils valent null, et diagnostics dit pourquoi.
Ainsi, un nouveau lieu le dit au lieu de deviner : dites à l’utilisateur qu’il n’y a pas encore de prévision et citez l’attente en direct. Ne présentez jamais les heures d’ouverture comme le meilleur moment pour y aller.
Voir aussi
Lire une réponse explique chaque champ. Les paramètres sont dans API REST et MCP, et chaque champ figure dans la Référence de l’API.