O Earth Engine está introduzindo
níveis de cota não comercial para proteger recursos de computação compartilhados e garantir um desempenho confiável para todo mundo. Todos os projetos não comerciais precisarão selecionar um nível de cota até
27 de abril de 2026 ou usarão o nível da comunidade por padrão. As cotas de nível vão entrar em vigor para todos os projetos (independente da data de seleção do nível) em
27 de abril de 2026.
Saiba mais.
ee.Algorithms.Image.Segmentation.KMeans
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Executa o clustering K-means na imagem de entrada. Gera uma imagem de uma banda que contém o ID do cluster a que cada pixel pertence. O algoritmo pode funcionar em uma grade fixa de células não sobrepostas (gridSize, que pode ser menor que um bloco) ou em blocos com sobreposição (neighborhoodSize). O padrão é usar blocos sem sobreposição.
Os clusters em uma célula ou bloco não estão relacionados a clusters em outra. Qualquer cluster que abranja um limite de célula ou bloco pode receber dois rótulos diferentes nas duas metades. Todos os pixels de entrada com máscaras parciais são totalmente mascarados na saída.
| Uso | Retorna |
|---|
ee.Algorithms.Image.Segmentation.KMeans(image, numClusters, numIterations, neighborhoodSize, gridSize, forceConvergence, uniqueLabels) | Imagem |
| Argumento | Tipo | Detalhes |
|---|
image | Imagem | A imagem de entrada para clustering. |
numClusters | Número inteiro, padrão: 8 | Número de clusters. |
numIterations | Número inteiro, padrão: 20 | Número de iterações. |
neighborhoodSize | Número inteiro, padrão: 0 | Tamanho da vizinhança. O valor para estender cada bloco (sobreposição) ao calcular os clusters. Essa opção é mutuamente exclusiva com gridSize. |
gridSize | Número inteiro, padrão: nulo | Tamanho da célula da grade. Se for maior que 0, o kMeans será executado de forma independente em células desse tamanho. Isso limita o tamanho de qualquer cluster a gridSize ou menor. Essa opção é mutuamente exclusiva com neighborhoodSize. |
forceConvergence | Booleano, padrão: falso | Se for verdadeiro, um erro será gerado se a convergência não for alcançada antes de numIterations. |
uniqueLabels | Booleano, padrão: verdadeiro | Se for verdadeiro, os clusters receberão IDs exclusivos. Caso contrário, eles serão repetidos por bloco ou célula de grade. |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2026-04-20 UTC.
[null,null,["Última atualização 2026-04-20 UTC."],[],["K-Means clustering is applied to an input image, generating a single-band output image where each pixel is assigned a cluster ID. Clustering can occur within a fixed grid (`gridSize`) or within overlapping tiles (`neighborhoodSize`). By default, tiles have no overlap. Clusters are independent per cell/tile, potentially resulting in different labels for clusters crossing boundaries. Parameters include the number of clusters and iterations. Convergence can be enforced and the ID labels be unique or repeat depending on the specified parameter.\n"]]