ee.Geometry.intersection
Returns the intersection of the two geometries.
Usage | Returns |
---|
Geometry.intersection(right, maxError, proj) | Geometry |
Argument | Type | Details |
---|
this: left | Geometry | The geometry used as the left operand of the operation. |
right | Geometry | The geometry used as the right operand of the operation. |
maxError | ErrorMargin, default: null | The maximum amount of error tolerated when performing any necessary reprojection. |
proj | Projection, default: null | The projection in which to perform the operation. If not specified, the operation will be performed in a spherical coordinate system, and linear distances will be in meters on the sphere. |
Examples
// Define a Geometry object.
var geometry = ee.Geometry({
'type': 'Polygon',
'coordinates':
[[[-122.081, 37.417],
[-122.086, 37.421],
[-122.084, 37.418],
[-122.089, 37.416]]]
});
// Define other inputs.
var inputGeom = ee.Geometry.BBox(-122.085, 37.415, -122.075, 37.425);
// Apply the intersection method to the Geometry object.
var geometryIntersection = geometry.intersection({'right': inputGeom, 'maxError': 1});
// Print the result to the console.
print('geometry.intersection(...) =', geometryIntersection);
// Display relevant geometries on the map.
Map.setCenter(-122.085, 37.422, 15);
Map.addLayer(geometry,
{'color': 'black'},
'Geometry [black]: geometry');
Map.addLayer(inputGeom,
{'color': 'blue'},
'Parameter [blue]: inputGeom');
Map.addLayer(geometryIntersection,
{'color': 'red'},
'Result [red]: geometry.intersection');
Python setup
See the
Python Environment page for information on the Python API and using
geemap
for interactive development.
import ee
import geemap.core as geemap
# Define a Geometry object.
geometry = ee.Geometry({
'type': 'Polygon',
'coordinates': [[
[-122.081, 37.417],
[-122.086, 37.421],
[-122.084, 37.418],
[-122.089, 37.416],
]],
})
# Define other inputs.
input_geom = ee.Geometry.BBox(-122.085, 37.415, -122.075, 37.425)
# Apply the intersection method to the Geometry object.
geometry_intersection = geometry.intersection(right=input_geom, maxError=1)
# Print the result.
display('geometry.intersection(...) =', geometry_intersection)
# Display relevant geometries on the map.
m = geemap.Map()
m.set_center(-122.085, 37.422, 15)
m.add_layer(geometry, {'color': 'black'}, 'Geometry [black]: geometry')
m.add_layer(input_geom, {'color': 'blue'}, 'Parameter [blue]: input_geom')
m.add_layer(
geometry_intersection,
{'color': 'red'},
'Result [red]: geometry.intersection',
)
m
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2023-10-06 UTC.
[null,null,["Last updated 2023-10-06 UTC."],[[["Returns a new Geometry that represents the shared area between two input geometries."],["Accepts two geometries as input: `left` (the geometry the method is called on) and `right`."],["Can be performed using a specified projection (`proj`) or a spherical coordinate system with linear distances in meters if no projection is defined."],["Includes an optional `maxError` parameter to control the tolerance for reprojection errors."]]],["The `intersection` method computes the overlapping area between two geometries. It takes a `right` geometry as input, and optionally `maxError` and `proj` for reprojection settings. The output is a new `Geometry` representing the intersection. If no `proj` is provided, the operation uses spherical coordinates with linear distances in meters. Examples in JavaScript and Python demonstrate defining two geometries, using the method to get the intersection, and displaying the result.\n"]]