Linha de visada no terreno
Verifique se uma linha de visada reta passa livre sobre o terreno entre observador e alvo: no perfil 100, 105, 120, 110 e 95 m com o olho a 1,7 m, o raio fica bloqueado e passa 21,65 m abaixo da crista de 120 m. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Roda direto no seu navegador. Grátis, sem cadastro — seus dados não são enviados para lugar nenhum.
A linha de visada sobre o terreno é a pergunta geométrica por trás de enlaces de rádio, estandes de tiro, câmeras de trilha, rotas de drones e verificações simples de visibilidade quando você já possui um perfil de alturas ao longo de um caminho. Esta calculadora de linha de visada recebe uma série ordenada de cotas do solo do observador ao alvo, mais a altura do olho ou da antena acima da primeira amostra e a do objeto acima da última, e informa se o raio reto supera cada amostra intermediária. O modelo é de Terra plana com espaçamento horizontal igual entre os pontos do perfil — rápido, determinístico e fácil de integrar em scripts que já extraiam elevações de um DEM ou de um levantamento. Quando o raio desce abaixo do solo em qualquer amostra, a resposta marca o caminho bloqueado e nomeia o primeiro índice bloqueante.
Como funciona o modelo de linha de visada sobre o terreno
Imagine percorrer um traçado reto no solo de um observador até um alvo amostrando a elevação em passos horizontais regulares. A primeira amostra é o solo sob o observador; a última, o solo sob o alvo; todo valor intermediário é terreno interveniente. Em um croqui de Terra plana, o raio livre é a reta que une esses dois pontos elevados.
No índice de amostra i de n amostras totais, a distância fracionária ao longo do caminho é t igual a i dividido por n menos um. A altura geométrica da linha de visada nessa fração é eye0 mais t vezes (eye1 menos eye0), onde eye0 e eye1 são as extremidades elevadas. A folga na amostra i é essa altura geométrica menos a elevação do terreno em i.
Se toda folga for maior ou igual a zero, o caminho está livre — inclusive o contato de rasante que apenas toca um espinhaço. Se alguma folga for estritamente negativa, o raio fica bloqueado pelo solo naquela amostra. Curvatura da Terra, refração e vegetação ficam deliberadamente fora do escopo: forneça um perfil que já inclua essas correções se o seu padrão de engenharia as exigir, ou use esta ferramenta como núcleo geométrico puro de um pipeline maior.
Quem usa a verificação de linha de visada
Cadernos de topografia e GIS frequentemente já contêm uma lista de amostras DEM ao longo de um salto de micro-ondas planejado, um azimute de câmera de trilha ou um mirante de trilha; esta calculadora responde a pergunta binária livre ou bloqueado sem montar uma pilha completa de viewshed. Planejadores de rádio podem processar em lote milhares de caminhos candidatos em edge workers porque o algoritmo é aritmética pura sem rede de saída.
Ferramentas de jogo e simulação que armazenam mapas de altura podem exportar um corte 1-D e reutilizar o mesmo contrato para checagens de visibilidade de IA. Validação falha não consome saldo. Mantenha perfis abaixo de cinco mil amostras, fixe folgas arredondadas nos testes e obtenha decisões de LOS reproduzíveis para kits de campo, demos LMS e pipelines de produção sem um servidor GIS próprio.
Casos de uso
Verificações de caminhos de rádio e micro-ondas
Forneça amostras DEM ao longo de um salto mais alturas de antena para ver se o raio geométrico supera o terreno intermediário antes de um orçamento de enlace completo.
Posicionamento de estande, trilha e câmera
Teste se um espinhaço bloqueia a linha de um observador em pé ou com bipé até um alvo, bandeira ou sujeito de câmera de trilha com um perfil de elevação curto.
Cortes de visibilidade em simulação e jogos
Exporte um corte 1-D do mapa de altura entre duas entidades e reutilize o contrato livre/bloqueado para testes determinísticos de linha de visada de IA.
Perguntas frequentes
Quais unidades devo usar para o perfil e as alturas?
Metros em todo campo de elevação e altura. Mantenha o perfil e as alturas no mesmo sistema de unidades; a matemática é coerente desde que você não misture pés e metros.
A ferramenta considera curvatura da Terra ou refração?
Não. O modelo é geometria de Terra plana sobre o perfil que você fornece.
E se o meu perfil tiver apenas dois pontos?
É válido: a folga é verificada apenas nas extremidades (olho do observador e ponta do alvo acima de seus solos). Com alturas não negativas o caminho está sempre livre para duas amostras; terreno interveniente exige amostras do meio.
O que indica a folga mínima?
É a menor distância entre a linha de visada e o solo ao longo do perfil, junto com a amostra onde ela ocorre. Um valor negativo significa que o terreno fica acima do raio: no exemplo é −21,65 m na crista de 120 m, então você vê quanto faltou.
Um raio que apenas raspa uma crista conta como livre?
Sim. A visada é livre quando o raio fica na altura de cada amostra ou acima dela, então tocar exatamente uma crista ainda conta como livre. Só há bloqueio quando o terreno sobe estritamente acima do raio em algum ponto.
Ferramentas relacionadas
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/geo/line-of-sight \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"profile":[100,105,120,110,95],"observer_height":1.7,"target_height":0}'const res = await fetch("https://api.kit.forhosting.com/geo/line-of-sight", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"profile": [
100,
105,
120,
110,
95
],
"observer_height": 1.7,
"target_height": 0
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geo/line-of-sight",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"profile": [
100,
105,
120,
110,
95
],
"observer_height": 1.7,
"target_height": 0
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/line-of-sight", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"profile":[100,105,120,110,95],"observer_height":1.7,"target_height":0}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"profile":[100,105,120,110,95],"observer_height":1.7,"target_height":0}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/line-of-sight", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"profile": [
100,
105,
120,
110,
95
],
"observer_height": 1.7,
"target_height": 0
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.line_of_sight",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
Notas técnicas
Como funciona o modelo de linha de visada sobre o terreno
O olho do observador (ou o ponto de alimentação da antena) fica observer_height metros acima da primeira amostra, e a ponta do alvo, target_height metros acima da última. Este endpoint devolve a folga mínima global e seu índice para que você veja quão perto esteve um quase-erro e, em um caminho bloqueado, também o primeiro índice bloqueante com as elevações do terreno e da linha de visada ali. O distance_m opcional dimensiona o relatório para que o espaçamento entre amostras apareça em metros; não altera a decisão de livre ou bloqueado, porque o espaçamento igual já é assumido nas frações de índice.
Contrato de entrada, campos de resposta e validação
Exemplo: perfil cem, cento e cinco, cento e vinte, cento e dez, noventa e cinco com altura do observador um ponto sete metros, altura do alvo zero e distância mil metros reportará bloqueado se o espinhaço a cento e vinte metros perfurar o raio, ou livre se as alturas elevarem o raio acima de cada pico. Envie um corpo JSON com profile, um array de pelo menos dois números finitos com elevações do terreno em metros do solo do observador ao do alvo; observer_height, um número finito não negativo de metros de olho ou antena acima da primeira amostra; e target_height, um número finito não negativo de metros de altura do objeto acima da última amostra. O distance_m opcional é o comprimento horizontal total do caminho em metros quando você deseja sample_spacing_m na resposta. Aliases aceitos por conveniência incluem terrain, elevations e samples para o perfil; observer_h, h_obs e eye_height para o observador; target_h, h_tgt e object_height para o alvo; e distance, range_m ou path_length_m para o comprimento do caminho. Campos obrigatórios ausentes, valores não finitos, alturas negativas, um perfil com menos de duas amostras ou mais de cinco mil amostras falham com invalid_input nomeando o problema; essas falhas não são faturadas. Em caso de sucesso o corpo sempre inclui clear (booleano), sample_count, observer_eye_elev e target_eye_elev (elevações absolutas das extremidades do raio), min_clearance_m e min_clearance_index (a amostra mais apertada, que ainda pode ser positiva em um caminho livre) e uma string de fórmula curta que reescreve o teste. Quando distance_m foi fornecido, distance_m e sample_spacing_m são ecoados e derivados. Quando clear é false, blocked_at_index, terrain_elev_at_block e los_elev_at_block identificam a primeira amostra em que a folga ficou negativa.
Onde uma API de LOS sobre o terreno vale a pena
Educadores ao ar livre e oficiais de estande podem colar uma série curta de elevações de um aplicativo do telefone e ver se um espinhaço bloqueia a linha até uma bandeira ou alvo, ajustando observer_height para bipé versus em pé e target_height para uma chapa de aço versus uma estaca no solo. Como a implementação é parse puro de nível A, cada chamada bem-sucedida custa o preço base publicado US$ 0,002 sem tokens de modelo e sem serviço de elevação de terceiros — você fornece o perfil.
Perguntas técnicas
Como a calculadora de linha de visada decide livre versus bloqueado?
Constrói um raio reto de profile[0]+observer_height até profile[n−1]+target_height e verifica a folga em cada amostra igualmente espaçada. Se alguma amostra tiver los_z − terrain < 0, o caminho está bloqueado; caso contrário está livre (rasante conta como livre).
Quanto custa a ferramenta de linha de visada sobre o terreno?
A ferramenta do navegador é gratuita. Solicitações API usam saldo pré-pago KIT a US$ 0,002 por chamada bem-sucedida; entrada inválida não é faturada.