הודעה: כל הפרויקטים הלא מסחריים שנרשמו לשימוש ב-Earth Engine לפני 
15 באפריל 2025 חייבים 
לאמת את הזכאות לשימוש לא מסחרי כדי לשמור על הגישה. אם לא תאמתו את החשבון עד 26 בספטמבר 2025, יכול להיות שהגישה שלכם תושעה.
  
        
 
       
     
  
  
  
    
  
  
  
    
      ee.Algorithms.Image.Segmentation.KMeans
    
    
      
    
    
      
      קל לארגן דפים בעזרת אוספים
    
    
      
      אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
    
  
  
      
    
  
  
  
  
  
    
  
  
    
    
    
  
  
מבצע אשכולות K-Means בתמונת הקלט. פלט של תמונה עם פס אחד שמכיל את המזהה של האשכול שאליו כל פיקסל שייך. האלגוריתם יכול לפעול על רשת קבועה של תאים לא חופפים (gridSize, שיכול להיות קטן יותר מ-tile) או על tiles עם חפיפה (neighborhoodSize). ברירת המחדל היא שימוש באריחים ללא חפיפה. האשכולות בתא או במשבצת מסוימים לא קשורים לאשכולות בתא או במשבצת אחרים. יכול להיות שכל אשכול שחוצה את הגבול של תא או משבצת יקבל שתי תוויות שונות בשני החצאים. כל פיקסל קלט עם מסכות חלקיות מוסתר לחלוטין בפלט.
| שימוש | החזרות | 
|---|
| ee.Algorithms.Image.Segmentation.KMeans(image, numClusters, numIterations, neighborhoodSize, gridSize, forceConvergence, uniqueLabels) | תמונה | 
| ארגומנט | סוג | פרטים | 
|---|
| image | תמונה | תמונת הקלט לאשכול. | 
| numClusters | מספר שלם, ברירת מחדל: 8 | מספר הצבירים. | 
| numIterations | מספר שלם, ברירת מחדל: 20 | מספר האיטרציות. | 
| neighborhoodSize | מספר שלם, ברירת מחדל: 0 | גודל השכונה. הסכום שבו צריך להרחיב כל משבצת (חפיפה) כשמחשבים את האשכולות. האפשרות הזו בלעדית עם gridSize. | 
| gridSize | מספר שלם, ברירת מחדל: null | גודל תא הרשת. אם הערך גדול מ-0, האלגוריתם kMeans יופעל באופן עצמאי על תאים בגודל הזה. ההשפעה של הפעולה הזו היא הגבלת הגודל של כל אשכול ל-gridSize או פחות. האפשרות הזו לא יכולה לפעול יחד עם neighborhoodSize. | 
| forceConvergence | בוליאני, ברירת מחדל: false | אם הערך הוא True, תוצג שגיאה אם לא תושג התכנסות לפני numIterations. | 
| uniqueLabels | בוליאני, ברירת מחדל: true | אם הערך הוא True, לאשכולות מוקצים מזהים ייחודיים. אחרת, הם חוזרים על עצמם בכל משבצת או תא ברשת. | 
  
  
  
  
  
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
  עדכון אחרון: 2025-07-26 (שעון UTC).
  
  
  
    
      [null,null,["עדכון אחרון: 2025-07-26 (שעון 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"]]