Centroide de polígono

Esta capacidade implementa o centroide shoelace planar clássico em coordenadas em graus decimais, rejeita anéis com menos de três vértices e devolve JSON estruturado com o centroide, a área planar com sinal e um eco de vértices normalizados.

O que é um centroide de polígono ponderado por área e quando usá-lo

Resultados são funções puras do anel de entrada: vértices idênticos sempre produzem JSON idêntico sem modelo, sem geocodificador de rede e sem semente aleatória no caminho.

Contrato de entrada, validação e fórmulas shoelace usadas

A latitude deve ficar entre menos noventa e noventa, a longitude entre menos cento e oitenta e cento e oitenta, e cada coordenada deve ser um número finito ou string numérica. Se o anel estiver fechado no estilo GeoJSON com o primeiro ponto repetido no final, o vértice de fechamento duplicado é removido antes da contagem. Área com sinal zero ou quase zero falha porque anéis colineares ou colapsados não têm centro ponderado por área bem definido. Envie um objeto JSON cujo campo obrigatório vertices é um array de objetos, cada um com lat e lon em graus decimais WGS84. Aliases points, ring e coordinates são aceitos para o array; cada vértice também aceita latitude ou y para lat e longitude, lng ou x para lon. Após a normalização o motor exige pelo menos três vértices; menos de três eleva invalid_input com mensagem clara e não é cobrado. A área planar com sinal A é metade da soma de produtos cruzados x_i y_{i+1} menos x_{i+1} y_i com x igual a lon e y igual a lat. A longitude do centroide é um sobre seis A vezes a soma de x_i mais x_{i+1} vezes cada termo cruzado, e a latitude do centroide usa a soma análoga nas coordenadas y. Respostas bem-sucedidas ecoam vertex_count e os vértices normalizados, devolvem lat e lon do centroide, incluem signed_area em unidades de grau ao quadrado para diagnóstico e definem method como area_weighted_shoelace para que quem chama possa afirmar o algoritmo em integração contínua. Não há biblioteca de triangulação nem serviço externo de tiles de mapa — apenas aritmética em um Worker compartilhado com a ferramenta gratuita no navegador.

Uso da API, preços, limites e fluxos práticos

Use a calculadora gratuita de centroide de polígono no navegador quando quiser uma checagem imediata ao editar o contorno de uma zona, verificar um exercício de aula ou colocar um pin de mapa sem instalar software GIS. Anéis têm um teto generoso de vértices adequado a quarteirões e campus; mantenha regiões modestas se depender da aproximação planar em graus, porque polígonos continentais grandes devem usar projeções de área igual ou bibliotecas geodésicas em vez de shoelace lat/lon bruto. Polígonos em laço autointersecantes não são uma promessa de produto suportada; envie anéis simples sem autointerseções para centros previsíveis. Use a API pré-paga quando um painel de logística, uma plataforma imobiliária, um gerador de lições ou uma suíte de testes precisar do mesmo contrato ponderado por área sob saldo KIT a US$ 0,002 por item bem-sucedido; falhas de validação nunca consomem saldo após a rejeição do motor. Ordene os vértices de forma consistente em torno do contorno — horário ou anti-horário funcionam; o sinal de signed_area reflete o enrolamento. Combine este endpoint com ferramentas de centroide de triângulo quando a forma for estritamente de três pontos e você só quiser a média aritmética dos vértices, ou com ajudantes de rumo e distância quando o próximo passo for navegação a partir do centro calculado. Autores que publicam SDK podem mapear lat e lon diretamente em APIs de marcadores de mapa ou exportações CSV sem reimplementar shoelace em cada linguagem.