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.Geometry.Polygon.difference
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Retorna o resultado da subtração da geometria "direita" da geometria "esquerda".
| Uso | Retorna |
|---|
Polygon.difference(right, maxError, proj) | Geometria |
| Argumento | Tipo | Detalhes |
|---|
isso: left | Geometria | A geometria usada como o operando à esquerda da operação. |
right | Geometria | A geometria usada como o operando à direita da operação. |
maxError | ErrorMargin, padrão: null | A quantidade máxima de erro tolerada ao realizar qualquer reprojeção necessária. |
proj | Projeção, padrão: nulo | A projeção em que a operação será realizada. Se não for especificado, a operação será realizada em um sistema de coordenadas esféricas, e as distâncias lineares serão em metros na esfera. |
Exemplos
Editor de código (JavaScript)
// Define a Polygon object.
var polygon = ee.Geometry.Polygon(
[[[-122.092, 37.424],
[-122.086, 37.418],
[-122.079, 37.425],
[-122.085, 37.423]]]);
// Define other inputs.
var inputGeom = ee.Geometry.BBox(-122.085, 37.415, -122.075, 37.425);
// Apply the difference method to the Polygon object.
var polygonDifference = polygon.difference({'right': inputGeom, 'maxError': 1});
// Print the result to the console.
print('polygon.difference(...) =', polygonDifference);
// Display relevant geometries on the map.
Map.setCenter(-122.085, 37.422, 15);
Map.addLayer(polygon,
{'color': 'black'},
'Geometry [black]: polygon');
Map.addLayer(inputGeom,
{'color': 'blue'},
'Parameter [blue]: inputGeom');
Map.addLayer(polygonDifference,
{'color': 'red'},
'Result [red]: polygon.difference');
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)
# Define a Polygon object.
polygon = ee.Geometry.Polygon([[
[-122.092, 37.424],
[-122.086, 37.418],
[-122.079, 37.425],
[-122.085, 37.423],
]])
# Define other inputs.
input_geom = ee.Geometry.BBox(-122.085, 37.415, -122.075, 37.425)
# Apply the difference method to the Polygon object.
polygon_difference = polygon.difference(right=input_geom, maxError=1)
# Print the result.
display('polygon.difference(...) =', polygon_difference)
# Display relevant geometries on the map.
m = geemap.Map()
m.set_center(-122.085, 37.422, 15)
m.add_layer(polygon, {'color': 'black'}, 'Geometry [black]: polygon')
m.add_layer(input_geom, {'color': 'blue'}, 'Parameter [blue]: input_geom')
m.add_layer(
polygon_difference, {'color': 'red'}, 'Result [red]: polygon.difference'
)
m
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 `difference` method subtracts a 'right' geometry from a 'left' geometry, returning the resulting geometry. It accepts the 'right' geometry, an optional `maxError` for reprojection tolerance, and an optional `proj` for the projection. The operation can be performed in a spherical coordinate system, with linear distances in meters if `proj` is not defined. The examples illustrate using this function with a polygon and a bounding box, showing the geometries in both the JavaScript code editor and the Colab environment.\n"]]