Recursos

Alternativas

Quando a espera de um lugar é longa, o Waity oferece lugares próximos do mesmo tipo com uma espera menor, e diz quanto menor e quanto mais longe.

O que é

A resposta para um lugar, GET /v1/places/{id} ou a ferramenta get_wait, traz instead: até três alternativas, a melhor primeiro, cada uma no mesmo formato de qualquer lugar. Um agente pode dizer “a ponte está com 55 min, Ysleta com 7” sem uma segunda busca.

Pedir alternativas

instead vem na visão completa: envie view=full no REST, ou "view": "full" para get_wait, que usa a mínima por padrão. As duas visões trazem links.alternatives, uma chamada de lista para os mesmos lugares.

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

Como escolhe

• O mesmo tipo de lugar: a mesma categoria em até 25 km, depois 40, depois 60. Faixas de aeroporto são comparadas com outras faixas do mesmo aeroporto; uma faixa de fronteira, também com o mesmo tipo de faixa em portos próximos.
• Só esperas ao vivo utilizáveis: um lugar cujo now.usable é false, ou que fecha dentro de uma hora, fica de fora.
• Mais curta, nunca mais longa: a espera de uma alternativa é menor que a do lugar consultado, ou igual e mais perto.
• Vale o trajeto: os minutos economizados precisam ser mais do que o trajeto extra, por uma estimativa em linha reta. As alternativas são ordenadas por trajeto mais espera; a estimativa do trajeto nunca é retornada.
• Depois das alternativas de um pronto-socorro, podem vir até duas unidades de pronto atendimento. Elas nunca vêm sozinhas, e a espera delas nunca é comparada com a do pronto-socorro.
• Um lugar fechado recebe alternativas abertas agora com espera ao vivo. Com date, cada alternativa traz seu horário mais tranquilo naquele dia em best_on_day.

Em comparação com o lugar consultado

Cada alternativa traz vs_requested:

• wait_diff_min: a espera no lugar consultado menos a desta. Positivo significa que esta é mais curta; null quando as duas não podem ser comparadas.
• extra_km: quanto mais longe esta fica, em km em linha reta.
• note: por que wait_diff_min é null, ou o que saber sobre este lugar, como um pronto-socorro independente. Repita-a.

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

O que nunca faz

• Nunca oferece um pronto-socorro ou pronto atendimento só infantil a quem está em um lugar para todas as idades. Um pronto-socorro infantil recebe primeiro outros prontos-socorros infantis, depois prontos-socorros de hospital, nunca um independente.
• Nunca oferece uma faixa que exige mais do que a consultada: nada de SENTRI, NEXUS ou Ready Lane para quem está em uma faixa geral ou padrão, nada de SENTRI ou NEXUS para uma Ready Lane, e nada de PreCheck ou CLEAR em um aeroporto.
• Nunca compara minutos medidos de formas diferentes. Um pronto-socorro ou pronto atendimento só é oferecido como mais curto quando as duas esperas vêm da mesma fonte; caso contrário, os minutos não são comparados, e vs_requested.note diz isso.
• Nunca esconde o que é um pronto-socorro independente: place.facility: "freestanding_ed" o identifica, ele vem depois dos prontos-socorros de hospital, e sua nota diz que ele não tem leitos de internação nem cirurgia, então um caso grave é transferido para um hospital.
• Nunca sugere sair de um pronto-socorro ou pronto atendimento porque a espera dele é desconhecida.
• Nunca cruza um limite que uma pessoa não pode cruzar: terminais de aeroporto não conectados depois da segurança, ou um lugar acessível só passando por outro país.

Segurança no pronto-socorro

Toda resposta de pronto-socorro diz isso em warnings[0] e notes. Leia-os ao usuário antes de qualquer alternativa.

Quando está vazia

Quando nada se qualifica, instead é uma lista vazia e diagnostics diz por quê: nada é mais curto depois de contar o trajeto, as esperas próximas vêm de uma fonte que mede de outra forma, ou nenhum outro lugar próximo serve para quem está nessa fila.

Relacionado

Como ler uma resposta explica cada campo de uma alternativa. Os parâmetros estão em API REST e MCP, e todos os campos estão na Referência da API.