Fonctionnalités

Ailleurs

Quand l’attente d’un lieu est longue, Waity propose des lieux proches du même type avec une attente plus courte, et dit de combien elle est plus courte et de combien ils sont plus loin.

Ce que c’est

La réponse pour un lieu, GET /v1/places/{id} ou l’outil get_wait, contient instead : jusqu’à trois alternatives, la meilleure d’abord, chacune de même forme que n’importe quel lieu. Un agent peut dire « le pont est à 55 min, Ysleta à 7 » sans seconde recherche.

Demander des alternatives

instead figure dans la vue complète : envoyez view=full à REST, ou "view": "full" à get_wait, qui utilise la vue minimale par défaut. Les deux vues contiennent links.alternatives, un appel de liste pour les mêmes lieux.

curl "https://api.waity.ai/v1/places/pl_6e3znhb7h9?view=full" \
  -H "X-Api-Key: $WAITY_API_KEY"

Comment il choisit

• Le même type de lieu : la même catégorie dans un rayon de 25 km, puis 40, puis 60. Les files d’aéroport sont comparées aux autres files du même aéroport ; une file frontalière aussi au même type de file aux postes-frontières proches.
• Seulement des attentes en direct utilisables : un lieu dont now.usable vaut false, ou qui ferme dans l’heure, est écarté.
• Plus courte, jamais plus longue : l’attente d’une alternative est plus courte que celle du lieu demandé, ou aussi courte et plus proche.
• Le trajet doit en valoir la peine : les minutes gagnées doivent dépasser le trajet supplémentaire, estimé à vol d’oiseau. Les alternatives sont classées par trajet plus attente ; l’estimation du trajet n’est jamais renvoyée.
• Après les alternatives d’un service d’urgences, jusqu’à deux centres de soins urgents peuvent suivre. Ils ne viennent jamais seuls, et leur attente n’est jamais comparée à celle des urgences.
• Un lieu fermé reçoit des alternatives ouvertes maintenant avec une attente en direct. Avec date, chaque alternative indique son heure la plus calme ce jour-là dans best_on_day.

Par rapport au lieu demandé

Chaque alternative contient vs_requested :

• wait_diff_min : l’attente au lieu demandé moins celle-ci. Positif signifie que celle-ci est plus courte ; null quand les deux ne sont pas comparables.
• extra_km : de combien ce lieu est plus loin, en km à vol d’oiseau.
• note : pourquoi wait_diff_min vaut null, ou ce qu’il faut savoir sur ce lieu, comme un service d’urgences autonome. Répétez-la.

{
  "place": {
    "id": "pl_nvk0wkb3ps",
    "name": "Ysleta Passenger Vehicles, Standard",
    "category": "border",
    "parent": {
      "id": "pl_q4znr9abbj",
      "name": "Ysleta-Zaragoza Bridge"
    },
    "open_now": true,
    "opens_at": null,
    "closes_at": null,
    "timezone": "America/Denver",
    "sample": false,
    "facility": null,
    "audience": "all",
    "lane": "standard",
    "url": "https://waity.ai/places/ysleta-passenger-vehicles-standard-kb3ps",
    "api_url": "https://api.waity.ai/v1/places/pl_nvk0wkb3ps"
  },
  "summary": "About 7 min to enter the US, estimated by the border agency, updated 2 min ago.",
  "now": {
    "status": "live",
    "usable": true,

Ce qu’il ne fait jamais

• Ne propose jamais des urgences ou des soins urgents réservés aux enfants à quelqu’un qui se trouve dans un lieu pour tous les âges. Des urgences pédiatriques reçoivent d’abord d’autres urgences pédiatriques, puis des urgences hospitalières, jamais des urgences autonomes.
• Ne propose jamais une file qui exige plus que celle demandée : ni SENTRI, NEXUS ou Ready Lane pour quelqu’un dans une file générale ou standard, ni SENTRI ou NEXUS pour une Ready Lane, ni PreCheck ou CLEAR dans un aéroport.
• Ne compare jamais des minutes mesurées différemment. Des urgences ou des soins urgents ne sont présentés comme plus courts que si les deux attentes viennent de la même source ; sinon les minutes ne sont pas comparées, et vs_requested.note le dit.
• Ne cache jamais ce qu’est un service d’urgences autonome : place.facility: "freestanding_ed" l’identifie, il vient après les urgences hospitalières, et sa note précise qu’il n’a ni lits d’hospitalisation ni chirurgie, donc un cas grave est transféré vers un hôpital.
• Ne suggère jamais de quitter des urgences ou des soins urgents parce que leur attente est inconnue.
• Ne franchit jamais une limite qu’une personne ne peut pas franchir : des terminaux d’aéroport non reliés après le contrôle de sécurité, ou un lieu accessible seulement en passant par un autre pays.

Sécurité aux urgences

Chaque réponse pour les urgences le dit dans warnings[0] et notes. Lisez-les à l’utilisateur avant toute alternative.

Quand la liste est vide

Quand rien ne convient, instead est une liste vide et diagnostics dit pourquoi : rien n’est plus court une fois le trajet compté, les attentes proches viennent d’une source qui mesure différemment, ou aucun autre lieu proche n’est utilisable par quelqu’un dans cette file.

Voir aussi

Lire une réponse explique chaque champ d’une alternative. Les paramètres sont dans API REST et MCP, et chaque champ figure dans la Référence de l’API.