Funktionen

Stattdessen

Ist die Wartezeit an einem Ort lang, bietet Waity Orte derselben Art in der Nähe mit einer kürzeren an und sagt, wie viel kürzer und wie viel weiter weg.

Was es ist

Die Antwort für einen Ort, GET /v1/places/{id} oder das Tool get_wait, enthält instead: bis zu drei Alternativen, die beste zuerst, jede in derselben Form wie jeder Ort. Ein Agent kann „die Brücke hat 55 Min., Ysleta 7“ sagen, ohne ein zweites Mal zu suchen.

Alternativen abfragen

instead steht in der vollen Ansicht: Sende view=full an REST oder "view": "full" an get_wait, das standardmäßig die minimale Ansicht nutzt. Beide Ansichten enthalten links.alternatives, einen Listenaufruf für dieselben Orte.

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

Wie es auswählt

• Dieselbe Art von Ort: dieselbe Kategorie im Umkreis von 25 km, dann 40, dann 60. Flughafenspuren werden mit anderen Spuren desselben Flughafens verglichen, eine Grenzspur auch mit demselben Spurtyp an nahen Grenzübergängen.
• Nur nutzbare Live-Wartezeiten: Ein Ort, dessen now.usable false ist oder der innerhalb der nächsten Stunde schließt, fällt weg.
• Kürzer, nie länger: Die Wartezeit einer Alternative ist kürzer als am angefragten Ort, oder genauso kurz und näher.
• Die Fahrt muss sich lohnen: Die gesparten Minuten müssen mehr sein als die zusätzliche Fahrt, geschätzt nach Luftlinie. Alternativen werden nach Fahrt plus Wartezeit sortiert; die Schätzung der Fahrt wird nie zurückgegeben.
• Nach den Alternativen einer Notaufnahme können bis zu zwei Urgent Cares folgen. Sie kommen nie allein, und ihre Wartezeit wird nie mit der der Notaufnahme verglichen.
• Ein geschlossener Ort bekommt Alternativen, die jetzt geöffnet sind und eine Live-Wartezeit haben. Mit date trägt jede Alternative ihre ruhigste Stunde an diesem Tag in best_on_day.

Im Vergleich zum angefragten Ort

Jede Alternative enthält vs_requested:

• wait_diff_min: die Wartezeit am angefragten Ort minus diese. Positiv heißt, diese ist kürzer; null, wenn sich die beiden nicht vergleichen lassen.
• extra_km: wie viel weiter diese entfernt ist, in km Luftlinie.
• note: warum wait_diff_min null ist oder was man über diesen Ort wissen sollte, etwa bei einer eigenständigen Notaufnahme. Gib ihn weiter.

{
  "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,

Was es nie tut

• Bietet jemandem an einem Ort für alle Altersgruppen nie eine Notaufnahme oder Urgent Care nur für Kinder an. Eine Kinder-Notaufnahme bekommt zuerst andere Kinder-Notaufnahmen, dann Notaufnahmen von Krankenhäusern, nie eine eigenständige.
• Bietet nie eine Spur an, die mehr verlangt als die angefragte: kein SENTRI, NEXUS oder Ready Lane für jemanden in einer allgemeinen oder Standardspur, kein SENTRI oder NEXUS für eine Ready Lane und kein PreCheck oder CLEAR an einem Flughafen.
• Vergleicht nie Minuten, die unterschiedlich gemessen werden. Eine Notaufnahme oder Urgent Care wird nur dann als kürzer angeboten, wenn beide Wartezeiten aus derselben Quelle stammen; sonst werden die Minuten nicht verglichen, und vs_requested.note sagt das.
• Verschweigt nie, was eine eigenständige Notaufnahme ist: place.facility: "freestanding_ed" kennzeichnet sie, sie kommt nach den Notaufnahmen von Krankenhäusern, und ihr Hinweis sagt, dass sie keine stationären Betten und keine Operationen hat, sodass ein ernster Fall in ein Krankenhaus verlegt wird.
• Schlägt nie vor, eine Notaufnahme oder Urgent Care zu verlassen, weil ihre Wartezeit unbekannt ist.
• Überschreitet nie eine Grenze, die ein Mensch nicht überschreiten kann: Flughafenterminals, die nach der Sicherheitskontrolle nicht verbunden sind, oder einen Ort, der nur über ein anderes Land erreichbar ist.

Sicherheit bei Notaufnahmen

Jede Notaufnahme-Antwort sagt das in warnings[0] und notes. Lies sie dem Nutzer vor jeder Alternative vor.

Wenn die Liste leer ist

Wenn nichts passt, ist instead eine leere Liste, und diagnostics sagt warum: Nichts ist kürzer, sobald die Fahrt mitzählt, die Wartezeiten in der Nähe stammen aus einer Quelle, die anders misst, oder kein anderer Ort in der Nähe ist einer, den jemand in dieser Schlange nutzen kann.

Siehe auch

Eine Antwort lesen erklärt jedes Feld einer Alternative. Die Parameter stehen in REST-API und MCP, jedes Feld steht in der API-Referenz.