Anúncio: todos os projetos não comerciais registrados para usar o Earth Engine antes de 
15 de abril de 2025 precisam 
verificar a qualificação não comercial para manter o acesso. Se você não fizer a verificação até 26 de setembro de 2025, seu acesso poderá ser suspenso.
  
        
 
       
     
  
  
  
    
  
  
  
    
      ee.Array.first
    
    
      
    
    
      
      Mantenha tudo organizado com as coleções
    
    
      
      Salve e categorize o conteúdo com base nas suas preferências.
    
  
  
      
    
  
  
  
  
  
    
  
  
    
    
    
  
  
Seleciona o valor do primeiro valor com base em elementos.
| Uso | Retorna | 
|---|
| Array.first(right) | Matriz | 
| Argumento | Tipo | Detalhes | 
|---|
| isso: left | Matriz | O valor à esquerda. | 
| right | Matriz | O valor à direita. | 
  
  
  Exemplos
  
    
  
  
    
    
  
  
  
  
    
    
    
      Editor de código (JavaScript)
    
    
  var empty = ee.Array([], ee.PixelType.int8());
print(empty.first(empty));  // []
print(ee.Array([0]).first(0));  // [0]
print(ee.Array([0, 1, 2]).first(1));  // [0,1,2]
print(ee.Array([0, 1, 2]).first(ee.Array([3, 4, 5])));  // [0,1,2]
print(ee.Array([3, 4, 5]).first(ee.Array([0, 1, 2])));  // [3,4,5]
  
    
  
  
    
  
  
  
  
    
  
    
  Configuração do Python
  Consulte a página 
    Ambiente Python para informações sobre a API Python e como usar
    geemap para desenvolvimento interativo.
  import ee
import geemap.core as geemap
  
    
    
      Colab (Python)
    
    
  empty = ee.Array([], ee.PixelType.int8())
display(empty.first(empty))  # []
display(ee.Array([0]).first(0))  # [0]
display(ee.Array([0, 1, 2]).first(1))  # [0,1,2]
display(ee.Array([0, 1, 2]).first(ee.Array([3, 4, 5])))  # [0, 1, 2]
display(ee.Array([3, 4, 5]).first(ee.Array([0, 1, 2])))  # [3, 4, 5]
  
  
  
  
  
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 2025-07-26 UTC.
  
  
  
    
      [null,null,["Última atualização 2025-07-26 UTC."],[],["The `first()` method selects values element-wise, prioritizing the left-hand array (`this: left`). If the left-hand array is empty, it returns an empty array. When used with a scalar value, it treats the value as an array of one element. The right-hand array, provided as an argument, is only used when there is no element in the left-hand array at a specific index. It returns an array object. The code snippets illustrate this in JavaScript and Python.\n"]]