ee.ErrorMargin

  • ee.ErrorMargin creates an object representing a margin of error for spatial operations.

  • It accepts an optional value (default: null) and unit (default: "meters") to define the margin.

  • Units can be 'meters', 'projected', or 'infinite', with large values (>= 2.0e7) automatically treated as 'infinite'.

  • Negative values for value are converted to positive values, representing the absolute error.

 Returns an ErrorMargin of the given type with the given value.

UsageReturns
ee.ErrorMargin(value, unit)ErrorMargin
ArgumentTypeDetails
valueFloat, default: nullThe maximum error value allowed by the margin. Ignored if the unit is 'infinite'.
unitString, default: "meters"The unit of this margin: 'meters', 'projected' or 'infinite'.

Examples

Code Editor (JavaScript)

// Construct a variety of error margins.
print(ee.ErrorMargin(0));  // unit: meters value: 0
print(ee.ErrorMargin(1));  // unit: meters value: 1
// Negative margin yields a positive value.
print(ee.ErrorMargin(-1));  // unit: meters value: 1
// Large values are turned into an 'infinite'
print(ee.ErrorMargin(1e8));  // unit: infinite
// A very large error margin does not quite trigger infinite, which is 2.0e7.
print(ee.ErrorMargin(1e7));  // unit: meters value: 10000000

// Being explicit about the units of the error margin.
print(ee.ErrorMargin(1, 'meters'));  // unit: meters value: 1
print(ee.ErrorMargin(1, 'projected'));  // unit: projected value: 1
print(ee.ErrorMargin(1, 'infinite'));  // unit: infinite

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

Colab (Python)

# Construct a variety of error margins.
print(ee.ErrorMargin(0).getInfo())  # unit: meters value: 0
print(ee.ErrorMargin(1).getInfo())  # unit: meters value: 1
# Negative margin yields a positive value.
print(ee.ErrorMargin(-1).getInfo())  # unit: meters value: 1
# Large values are turned into an 'infinite'
print(ee.ErrorMargin(1e8).getInfo())  # unit: infinite
# A very large error margin does not quite trigger infinite, which is 2.0e7.
print(ee.ErrorMargin(1e7).getInfo())  # unit: meters value: 10000000

# Being explicit about the units of the error margin.
print(ee.ErrorMargin(1, 'meters').getInfo())  # unit: meters value: 1
print(ee.ErrorMargin(1, 'projected').getInfo())  # unit: projected value: 1
print(ee.ErrorMargin(1, 'infinite').getInfo())  # unit: infinite