Guias

Localização e segurança

Onde o usuário está decide quais lugares voltam. Envie a localização de forma explícita, mantenha-a fora de URLs e nunca deixe um palpite escolher um pronto-socorro.

Envie uma localização

Envie a localização do usuário no header X-Waity-Location: lat,lng: assim ela fica fora de URLs e logs. near também funciona, assim como uma cidade ou ZIP em q.

curl "https://api.waity.ai/v1/places?category=border&view=minimal" \
  -H "X-Waity-Location: 31.759,-106.487"

Se você não sabe onde o usuário está

Pergunte a cidade ou o ZIP, ou lat e lng, antes de chamar.

Quando o Waity adivinha

Só no REST GET /v1/places com uma pergunta do tipo “perto de mim” e sem localização, a partir de uma rede de banda larga residencial, com um navegador ou um cliente do tipo curl. Nunca no MCP, no get_wait, em redes de nuvem ou datacenter, VPNs, redes móveis, scripts em uma página web ou agentes de IA. A resposta então diz query.resolved.source: "ip".

Desativar o palpite

Envie X-Waity-Location: none e o Waity nunca adivinha; a requisição é tratada como sem localização.

curl "https://api.waity.ai/v1/places?q=ER+near+me&view=minimal" \
  -H "X-Waity-Location: none"

Respostas de pronto-socorro

• Quando a localização foi estimada, warnings[1] avisa: peça a localização real antes de escolher um pronto-socorro.
• O Waity acompanha só alguns prontos-socorros e unidades de pronto atendimento, então essas listas têm cobertura parcial: nunca diga que os resultados são os mais próximos.

Regras de segurança

• Pronto atendimento é só para doenças ou ferimentos leves, nunca para uma emergência.
• As esperas de fronteira são só para entrar nos EUA; o Waity não tem nenhuma para sair.
• Regras do lugar, como os portões que um posto de controle atende ou o que um número do DMV conta, vêm nas notes de cada resposta: repita-as.