Localizador de quadrantes

Ela segue a convenção matemática padrão: o quadrante I é aquele em que ambas as coordenadas são positivas, e a numeração avança no sentido anti-horário. Uma coordenada zero nunca é forçada a um quadrante: os pontos situados sobre um eixo são relatados como pontos de eixo, que é justamente a distinção em que a maioria das implementações apressadas erra. Ambas as coordenadas devem ser números finitos; qualquer outra coisa retorna um erro claro de entrada inválida.

O que significa o quadrante de um ponto

O plano cartesiano é dividido pelo eixo x e pelo eixo y em quatro regiões chamadas quadrantes. O quadrante I contém todo ponto em que x e y são ambos positivos; avançando no sentido anti-horário, o quadrante II tem x negativo e y positivo, o quadrante III tem ambas as coordenadas negativas e o quadrante IV tem x positivo e y negativo. Conhecer o quadrante de um ponto é mais do que um exercício escolar: ele revela o padrão de sinais das coordenadas sem inspecionar cada valor separadamente, que é exatamente aquilo em que a trigonometria, as simulações de física e os motores de jogos se apoiam ao interpretar ângulos e vetores. Um localizador de quadrantes comprime todo esse raciocínio em uma única chamada de classificação. Você envia dois números e recebe um número de quadrante entre um e quatro, ou uma localização explícita de eixo ou origem quando uma coordenada é igual a zero — porque os pontos sobre um eixo não pertencem a quadrante algum, e confundi-los com um é o clássico erro de um da geometria de coordenadas.

Como a classificação é decidida

A regra é um teste de sinais estrito, aplicado em uma ordem fixa para que o resultado seja sempre inequívoco. Primeiro o endpoint verifica se ambas as coordenadas são zero; nesse caso, o ponto é a origem. Em seguida, verifica se y é zero, o que coloca o ponto sobre o eixo x, e se x é zero, o que o coloca sobre o eixo y. Somente quando ambas as coordenadas são diferentes de zero o sinal de cada uma decide o quadrante: positivo-positivo é I, negativo-positivo é II, negativo-negativo é III e positivo-negativo é IV. Essa ordem importa porque um ponto como (0, 5) está sobre o eixo y, e não no quadrante I ou II, e (0, 0) é a origem, e não um eixo arbitrário. A validação da entrada é igualmente estrita: cada coordenada deve ser um número finito, de modo que NaN, Infinity, campos ausentes e valores não numéricos são rejeitados com um erro de entrada inválida, em vez de produzir uma classificação silenciosamente errada.

Onde ela se encaixa no trabalho real

Ferramentas educacionais usam o endpoint para corrigir instantaneamente e com consistência as respostas dos alunos sobre o plano de coordenadas. Desenvolvedores de jogos usam a lógica de quadrantes para decidir a orientação de sprites, o posicionamento no minimapa e as regiões de colisão, e esta API permite que a validação no servidor concorde com a do cliente. Pipelines de visualização de dados a utilizam para agrupar pontos em regiões antes de colorir e anotar um gráfico de dispersão. Como o mesmo código determinístico roda grátis no seu navegador nesta página e na nossa edge para chamadas de API, você pode prototipar uma classificação de forma interativa e depois automatizá-la com a confiança de que as respostas serão exatamente iguais. A chamada não mantém estado, não armazena nada e custa US$ 0,002 por requisição quando feita pela API. Para trabalho em volume, envie uma requisição por ponto e agregue as localizações no lado do cliente; não há variante em lote, o que mantém o contrato — e seu preço — trivialmente previsível.