Funciones

Alternativas

Cuando la espera de un lugar es larga, Waity ofrece lugares cercanos del mismo tipo con una más corta, y dice cuánto más corta y cuánto más lejos.

Qué es

La respuesta de un lugar, GET /v1/places/{id} o la herramienta get_wait, lleva instead: hasta tres alternativas, la mejor primero, cada una con la misma forma que cualquier lugar. Un agente puede decir “el puente tiene 55 min, Ysleta 7” sin una segunda búsqueda.

Pedir alternativas

instead está en la vista completa: envía view=full a REST, o "view": "full" a get_wait, que usa la vista mínima por defecto. Ambas vistas llevan links.alternatives, una llamada de lista para los mismos lugares.

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

Cómo elige

• El mismo tipo de lugar: la misma categoría a menos de 25 km, luego 40, luego 60. Los carriles de un aeropuerto se comparan con otros carriles del mismo aeropuerto; un carril fronterizo, también con el mismo tipo de carril en puertos cercanos.
• Solo esperas en vivo utilizables: se deja fuera un lugar cuyo now.usable es false o que cierra en menos de una hora.
• Más corta, nunca más larga: la espera de una alternativa es más corta que la del lugar consultado, o igual de corta y más cerca.
• Que valga el trayecto: los minutos ahorrados deben superar el trayecto extra, estimado en línea recta. Las alternativas se ordenan por trayecto más espera; la estimación del trayecto nunca se devuelve.
• Después de las alternativas de unas urgencias pueden seguir hasta dos centros de atención urgente. Nunca vienen solos, y su espera nunca se compara con la de las urgencias.
• Un lugar cerrado recibe alternativas abiertas ahora con una espera en vivo. Con date, cada alternativa lleva su hora más tranquila de ese día en best_on_day.

Comparado con el lugar consultado

Cada alternativa lleva vs_requested:

• wait_diff_min: la espera del lugar consultado menos la de esta. Positivo significa que esta es más corta; null cuando no se pueden comparar.
• extra_km: cuánto más lejos está esta, en km en línea recta.
• note: por qué wait_diff_min es null, o qué hay que saber de este lugar, como unas urgencias independientes. Repítela.

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

Lo que nunca hace

• Nunca ofrece unas urgencias o un centro de atención urgente solo para niños a alguien que está en un lugar para todas las edades. Unas urgencias pediátricas reciben primero otras urgencias pediátricas, luego urgencias de hospital, nunca unas independientes.
• Nunca ofrece un carril que exija más que el consultado: ni SENTRI, NEXUS ni Ready Lane para alguien en un carril general o estándar, ni SENTRI ni NEXUS para un Ready Lane, ni PreCheck ni CLEAR en un aeropuerto.
• Nunca compara minutos medidos de forma distinta. Unas urgencias o un centro de atención urgente solo se ofrecen como más cortos cuando ambas esperas vienen de la misma fuente; si no, los minutos no se comparan y vs_requested.note lo indica.
• Nunca oculta qué son unas urgencias independientes: place.facility: "freestanding_ed" las identifica, van después de las urgencias de hospital, y su nota dice que no tienen camas de hospitalización ni cirugía, así que un caso grave se traslada a un hospital.
• Nunca sugiere dejar unas urgencias o un centro de atención urgente porque su espera sea desconocida.
• Nunca cruza un límite que una persona no puede cruzar: terminales de aeropuerto no conectadas tras el control de seguridad, o un lugar al que solo se llega a través de otro país.

Seguridad en urgencias

Cada respuesta de urgencias lo dice en warnings[0] y notes. Léeselas al usuario antes de cualquier alternativa.

Cuando está vacía

Cuando nada cumple los requisitos, instead es una lista vacía y diagnostics dice por qué: nada es más corto una vez contado el trayecto, las esperas cercanas vienen de una fuente que mide de otra forma, o ningún otro lugar cercano le sirve a alguien en esta fila.

Ver también

Cómo leer una respuesta explica cada campo de una alternativa. Los parámetros están en API REST y MCP, y cada campo está en la Referencia de la API.