Single-Page API Reference

ee.Algorithms.CannyEdgeDetector

Applies the Canny edge detection algorithm to an image. The output is an image whose bands have the same names as the input bands, and in which non-zero values indicate edges, and the magnitude of the value is the gradient magnitude.

UsageReturns
ee.Algorithms.CannyEdgeDetector(image, threshold, sigma)Image
ArgumentTypeDetails
imageImageThe image on which to apply edge detection.
thresholdFloatThreshold value. The pixel is only considered for edge detection if the gradient magnitude is higher than this threshold.
sigmaFloat, default: 1Sigma value for a gaussian filter applied before edge detection. 0 means apply no filtering.

ee.Algorithms.Collection

Returns a Collection containing the specified features.

UsageReturns
ee.Algorithms.Collection(features)FeatureCollection
ArgumentTypeDetails
featuresListThe features comprising the collection.

ee.Algorithms.CrossCorrelation

Gives information on the quality of image registration between two (theoretically) co-registered images. The input is two images with the same number of bands. This function outputs an image composed of four bands of information. The first three are distances: the deltaX, deltaY, and the Euclidean distance for each pixel in imageA to the pixel which has the highest corresponding correlation coefficient in imageB. The fourth band is the value of the correlation coefficient for that pixel [-1 : +1].

UsageReturns
ee.Algorithms.CrossCorrelation(imageA, imageB, maxGap, windowSize, maxMaskedFrac)Image
ArgumentTypeDetails
imageAImageFirst image, with N bands.
imageBImageSecond image, must have the same number of bands as imageA.
maxGapIntegerThe greatest distance a pixel may shift in either X or Y.
windowSizeIntegerSize of the window to be compared.
maxMaskedFracFloat, default: 0The maximum fraction of pixels within the correlation window that are allowed to be masked. This test is applied at each offset location within the search region. For each offset, the overlapping image patches are compared and a correlation score computed. A pixel within these overlapping patches is considered masked if either of the patches is masked there. If the test fails at any single location in the search region, the output pixel for which the correlation is being computed is considered invalid, and will be masked.

ee.Algorithms.Date

Creates a Date.

UsageReturns
ee.Algorithms.Date(value, timeZone)Date
ArgumentTypeDetails
valueObjectA number (interpreted as milliseconds since 1970-01-01T00:00:00Z), or string such as '1996-01-01' or '1996-001' or '1996-01-01T08:00'.
timeZoneString, default: nullThe time zone (e.g. 'America/Los_Angeles'); defaults to UTC.

ee.Algorithms.Describe

Describes an object using a simple JSON-compatible structure.

UsageReturns
ee.Algorithms.Describe(input)Object
ArgumentTypeDetails
inputObjectThe object to describe.

ee.Algorithms.Dictionary

Constructs a dictionary.

UsageReturns
ee.Algorithms.Dictionary(input)Dictionary
ArgumentTypeDetails
inputObject, default: nullAn object to convert to a dictionary. Either a JSON dictionary or a list of alternating key/value pairs. Keys must be strings.

ee.Algorithms.FMask.fillMinima

Fills local minima. Only works on INT types.

UsageReturns
ee.Algorithms.FMask.fillMinima(image, borderValue, neighborhood)Image
ArgumentTypeDetails
imageImageThe image to fill.
borderValueLong, default: nullThe border value.
neighborhoodInteger, default: 50The size of the neighborhood to compute over.

ee.Algorithms.FMask.matchClouds

Runs the FMask cloud and shadow matching. Outputs a single band ('csm'), containing the computed cloud and shadow masks.

UsageReturns
ee.Algorithms.FMask.matchClouds(input, cloud, shadow, btemp, sceneLow, sceneHigh, neighborhood)Image
ArgumentTypeDetails
inputImageThe scene for which to compute cloud and shadow masks.
cloudImagePotential cloud mask image. Expected to contain 1s for cloudy pixels and masked pixels everywhere else.
shadowImagePotential shadow mask image. Expected to contain 1s for shadow pixels and masked pixels everywhere else.
btempImageBrightness temperature image, in Celsius.
sceneLowFloatThe 0.175 percentile brightness temperature of the scene.
sceneHighFloatThe 0.825 percentile brightness temperature of the scene.
neighborhoodInteger, default: 50The neighborhood to pad around each tile.

ee.Algorithms.Feature

Returns a Feature composed of the given geometry and metadata.

UsageReturns
ee.Algorithms.Feature(geometry, metadata, geometryKey)Feature
ArgumentTypeDetails
geometryGeometry, default: nullThe geometry of the feature.
metadataDictionary, default: {}The properties of the feature.
geometryKeyString, default: nullObsolete; has no effect.

ee.Algorithms.GeometryConstructors.BBox

Constructs a rectangle whose edges are lines of latitude and longitude.

The result is a planar WGS84 rectangle.

If (east - west) ≥ 360 then the longitude range will be normalized to -180 to +180; otherwise they will be treated as designating points on a circle (e.g. east may be numerically less than west).

UsageReturns
ee.Algorithms.GeometryConstructors.BBox(west, south, east, north)Geometry
ArgumentTypeDetails
westFloatThe westernmost enclosed longitude. Will be adjusted to lie in the range -180 to 180.
southFloatThe southernmost enclosed latitude. If less than -90 (south pole), will be treated as -90.
eastFloatThe easternmost enclosed longitude.
northFloatThe northernmost enclosed latitude. If greater than +90 (north pole), will be treated as +90.

ee.Algorithms.GeometryConstructors.LineString

Constructs a LineString from the given coordinates.

UsageReturns
ee.Algorithms.GeometryConstructors.LineString(coordinates, crs, geodesic)Geometry
ArgumentTypeDetails
coordinatesListThe list of Points or pairs of Numbers in x,y order.
crsProjection, default: nullThe coordinate reference system of the coordinates. The default is the projection of the inputs, where Numbers are assumed to be EPSG:4326.
geodesicBoolean, default: nullIf false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth. The default is the geodesic state of the inputs, or true if the inputs are numbers.

ee.Algorithms.GeometryConstructors.LinearRing

Constructs a LinearRing from the given coordinates, automatically adding the first point at the end if the ring is not explicitly closed.

UsageReturns
ee.Algorithms.GeometryConstructors.LinearRing(coordinates, crs, geodesic)Geometry
ArgumentTypeDetails
coordinatesListThe list of Points or pairs of Numbers in x,y order.
crsProjection, default: nullThe coordinate reference system of the coordinates. The default is the projection of the inputs, where Numbers are assumed to be EPSG:4326.
geodesicBoolean, default: nullIf false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth. The default is the geodesic state of the inputs, or true if the inputs are numbers.

ee.Algorithms.GeometryConstructors.MultiGeometry

Constructs a MultiGeometry from the given list of geometry elements.

UsageReturns
ee.Algorithms.GeometryConstructors.MultiGeometry(geometries, crs, geodesic, maxError)Geometry
ArgumentTypeDetails
geometriesListThe list of geometries for the MultiGeometry.
crsProjection, default: nullThe coordinate reference system of the coordinates. The default is the projection of the inputs, where Numbers are assumed to be EPSG:4326.
geodesicBoolean, default: nullIf false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth. The default is the geodesic state of the inputs, or true if the inputs are numbers.
maxErrorErrorMargin, default: nullMax error when input geometry must be reprojected to an explicitly requested result projection or geodesic state.

ee.Algorithms.GeometryConstructors.MultiLineString

Constructs a MultiLineString from the given coordinates.

UsageReturns
ee.Algorithms.GeometryConstructors.MultiLineString(coordinates, crs, geodesic, maxError)Geometry
ArgumentTypeDetails
coordinatesListThe list of LineStrings, or to wrap a single LineString, the list of Points or pairs of Numbers in x,y order.
crsProjection, default: nullThe coordinate reference system of the coordinates. The default is the projection of the inputs, where Numbers are assumed to be EPSG:4326.
geodesicBoolean, default: nullIf false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth. The default is the geodesic state of the inputs, or true if the inputs are numbers.
maxErrorErrorMargin, default: nullMax error when input geometry must be reprojected to an explicitly requested result projection or geodesic state.

ee.Algorithms.GeometryConstructors.MultiPoint

Constructs a MultiPoint from the given coordinates.

UsageReturns
ee.Algorithms.GeometryConstructors.MultiPoint(coordinates, crs)Geometry
ArgumentTypeDetails
coordinatesListThe list of Points or pairs of Numbers in x,y order.
crsProjection, default: nullThe coordinate reference system of the coordinates. The default is the projection of the inputs, where Numbers are assumed to be EPSG:4326.

ee.Algorithms.GeometryConstructors.MultiPolygon

Constructs a MultiPolygon from the given coordinates.

UsageReturns
ee.Algorithms.GeometryConstructors.MultiPolygon(coordinates, crs, geodesic, maxError, evenOdd)Geometry
ArgumentTypeDetails
coordinatesListA list of Polygons, or for one simple polygon, a list of Points or pairs of Numbers in x,y order.
crsProjection, default: nullThe coordinate reference system of the coordinates. The default is the projection of the inputs, where Numbers are assumed to be EPSG:4326.
geodesicBoolean, default: nullIf false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth. The default is the geodesic state of the inputs, or true if the inputs are numbers.
maxErrorErrorMargin, default: nullMax error when input geometry must be reprojected to an explicitly requested result projection or geodesic state.
evenOddBoolean, default: trueIf true, polygon interiors will be determined by the even/odd rule, where a point is inside if it crosses an odd number of edges to reach a point at infinity. Otherwise polygons use the left-inside rule, where interiors are on the left side of the shell's edges when walking the vertices in the given order.

ee.Algorithms.GeometryConstructors.Point

Constructs a new Point from the given x,y coordinates.

UsageReturns
ee.Algorithms.GeometryConstructors.Point(coordinates, crs)Geometry
ArgumentTypeDetails
coordinatesListThe coordinates of this Point in x,y order.
crsProjection, default: nullThe coordinate reference system of the coordinates. The default is the projection of the inputs, where Numbers are assumed to be EPSG:4326.

ee.Algorithms.GeometryConstructors.Polygon

Constructs a Polygon from the given coordinates.

UsageReturns
ee.Algorithms.GeometryConstructors.Polygon(coordinates, crs, geodesic, maxError, evenOdd)Geometry
ArgumentTypeDetails
coordinatesListA list of LinearRings where the first is the shell and the rest are holes, or for a simple polygon, a list of Points or pairs of Numbers in x,y order.
crsProjection, default: nullThe coordinate reference system of the coordinates. The default is the projection of the inputs, where Numbers are assumed to be EPSG:4326.
geodesicBoolean, default: nullIf false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth. The default is the geodesic state of the inputs, or true if the inputs are numbers.
maxErrorErrorMargin, default: nullMax error when input geometry must be reprojected to an explicitly requested result projection or geodesic state.
evenOddBoolean, default: trueIf true, polygon interiors will be determined by the even/odd rule, where a point is inside if it crosses an odd number of edges to reach a point at infinity. Otherwise polygons use the left-inside rule, where interiors are on the left side of the shell's edges when walking the vertices in the given order.

ee.Algorithms.GeometryConstructors.Rectangle

Constructs a rectangular polygon from the given corner points.

UsageReturns
ee.Algorithms.GeometryConstructors.Rectangle(coordinates, crs, geodesic, evenOdd)Geometry
ArgumentTypeDetails
coordinatesListThe low and then high corners of the Rectangle, as a list of Points or pairs of Numbers in x,y order.
crsProjection, default: nullThe coordinate reference system of the coordinates. The default is the projection of the inputs, where Numbers are assumed to be EPSG:4326.
geodesicBoolean, default: nullIf false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth. The default is the geodesic state of the inputs, or true if the inputs are numbers.
evenOddBoolean, default: trueIf true, polygon interiors will be determined by the even/odd rule, where a point is inside if it crosses an odd number of edges to reach a point at infinity. Otherwise polygons use the left-inside rule, where interiors are on the left side of the shell's edges when walking the vertices in the given order.

ee.Algorithms.HillShadow

Creates a shadow band, with output 1 where pixels are illumunated and 0 where they are shadowed. Takes as input an elevation band, azimuth and zenith of the light source in degrees, a neighborhood size, and whether or not to apply hysteresis when a shadow appears. Currently, this algorithm only works for Mercator projections, in which light rays are parallel.

UsageReturns
ee.Algorithms.HillShadow(image, azimuth, zenith, neighborhoodSize, hysteresis)Image
ArgumentTypeDetails
imageImageThe image to which to apply the shadow algorithm, in which each pixel should represent an elevation in meters.
azimuthFloatAzimuth in degrees.
zenithFloatZenith in degrees.
neighborhoodSizeInteger, default: 0Neighborhood size.
hysteresisBoolean, default: falseUse hysteresis. Less physically accurate, but may generate better images.

ee.Algorithms.HoughTransform

Applies the Hough transform to an image. For every input band, outputs a band where lines are detected by thresholding the Hough transform with a value of lineThreshold. The output band is named [input]_lines, where [input] is the name of the original band. The defaults provided for the parameters are intended as a starting point for use with UINT8 images.

UsageReturns
ee.Algorithms.HoughTransform(image, gridSize, inputThreshold, lineThreshold, smooth)Image
ArgumentTypeDetails
imageImageThe image to which to apply the transform.
gridSizeInteger, default: 256The size of the grid over which to perform the computation.
inputThresholdFloat, default: 64Value threshold for input image. Pixels equal to or above this value are considered active.
lineThresholdFloat, default: 72Threshold for line detection. Values equal to or above this threshold on the Hough transform are considered to be detected lines.
smoothBoolean, default: trueWhether to smooth the Hough transform before line detection.

ee.Algorithms.If

Selects one of its inputs based on a condition, similar to an if-then-else construct.

UsageReturns
ee.Algorithms.If(condition, trueCase, falseCase)Object
ArgumentTypeDetails
conditionObject, default: nullThe condition that determines which result is returned. If this is not a boolean, it is interpreted as a boolean by the following rules:
  • Numbers that are equal to 0 or a NaN are false.
  • Empty strings, lists and dictionaries are false.
  • Null is false.
  • Everything else is true.
trueCaseObject, default: nullThe result to return if the condition is true.
falseCaseObject, default: nullThe result to return if the condition is false.

ee.Algorithms.Image.Segmentation.GMeans

Performs G-Means clustering on the input image. Iteratively applies k-means followed by a normality test to automatically determine the number of clusters to use. The output contains a 'clusters' band containing the integer ID of the cluster that each pixel belongs to. The algorithm can work either on a fixed grid of non-overlapping cells (gridSize, which can be smaller than a tile) or on tiles with overlap (neighborhoodSize). The default is to use tiles with no overlap. Clusters in one cell or tile are unrelated to clusters in another. Any cluster that spans a cell or tile boundary may receive two different labels in the two halves. Any input pixels with partial masks are fully masked in the output. This algorithm is only expected to perform well for images with a narrow dynamic range (i.e. bytes or shorts).

See: G. Hamerly and C. Elkan. 'Learning the k in k-means'. NIPS, 2003.

UsageReturns
ee.Algorithms.Image.Segmentation.GMeans(image, numIterations, pValue, neighborhoodSize, gridSize, uniqueLabels)Image
ArgumentTypeDetails
imageImageThe input image for clustering.
numIterationsInteger, default: 10Number of iterations. Default 10.
pValueFloat, default: 50Significance level for normality test.
neighborhoodSizeInteger, default: 0Neighborhood size. The amount to extend each tile (overlap) when computing the clusters. This option is mutually exclusive with gridSize.
gridSizeInteger, default: nullGrid cell-size. If greater than 0, kMeans will be run independently on cells of this size. This has the effect of limiting the size of any cluster to be gridSize or smaller. This option is mutually exclusive with neighborhoodSize.
uniqueLabelsBoolean, default: trueIf true, clusters are assigned unique IDs. Otherwise, they repeat per tile or grid cell.

ee.Algorithms.Image.Segmentation.KMeans

Performs K-Means clustering on the input image. Outputs a 1-band image containing the ID of the cluster that each pixel belongs to. The algorithm can work either on a fixed grid of non-overlapping cells (gridSize, which can be smaller than a tile) or on tiles with overlap (neighborhoodSize). The default is to use tiles with no overlap. Clusters in one cell or tile are unrelated to clusters in another. Any cluster that spans a cell or tile boundary may receive two different labels in the two halves. Any input pixels with partial masks are fully masked in the output.

UsageReturns
ee.Algorithms.Image.Segmentation.KMeans(image, numClusters, numIterations, neighborhoodSize, gridSize, forceConvergence, uniqueLabels)Image
ArgumentTypeDetails
imageImageThe input image for clustering.
numClustersInteger, default: 8Number of clusters.
numIterationsInteger, default: 20Number of iterations.
neighborhoodSizeInteger, default: 0Neighborhood size. The amount to extend each tile (overlap) when computing the clusters. This option is mutually exclusive with gridSize.
gridSizeInteger, default: nullGrid cell-size. If greater than 0, kMeans will be run independently on cells of this size. This has the effect of limiting the size of any cluster to be gridSize or smaller. This option is mutually exclusive with neighborhoodSize.
forceConvergenceBoolean, default: falseIf true, an error is thrown if convergence is not achieved before numIterations.
uniqueLabelsBoolean, default: trueIf true, clusters are assigned unique IDs. Otherwise, they repeat per tile or grid cell.

ee.Algorithms.Image.Segmentation.SNIC

Superpixel clustering based on SNIC (Simple Non-Iterative Clustering). Outputs a band of cluster IDs and the per-cluster averages for each of the input bands. If the 'seeds' image isn't provided as input, the output will include a 'seeds' band containing the generated seed locations. See: Achanta, Radhakrishna and Susstrunk, Sabine, 'Superpixels and Polygons using Simple Non-Iterative Clustering', CVPR, 2017.

UsageReturns
ee.Algorithms.Image.Segmentation.SNIC(image, size, compactness, connectivity, neighborhoodSize, seeds)Image
ArgumentTypeDetails
imageImageThe input image for clustering.
sizeInteger, default: 5The superpixel seed location spacing, in pixels. If 'seeds' image is provided, no grid is produced.
compactnessFloat, default: 1Compactness factor. Larger values cause clusters to be more compact (square). Setting this to 0 disables spatial distance weighting.
connectivityInteger, default: 8Connectivity. Either 4 or 8.
neighborhoodSizeInteger, default: nullTile neighborhood size (to avoid tile boundary artifacts). Defaults to 2 * size.
seedsImage, default: nullIf provided, any non-zero valued pixels are used as seed locations. Pixels that touch (as specified by 'connectivity') are considered to belong to the same cluster.

ee.Algorithms.Image.Segmentation.seedGrid

Selects seed pixels for clustering.

UsageReturns
ee.Algorithms.Image.Segmentation.seedGrid(size, gridType)Image
ArgumentTypeDetails
sizeInteger, default: 5The superpixel seed location spacing, in pixels.
gridTypeString, default: "square"Type of grid. One of 'square' or 'hex'.

ee.Algorithms.IsEqual

Returns whether two objects are equal.

UsageReturns
ee.Algorithms.IsEqual(left, right)Boolean
ArgumentTypeDetails
leftObject, default: null
rightObject, default: null

ee.Algorithms.Landsat.TOA

Calibrates Landsat DN to TOA reflectance and brightness temperature for Landsat and similar data. For recently-acquired scenes calibration coefficients are extracted from the image metadata; for older scenes the coefficients are derived from:

 Chander, Gyanesh, Brian L. Markham, and Dennis L. Helder. "Summary of current radiometric calibration coefficients for Landsat MSS, TM, ETM+, and EO-1 ALI sensors." Remote sensing of environment 113.5 (2009): 893-903.

UsageReturns
ee.Algorithms.Landsat.TOA(input)Image
ArgumentTypeDetails
inputImageThe Landsat image to process.

ee.Algorithms.Landsat.calibratedRadiance

Calibrates each band of an image by applying linear transformation with slope RADIANCE_MULT_BAND_N and y-intercept RADIANCE_ADD_BAND_N; these values are extracted from the image metadata.

UsageReturns
ee.Algorithms.Landsat.calibratedRadiance(image)Image
ArgumentTypeDetails
imageImageThe input Landsat image.

ee.Algorithms.Landsat.pathRowLimit

Limits requests to an ImageCollection of Landsat scenes to return a controllable number of the best scenes for each request. This is intended for use with statistical algorithms like median composites that need a certain amount of good data to perform well, but that do not benefit substantially from additional data beyond that while becoming needlessly expensive. The default arguments select approximately one year's worth of good data.

Note that in rare circumstances, when the tile boundary aligns with a Landsat WRS cell boundary, queries for adjacent tiles may yield conflicting results. This is why it is important that this algorithm only be used with statistical methods that can tolerate these inconsistencies.

UsageReturns
ee.Algorithms.Landsat.pathRowLimit(collection, maxScenesPerPathRow, maxScenesTotal)ImageCollection
ArgumentTypeDetails
collectionImageCollectionThe Landsat ImageCollection to limit.
maxScenesPerPathRowInteger, default: 25The max number of scenes to return per path/row.
maxScenesTotalInteger, default: 100The max number of scenes to return per request total.

ee.Algorithms.Landsat.simpleCloudScore

Computes a simple cloud-likelihood score in the range [0,100] using a combination of brightness, temperature, and NDSI. This is not a robust cloud detector, and is intended mainly to compare multiple looks at the same point for relative cloud likelihood.

UsageReturns
ee.Algorithms.Landsat.simpleCloudScore(image)Image
ArgumentTypeDetails
imageImageThe Landsat TOA image to process.

ee.Algorithms.Landsat.simpleComposite

Computes a Landsat TOA composite from a collection of raw Landsat scenes. It applies standard TOA calibration and then assigns a cloud score to each pixel using the SimpleLandsatCloudScore algorithm. It selects the lowest possible range of cloud scores at each point and then computes per-band percentile values from the accepted pixels. This algorithm also uses the LandsatPathRowLimit algorithm to select only the least-cloudy scenes in regions where more than maxDepth input scenes are available.

UsageReturns
ee.Algorithms.Landsat.simpleComposite(collection, percentile, cloudScoreRange, maxDepth, asFloat)Image
ArgumentTypeDetails
collectionImageCollectionThe raw Landsat ImageCollection to composite.
percentileInteger, default: 50The percentile value to use when compositing each band.
cloudScoreRangeInteger, default: 10The size of the range of cloud scores to accept per pixel.
maxDepthInteger, default: 40An approximate limit on the maximum number of scenes used to compute each pixel.
asFloatBoolean, default: falseIf true, output bands are in the same units as the Landsat.TOA algorithm; if false, TOA values are converted to uint8 by multiplying by 255 (reflective bands) or subtracting 100 (thermal bands) and rounding to the nearest integer.

ee.Algorithms.ObjectType

Returns a string representing the type of the given object.

UsageReturns
ee.Algorithms.ObjectType(value)String
ArgumentTypeDetails
valueObject, default: nullThe object to get the type of.

ee.Algorithms.ProjectionTransform

Transforms the geometry of a feature to a specific projection.

UsageReturns
ee.Algorithms.ProjectionTransform(feature, proj, maxError)Feature
ArgumentTypeDetails
featureElementThe feature the geometry of which is being converted.
projProjection, optionalThe target projection. Defaults to WGS84. If this has a geographic CRS, the edges of the geometry will be interpreted as geodesics. Otherwise they will be interpreted as straight lines in the projection.
maxErrorErrorMargin, default: nullThe maximum projection error.

ee.Algorithms.Sentinel2.CDI

Computes the Cloud Displacement Index (CDI) from a Sentinel-2 Level 1C image. CDI is a measure of the optical separation in elevated objects due to sensor parallax. Returns a floating point band named "cdi".

 See Frantz, D., Hass, E., Uhl, A., Stoffels, J., & Hill, J. (2018). Improvement of the Fmask algorithm for Sentinel-2 images: Separating clouds from bright surfaces based on parallax effects. Remote sensing of environment, 215, 471-481.

UsageReturns
ee.Algorithms.Sentinel2.CDI(source)Image
ArgumentTypeDetails
sourceImageThe source image.

ee.Algorithms.String

Converts the input to a string.

UsageReturns
ee.Algorithms.String(input)String
ArgumentTypeDetails
inputObjectThe object to convert.

ee.Algorithms.TemporalSegmentation.Ccdc

Implements the Continuous Change Detection and Classification temporal breakpoint algorithm. This algorithm finds temporal breakpoints in an image collection by iteratively fitting harmonic functions to the data. Fit coefficients are produced for all input bands, but the bands used for breakpoint detection can be specified with the 'breakpointBands' argument.

 For more details, see Zhu, Z. and Woodcock, C.E., 2014. Continuous change detection and classification of land cover using all available Landsat data. Remote sensing of Environment, 144, pp.152-171.

UsageReturns
ee.Algorithms.TemporalSegmentation.Ccdc(collection, breakpointBands, tmaskBands, minObservations, chiSquareProbability, minNumOfYearsScaler, dateFormat, lambda, maxIterations)Image
ArgumentTypeDetails
collectionImageCollectionCollection of images on which to run CCDC.
breakpointBandsList, default: nullThe name or index of the bands to use for change detection. If unspecified, all bands are used.
tmaskBandsList, default: nullThe name or index of the bands to use for iterative TMask cloud detection. These are typically the green band and the SWIR1 band. If unspecified, TMask is not used. If specified, 'tmaskBands' must be included in 'breakpointBands'.
minObservationsInteger, default: 6The number of observations required to flag a change.
chiSquareProbabilityFloat, default: 0.99The chi-square probability threshold for change detection in the range of [0, 1]
minNumOfYearsScalerFloat, default: 1.33Factors of minimum number of years to apply new fitting.
dateFormatInteger, default: 0The time representation to use during fitting: 0 = jDays, 1 = fractional years, 2 = unix time in milliseconds. The start, end and break times for each temporal segment will be encoded this way.
lambdaFloat, default: 20Lambda for LASSO regression fitting. If set to 0, regular OLS is used instead of LASSO.
maxIterationsInteger, default: 25000Maximum number of runs for LASSO regression convergence. If set to 0, regular OLS is used instead of LASSO.

ee.Algorithms.TemporalSegmentation.Ewmacd

Exponentially Weighted Moving Average Change Detection. This algorithm computes a harmonic model for the 'training' portion of the input data and subtracts that from the original results. The residuals are then subjected to Shewhart X-bar charts and an exponentially weighted moving average. Disturbed pixels are indicated when the charts signal a deviation from the given control limits.

 The output is a 5 band image containing the bands:

    ewma: a 1D array of the EWMA score for each input image. Negative values represent disturbance and positive values represent recovery.

    harmonicCoefficients: A 1-D array of the computed harmonic coefficient pairs. The coefficients are ordered as [constant, sin0, cos0, sin1, cos1...]

    rmse: the RMSE from the harmonic regression.

    rSquared: r-squared value from the harmonic regression.

    residuals: 1D array of residuals from the harmonic regression.

See: Brooks, E.B., Wynne, R.H., Thomas, V.A., Blinn, C.E. and Coulston, J.W., 2014. On-the-fly massively multitemporal change detection using statistical quality control charts and Landsat data. IEEE Transactions on Geoscience and Remote Sensing, 52(6), pp.3316-3332.

UsageReturns
ee.Algorithms.TemporalSegmentation.Ewmacd(timeSeries, vegetationThreshold, trainingStartYear, trainingEndYear, harmonicCount, xBarLimit1, xBarLimit2, lambda, lambdasigs, rounding, persistence)Image
ArgumentTypeDetails
timeSeriesImageCollectionCollection from which to extract EWMA. This collection is expected to contain 1 image for each year and be sorted temporally.
vegetationThresholdFloatThreshold for vegetation. Values below this are considered non-vegetation.
trainingStartYearIntegerStart year of training period, inclusive.
trainingEndYearIntegerEnd year of training period, exclusive.
harmonicCountInteger, default: 2Number of harmonic function pairs (sine and cosine) used.
xBarLimit1Float, default: 1.5Threshold for initial training xBar limit.
xBarLimit2Integer, default: 20Threshold for running xBar limit.
lambdaFloat, default: 0.3The 'lambda' tuning parameter weighting new years vs the running average.
lambdasigsFloat, default: 3EWMA control bounds, in units of standard deviations.
roundingBoolean, default: trueShould rounding be performed for EWMA
persistenceInteger, default: 3Minimum number of observations needed to consider a change.

ee.Algorithms.TemporalSegmentation.LandTrendr

Landsat-based detection of Trends in Disturbance and Recovery: temporally segments a time-series of images by extracting the spectral trajectories of change over time. The first band of each image is used to find breakpoints, and those breakpoints are used to perform fitting on all subsequent bands. The breakpoints are returned as a 2-D matrix of 4 rows and as many columns as images. The first two rows are the original X and Y values. The third row contains the Y values fitted to the estimated segments, and the 4th row contains a 1 if the corresponding point was used as a segment vertex or 0 if not. Any additional fitted bands are appended as rows in the output. Breakpoint fitting assumes that increasing values represent disturbance and decreasing values represent recovery.

See: Kennedy, R.E., Yang, Z. and Cohen, W.B., 2010. Detecting trends in forest disturbance and recovery using yearly Landsat time series: 1. LandTrendr - Temporal segmentation algorithms. Remote Sensing of Environment, 114(12), pp.2897-2910.

UsageReturns
ee.Algorithms.TemporalSegmentation.LandTrendr(timeSeries, maxSegments, spikeThreshold, vertexCountOvershoot, preventOneYearRecovery, recoveryThreshold, pvalThreshold, bestModelProportion, minObservationsNeeded)Image
ArgumentTypeDetails
timeSeriesImageCollectionYearly time-series from which to extract breakpoints. The first band is usedto find breakpoints, and all subsequent bands are fitted using those breakpoints.
maxSegmentsIntegerMaximum number of segments to be fitted on the time series.
spikeThresholdFloat, default: 0.9Threshold for dampening the spikes (1.0 means no dampening).
vertexCountOvershootInteger, default: 3The initial model can overshoot the maxSegments + 1 vertices by this amount. Later, it will be pruned down to maxSegments + 1.
preventOneYearRecoveryBoolean, default: falsePrevent segments that represent one year recoveries.
recoveryThresholdFloat, default: 0.25If a segment has a recovery rate faster than 1/recoveryThreshold (in years), then the segment is disallowed.
pvalThresholdFloat, default: 0.1If the p-value of the fitted model exceeds this threshold, then the current model is discarded and another one is fitted using the Levenberg-Marquardt optimizer.
bestModelProportionFloat, default: 0.75Allows models with more vertices to be chosen if their p-value is no more than (2 - bestModelProportion) times the p-value of the best model.
minObservationsNeededInteger, default: 6Min observations needed to perform output fitting.

ee.Algorithms.TemporalSegmentation.LandTrendrFit

Interpolates a time series using a set of LandTrendr breakpoint years. For each input band in the timeSeries, outputs a new 1D array-valued band containing the input values interpolated between the breakpoint times identified by the vertices image. See the LandTrendr Algorithm for more details.

UsageReturns
ee.Algorithms.TemporalSegmentation.LandTrendrFit(timeSeries, vertices, spikeThreshold, minObservationsNeeded)Image
ArgumentTypeDetails
timeSeriesImageCollectionTime series to interpolate.
verticesImageVertices image. A 1D array of LandTrendr breakpoint years.
spikeThresholdFloat, default: 0.9Threshold for dampening input spikes (1.0 means no dampening).
minObservationsNeededInteger, default: 6Min observations needed.

ee.Algorithms.TemporalSegmentation.StructuralChangeBreakpoints

Runs breakpoint detection, similar to R's strucchange::breakpoints function.

Each pixel is fit by a piecewise linear/harmonic model, of the form

Y = A + B * t + C * cos(2 * pi * season(t)) + D * sin(2 * pi * season(t)) + E * cos(4 * pi * season(t)) + F * sin(4 * pi * season(t)) + ...

In this equation, 't' is the start time of the image in the format specified by 'dateFormat', and 'season(t)' is the fractional year of that start time (see the description of dateFormat for details). The maximum order of the harmonic terms is determined by 'seasonalModelOrder'.

The result is an image containing two bands, plus two bands per band in the input:

tStart, tEnd: each of these holds a 1D array, with one entry per segment in the piecewise linear fit; each entry contains the start time of the first or last images in that segment. By default the values here are in fractional years, for easy use with the coefficients.

coefs_BANDNAME: there will be one such output band per input band. Each of these holds a 2D array, with one row per segment. The values in that row are the coefficients of the linear fit for that segment - that is, the values of A, B, C, ... for that segment. As described above, the values here are affected by 'dateFormat'

.rmse_BANDNAME: there will be one such output band per input band. This holds a 1D array, with one entry per segment. The value for each segment is the RMSE for the linear fit residuals for that segment.

UsageReturns
ee.Algorithms.TemporalSegmentation.StructuralChangeBreakpoints(collection, breakpointBand, seasonalModelOrder, minSpacing, maxBreaks, dateFormat)Image
ArgumentTypeDetails
collectionImageCollectionCollection of images on which to detect breakpoints.
breakpointBandString, default: nullThe name of the band to use for breakpoint detection. Optional only if the images have only a single band.
seasonalModelOrderInteger, default: 3The order of the harmonic seasonal model.
minSpacingFloat, default: 0.15The minimum spacing between breakpoints. If this is between 0 and 1 (exclusive), it will be interpreted as a fraction of the number of images in the collection. Otherwise, it will be interpreted as a number of samples.
maxBreaksInteger, default: 0The maximum number of breakpoints.
dateFormatInteger, default: 1The time representation to use in the results: 1 = fractional years, 2 = unix time in milliseconds. This affects the values in the tStart and tEnd bands and the 't' values used in the harmonic model. The fractional years used here and in that model are defined as the fractional number of 365.25-day years since 1 Jan 1970.

ee.Algorithms.TemporalSegmentation.VCT

Vegetation Change Tracker, an automated approach for reconstructing recent forest disturbance history using dense Landsat time series stacks.

The output is a 2D array per pixel containing 6 rows x N years. The output rows contain: input years, VCT landcover mask, magnitude in term of the UD composite, magnitude of distubance in B4, magnitude of distubance in NDVI, magnitude of distubance in dNBR.

See: Huang, C., Goward, S.N., Masek, J.G., Thomas, N., Zhu, Z. and Vogelmann, J.E., 2010. An automated approach for reconstructing recent forest disturbance history using dense Landsat time series stacks. Remote Sensing of Environment, 114(1), pp.183-198.

UsageReturns
ee.Algorithms.TemporalSegmentation.VCT(timeSeries, landCover, maxUd, minNdvi, forThrMax, nYears)Image
ArgumentTypeDetails
timeSeriesImageCollectionCollection from which to extract VCT disturbances, containing the bands: B3, B4, B5, B7, thermal, NDVI, DNBR and COMP. This collection is expected to contain 1 image for each year, sorted by time.
landCoverImageCollectionCollection from which to extract VCT masks. This collection is expected to contain 1 image for each image in the timeSeries, sorted by time.
maxUdFloat, default: 4Maximum Z-score composite value for detecting forest.
minNdviFloat, default: 0.45Minimum NDVI value for forest.
forThrMaxFloat, default: 3Maximum threshold for forest.
nYearsInteger, default: 30Maximum number of years.

ee.Algorithms.TemporalSegmentation.Verdet

Vegetation Regeneration and Disturbance Estimates through Time, forest change detection algorithm. This algorithm generates a yearly clear-sky composite from satellite imagery, calculates a spectral vegetation index for each pixel in that composite, spatially segments the vegetation index image into patches, temporally divides the time series into differently sloped segments, and then labels those segments as disturbed, stable, or regenerating. Segmentation at both the spatial and temporal steps are performed using total variation regularization.

The output consists of a 1D array per pixel containing the slope of fitted trend lines. Negative values indicate disturbance and positive values regeneration.

See: Hughes, M.J., Kaylor, S.D. and Hayes, D.J., 2017. Patch-based forest change detection from Landsat time series. Forests, 8(5), p.166.

UsageReturns
ee.Algorithms.TemporalSegmentation.Verdet(timeSeries, tolerance, alpha, nRuns)Image
ArgumentTypeDetails
timeSeriesImageCollectionCollection from which to extract VeRDET scores. This collection is expected to contain 1 image for each year, sorted temporally.
toleranceFloat, default: 0.0001Convergence tolerance.
alphaFloat, default: 0.03333333333333333Regularization parameter for segmentation.
nRunsInteger, default: 100Maximum number of runs for convergence.

ee.Algorithms.Terrain

Calculates slope, aspect, and a simple hillshade from a terrain DEM.

Expects an image containing either a single band of elevation, measured in meters, or if there's more than one band, one named 'elevation'. Adds output bands named 'slope' and 'aspect' measured in degrees plus an unsigned byte output band named 'hillshade' for visualization. All other bands and metadata are copied from the input image. The local gradient is computed using the 4-connected neighbors of each pixel, so missing values will occur around the edges of an image.

UsageReturns
ee.Algorithms.Terrain(input)Image
ArgumentTypeDetails
inputImageAn elevation image, in meters.

ee.Array

Returns an array with the given coordinates.

UsageReturns
ee.Array(values, pixelType)Array
ArgumentTypeDetails
valuesObjectAn existing array to cast, or a number/list of numbers/nested list of numbers of any depth to create an array from. For nested lists, all inner arrays at the same depth must have the same length, and numbers may only be present at the deepest level.
pixelTypePixelType, default: nullThe type of each number in the values argument. If the pixel type is not provided, it will be inferred from the numbers in 'values'. If there aren't any numbers in 'values', this type must be provided.

ee.Array.abs

On an element-wise basis, computes the absolute value of the input.

UsageReturns
Array.abs()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.accum

Accumulates elements of an array along the given axis, by setting each element of the result to the reduction of elements along that axis up to and including the current position. May be used to make a cumulative sum, a monotonically increasing sequence, etc.

UsageReturns
Array.accum(axis, reducer)Array
ArgumentTypeDetails
this: arrayArrayArray to accumulate.
axisIntegerAxis along which to perform the accumulation.
reducerReducer, default: nullReducer to accumulate values. Default is SUM, to produce the cumulative sum of each vector along the given axis.

ee.Array.acos

On an element-wise basis, computes the arc cosine in radians of the input.

UsageReturns
Array.acos()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.add

On an element-wise basis, adds the first value to the second.

UsageReturns
Array.add(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

ee.Array.and

On an element-wise basis, returns 1 if and only if both values are non-zero.

UsageReturns
Array.and(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

ee.Array.argmax

Returns the position, as a list of indices in each array axis, of the maximum value in an array, or null if the array is empty. If there are multiple occurrences of the maximum, returns the position of the first.

UsageReturns
Array.argmax()List
ArgumentTypeDetails
this: arrayArray

ee.Array.asin

On an element-wise basis, computes the arc sine in radians of the input.

UsageReturns
Array.asin()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.atan

On an element-wise basis, computes the arc tangent in radians of the input.

UsageReturns
Array.atan()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.atan2

On an element-wise basis, calculates the angle formed by the 2D vector [x, y].

UsageReturns
Array.atan2(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

ee.Array.bitCount

On an element-wise basis, calculates the number of one-bits in the 64-bit two's complement binary representation of the input.

UsageReturns
Array.bitCount()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.bitsToArray

Convert the bits of an integer to an Array. The array has as many elements as the position of the highest set bit, or a single 0 for a value of 0.

UsageReturns
ee.Array.bitsToArray(input)Array
ArgumentTypeDetails
inputNumber

ee.Array.bitwiseAnd

On an element-wise basis, calculates the bitwise AND of the input values.

UsageReturns
Array.bitwiseAnd(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

ee.Array.bitwiseNot

On an element-wise basis, calculates the bitwise NOT of the input, in the smallest signed integer type that can hold the input.

UsageReturns
Array.bitwiseNot()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.bitwiseOr

On an element-wise basis, calculates the bitwise OR of the input values.

UsageReturns
Array.bitwiseOr(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

ee.Array.bitwiseXor

On an element-wise basis, calculates the bitwise XOR of the input values.

UsageReturns
Array.bitwiseXor(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

ee.Array.byte

On an element-wise basis, casts the input value to an unsigned 8-bit integer.

UsageReturns
Array.byte()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.cat

Concatenates multiple arrays into a single array along the given axis. Each array must have the same dimensionality and the same length on all axes except the concatenation axis.

UsageReturns
ee.Array.cat(arrays, axis)Array
ArgumentTypeDetails
arraysListArrays to concatenate.
axisInteger, default: 0Axis to concatenate along.

ee.Array.cbrt

On an element-wise basis, computes the cubic root of the input.

UsageReturns
Array.cbrt()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.ceil

On an element-wise basis, computes the smallest integer greater than or equal to the input.

UsageReturns
Array.ceil()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.cos

On an element-wise basis, computes the cosine of the input in radians.

UsageReturns
Array.cos()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.cosh

On an element-wise basis, computes the hyperbolic cosine of the input.

UsageReturns
Array.cosh()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.cut

Cut an array along one or more axes.

UsageReturns
Array.cut(position)Array
ArgumentTypeDetails
this: arrayArrayThe array to cut.
positionListCut an array along one or more axes. The positions args specifies either a single value for each axis of the array, or -1, indicating the whole axis. The output will be an array that has the same dimensions as the input, with a length of 1 on each axis that was not -1 in the positions array.

ee.Array.digamma

On an element-wise basis, computes the digamma function of the input.

UsageReturns
Array.digamma()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.divide

On an element-wise basis, divides the first value by the second, returning 0 for division by 0.

UsageReturns
Array.divide(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

ee.Array.dotProduct

Compute the dot product between two 1-D arrays.

UsageReturns
Array.dotProduct(array2)Number
ArgumentTypeDetails
this: array1ArrayThe first 1-D array.
array2ArrayThe second 1-D array.

ee.Array.double

On an element-wise basis, casts the input value to a 64-bit float.

UsageReturns
Array.double()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.eigen

Computes the real eigenvectors and eigenvalues of a square 2D array of A rows and A columns. Returns an array with A rows and A+1 columns, where each row contains an eigenvalue in the first column, and the corresponding eigenvector in the remaining A columns. The rows are sorted by eigenvalue, in descending order.

 This implementation uses DecompositionFactory.eig() from https://ejml.org.

UsageReturns
Array.eigen()Array
ArgumentTypeDetails
this: inputArrayA square, 2D array from which to compute the eigenvalue decomposition.

ee.Array.eq

On an element-wise basis, returns 1 if and only if the first value is equal to the second.

UsageReturns
Array.eq(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

ee.Array.erf

On an element-wise basis, computes the error function of the input.

UsageReturns
Array.erf()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.erfInv

On an element-wise basis, computes the inverse error function of the input.

UsageReturns
Array.erfInv()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.erfc

On an element-wise basis, computes the complementary error function of the input.

UsageReturns
Array.erfc()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.erfcInv

On an element-wise basis, computes the inverse complementary error function of the input.

UsageReturns
Array.erfcInv()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.exp

On an element-wise basis, computes the Euler's number e raised to the power of the input.

UsageReturns
Array.exp()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.first

On an element-wise basis, selects the value of the first value.

UsageReturns
Array.first(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

ee.Array.firstNonZero

On an element-wise basis, selects the first value if it is non-zero, and the second value otherwise.

UsageReturns
Array.firstNonZero(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

ee.Array.float

On an element-wise basis, casts the input value to a 32-bit float.

UsageReturns
Array.float()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.floor

On an element-wise basis, computes the largest integer less than or equal to the input.

UsageReturns
Array.floor()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.gamma

On an element-wise basis, computes the gamma function of the input.

UsageReturns
Array.gamma()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.gammainc

On an element-wise basis, calculates the regularized lower incomplete Gamma function γ(x,a).

UsageReturns
Array.gammainc(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

ee.Array.get

Extracts the value at the given position from the input array.

UsageReturns
Array.get(position)Number
ArgumentTypeDetails
this: arrayArrayThe array to extract from.
positionListThe coordinates of the element to get.

ee.Array.gt

On an element-wise basis, returns 1 if and only if the first value is greater than the second.

UsageReturns
Array.gt(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

ee.Array.gte

On an element-wise basis, returns 1 if and only if the first value is greater than or equal to the second.

UsageReturns
Array.gte(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

ee.Array.hypot

On an element-wise basis, calculates the magnitude of the 2D vector [x, y].

UsageReturns
Array.hypot(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

ee.Array.identity

Creates a 2D identity matrix of the given size.

UsageReturns
ee.Array.identity(size)Array
ArgumentTypeDetails
sizeIntegerThe length of each axis.

ee.Array.int

On an element-wise basis, casts the input value to a signed 32-bit integer.

UsageReturns
Array.int()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.int16

On an element-wise basis, casts the input value to a signed 16-bit integer.

UsageReturns
Array.int16()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.int32

On an element-wise basis, casts the input value to a signed 32-bit integer.

UsageReturns
Array.int32()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.int64

On an element-wise basis, casts the input value to a signed 64-bit integer.

UsageReturns
Array.int64()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.int8

On an element-wise basis, casts the input value to a signed 8-bit integer.

UsageReturns
Array.int8()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.lanczos

On an element-wise basis, computes the Lanczos approximation of the input.

UsageReturns
Array.lanczos()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.leftShift

On an element-wise basis, calculates the left shift of v1 by v2 bits.

UsageReturns
Array.leftShift(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

ee.Array.length

Returns a 1-D ee.Array containing the length of each dimension of the given ee.Array.

UsageReturns
Array.length()Array
ArgumentTypeDetails
this: arrayArrayThe array from which to extract the axis lengths.

ee.Array.log

On an element-wise basis, computes the natural logarithm of the input.

UsageReturns
Array.log()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.log10

On an element-wise basis, computes the base-10 logarithm of the input.

UsageReturns
Array.log10()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.long

On an element-wise basis, casts the input value to a signed 64-bit integer.

UsageReturns
Array.long()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.lt

On an element-wise basis, returns 1 if and only if the first value is less than the second.

UsageReturns
Array.lt(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

ee.Array.lte

On an element-wise basis, returns 1 if and only if the first value is less than or equal to the second.

UsageReturns
Array.lte(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

ee.Array.mask

Creates a subarray by slicing out each position in an input array that is parallel to a non-zero element of the given mask array.

UsageReturns
Array.mask(mask)Array
ArgumentTypeDetails
this: inputArrayArray to mask.
maskArrayMask array.

ee.Array.matrixCholeskyDecomposition

Calculates the Cholesky decomposition of a matrix. The Cholesky decomposition is a decomposition into the form L * L' where L is a lower triangular matrix. The input must be a symmetric positive-definite matrix. Returns a dictionary with 1 entry named 'L'.

UsageReturns
Array.matrixCholeskyDecomposition()Dictionary
ArgumentTypeDetails
this: arrayArrayThe array to decompose.

ee.Array.matrixDeterminant

Computes the determinant of the matrix.

UsageReturns
Array.matrixDeterminant()Number
ArgumentTypeDetails
this: inputArrayThe array to compute on.

ee.Array.matrixDiagonal

Computes the diagonal of the matrix in a single column.

UsageReturns
Array.matrixDiagonal()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.matrixFnorm

Computes the Frobenius norm of the matrix.

UsageReturns
Array.matrixFnorm()Number
ArgumentTypeDetails
this: inputArrayThe array to compute on.

ee.Array.matrixInverse

Computes the inverse of the matrix.

UsageReturns
Array.matrixInverse()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.matrixLUDecomposition

Calculates the LU matrix decomposition such that P×input=L×U, where L is lower triangular (with unit diagonal terms), U is upper triangular and P is a partial pivot permutation matrix. The input matrix must be square. Returns a dictionary with entries named 'L', 'U' and 'P'.

UsageReturns
Array.matrixLUDecomposition()Dictionary
ArgumentTypeDetails
this: arrayArrayThe array to decompose.

ee.Array.matrixMultiply

Returns the matrix multiplication A * B.

UsageReturns
Array.matrixMultiply(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

ee.Array.matrixPseudoInverse

Computes the Moore-Penrose pseudoinverse of the matrix.

UsageReturns
Array.matrixPseudoInverse()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.matrixQRDecomposition

Calculates the QR-decomposition of a matrix into two matrices Q and R such that input = QR, where Q is orthogonal, and R is upper triangular. Returns a dictionary with entries named 'Q' and 'R'.

UsageReturns
Array.matrixQRDecomposition()Dictionary
ArgumentTypeDetails
this: arrayArrayThe array to decompose.

ee.Array.matrixSingularValueDecomposition

Calculates the Singular Value Decomposition of the input matrix into U×S×V', such that U and V are orthogonal and S is diagonal. Returns a dictionary with entries named 'U', 'S' and 'V'.

UsageReturns
Array.matrixSingularValueDecomposition()Dictionary
ArgumentTypeDetails
this: arrayArrayThe array to decompose.

ee.Array.matrixSolve

Solves for x in the matrix equation A * x = B, finding a least-squares solution if A is overdetermined.

UsageReturns
Array.matrixSolve(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

ee.Array.matrixToDiag

Computes a square diagonal matrix from a single column matrix.

UsageReturns
Array.matrixToDiag()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.matrixTrace

Computes the trace of the matrix.

UsageReturns
Array.matrixTrace()Number
ArgumentTypeDetails
this: inputArrayThe array to compute on.

ee.Array.matrixTranspose

Transposes two dimensions of an array.

UsageReturns
Array.matrixTranspose(axis1, axis2)Array
ArgumentTypeDetails
this: arrayArrayArray to transpose.
axis1Integer, default: 0First axis to swap.
axis2Integer, default: 1Second axis to swap.

ee.Array.max

On an element-wise basis, selects the maximum of the first and second values.

UsageReturns
Array.max(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

ee.Array.min

On an element-wise basis, selects the minimum of the first and second values.

UsageReturns
Array.min(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

ee.Array.mod

On an element-wise basis, calculates the remainder of the first value divided by the second.

UsageReturns
Array.mod(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

ee.Array.multiply

On an element-wise basis, multiplies the first value by the second.

UsageReturns
Array.multiply(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

ee.Array.neq

On an element-wise basis, returns 1 if and only if the first value is not equal to the second.

UsageReturns
Array.neq(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

ee.Array.not

On an element-wise basis, returns 0 if the input is non-zero, and 1 otherwise.

UsageReturns
Array.not()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.or

On an element-wise basis, returns 1 if and only if either input value is non-zero.

UsageReturns
Array.or(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

ee.Array.pad

Pad an array to a given length. The pad value will be repeatedly appended to the array to extend it to given length along each axis. If the array is already as large or larger than a given length, it will remain unchanged along that axis.

UsageReturns
Array.pad(lengths, pad)Array
ArgumentTypeDetails
this: arrayArrayArray to pad.
lengthsListA list of new lengths for each axis.
padNumber, default: 0The value with which to pad the array.

ee.Array.pow

On an element-wise basis, raises the first value to the power of the second.

UsageReturns
Array.pow(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

ee.Array.project

Projects an array to a lower dimensional space by specifying the axes to retain. Dropped axes must be at most length 1.

UsageReturns
Array.project(axes)Array
ArgumentTypeDetails
this: arrayArrayArray to project.
axesListThe axes to project onto. Other axes will be discarded, and must be at most length 1.

ee.Array.reduce

Apply a reducer to an array by collapsing all the input values along each specified axis into a single output value computed by the reducer.

The output always has the same dimensionality as the input, and the individual axes are affected as follows:

  • The axes specified in the 'axes' parameter have their length reduced to 1 (by applying the reducer).

  • If the reducer has multiple inputs or multiple outputs, the axis specified in 'fieldAxis' will be used to provide the reducer's inputs and store the reducer's outputs.

  • All other axes are unaffected (independent reductions are performed).

UsageReturns
Array.reduce(reducer, axes, fieldAxis)Array
ArgumentTypeDetails
this: arrayArrayThe array.
reducerReducerThe reducer to apply. Each of its outputs must be a number, not an array or other type.
axesListThe list of axes over which to reduce. The output will have a length of 1 in all these axes.
fieldAxisInteger, default: nullThe axis to use as the reducer's input and output fields. Only required if the reducer has multiple inputs or multiple outputs, in which case the axis must have length equal to the number of reducer inputs, and in the result it will have length equal to the number of reducer outputs.

ee.Array.repeat

Repeats the array along the given axis. The result will have the shape of the input, except length along the repeated axis will be multiplied by the given number of copies.

UsageReturns
Array.repeat(axis, copies)Array
ArgumentTypeDetails
this: arrayArrayArray to repeat.
axisInteger, default: 0The axis along which to repeat the array.
copiesInteger, default: 2The number of copies of this array to concatenate along the given axis.

ee.Array.reshape

Reshapes an array to a new list of dimension lengths.

UsageReturns
Array.reshape(shape)Array
ArgumentTypeDetails
this: arrayArrayArray to reshape.
shapeArrayNew shape to which arrays are converted. If one component of the shape is the special value -1, the size of that dimension is computed so that the total size remains constant. In particular, a shape of [-1] flattens into 1-D. At most one component of shape can be -1.

ee.Array.rightShift

On an element-wise basis, calculates the signed right shift of v1 by v2 bits.

UsageReturns
Array.rightShift(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

ee.Array.round

On an element-wise basis, computes the integer nearest to the input.

UsageReturns
Array.round()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.short

On an element-wise basis, casts the input value to a signed 16-bit integer.

UsageReturns
Array.short()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.signum

On an element-wise basis, computes the signum function (sign) of the input; zero if the input is zero, 1 if the input is greater than zero, -1 if the input is less than zero.

UsageReturns
Array.signum()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.sin

On an element-wise basis, computes the sine of the input in radians.

UsageReturns
Array.sin()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.sinh

On an element-wise basis, computes the hyperbolic sine of the input.

UsageReturns
Array.sinh()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.slice

Creates a subarray by slicing out each position along the given axis from the 'start' (inclusive) to 'end' (exclusive) by increments of 'step'. The result will have as many dimensions as the input, and the same length in all directions except the slicing axis, where the length will be the number of positions from 'start' to 'end' by 'step' that are in range of the input array's length along 'axis'. This means the result can be length 0 along the given axis if start=end, or if the start or end values are entirely out of range.

UsageReturns
Array.slice(axis, start, end, step)Array
ArgumentTypeDetails
this: arrayArrayArray to slice.
axisInteger, default: 0The axis to slice on.
startInteger, default: 0The coordinate of the first slice (inclusive) along 'axis'. Negative numbers are used to position the start of slicing relative to the end of the array, where -1 starts at the last position on the axis, -2 starts at the next to last position, etc.
endInteger, default: nullThe coordinate (exclusive) at which to stop taking slices. By default this will be the length of the given axis. Negative numbers are used to position the end of slicing relative to the end of the array, where -1 will exclude the last position, -2 will exclude the last two positions, etc.
stepInteger, default: 1The separation between slices along 'axis'; a slice will be taken at each whole multiple of 'step' from 'start' (inclusive) to 'end' (exclusive). Must be positive.

ee.Array.sort

Sorts elements of the array along one axis.

UsageReturns
Array.sort(keys)Array
ArgumentTypeDetails
this: arrayArrayArray image to sort.
keysArray, default: nullOptional keys to sort by. If not provided, the values are used as the keys. The keys can only have multiple elements along one axis, which determines the direction to sort in.

ee.Array.sqrt

On an element-wise basis, computes the square root of the input.

UsageReturns
Array.sqrt()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.subtract

On an element-wise basis, subtracts the second value from the first.

UsageReturns
Array.subtract(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

ee.Array.tan

On an element-wise basis, computes the tangent of the input in radians.

UsageReturns
Array.tan()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.tanh

On an element-wise basis, computes the hyperbolic tangent of the input.

UsageReturns
Array.tanh()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.toByte

On an element-wise basis, casts the input value to an unsigned 8-bit integer.

UsageReturns
Array.toByte()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.toDouble

On an element-wise basis, casts the input value to a 64-bit float.

UsageReturns
Array.toDouble()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.toFloat

On an element-wise basis, casts the input value to a 32-bit float.

UsageReturns
Array.toFloat()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.toInt

On an element-wise basis, casts the input value to a signed 32-bit integer.

UsageReturns
Array.toInt()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.toInt16

On an element-wise basis, casts the input value to a signed 16-bit integer.

UsageReturns
Array.toInt16()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.toInt32

On an element-wise basis, casts the input value to a signed 32-bit integer.

UsageReturns
Array.toInt32()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.toInt64

On an element-wise basis, casts the input value to a signed 64-bit integer.

UsageReturns
Array.toInt64()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.toInt8

On an element-wise basis, casts the input value to a signed 8-bit integer.

UsageReturns
Array.toInt8()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.toList

Turns an Array into a list of lists of numbers.

UsageReturns
Array.toList()List
ArgumentTypeDetails
this: arrayArrayArray to convert.

ee.Array.toLong

On an element-wise basis, casts the input value to a signed 64-bit integer.

UsageReturns
Array.toLong()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.toShort

On an element-wise basis, casts the input value to a signed 16-bit integer.

UsageReturns
Array.toShort()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.toUint16

On an element-wise basis, casts the input value to an unsigned 16-bit integer.

UsageReturns
Array.toUint16()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.toUint32

On an element-wise basis, casts the input value to an unsigned 32-bit integer.

UsageReturns
Array.toUint32()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.toUint8

On an element-wise basis, casts the input value to an unsigned 8-bit integer.

UsageReturns
Array.toUint8()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.transpose

Transposes two dimensions of an array.

UsageReturns
Array.transpose(axis1, axis2)Array
ArgumentTypeDetails
this: arrayArrayArray to transpose.
axis1Integer, default: 0First axis to swap.
axis2Integer, default: 1Second axis to swap.

ee.Array.trigamma

On an element-wise basis, computes the trigamma function of the input.

UsageReturns
Array.trigamma()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.uint16

On an element-wise basis, casts the input value to an unsigned 16-bit integer.

UsageReturns
Array.uint16()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.uint32

On an element-wise basis, casts the input value to an unsigned 32-bit integer.

UsageReturns
Array.uint32()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Array.uint8

On an element-wise basis, casts the input value to an unsigned 8-bit integer.

UsageReturns
Array.uint8()Array
ArgumentTypeDetails
this: inputArrayThe input array.

ee.Blob

Loads a Blob from a Google Cloud Storage URL.

UsageReturns
ee.Blob(url)Blob
ArgumentTypeDetails
urlStringThe Blob's Google Cloud Storage URL.

ee.Blob.string

Returns the contents of the blob as a String.

UsageReturns
Blob.string(encoding)String
ArgumentTypeDetails
this: blobBlob
encodingString, default: null

ee.Blob.url

Returns the Blob's Google Cloud Storage URL.

UsageReturns
Blob.url()String
ArgumentTypeDetails
this: blobBlob

ee.Classifier.amnhMaxent

Creates a Maximum Entropy classifier. Maxent is used to model species distribution probabilities using environmental data for locations of known presence and for a large number of 'background' locations. For more information and to cite, see: https://biodiversityinformatics.amnh.org/open_source/maxent/ and the reference publication: Phillips, et. al., 2004 A maximum entropy approach to species distribution modeling, Proceedings of the Twenty-First International Conference on Machine Learning. The output is a single band named 'probability', containing the modeled probability, and an additional band named 'clamp' when the 'writeClampGrid' argument is true.

UsageReturns
ee.Classifier.amnhMaxent(categoricalNames, outputFormat, autoFeature, linear, quadratic, product, threshold, hinge, hingeThreshold, l2lqThreshold, lq2lqptThreshold, addSamplesToBackground, addAllSamplesToBackground, betaMultiplier, betaHinge, betaLqp, betaCategorical, betaThreshold, extrapolate, doClamp, writeClampGrid, randomTestPoints, seed)Classifier
ArgumentTypeDetails
categoricalNamesList, default: nullA list of the names of the categorical inputs. Any inputs not listed in this argument are considered to be continuous.
outputFormatString, default: "cloglog"Representation of probabilities in output.
autoFeatureBoolean, default: trueAutomatically select which feature classes to use, based on number of training samples.
linearBoolean, default: trueAllow linear features to be used. Ignored when autofeature is true.
quadraticBoolean, default: trueAllow quadratic features to be used. Ignored when autofeature is true.
productBoolean, default: trueAllow product features to be used. Ignored when autofeature is true.
thresholdBoolean, default: falseAllow threshold features to be used. Ignored when autofeature is true.
hingeBoolean, default: trueAllow hinge features to be used. Ignored when autofeature is true.
hingeThresholdInteger, default: 15Number of samples at which hinge features start being used. Ignored when autofeature is false.
l2lqThresholdInteger, default: 10Number of samples at which quadratic features start being used. Ignored when autofeature is false.
lq2lqptThresholdInteger, default: 80Number of samples at which product and threshold features start being used. Ignored when autofeature is false.
addSamplesToBackgroundBoolean, default: trueAdd to the background any sample for which has a combination of environmental values that isn't already present in the background.
addAllSamplesToBackgroundBoolean, default: falseAdd all samples to the background, even if they have combinations of environmental values that are already present in the background.
betaMultiplierFloat, default: 1Regularization multiplier. Multiply all automatic regularization parameters by this number. A higher number gives a more spread-out distribution.
betaHingeFloat, default: -1Regularization parameter to be applied to all hinge features; negative value enables automatic setting.
betaLqpFloat, default: -1Regularization parameter to be applied to all linear, quadratic and product features; negative value enables automatic setting.
betaCategoricalFloat, default: -1Regularization parameter to be applied to all categorical features; negative value enables automatic setting.
betaThresholdFloat, default: -1Regularization parameter to be applied to all threshold features; negative value enables automatic setting.
extrapolateBoolean, default: trueExtrapolate. Predict to regions of environmental space outside the limits encountered during training.
doClampBoolean, default: trueApply clamping to output.
writeClampGridBoolean, default: trueAdds a band to the output ('clamp') showing the spatial distribution of clamping. At each point, the value is the absolute difference between prediction values with and without clamping.
randomTestPointsInteger, default: 0Random test percentage. The percentage of training points to hold aside as test points, used to compute AUX, omission, etc.
seedLong, default: 0A seed used when generating random numbers.

ee.Classifier.confusionMatrix

Computes a 2D confusion matrix for a classifier based on its training data (ie: resubstitution error). Axis 0 of the matrix corresponds to the input classes, and axis 1 corresponds to the output classes. The rows and columns start at class 0 and increase sequentially up to the maximum class value, so some rows or columns might be empty if the input classes aren't 0-based or sequential.

UsageReturns
Classifier.confusionMatrix()ConfusionMatrix
ArgumentTypeDetails
this: classifierClassifierThe classifier to use.

ee.Classifier.decisionTree

Creates a classifier that applies the given decision tree.

UsageReturns
ee.Classifier.decisionTree(treeString)Classifier
ArgumentTypeDetails
treeStringStringThe decision tree, specified in the text format generated by R and other similar tools.

ee.Classifier.decisionTreeEnsemble

Creates a classifier that applies the given decision trees.

UsageReturns
ee.Classifier.decisionTreeEnsemble(treeStrings)Classifier
ArgumentTypeDetails
treeStringsListThe decision trees, specified in the text format generated by R and other similar tools. Each item in the list should contain one or more trees in text format.

ee.Classifier.explain

Describe the results of a trained classifier.

UsageReturns
Classifier.explain()Dictionary
ArgumentTypeDetails
this: classifierClassifierThe classifier to describe.

ee.Classifier.libsvm

Creates an empty Support Vector Machine classifier.

UsageReturns
ee.Classifier.libsvm(decisionProcedure, svmType, kernelType, shrinking, degree, gamma, coef0, cost, nu, terminationEpsilon, lossEpsilon, oneClass)Classifier
ArgumentTypeDetails
decisionProcedureString, default: "Voting"The decision procedure to use for classification. Either 'Voting' or 'Margin'. Not used for regression.
svmTypeString, default: "C_SVC"The SVM type. One of `C_SVC`, `NU_SVC`, `ONE_CLASS`, `EPSILON_SVR` or `NU_SVR`.
kernelTypeString, default: "LINEAR"The kernel type. One of LINEAR (u′×v), POLY ((γ×u′×v + coef₀)ᵈᵉᵍʳᵉᵉ), RBF (exp(-γ×|u-v|²)) or SIGMOID (tanh(γ×u′×v + coef₀)).
shrinkingBoolean, default: trueWhether to use shrinking heuristics.
degreeInteger, default: nullThe degree of polynomial. Valid for POLY kernels.
gammaFloat, default: nullThe gamma value in the kernel function. Defaults to the reciprocal of the number of features. Valid for POLY, RBF and SIGMOID kernels.
coef0Float, default: nullThe coef₀ value in the kernel function. Defaults to 0. Valid for POLY and SIGMOID kernels.
costFloat, default: nullThe cost (C) parameter. Defaults to 1. Only valid for C-SVC, epsilon-SVR, and nu-SVR.
nuFloat, default: nullThe nu parameter. Defaults to 0.5. Only valid for nu-SVC, one-class SVM, and nu-SVR.
terminationEpsilonFloat, default: nullThe termination criterion tolerance (e). Defaults to 0.001. Only valid for epsilon-SVR.
lossEpsilonFloat, default: nullThe epsilon in the loss function (p). Defaults to 0.1. Only valid for epsilon-SVR.
oneClassInteger, default: nullThe class of the training data on which to train in a one-class SVM. Defaults to 0. Only valid for one-class SVM. Possible values are 0 and 1. The classifier output is binary (0/1) and will match this class value for the data determined to be in the class.

ee.Classifier.load

Creates a Classifier.

UsageReturns
ee.Classifier.load(id)Classifier
ArgumentTypeDetails
idStringThe Classifier's Asset ID.

ee.Classifier.minimumDistance

Creates a minimum distance classifier for the given distance metric. In CLASSIFICATION mode, the nearest class is returned. In REGRESSION mode, the distance to the nearest class center is returned. In RAW mode, the distance to every class center is returned.

UsageReturns
ee.Classifier.minimumDistance(metric, kNearest)Classifier
ArgumentTypeDetails
metricString, default: "euclidean"The distance metric to use. Options are:
  • 'euclidean' - euclidean distance from the unnormalized class mean.
  • 'cosine' - spectral angle from the unnormalized class mean.
  • 'mahalanobis' - Mahalanobis distance from the class mean.
  • 'manhattan' - Manhattan distance from the unnormalized class mean.
kNearestInteger, default: 1If greater than 1, the result will contain an array of the k nearest neighbors or distances, based on the output mode setting. if kNearest is greater than the total number of classes, it will be set equal to the number of classes.

ee.Classifier.mode

Returns the classifier mode: CLASSIFICATION, REGRESSION, PROBABILITY, MULTIPROBABILITY, RAW or RAW_REGRESSION.

UsageReturns
Classifier.mode()String
ArgumentTypeDetails
this: classifierClassifier

ee.Classifier.schema

Returns the names of the inputs used by this classifier, or null if this classifier has not had any training data added yet.

UsageReturns
Classifier.schema()List
ArgumentTypeDetails
this: classifierClassifier

ee.Classifier.setOutputMode

Sets the output mode.

UsageReturns
Classifier.setOutputMode(mode)Classifier
ArgumentTypeDetails
this: classifierClassifierAn input classifier.
modeStringThe output mode. One of:
  • CLASSIFICATION (default): The output is the class number.
  • REGRESSION: The output is the result of standard regression.
  • PROBABILITY: The output is the probability that the classification is correct.
  • MULTIPROBABILITY: The output is an array of probabilities that each class is correct ordered by classes seen.
  • RAW: The output is an array of the internal representation of the classification process. For example, the raw votes in multi-decision tree models.
  • RAW_REGRESSION: The output is an array of the internal representation of the regression process. For example, the raw predictions of multiple regression trees.
Not all classifiers support modes other than CLASSIFICATION.

ee.Classifier.smileCart

Creates an empty CART classifier. See:

  "Classification and Regression Trees,"

  L. Breiman, J. Friedman, R. Olshen, C. Stone

  Chapman and Hall, 1984.

UsageReturns
ee.Classifier.smileCart(maxNodes, minLeafPopulation)Classifier
ArgumentTypeDetails
maxNodesInteger, default: nullThe maximum number of leaf nodes in each tree. If unspecified, defaults to no limit.
minLeafPopulationInteger, default: 1Only create nodes whose training set contains at least this many points.

ee.Classifier.smileGradientTreeBoost

Creates an empty Gradient Tree Boost classifier.

UsageReturns
ee.Classifier.smileGradientTreeBoost(numberOfTrees, shrinkage, samplingRate, maxNodes, loss, seed)Classifier
ArgumentTypeDetails
numberOfTreesIntegerThe number of decision trees to create.
shrinkageFloat, default: 0.005The shrinkage parameter in (0, 1] controls the learning rate of procedure.
samplingRateFloat, default: 0.7The sampling rate for stochastic tree boosting.
maxNodesInteger, default: nullThe maximum number of leaf nodes in each tree. If unspecified, defaults to no limit.
lossString, default: "LeastAbsoluteDeviation"Loss function for regression. One of: LeastSquares, LeastAbsoluteDeviation, Huber.
seedInteger, default: 0The randomization seed.

ee.Classifier.smileKNN

Creates an empty kNN classifier.

The k-nearest neighbor algorithm (k-NN) is a method for classifying objects by a majority vote of its neighbors, with the object being assigned to the class most common amongst its k nearest neighbors (k is a positive integer, typically small, typically odd).

UsageReturns
ee.Classifier.smileKNN(k, searchMethod, metric)Classifier
ArgumentTypeDetails
kInteger, default: 1The number of neighbors for classification.
searchMethodString, default: "AUTO"Search method. The following are valid [AUTO, LINEAR_SEARCH, KD_TREE, COVER_TREE]. AUTO Will choose between KD_TREE and COVER_TREE depending on the dimension count. Results may vary between the different search methods for distance ties and probability values. Since performance and results may vary consult with SMILE's documentation and other literature.
metricString, default: "EUCLIDEAN"The distance metric to use. NOTE: KD_TREE (and AUTO for low dimensions) will not use the metric selected. Options are:   'EUCLIDEAN' - euclidean distance.   'MAHALANOBIS' - Mahalanobis distance.   'MANHATTAN' - Manhattan distance.

ee.Classifier.smileNaiveBayes

Creates an empty Naive Bayes classifier. This classifier assumes that the feature vector consists of positive integers, and negative inputs are discarded.

UsageReturns
ee.Classifier.smileNaiveBayes(lambda)Classifier
ArgumentTypeDetails
lambdaFloat, default: 0.000001A smoothing lambda. Used to avoid assigning zero probability to classes not seen during training, instead using lambda / (lambda * nFeatures).

ee.Classifier.smileRandomForest

Creates an empty Random Forest classifier.

UsageReturns
ee.Classifier.smileRandomForest(numberOfTrees, variablesPerSplit, minLeafPopulation, bagFraction, maxNodes, seed)Classifier
ArgumentTypeDetails
numberOfTreesIntegerThe number of decision trees to create.
variablesPerSplitInteger, default: nullThe number of variables per split. If unspecified, uses the square root of the number of variables.
minLeafPopulationInteger, default: 1Only create nodes whose training set contains at least this many points.
bagFractionFloat, default: 0.5The fraction of input to bag per tree.
maxNodesInteger, default: nullThe maximum number of leaf nodes in each tree. If unspecified, defaults to no limit.
seedInteger, default: 0The randomization seed.

ee.Classifier.spectralRegion

Creates a classifier that tests if its inputs lie within a polygon defined by a set of coordinates in an arbitrary 2D coordinate system. Each input to be classified must have 2 values (e.g.: images must have 2 bands). The result will be 1 wherever the input values are contained within the given polygon and 0 otherwise.

UsageReturns
ee.Classifier.spectralRegion(coordinates, schema)Classifier
ArgumentTypeDetails
coordinatesListThe coordinates of the polygon, as a list of rings. Each ring is a list of coordinate pairs (e.g.: [u1, v1, u2, v2, ..., uN, vN]). No edge may intersect any other edge. The resulting classification will be a 1 wherever the input values are within the interior of the given polygon, that is, an odd number of polygon edges must be crossed to get outside the polygon and 0 otherwise.
schemaList, default: nullThe classifier's schema. A list of band or property names that the classifier will operate on. Since this classifier doesn't undergo a training step, these have to be specified manually. Defaults to ['u', 'v'].

ee.Classifier.train

Trains the classifier on a collection of features, using the specified numeric properties of each feature as training data. The geometry of the features is ignored.

UsageReturns
Classifier.train(features, classProperty, inputProperties, subsampling, subsamplingSeed)Classifier
ArgumentTypeDetails
this: classifierClassifierAn input classifier.
featuresFeatureCollectionThe collection to train on.
classPropertyStringThe name of the property containing the class value. Each feature must have this property, and its value must be numeric.
inputPropertiesList, default: nullThe list of property names to include as training data. Each feature must have all these properties, and their values must be numeric. This argument is optional if the input collection contains a 'band_order' property, (as produced by Image.sample).
subsamplingFloat, default: 1An optional subsampling factor, within (0, 1].
subsamplingSeedInteger, default: 0A randomization seed to use for subsampling.

ee.Clusterer.schema

Returns the names of the inputs used by this Clusterer, or null if this Clusterer has not had any training data added yet.

UsageReturns
Clusterer.schema()List
ArgumentTypeDetails
this: clustererClusterer

ee.Clusterer.train

Trains the Clusterer on a collection of features, using the specified numeric properties of each feature as training data. The geometry of the features is ignored.

UsageReturns
Clusterer.train(features, inputProperties, subsampling, subsamplingSeed)Clusterer
ArgumentTypeDetails
this: clustererClustererAn input Clusterer.
featuresFeatureCollectionThe collection to train on.
inputPropertiesList, default: nullThe list of property names to include as training data. Each feature must have all these properties, and their values must be numeric. This argument is optional if the input collection contains a 'band_order' property, (as produced by Image.sample).
subsamplingFloat, default: 1An optional subsampling factor, within (0, 1].
subsamplingSeedInteger, default: 0A randomization seed to use for subsampling.

ee.Clusterer.wekaCascadeKMeans

Cascade simple k-means, selects the best k according to the Calinski-Harabasz criterion. For more information see:

Calinski, T. and J. Harabasz. 1974. A dendrite method for cluster analysis. Commun. Stat. 3: 1-27.

UsageReturns
ee.Clusterer.wekaCascadeKMeans(minClusters, maxClusters, restarts, manual, init, distanceFunction, maxIterations)Clusterer
ArgumentTypeDetails
minClustersInteger, default: 2Min number of clusters.
maxClustersInteger, default: 10Max number of clusters.
restartsInteger, default: 10Number of restarts.
manualBoolean, default: falseManually select the number of clusters.
initBoolean, default: falseSet whether to initialize using the probabilistic farthest first like method of the k-means++ algorithm (rather than the standard random selection of initial cluster centers).
distanceFunctionString, default: "Euclidean"Distance function to use. Options are: Euclidean & Manhattan
maxIterationsInteger, default: nullMaximum number of iterations for k-means.

ee.Clusterer.wekaCobweb

Implementation of the Cobweb clustering algorithm. For more information see:

D. Fisher (1987). Knowledge acquisition via incremental conceptual clustering. Machine Learning. 2(2):139-172. and J. H. Gennari, P. Langley, D. Fisher (1990). Models of incremental concept formation. Artificial Intelligence. 40:11-61.

UsageReturns
ee.Clusterer.wekaCobweb(acuity, cutoff, seed)Clusterer
ArgumentTypeDetails
acuityFloat, default: 1Acuity (minimum standard deviation).
cutoffFloat, default: 0.002Cutoff (minimum category utility).
seedInteger, default: 42Random number seed.

ee.Clusterer.wekaKMeans

Cluster data using the k means algorithm. Can use either the Euclidean distance (default) or the Manhattan distance. If the Manhattan distance is used, then centroids are computed as the component-wise median rather than mean. For more information see:

D. Arthur, S. Vassilvitskii: k-means++: the advantages of careful seeding. In: Proceedings of the eighteenth annual ACM-SIAM symposium on Discrete algorithms, 1027-1035, 2007.

UsageReturns
ee.Clusterer.wekaKMeans(nClusters, init, canopies, maxCandidates, periodicPruning, minDensity, t1, t2, distanceFunction, maxIterations, preserveOrder, fast, seed)Clusterer
ArgumentTypeDetails
nClustersIntegerNumber of clusters.
initInteger, default: 0Initialization method to use.0 = random, 1 = k-means++, 2 = canopy, 3 = farthest first.
canopiesBoolean, default: falseUse canopies to reduce the number of distance calculations.
maxCandidatesInteger, default: 100Maximum number of candidate canopies to retain in memory at any one time when using canopy clustering. T2 distance plus, data characteristics, will determine how many candidate canopies are formed before periodic and final pruning are performed, which might result in exceess memory consumption. This setting avoids large numbers of candidate canopies consuming memory.
periodicPruningInteger, default: 10000How often to prune low density canopies when using canopy clustering.
minDensityInteger, default: 2Minimum canopy density, when using canopy clustering, below which a canopy will be pruned during periodic pruning.
t1Float, default: -1.5The T1 distance to use when using canopy clustering. A value < 0 is taken as a positive multiplier for T2.
t2Float, default: -1The T2 distance to use when using canopy clustering. Values < 0 cause a heuristic based on attribute std. deviation to be used.
distanceFunctionString, default: "Euclidean"Distance function to use. Options are: Euclidean & Manhattan
maxIterationsInteger, default: nullMaximum number of iterations.
preserveOrderBoolean, default: falsePreserve order of instances.
fastBoolean, default: falseEnables faster distance calculations, using cut-off values. Disables the calculation/output of squared errors/distances
seedInteger, default: 10The randomization seed.

ee.Clusterer.wekaLVQ

A Clusterer that implements the Learning Vector Quantization algorithm. For more details, see:

T. Kohonen, "Learning Vector Quantization", The Handbook of Brain Theory and Neural Networks, 2nd Edition, MIT Press, 2003, pp. 631-634.

UsageReturns
ee.Clusterer.wekaLVQ(numClusters, learningRate, epochs, normalizeInput)Clusterer
ArgumentTypeDetails
numClustersInteger, default: 7The number of clusters.
learningRateFloat, default: 1The learning rate for the training algorithm. (Value should be greaterthan 0 and less or equal to 1).
epochsInteger, default: 1000Number of training epochs. (Value should be greater than or equal to 1).
normalizeInputBoolean, default: falseSkip normalizing the attributes.

ee.Clusterer.wekaXMeans

X-Means is K-Means with an efficient estimation of the number of clusters. For more information see:

Dan Pelleg, Andrew W. Moore: X-means: Extending K-means with Efficient Estimation of the Number of Clusters. In: Seventeenth International Conference on Machine Learning, 727-734, 2000.

UsageReturns
ee.Clusterer.wekaXMeans(minClusters, maxClusters, maxIterations, maxKMeans, maxForChildren, useKD, cutoffFactor, distanceFunction, seed)Clusterer
ArgumentTypeDetails
minClustersInteger, default: 2Minimum number of clusters.
maxClustersInteger, default: 8Maximum number of clusters.
maxIterationsInteger, default: 3Maximum number of overall iterations.
maxKMeansInteger, default: 1000The maximum number of iterations to perform in KMeans.
maxForChildrenInteger, default: 1000The maximum number of iterations in KMeans that is performed on the child centers.
useKDBoolean, default: falseUse a KDTree.
cutoffFactorFloat, default: 0Takes the given percentage of the split centroids if none of the children win.
distanceFunctionString, default: "Euclidean"Distance function to use. Options are: Chebyshev, Euclidean & Manhattan.
seedInteger, default: 10The randomization seed.

ee.ConfusionMatrix

Creates a confusion matrix. Axis 0 (the rows) of the matrix correspond to the actual values, and Axis 1 (the columns) to the predicted values.

UsageReturns
ee.ConfusionMatrix(array, order)ConfusionMatrix
ArgumentTypeDetails
arrayObjectA square, 2D array of integers, representing the confusion matrix.
orderList, default: nullThe row and column size and order, for non-contiguous or non-zero based matrices.

ee.ConfusionMatrix.accuracy

Computes the overall accuracy of a confusion matrix defined as correct / total.

UsageReturns
ConfusionMatrix.accuracy()Float
ArgumentTypeDetails
this: confusionMatrixConfusionMatrix

ee.ConfusionMatrix.array

Returns a confusion matrix as an Array.

UsageReturns
ConfusionMatrix.array()Array
ArgumentTypeDetails
this: confusionMatrixConfusionMatrix

ee.ConfusionMatrix.consumersAccuracy

Computes the consumer's accuracy (reliability) of a confusion matrix defined as (correct / total) for each row.

UsageReturns
ConfusionMatrix.consumersAccuracy()Array
ArgumentTypeDetails
this: confusionMatrixConfusionMatrix

ee.ConfusionMatrix.fscore

Computes the Fβ-score for the confusion matrix.

UsageReturns
ConfusionMatrix.fscore(beta)Array
ArgumentTypeDetails
this: confusionMatrixConfusionMatrix
betaFloat, default: 1A factor indicating how much more important recall is than precision. The standard F-score is equivalent to setting β to one.

ee.ConfusionMatrix.kappa

Computes the Kappa statistic for the confusion matrix.

UsageReturns
ConfusionMatrix.kappa()Float
ArgumentTypeDetails
this: confusionMatrixConfusionMatrix

ee.ConfusionMatrix.order

Returns the name and order of the rows and columns of the matrix.

UsageReturns
ConfusionMatrix.order()List
ArgumentTypeDetails
this: confusionMatrixConfusionMatrix

ee.ConfusionMatrix.producersAccuracy

Computes the producer's accuracy of a confusion matrix defined as (correct / total) for each column.

UsageReturns
ConfusionMatrix.producersAccuracy()Array
ArgumentTypeDetails
this: confusionMatrixConfusionMatrix

ee.Date

Constructs a new Date object.

UsageReturns
ee.Date(date, tz)Date
ArgumentTypeDetails
dateComputedObject|Date|Number|StringThe date to convert, one of: a number (number of milliseconds since the epoch), an ISO Date string, a JavaScript Date or a ComputedObject.
tzString, optionalAn optional timezone only to be used with a string date.

ee.Date.advance

Create a new Date by adding the specified units to the given Date.

UsageReturns
Date.advance(delta, unit, timeZone)Date
ArgumentTypeDetails
this: dateDate
deltaFloat
unitStringOne of 'year', 'month' 'week', 'day', 'hour', 'minute', or 'second'.
timeZoneString, default: nullThe time zone (e.g. 'America/Los_Angeles'); defaults to UTC.

ee.Date.aside

Calls a function passing this object as the first argument, and returning itself. Convenient e.g. when debugging:

var c = ee.ImageCollection('foo').aside(print)

.filterDate('2001-01-01', '2002-01-01').aside(print, 'In 2001')

.filterBounds(geom).aside(print, 'In region')

.aside(Map.addLayer, {min: 0, max: 142}, 'Filtered')

.select('a', 'b');

Returns the same object, for chaining.

UsageReturns
Date.aside(func, var_args)ComputedObject
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
funcFunctionThe function to call.
var_argsVarArgsAny extra arguments to pass to the function.

ee.Date.difference

Returns the difference between two Dates in the specified units; the result is floating-point and based on the average length of the unit.

UsageReturns
Date.difference(start, unit)Float
ArgumentTypeDetails
this: dateDate
startDate
unitStringOne of 'year', 'month' 'week', 'day', 'hour', 'minute', or 'second'.

ee.Date.evaluate

Asynchronously retrieves the value of this object from the server and passes it to the provided callback function.

UsageReturns
Date.evaluate(callback)
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunctionA function of the form function(success, failure), called when the server returns an answer. If the request succeeded, the success argument contains the evaluated result. If the request failed, the failure argument will contains an error message.

ee.Date.format

Convert a date to string.

UsageReturns
Date.format(format, timeZone)String
ArgumentTypeDetails
this: dateDate
formatString, default: nullA pattern, as described at http://joda-time.sourceforge.net/apidocs/org/joda/time/format/DateTimeFormat.html; if omitted will use ISO standard date formatting.
timeZoneString, default: nullThe time zone (e.g. 'America/Los_Angeles'); defaults to UTC.

ee.Date.fromYMD

Returns a Date given year, month, day.

UsageReturns
ee.Date.fromYMD(year, month, day, timeZone)Date
ArgumentTypeDetails
yearInteger
monthInteger
dayInteger
timeZoneString, default: nullThe time zone (e.g. 'America/Los_Angeles'); defaults to UTC.

ee.Date.get

Returns the specified unit of this date.

UsageReturns
Date.get(unit, timeZone)Long
ArgumentTypeDetails
this: dateDate
unitStringOne of 'year', 'month' (returns 1-12), 'week' (1-53), 'day' (1-31), 'hour' (0-23), 'minute' (0-59), or 'second' (0-59).
timeZoneString, default: nullThe time zone (e.g. 'America/Los_Angeles'); defaults to UTC.

ee.Date.getFraction

Returns this date's elapsed fraction of the specified unit (between 0 and 1).

UsageReturns
Date.getFraction(unit, timeZone)Float
ArgumentTypeDetails
this: dateDate
unitStringOne of 'year', 'month' 'week', 'day', 'hour', 'minute', or 'second'.
timeZoneString, default: nullThe time zone (e.g. 'America/Los_Angeles'); defaults to UTC.

ee.Date.getInfo

Retrieves the value of this object from the server.

If no callback function is provided, the request is made synchronously. If a callback is provided, the request is made asynchronously.

The asynchronous mode is preferred because the synchronous mode stops all other code (for example, the EE Code Editor UI) while waiting for the server. To make an asynchronous request, evaluate() is preferred over getInfo().

Returns the computed value of this object.

UsageReturns
Date.getInfo(callback)Object
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.Date.getRange

Returns a DateRange covering the unit of the specified type that contains this date, e.g. Date('2013-3-15').getRange('year') returns DateRange('2013-1-1', '2014-1-1').

UsageReturns
Date.getRange(unit, timeZone)DateRange
ArgumentTypeDetails
this: dateDate
unitStringOne of 'year', 'month' 'week', 'day', 'hour', 'minute', or 'second'.
timeZoneString, default: nullThe time zone (e.g. 'America/Los_Angeles'); defaults to UTC.

ee.Date.getRelative

Returns the specified (0-based) unit of this date relative to a larger unit, e.g. getRelative('day', 'year') returns a value between 0 and 365.

UsageReturns
Date.getRelative(unit, inUnit, timeZone)Long
ArgumentTypeDetails
this: dateDate
unitStringOne of 'month' 'week', 'day', 'hour', 'minute', or 'second'.
inUnitStringOne of 'year', 'month' 'week', 'day', 'hour', or 'minute'.
timeZoneString, default: nullThe time zone (e.g. 'America/Los_Angeles'); defaults to UTC.

ee.Date.millis

The number of milliseconds since 1970-01-01T00:00:00Z.

UsageReturns
Date.millis()Long
ArgumentTypeDetails
this: dateDate

ee.Date.parse

Parse a date string, given a string describing its format.

UsageReturns
ee.Date.parse(format, date, timeZone)Date
ArgumentTypeDetails
formatStringA pattern, as described at http://joda-time.sourceforge.net/apidocs/org/joda/time/format/DateTimeFormat.html.
dateStringA string matching the given pattern.
timeZoneString, default: nullThe time zone (e.g. 'America/Los_Angeles'); defaults to UTC.

ee.Date.serialize

Returns the serialized representation of this object.

UsageReturns
Date.serialize(legacy)String
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
legacyBoolean, optionalEnables legacy format.

ee.Date.unitRatio

Returns the ratio of the length of one unit to the length of another, e.g. unitRatio('day', 'minute') returns 1440. Valid units are 'year', 'month' 'week', 'day', 'hour', 'minute', and 'second'.

UsageReturns
ee.Date.unitRatio(numerator, denominator)Float
ArgumentTypeDetails
numeratorString
denominatorString

ee.Date.update

Create a new Date by setting one or more of the units of the given Date to a new value. If a timeZone is given the new value(s) is interpreted in that zone.

UsageReturns
Date.update(year, month, day, hour, minute, second, timeZone)Date
ArgumentTypeDetails
this: dateDate
yearInteger, default: null
monthInteger, default: null
dayInteger, default: null
hourInteger, default: null
minuteInteger, default: null
secondNumber, default: null
timeZoneString, default: nullThe time zone (e.g. 'America/Los_Angeles'); defaults to UTC.

ee.DateRange

Creates a DateRange with the given start (inclusive) and end (exclusive), which may be Dates, numbers (interpreted as milliseconds since 1970-01-01T00:00:00Z), or strings (such as '1996-01-01T08:00'). If 'end' is not specified, a 1-millisecond range starting at 'start' is created.

UsageReturns
ee.DateRange(start, end, timeZone)DateRange
ArgumentTypeDetails
startObject
endObject, default: null
timeZoneString, default: nullIf start and/or end are provided as strings, the time zone in which to interpret them; defaults to UTC.

ee.DateRange.contains

Returns true if the given Date or DateRange is within this DateRange.

UsageReturns
DateRange.contains(other)Boolean
ArgumentTypeDetails
this: dateRangeDateRange
otherObject

ee.DateRange.end

Returns the (exclusive) end of this DateRange.

UsageReturns
DateRange.end()Date
ArgumentTypeDetails
this: dateRangeDateRange

ee.DateRange.intersection

Returns a DateRange that contains all points in the intersection of this DateRange and another.

UsageReturns
DateRange.intersection(other)DateRange
ArgumentTypeDetails
this: dateRangeDateRange
otherDateRange

ee.DateRange.intersects

Returns true if the given DateRange has at least one point in common with this DateRange.

UsageReturns
DateRange.intersects(other)Boolean
ArgumentTypeDetails
this: dateRangeDateRange
otherDateRange

ee.DateRange.isEmpty

Returns true if this DateRange contains no dates (i.e. start >= end).

UsageReturns
DateRange.isEmpty()Boolean
ArgumentTypeDetails
this: dateRangeDateRange

ee.DateRange.isUnbounded

Returns true if this DateRange contains all dates.

UsageReturns
DateRange.isUnbounded()Boolean
ArgumentTypeDetails
this: dateRangeDateRange

ee.DateRange.start

Returns the (inclusive) start of this DateRange.

UsageReturns
DateRange.start()Date
ArgumentTypeDetails
this: dateRangeDateRange

ee.DateRange.unbounded

Returns a DateRange that includes all possible dates.

UsageReturns
ee.DateRange.unbounded()DateRange

No arguments.

ee.DateRange.union

Returns a DateRange that contains all points in the union of this DateRange and another.
UsageReturns
DateRange.union(other)DateRange
ArgumentTypeDetails
this: dateRangeDateRange
otherDateRange

ee.Dictionary

Constructs a new Dictionary.

UsageReturns
ee.Dictionary(dict)Dictionary
ArgumentTypeDetails
dictComputedObject|Object, optionalAn object to convert to a dictionary. This constructor accepts the following types: 1) Another dictionary. 2) A list of key/value pairs. 3) A null or no argument (producing an empty dictionary)

ee.Dictionary.aside

Calls a function passing this object as the first argument, and returning itself. Convenient e.g. when debugging:

var c = ee.ImageCollection('foo').aside(print)

.filterDate('2001-01-01', '2002-01-01').aside(print, 'In 2001')

.filterBounds(geom).aside(print, 'In region')

.aside(Map.addLayer, {min: 0, max: 142}, 'Filtered')

.select('a', 'b');

Returns the same object, for chaining.

UsageReturns
Dictionary.aside(func, var_args)ComputedObject
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
funcFunctionThe function to call.
var_argsVarArgsAny extra arguments to pass to the function.

ee.Dictionary.combine

Combines two dictionaries. In the case of duplicate names, the output will contain the value of the second dictionary unless overwrite is false. Null values in both dictionaries are ignored / removed.

UsageReturns
Dictionary.combine(second, overwrite)Dictionary
ArgumentTypeDetails
this: firstDictionary
secondDictionary
overwriteBoolean, default: true

ee.Dictionary.contains

Returns true if the dictionary contains the given key.

UsageReturns
Dictionary.contains(key)Boolean
ArgumentTypeDetails
this: dictionaryDictionary
keyString, default: null

ee.Dictionary.evaluate

Asynchronously retrieves the value of this object from the server and passes it to the provided callback function.

UsageReturns
Dictionary.evaluate(callback)
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunctionA function of the form function(success, failure), called when the server returns an answer. If the request succeeded, the success argument contains the evaluated result. If the request failed, the failure argument will contains an error message.

ee.Dictionary.fromLists

Construct a dictionary from two parallel lists of keys and values.

UsageReturns
ee.Dictionary.fromLists(keys, values)Dictionary
ArgumentTypeDetails
keysList
valuesList

ee.Dictionary.get

Extracts a named value from a dictionary. If the dictionary does not contain the given key, then defaultValue is returned, unless it is null.

UsageReturns
Dictionary.get(key, defaultValue)Object
ArgumentTypeDetails
this: dictionaryDictionary
keyString
defaultValueObject, default: null

ee.Dictionary.getArray

Extracts a named array value from a dictionary.

UsageReturns
Dictionary.getArray(key)Array
ArgumentTypeDetails
this: dictionaryDictionary
keyString

ee.Dictionary.getGeometry

Extracts a named geometry value from a dictionary.

UsageReturns
Dictionary.getGeometry(key)Geometry
ArgumentTypeDetails
this: dictionaryDictionary
keyString

ee.Dictionary.getInfo

Retrieves the value of this object from the server.

If no callback function is provided, the request is made synchronously. If a callback is provided, the request is made asynchronously.

The asynchronous mode is preferred because the synchronous mode stops all other code (for example, the EE Code Editor UI) while waiting for the server. To make an asynchronous request, evaluate() is preferred over getInfo().

Returns the computed value of this object.

UsageReturns
Dictionary.getInfo(callback)Object
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.Dictionary.getNumber

Extracts a named number value from a dictionary.

UsageReturns
Dictionary.getNumber(key)Number
ArgumentTypeDetails
this: dictionaryDictionary
keyString

ee.Dictionary.getString

Extracts a named string value from a dictionary.

UsageReturns
Dictionary.getString(key)String
ArgumentTypeDetails
this: dictionaryDictionary
keyString

ee.Dictionary.keys

Retrieve the keys of a dictionary as a list. The keys will be sorted in natural order.

UsageReturns
Dictionary.keys()List
ArgumentTypeDetails
this: dictionaryDictionary

ee.Dictionary.map

Map an algorithm over a dictionary. The algorithm is expected to take 2 arguments, a key from the existing dictionary and the value it corresponds to, and return a new value for the given key. If the algorithm returns null, the key is dropped.

UsageReturns
Dictionary.map(baseAlgorithm)Dictionary
ArgumentTypeDetails
this: dictionaryDictionary
baseAlgorithmAlgorithm

ee.Dictionary.remove

Returns a dictionary with the specified keys removed.

UsageReturns
Dictionary.remove(selectors, ignoreMissing)Dictionary
ArgumentTypeDetails
this: dictionaryDictionary
selectorsListA list of keys names or regular expressions of key names to remove.
ignoreMissingBoolean, default: falseIgnore selectors that don't match at least 1 key.

ee.Dictionary.rename

Rename elements in a dictionary.

UsageReturns
Dictionary.rename(from, to, overwrite)Dictionary
ArgumentTypeDetails
this: dictionaryDictionary
fromListA list of keys to be renamed.
toListA list of the new names for the keys listed in the 'from' parameter. Must have the same length as the 'from' list.
overwriteBoolean, default: falseAllow overwriting existing properties with the same name.

ee.Dictionary.select

Returns a dictionary with only the specified keys.

UsageReturns
Dictionary.select(selectors, ignoreMissing)Dictionary
ArgumentTypeDetails
this: dictionaryDictionary
selectorsListA list of keys or regular expressions to select.
ignoreMissingBoolean, default: falseIgnore selectors that don't match at least 1 key.

ee.Dictionary.serialize

Returns the serialized representation of this object.

UsageReturns
Dictionary.serialize(legacy)String
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
legacyBoolean, optionalEnables legacy format.

ee.Dictionary.set

Set a value in a dictionary.

UsageReturns
Dictionary.set(key, value)Dictionary
ArgumentTypeDetails
this: dictionaryDictionary
keyString
valueObject

ee.Dictionary.size

Returns the number of entries in a dictionary.

UsageReturns
Dictionary.size()Integer
ArgumentTypeDetails
this: dictionaryDictionary

ee.Dictionary.toArray

Returns numeric values of a dictionary as an array. If no keys are specified, all values are returned in the natural ordering of the dictionary's keys. The default 'axis' is 0.

UsageReturns
Dictionary.toArray(keys, axis)Array
ArgumentTypeDetails
this: dictionaryDictionary
keysList, default: null
axisInteger, default: 0

ee.Dictionary.toImage

Creates an image of constants from values in a dictionary. The bands of the image are ordered and named according to the names argument. If no names are specified, the bands are sorted alpha-numerically.

UsageReturns
Dictionary.toImage(names)Image
ArgumentTypeDetails
this: dictionaryDictionaryThe dictionary to convert.
namesList, default: nullThe order of the output bands.

ee.Dictionary.values

Returns the values of a dictionary as a list. If no keys are specified, all values are returned in the natural ordering of the dictionary's keys.

UsageReturns
Dictionary.values(keys)List
ArgumentTypeDetails
this: dictionaryDictionary
keysList, default: null

ee.ErrorMargin

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'.

ee.Feature

Features can be constructed from one of the following arguments plus an optional dictionary of properties:

  - An ee.Geometry.

  - A GeoJSON Geometry.

  - A GeoJSON Feature.

  - A computed object: reinterpreted as a geometry if properties are specified, and as a feature if they aren't.

UsageReturns
ee.Feature(geometry, properties)Feature
ArgumentTypeDetails
geometryComputedObject|Feature|Geometry|ObjectA geometry or feature.
propertiesObject, optionalA dictionary of metadata properties. If the first parameter is a Feature (instead of a geometry), this is unused.

ee.Feature.area

Returns the area of the feature's default geometry. Area of points and line strings is 0, and the area of multi geometries is the sum of the areas of their components (intersecting areas are counted multiple times).

UsageReturns
Feature.area(maxError, proj)Float
ArgumentTypeDetails
this: featureElementThe feature from which the geometry is taken.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in square meters.

ee.Feature.aside

Calls a function passing this object as the first argument, and returning itself. Convenient e.g. when debugging:

var c = ee.ImageCollection('foo').aside(print)

.filterDate('2001-01-01', '2002-01-01').aside(print, 'In 2001')

.filterBounds(geom).aside(print, 'In region')

.aside(Map.addLayer, {min: 0, max: 142}, 'Filtered')

.select('a', 'b');

Returns the same object, for chaining.

UsageReturns
Feature.aside(func, var_args)ComputedObject
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
funcFunctionThe function to call.
var_argsVarArgsAny extra arguments to pass to the function.

ee.Feature.bounds

Returns a feature containing the bounding box of the geometry of a given feature.

UsageReturns
Feature.bounds(maxError, proj)Feature
ArgumentTypeDetails
this: featureElementThe feature the bound of which is being calculated.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in WGS84.

ee.Feature.buffer

Returns the input buffered by a given distance. If the distance is positive, the geometry is expanded, and if the distance is negative, the geometry is contracted.

UsageReturns
Feature.buffer(distance, maxError, proj)Feature
ArgumentTypeDetails
this: featureElementThe feature the geometry of which is being buffered.
distanceFloatThe distance of the buffering, which may be negative. If no projection is specified, the unit is meters. Otherwise the unit is in the coordinate system of the projection.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when approximating the buffering circle and performing any necessary reprojection. If unspecified, defaults to 1% of the distance.
projProjection, default: nullIf specified, the buffering will be performed in this projection and the distance will be interpreted as units of the coordinate system of this projection. Otherwise the distance is interpereted as meters and the buffering is performed in a spherical coordinate system.

ee.Feature.centroid

Returns a feature containing the point at the center of the highest-dimension components of the geometry of a feature. Lower-dimensional components are ignored, so the centroid of a geometry containing two polygons, three lines and a point is equivalent to the centroid of a geometry containing just the two polygons.

UsageReturns
Feature.centroid(maxError, proj)Feature
ArgumentTypeDetails
this: featureElementCalculates the centroid of this feature's default geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in WGS84.

ee.Feature.containedIn

Returns true if and only if the geometry of one feature is contained in the geometry of another.

UsageReturns
Feature.containedIn(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftElementThe feature containing the geometry used as the left operand of the operation.
rightElementThe feature containing the geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Feature.contains

Returns true if and only if the geometry of one feature contains the geometry of another.

UsageReturns
Feature.contains(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftElementThe feature containing the geometry used as the left operand of the operation.
rightElementThe feature containing the geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Feature.convexHull

Returns the feature, with the geometry replaced by the convex hull of the original geometry. The convex hull of a single point is the point itself, the convex hull of collinear points is a line, and the convex hull of everything else is a polygon. Note that a degenerate polygon with all vertices on the same line will result in a line segment.

UsageReturns
Feature.convexHull(maxError, proj)Feature
ArgumentTypeDetails
this: featureElementThe feature containing the geometry whole hull is being calculated.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Feature.copyProperties

Copies metadata properties from one element to another.

UsageReturns
Feature.copyProperties(source, properties, exclude)Element
ArgumentTypeDetails
this: destinationElement, default: nullThe object whose properties to override.
sourceElement, default: nullThe object from which to copy the properties.
propertiesList, default: nullThe properties to copy. If omitted, all ordinary (i.e. non-system) properties are copied.
excludeList, default: nullThe list of properties to exclude when copying all properties. Must not be specified if properties is.

ee.Feature.cutLines

Converts LineString, MultiLineString, and LinearRing geometries into a MultiLineString by cutting them into parts no longer than the given distance along their length. All other geometry types will be converted to an empty MultiLineString.

UsageReturns
Feature.cutLines(distances, maxError, proj)Feature
ArgumentTypeDetails
this: featureElementCuts the lines of this feature's default geometry.
distancesListDistances along each LineString to cut the line into separate pieces, measured in units of the given proj, or meters if proj is unspecified.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullProjection of the result and distance measurements, or WGS84 if unspecified.

ee.Feature.difference

Returns a feature with the properties of the 'left' feature, and the geometry that results from subtracting the 'right' geometry from the 'left' geometry.

UsageReturns
Feature.difference(right, maxError, proj)Feature
ArgumentTypeDetails
this: leftElementThe feature containing the geometry used as the left operand of the operation. The properties of the result will be copied from this object.
rightElementThe feature containing the geometry used as the right operand of the operation. The properties of this object are ignored.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Feature.disjoint

Returns true if and only if the feature geometries are disjoint.

UsageReturns
Feature.disjoint(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftElementThe feature containing the geometry used as the left operand of the operation.
rightElementThe feature containing the geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Feature.dissolve

Returns a feature containing the union of the geometry of a feature. This leaves single geometries untouched, and unions multi geometries.

UsageReturns
Feature.dissolve(maxError, proj)Element
ArgumentTypeDetails
this: featureElementThe feature the geometry of which is being unioned.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the union will be performed in this projection. Otherwise it will be performed in a spherical coordinate system.

ee.Feature.distance

Returns the minimum distance between the geometries of two features.

UsageReturns
Feature.distance(right, maxError, proj)Float
ArgumentTypeDetails
this: leftElementThe feature containing the geometry used as the left operand of the operation.
rightElementThe feature containing the geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Feature.evaluate

Asynchronously retrieves the value of this object from the server and passes it to the provided callback function.

UsageReturns
Feature.evaluate(callback)
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunctionA function of the form function(success, failure), called when the server returns an answer. If the request succeeded, the success argument contains the evaluated result. If the request failed, the failure argument will contains an error message.

ee.Feature.geometry

Returns the geometry of a given feature in a given projection.

UsageReturns
Feature.geometry(maxError, proj, geodesics)Geometry
ArgumentTypeDetails
this: featureElementThe feature from which the geometry is taken.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the geometry will be in this projection. If unspecified, the geometry will be in its default projection.
geodesicsBoolean, default: nullIf true, the geometry will have geodesic edges. If false, it will have edges as straight lines in the specified projection. If null, the edge interpretation will be the same as the original geometry. This argument is ignored if proj is not specified.

ee.Feature.get

Extract a property from a feature.

UsageReturns
Feature.get(property)
ArgumentTypeDetails
this: objectElementThe feature to extract the property from.
propertyStringThe property to extract.

ee.Feature.getArray

Extract a property from a feature.

UsageReturns
Feature.getArray(property)Array
ArgumentTypeDetails
this: objectElementThe feature to extract the property from.
propertyStringThe property to extract.

ee.Feature.getInfo

An imperative function that returns information about this feature via an AJAX call.

Returns a description of the feature.

UsageReturns
Feature.getInfo(callback)GeoJSONFeature
ArgumentTypeDetails
this: featureFeatureThe Feature instance.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously. If supplied, will be called with the first parameter if successful and the second if unsuccessful.

ee.Feature.getMapId

An imperative function that returns a map ID and optional token, suitable for generating a Map overlay.

Returns an object which may be passed to ee.data.getTileUrl or ui.Map.addLayer, including an additional 'image' field, containing a Collection.draw image wrapping a FeatureCollection containing this feature. Undefined if a callback was specified.

UsageReturns
Feature.getMapId(visParams, callback)MapId|Object
ArgumentTypeDetails
this: featureFeatureThe Feature instance.
visParamsObject, optionalThe visualization parameters. Currently only one parameter, 'color', containing an RGB color string is allowed. If visParams is not specified, black ("000000") is used.
callbackFunction, optionalAn async callback.

ee.Feature.getNumber

Extract a property from a feature.

UsageReturns
Feature.getNumber(property)Number
ArgumentTypeDetails
this: objectElementThe feature to extract the property from.
propertyStringThe property to extract.

ee.Feature.getString

Extract a property from a feature.

UsageReturns
Feature.getString(property)String
ArgumentTypeDetails
this: objectElementThe feature to extract the property from.
propertyStringThe property to extract.

ee.Feature.hersDescriptor

Creates a dictionary of Histogram Error Ring Statistic (HERS) descriptor arrays from square array properties of an element. The HERS radius is taken to be the array's (side_length - 1) / 2.

UsageReturns
Feature.hersDescriptor(selectors, buckets, peakWidthScale)Dictionary
ArgumentTypeDetails
this: elementElementThe element with array properties.
selectorsList, default: nullThe array properties for which descriptors will be created. Selected array properties must be square, floating point arrays. Defaults to all array properties.
bucketsInteger, default: 100The number of HERS buckets. Defaults to 100.
peakWidthScaleFloat, default: 1The HERS peak width scale. Defaults to 1.0.

ee.Feature.id

Returns the ID of a given element within a collection. Objects outside collections are not guaranteed to have IDs.

UsageReturns
Feature.id()String
ArgumentTypeDetails
this: elementElementThe element from which the ID is taken.

ee.Feature.intersection

Returns a feature containing the intersection of the geometries of two features, with the properties of the left feature.

UsageReturns
Feature.intersection(right, maxError, proj)Feature
ArgumentTypeDetails
this: leftElementThe feature containing the geometry used as the left operand of the operation. The properties of the result will be copied from this object.
rightElementThe feature containing the geometry used as the right operand of the operation. The properties of this object are ignored.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Feature.intersects

Returns true if and only if the feature geometries intersect.

UsageReturns
Feature.intersects(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftElementThe feature containing the geometry used as the left operand of the operation.
rightElementThe feature containing the geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Feature.length

Returns the length of the linear parts of the geometry of a given feature. Polygonal parts are ignored. The length of multi geometries is the sum of the lengths of their components.

UsageReturns
Feature.length(maxError, proj)Float
ArgumentTypeDetails
this: featureElementThe feature from which the geometry is taken.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in meters.

ee.Feature.perimeter

Returns the length of the perimeter of the polygonal parts of the geometry of a given feature. The perimeter of multi geometries is the sum of the perimeters of their components.

UsageReturns
Feature.perimeter(maxError, proj)Float
ArgumentTypeDetails
this: featureElementThe feature from which the geometry is taken.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in meters.

ee.Feature.propertyNames

Returns the names of properties on this element.

UsageReturns
Feature.propertyNames()List
ArgumentTypeDetails
this: elementElement

ee.Feature.select

Selects properties from a feature by name or RE2-compatible regex and optionally renames them.

UsageReturns
Feature.select(propertySelectors, newProperties, retainGeometry)Element
ArgumentTypeDetails
this: inputElementThe feature to select properties from.
propertySelectorsListA list of names or regexes specifying the properties to select.
newPropertiesList, default: nullOptional new names for the output properties. Must match the number of properties selected.
retainGeometryBoolean, default: trueWhen false, the result will have a NULL geometry.

ee.Feature.serialize

Returns the serialized representation of this object.

UsageReturns
Feature.serialize(legacy)String
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
legacyBoolean, optionalEnables legacy format.

ee.Feature.set

Overrides one or more metadata properties of an Element.

Returns the element with the specified properties overridden.

UsageReturns
Feature.set(var_args)Element
ArgumentTypeDetails
this: elementElementThe Element instance.
var_argsVarArgsEither a dictionary of properties, or a vararg sequence of properties, e.g. key1, value1, key2, value2, ...

ee.Feature.setGeometry

Returns the feature, with the geometry replaced by the specified geometry.

UsageReturns
Feature.setGeometry(geometry)Element
ArgumentTypeDetails
this: featureElementThe feature on which to set the geometry.
geometryGeometry, default: nullThe geometry to set.

ee.Feature.simplify

Simplifies the geometry of a feature to within a given error margin. Note that this does not respect the error margin requested by the consumer of this algorithm, unless maxError is explicitly specified to be null.

This overrides the default Earth Engine policy for propagating error margins, so regardless of the geometry accuracy requested from the output, the inputs will be requested with the error margin specified in the arguments to this algorithm. This results in consistent rendering at all zoom levels of a rendered vector map, but at lower zoom levels (i.e. zoomed out), the geometry won't be simplified, which may harm performance.

UsageReturns
Feature.simplify(maxError, proj)Feature
ArgumentTypeDetails
this: featureElementThe feature whose geometry is being simplified.
maxErrorErrorMarginThe maximum amount of error by which the result may differ from the input.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in the same projection as the input. If the error margin is in projected units, the margin will be interpreted as units of this projection

ee.Feature.symmetricDifference

Returns a feature containing the symmetric difference between geometries of two features.

UsageReturns
Feature.symmetricDifference(right, maxError, proj)Feature
ArgumentTypeDetails
this: leftElementThe feature containing the geometry used as the left operand of the operation. The properties of the result will be copied from this object.
rightElementThe feature containing the geometry used as the right operand of the operation. The properties of this object are ignored.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Feature.toArray

Creates an array from the given properties of an object, which must all be numbers.

UsageReturns
Feature.toArray(properties)Array
ArgumentTypeDetails
this: featureFeatureThe object from which to select array properties.
propertiesListThe property selectors for each array element.

ee.Feature.toDictionary

Extract properties from a feature as a dictionary.

UsageReturns
Feature.toDictionary(properties)Dictionary
ArgumentTypeDetails
this: elementElementThe feature to extract the property from.
propertiesList, default: nullThe list of properties to extract. Defaults to all non-system properties.

ee.Feature.transform

Transforms the geometry of a feature to a specific projection.

UsageReturns
Feature.transform(proj, maxError)Feature
ArgumentTypeDetails
this: featureElementThe feature the geometry of which is being converted.
projProjection, optionalThe target projection. Defaults to WGS84. If this has a geographic CRS, the edges of the geometry will be interpreted as geodesics. Otherwise they will be interpreted as straight lines in the projection.
maxErrorErrorMargin, default: nullThe maximum projection error.

ee.Feature.union

Returns a feature containing the union of the geometries of two features.

UsageReturns
Feature.union(right, maxError, proj)Feature
ArgumentTypeDetails
this: leftElementThe feature containing the geometry used as the left operand of the operation. The properties of the result will be copied from this object.
rightElementThe feature containing the geometry used as the right operand of the operation. The properties of this object are ignored.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Feature.withinDistance

Returns true if and only if the geometries of two features are within a specified distance.

UsageReturns
Feature.withinDistance(right, distance, maxError, proj)Boolean
ArgumentTypeDetails
this: leftElementThe feature containing the geometry used as the left operand of the operation.
rightElementThe feature containing the geometry used as the right operand of the operation.
distanceFloatThe distance threshold. If a projection is specified, the distance is in units of that projected coordinate system, otherwise it is in meters.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.FeatureCollection

FeatureCollections can be constructed from the following arguments:

  - A string: assumed to be the name of a collection.

  - A single geometry.

  - A single feature.

  - A list of features.

  - A GeoJSON FeatureCollection

  - A computed object: reinterpreted as a collection.

UsageReturns
ee.FeatureCollection(args, column)FeatureCollection
ArgumentTypeDetails
argsComputedObject|Feature|FeatureCollection|Geometry|ListThe constructor arguments.
columnString, optionalThe name of the geometry column to use. Only useful when working with a named collection.

ee.FeatureCollection.aggregate_array

Aggregates over a given property of the objects in a collection, calculating a list of all the values of the selected property.

UsageReturns
FeatureCollection.aggregate_array(property)List
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.FeatureCollection.aggregate_count

Aggregates over a given property of the objects in a collection, calculating the number of non-null values of the property.

UsageReturns
FeatureCollection.aggregate_count(property)Number
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.FeatureCollection.aggregate_count_distinct

Aggregates over a given property of the objects in a collection, calculating the number of distinct values for the selected property.

UsageReturns
FeatureCollection.aggregate_count_distinct(property)Number
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.FeatureCollection.aggregate_first

Aggregates over a given property of the objects in a collection, calculating the property value of the first object in the collection.

UsageReturns
FeatureCollection.aggregate_first(property)
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.FeatureCollection.aggregate_histogram

Aggregates over a given property of the objects in a collection, calculating a histogram of the selected property.

UsageReturns
FeatureCollection.aggregate_histogram(property)Dictionary
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.FeatureCollection.aggregate_max

Aggregates over a given property of the objects in a collection, calculating the maximum of the values of the selected property.

UsageReturns
FeatureCollection.aggregate_max(property)
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.FeatureCollection.aggregate_mean

Aggregates over a given property of the objects in a collection, calculating the mean of the selected property.

UsageReturns
FeatureCollection.aggregate_mean(property)Number
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.FeatureCollection.aggregate_min

Aggregates over a given property of the objects in a collection, calculating the minimum of the values of the selected property.

UsageReturns
FeatureCollection.aggregate_min(property)
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.FeatureCollection.aggregate_product

Aggregates over a given property of the objects in a collection, calculating the product of the values of the selected property.

UsageReturns
FeatureCollection.aggregate_product(property)Number
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.FeatureCollection.aggregate_sample_sd

Aggregates over a given property of the objects in a collection, calculating the sample std. deviation of the values of the selected property.

UsageReturns
FeatureCollection.aggregate_sample_sd(property)Number
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.FeatureCollection.aggregate_sample_var

Aggregates over a given property of the objects in a collection, calculating the sample variance of the values of the selected property.

UsageReturns
FeatureCollection.aggregate_sample_var(property)Number
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.FeatureCollection.aggregate_stats

Aggregates over a given property of the objects in a collection, calculating the sum, min, max, mean, sample standard deviation, sample variance, total standard deviation and total variance of the selected property.

UsageReturns
FeatureCollection.aggregate_stats(property)Dictionary
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.FeatureCollection.aggregate_sum

Aggregates over a given property of the objects in a collection, calculating the sum of the values of the selected property.

UsageReturns
FeatureCollection.aggregate_sum(property)Number
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.FeatureCollection.aggregate_total_sd

Aggregates over a given property of the objects in a collection, calculating the total std. deviation of the values of the selected property.

UsageReturns
FeatureCollection.aggregate_total_sd(property)Number
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.FeatureCollection.aggregate_total_var

Aggregates over a given property of the objects in a collection, calculating the total variance of the values of the selected property.

UsageReturns
FeatureCollection.aggregate_total_var(property)Number
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.FeatureCollection.aside

Calls a function passing this object as the first argument, and returning itself. Convenient e.g. when debugging:

var c = ee.ImageCollection('foo').aside(print)

.filterDate('2001-01-01', '2002-01-01').aside(print, 'In 2001')

.filterBounds(geom).aside(print, 'In region')

.aside(Map.addLayer, {min: 0, max: 142}, 'Filtered')

.select('a', 'b');

Returns the same object, for chaining.

UsageReturns
FeatureCollection.aside(func, var_args)ComputedObject
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
funcFunctionThe function to call.
var_argsVarArgsAny extra arguments to pass to the function.

ee.FeatureCollection.classify

Classifies each feature in a collection.

UsageReturns
FeatureCollection.classify(classifier, outputName)FeatureCollection
ArgumentTypeDetails
this: featuresFeatureCollectionThe collection of features to classify. Each feature must contain all the properties in the classifier's schema.
classifierClassifierThe classifier to use.
outputNameString, default: "classification"The name of the output property to be added. This argument is ignored if the classifier has more than one output.

ee.FeatureCollection.cluster

Clusters each feature in a collection, adding a new column to each feature containing the cluster number to which it has been assigned.

UsageReturns
FeatureCollection.cluster(clusterer, outputName)FeatureCollection
ArgumentTypeDetails
this: featuresFeatureCollectionThe collection of features to cluster. Each feature must contain all the properties in the clusterer's schema.
clustererClustererThe clusterer to use.
outputNameString, default: "cluster"The name of the output property to be added.

ee.FeatureCollection.copyProperties

Copies metadata properties from one element to another.

UsageReturns
FeatureCollection.copyProperties(source, properties, exclude)Element
ArgumentTypeDetails
this: destinationElement, default: nullThe object whose properties to override.
sourceElement, default: nullThe object from which to copy the properties.
propertiesList, default: nullThe properties to copy. If omitted, all ordinary (i.e. non-system) properties are copied.
excludeList, default: nullThe list of properties to exclude when copying all properties. Must not be specified if properties is.

ee.FeatureCollection.distance

Produces a DOUBLE image where each pixel is the distance in meters from the pixel center to the nearest Point, LineString, or polygonal boundary in the collection. Note distance is also measured within interiors of polygons. Pixels that are not within 'searchRadius' meters of a geometry will be masked out.

Distances are computed on a sphere, so there is a small error proportional to the latitude difference between each pixel and the nearest geometry.

UsageReturns
FeatureCollection.distance(searchRadius, maxError)Image
ArgumentTypeDetails
this: featuresFeatureCollectionFeature collection from which to get features used to compute pixel distances.
searchRadiusFloat, default: 100000Maximum distance in meters from each pixel to look for edges. Pixels will be masked unless there are edges within this distance.
maxErrorFloat, default: 100Maximum reprojection error in meters, only used if the input polylines require reprojection. If '0' is provided, then this operation will fail if projection is required.

ee.FeatureCollection.distinct

Removes duplicates from a collection. Note that duplicates are determined using a strong hash over the serialized form of the selected properties.

UsageReturns
FeatureCollection.distinct(properties)FeatureCollection
ArgumentTypeDetails
this: collectionFeatureCollectionThe input collection from which objects will be selected.
propertiesObjectA property name or a list of property names to use for comparison. The '.geo' property can be included to compare object geometries.

ee.FeatureCollection.draw

Paints a vector collection for visualization. Not intended for use as input to other algorithms.

UsageReturns
FeatureCollection.draw(color, pointRadius, strokeWidth)Image
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to draw.
colorStringA hex string in the format RRGGBB specifying the color to use for drawing the features.
pointRadiusInteger, default: 3The radius in pixels of the point markers.
strokeWidthInteger, default: 2The width in pixels of lines and polygon borders.

ee.FeatureCollection.errorMatrix

Computes a 2D error matrix for a collection by comparing two columns of a collection: one containing the actual values, and one containing predicted values.The values are expected to be small contiguous integers, starting from 0. Axis 0 (the rows) of the matrix correspond to the actual values, and Axis 1 (the columns) to the predicted values.

UsageReturns
FeatureCollection.errorMatrix(actual, predicted, order)ConfusionMatrix
ArgumentTypeDetails
this: collectionFeatureCollectionThe input collection.
actualStringThe name of the property containing the actual value.
predictedStringThe name of the property containing the predicted value.
orderList, default: nullA list of the expected values. If this argument is not specified, the values are assumed to be contiguous and span the range 0 to maxValue. If specified, only values matching this list are used, and the matrix will have dimensions and order matching the this list.

ee.FeatureCollection.evaluate

Asynchronously retrieves the value of this object from the server and passes it to the provided callback function.

UsageReturns
FeatureCollection.evaluate(callback)
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunctionA function of the form function(success, failure), called when the server returns an answer. If the request succeeded, the success argument contains the evaluated result. If the request failed, the failure argument will contains an error message.

ee.FeatureCollection.filter

Apply a filter to this collection.

Returns the filtered collection.

UsageReturns
FeatureCollection.filter(filter)Collection
ArgumentTypeDetails
this: collectionCollectionThe Collection instance.
filterFilterA filter to apply to this collection.

ee.FeatureCollection.filterBounds

Shortcut to filter a collection by intersection with geometry. Items in the collection with a footprint that fails to intersect the given geometry will be excluded.

This is equivalent to this.filter(ee.Filter.bounds(...)).

Returns the filtered collection.

UsageReturns
FeatureCollection.filterBounds(geometry)Collection
ArgumentTypeDetails
this: collectionCollectionThe Collection instance.
geometryComputedObject|FeatureCollection|GeometryThe geometry, feature or collection to intersect with.

ee.FeatureCollection.filterDate

Shortcut to filter a collection by a date range. The start and end may be Dates, numbers (interpreted as milliseconds since 1970-01-01T00:00:00Z), or strings (such as '1996-01-01T08:00'). Based on 'system:time_start'.

This is equivalent to this.filter(ee.Filter.date(...)); see the ee.Filter type for other date filtering options.

Returns the filtered collection.

UsageReturns
FeatureCollection.filterDate(start, end)Collection
ArgumentTypeDetails
this: collectionCollectionThe Collection instance.
startDate|Number|StringThe start date (inclusive).
endDate|Number|String, optionalThe end date (exclusive). Optional. If not specified, a 1-millisecond range starting at 'start' is created.

ee.FeatureCollection.first

Returns the first entry from a given collection.

UsageReturns
FeatureCollection.first()Element
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection from which to select the first entry.

ee.FeatureCollection.flatten

Flattens collections of collections.

UsageReturns
FeatureCollection.flatten()FeatureCollection
ArgumentTypeDetails
this: collectionFeatureCollectionThe input collection of collections.

ee.FeatureCollection.geometry

Extracts and merges the geometries of a collection. Requires that all the geometries in the collection share the projection and edge interpretation.

UsageReturns
FeatureCollection.geometry(maxError)Geometry
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection whose geometries will be extracted.
maxErrorErrorMargin, optionalAn error margin to use when merging geometries.

ee.FeatureCollection.get

Extract a property from a feature.

UsageReturns
FeatureCollection.get(property)
ArgumentTypeDetails
this: objectElementThe feature to extract the property from.
propertyStringThe property to extract.

ee.FeatureCollection.getArray

Extract a property from a feature.

UsageReturns
FeatureCollection.getArray(property)Array
ArgumentTypeDetails
this: objectElementThe feature to extract the property from.
propertyStringThe property to extract.

ee.FeatureCollection.getDownloadURL

Gets a download URL. When the URL is accessed, the FeatureCollection is downloaded in one of several formats.

Returns a download URL or undefined if a callback was specified.

UsageReturns
FeatureCollection.getDownloadURL(format, selectors, filename, callback)Object|String
ArgumentTypeDetails
this: featurecollectionFeatureCollectionThe FeatureCollection instance.
formatString, optionalThe format of download, one of: "csv", "json", "geojson", "kml", "kmz" ("json" outputs GeoJSON). If unspecified, defaults to "csv".
selectorsList, optionalFeature property names used to select the attributes to be downloaded. If unspecified, all properties are included.
filenameString, optionalName of the file to be downloaded; extension is appended by default. If unspecified, defaults to "table".
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.FeatureCollection.getInfo

An imperative function that returns all the known information about this collection via an AJAX call.

Returns a collection description whose fields include:

  - features: a list containing metadata about the features in the collection.

  - properties: an optional dictionary containing the collection's metadata properties.

UsageReturns
FeatureCollection.getInfo(callback)FeatureCollectionDescription
ArgumentTypeDetails
this: featurecollectionFeatureCollectionThe FeatureCollection instance.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously. If supplied, will be called with the first parameter if successful and the second if unsuccessful.

ee.FeatureCollection.getMapId

An imperative function that returns a map ID and optional token, suitable for generating a Map overlay.

Returns an object which may be passed to ee.data.getTileUrl or ui.Map.addLayer, including an additional 'image' field, containing a Collection.draw image wrapping a FeatureCollection containing this feature. Undefined if a callback was specified.

UsageReturns
FeatureCollection.getMapId(visParams, callback)MapId|Object
ArgumentTypeDetails
this: featurecollectionFeatureCollectionThe FeatureCollection instance.
visParamsObject, optionalThe visualization parameters. Currently only one parameter, 'color', containing an RGB color string is allowed. If visParams is not specified, black ("000000") is used.
callbackFunction, optionalAn async callback.

ee.FeatureCollection.getNumber

Extract a property from a feature.

UsageReturns
FeatureCollection.getNumber(property)Number
ArgumentTypeDetails
this: objectElementThe feature to extract the property from.
propertyStringThe property to extract.

ee.FeatureCollection.getString

Extract a property from a feature.

UsageReturns
FeatureCollection.getString(property)String
ArgumentTypeDetails
this: objectElementThe feature to extract the property from.
propertyStringThe property to extract.

ee.FeatureCollection.inverseDistance

Returns an inverse-distance weighted estimate of the value at each pixel.

UsageReturns
FeatureCollection.inverseDistance(range, propertyName, mean, stdDev, gamma, reducer)Image
ArgumentTypeDetails
this: collectionFeatureCollectionFeature collection to use as source data for the estimation.
rangeFloatSize of the interpolation window (in meters).
propertyNameStringName of the numeric property to be estimated.
meanFloatGlobal expected mean.
stdDevFloatGlobal standard deviation.
gammaFloat, default: 1Determines how quickly the estimates tend towards the global mean.
reducerReducer, default: nullReducer used to collapse the 'propertyName' value of overlapping points into a single value.

ee.FeatureCollection.iterate

Applies a user-supplied function to each element of a collection. The user-supplied function is given two arguments: the current element, and the value returned by the previous call to iterate() or the first argument, for the first iteration. The result is the value returned by the final call to the user-supplied function.

Returns the result of the Collection.iterate() call.

UsageReturns
FeatureCollection.iterate(algorithm, first)ComputedObject
ArgumentTypeDetails
this: collectionCollectionThe Collection instance.
algorithmFunctionThe function to apply to each element. Must take two arguments: an element of the collection and the value from the previous iteration.
firstObject, optionalThe initial state.

ee.FeatureCollection.kriging

Returns the results of sampling a Kriging estimator at each pixel.

UsageReturns
FeatureCollection.kriging(propertyName, shape, range, sill, nugget, maxDistance, reducer)Image
ArgumentTypeDetails
this: collectionFeatureCollectionFeature collection to use as source data for the estimation.
propertyNameStringProperty to be estimated (must be numeric).
shapeStringSemivariogram shape (one of {exponential, gaussian, spherical}).
rangeFloatSemivariogram range, in meters.
sillFloatSemivariogram sill.
nuggetFloatSemivariogram nugget.
maxDistanceFloat, default: nullRadius which determines which features are included in each pixel's computation, in meters. Defaults to the semivariogram's range.
reducerReducer, default: nullReducer used to collapse the 'propertyName' value of overlapping points into a single value.

ee.FeatureCollection.limit

Limit a collection to the specified number of elements, optionally sorting them by a specified property first.

Returns the limited collection.

UsageReturns
FeatureCollection.limit(max, property, ascending)Collection
ArgumentTypeDetails
this: collectionCollectionThe Collection instance.
maxNumberThe number to limit the collection to.
propertyString, optionalThe property to sort by, if sorting.
ascendingBoolean, optionalWhether to sort in ascending or descending order. The default is true (ascending).

ee.FeatureCollection.makeArray

Add a 1-D Array to each feature in a collection by combining a list of properties for each feature into a 1-D Array. All of the properties must be numeric values. If a feature doesn't contain all of the named properties, or any of them aren't numeric, the feature will be dropped from the resulting collection.

UsageReturns
FeatureCollection.makeArray(properties, name)FeatureCollection
ArgumentTypeDetails
this: collectionFeatureCollectionThe input collection from which properties will be selected.
propertiesListThe properties to select.
nameString, default: "array"The name of the new array property.

ee.FeatureCollection.map

Maps an algorithm over a collection.

Returns the mapped collection.

UsageReturns
FeatureCollection.map(algorithm, dropNulls)Collection
ArgumentTypeDetails
this: collectionCollectionThe Collection instance.
algorithmFunctionThe operation to map over the images or features of the collection. A JavaScript function that receives an image or features and returns one. The function is called only once and the result is captured as a description, so it cannot perform imperative operations or rely on external state.
dropNullsBoolean, optionalIf true, the mapped algorithm is allowed to return nulls, and the elements for which it returns nulls will be dropped.

ee.FeatureCollection.merge

Merges two collections into one. The result has all the elements that were in either collection.

Elements from the first collection will have IDs prefixed with "1" and elements from the second collection will have IDs prefixed with "2".

UsageReturns
FeatureCollection.merge(collection2)FeatureCollection
ArgumentTypeDetails
this: collection1FeatureCollectionThe first collection to merge.
collection2FeatureCollectionThe second collection to merge.

ee.FeatureCollection.propertyNames

Returns the names of properties on this element.

UsageReturns
FeatureCollection.propertyNames()List
ArgumentTypeDetails
this: elementElement

ee.FeatureCollection.randomColumn

Adds a column of deterministic pseudorandom numbers to a collection. The outputs are double-precision floating point numbers. When using the 'uniform' distribution (default), outputs are in the range of [0, 1). Using the 'normal' distribution, outputs have μ=0, 𝛔=1, but have no explicit limits.

UsageReturns
FeatureCollection.randomColumn(columnName, seed, distribution)FeatureCollection
ArgumentTypeDetails
this: collectionFeatureCollectionThe input collection to which to add a random column.
columnNameString, default: "random"The name of the column to add.
seedLong, default: 0A seed used when generating the random numbers.
distributionString, default: "uniform"The distribution type of random numbers to produce; one of 'uniform' or 'normal'.

ee.FeatureCollection.randomPoints

Generates points that are uniformly random in the given geometry. If the geometry is two-dimensional (polygon or multi-polygon) then the returned points are uniformly distributed on the given region of the sphere. If the geometry is one-dimensional (linestrings), the returned points are interpolated uniformly along the geometry's edges. If the geometry has dimension zero (points), the returned points are sampled uniformly from the input points. If a multi-geometry of mixed dimension is given, points are sampled from the component geometries with the highest dimension.

UsageReturns
ee.FeatureCollection.randomPoints(region, points, seed, maxError)FeatureCollection
ArgumentTypeDetails
regionGeometryThe region to generate points for.
pointsInteger, default: 1000The number of points to generate.
seedLong, default: 0A seed for the random number generator.
maxErrorErrorMargin, optionalThe maximum amount of error tolerated when performing any necessary reprojection.

ee.FeatureCollection.reduceColumns

Apply a reducer to each element of a collection, using the given selectors to determine the inputs.

Returns a dictionary of results, keyed with the output names.

UsageReturns
FeatureCollection.reduceColumns(reducer, selectors, weightSelectors)Dictionary
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
reducerReducerThe reducer to apply.
selectorsListA selector for each input of the reducer.
weightSelectorsList, default: nullA selector for each weighted input of the reducer.

ee.FeatureCollection.reduceToImage

Creates an image from a feature collection by applying a reducer over the selected properties of all the features that intersect each pixel.

UsageReturns
FeatureCollection.reduceToImage(properties, reducer)Image
ArgumentTypeDetails
this: collectionFeatureCollectionFeature collection to intersect with each output pixel.
propertiesListProperties to select from each feature and pass into the reducer.
reducerReducerA Reducer to combine the properties of each intersecting feature into a final result to store in the pixel.

ee.FeatureCollection.remap

Remaps the value of a specific property in a collection. Takes two parallel lists and maps values found in one to values in the other. Any element with a value that is not specified in the first list is dropped from the output collection.

UsageReturns
FeatureCollection.remap(lookupIn, lookupOut, columnName)FeatureCollection
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to be modified.
lookupInListThe input mapping values. Restricted to strings and integers.
lookupOutListThe output mapping values. Must be the same size as lookupIn.
columnNameStringThe name of the property to remap.

ee.FeatureCollection.select

Select properties from each Feature in a collection. It is also possible to call this function with only string arguments; they will be all be interpreted as propertySelectors (varargs).

Returns the feature collection with selected properties.

UsageReturns
FeatureCollection.select(propertySelectors, newProperties, retainGeometry)FeatureCollection
ArgumentTypeDetails
this: featurecollectionFeatureCollectionThe FeatureCollection instance.
propertySelectorsListA list of names or regexes specifying the attributes to select.
newPropertiesList, optionalA list of new names for the output properties. Must match the number of properties selected.
retainGeometryBoolean, optionalWhen false, the result will have a NULL geometry. Defaults to true.

ee.FeatureCollection.serialize

Returns the serialized representation of this object.

UsageReturns
FeatureCollection.serialize(legacy)String
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
legacyBoolean, optionalEnables legacy format.

ee.FeatureCollection.set

Overrides one or more metadata properties of an Element.

Returns the element with the specified properties overridden.

UsageReturns
FeatureCollection.set(var_args)Element
ArgumentTypeDetails
this: elementElementThe Element instance.
var_argsVarArgsEither a dictionary of properties, or a vararg sequence of properties, e.g. key1, value1, key2, value2, ...

ee.FeatureCollection.size

Returns the number of elements in the collection.

UsageReturns
FeatureCollection.size()Integer
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to count.

ee.FeatureCollection.sort

Sort a collection by the specified property.

Returns the sorted collection.

UsageReturns
FeatureCollection.sort(property, ascending)Collection
ArgumentTypeDetails
this: collectionCollectionThe Collection instance.
propertyStringThe property to sort by.
ascendingBoolean, optionalWhether to sort in ascending or descending order. The default is true (ascending).

ee.FeatureCollection.style

Draw a vector collection for visualization using a simple style language.

UsageReturns
FeatureCollection.style(color, pointSize, pointShape, width, fillColor, styleProperty, neighborhood, lineType)Image
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to draw.
colorString, default: "black"A default color (CSS 3.0 color value e.g. 'FF0000' or 'red') to use for drawing the features. Supports opacity (e.g.: 'FF000088' for 50% transparent red).
pointSizeInteger, default: 3The default size in pixels of the point markers.
pointShapeString, default: "circle"The default shape of the marker to draw at each point location. One of: `circle`, `square`, `diamond`, `cross`, `plus`, `pentagram`, `hexagram`, `triangle`, `triangle_up`, `triangle_down`, `triangle_left`, `triangle_right`, `pentagon`, `hexagon`, `star5`, `star6`. This argument also supports the following Matlab marker abbreviations: `o`, `s`, `d`, `x`, `+`, `p`, `h`, `^`, `v`, `<`, `>`.
widthFloat, default: 2The default line width for lines and outlines for polygons and point shapes.
fillColorString, default: nullThe color for filling polygons and point shapes. Defaults to 'color' at 0.66 opacity.
stylePropertyString, default: nullA per-feature property expected to contain a dictionary. Values in the dictionary override any default values for that feature.
neighborhoodInteger, default: 5If styleProperty is used and any feature has a pointSize or width larger than the defaults, tiling artifacts can occur. Specifies the maximum neighborhood (pointSize + width) needed for any feature.
lineTypeString, default: "solid"The default line style for lines and outlines of polygons and point shapes. Defaults to 'solid'. One of: solid, dotted, dashed.

ee.FeatureCollection.toDictionary

Extract properties from a feature as a dictionary.

UsageReturns
FeatureCollection.toDictionary(properties)Dictionary
ArgumentTypeDetails
this: elementElementThe feature to extract the property from.
propertiesList, default: nullThe list of properties to extract. Defaults to all non-system properties.

ee.FeatureCollection.toList

Returns the elements of a collection as a list.

UsageReturns
FeatureCollection.toList(count, offset)List
ArgumentTypeDetails
this: collectionFeatureCollectionThe input collection to fetch.
countIntegerThe maximum number of elements to fetch.
offsetInteger, default: 0The number of elements to discard from the start. If set, (offset + count) elements will be fetched and the first offset elements will be discarded.

ee.FeatureCollection.union

Merges all geometries in a given collection into one and returns a collection containing a single feature with only an ID of 'union_result' and a geometry.

UsageReturns
FeatureCollection.union(maxError)FeatureCollection
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection being merged.
maxErrorErrorMargin, default: nullThe maximum error allowed when performing any necessary reprojections. If not specified, defaults to the error margin requested from the output.

ee.Filter

Constructs a new filter. This constructor accepts the following args:

  - Another filter.

  - A list of filters (which are implicitly ANDed together).

  - A ComputedObject returning a filter. Users shouldn't be making these; they're produced by the generator functions below.

UsageReturns
ee.Filter(filter)Filter
ArgumentTypeDetails
filterFilter|List, optionalOptional filter to add.

ee.Filter.and

Combine two or more filters using boolean AND.

Returns the constructed filter.

UsageReturns
ee.Filter.and(var_args)Filter
ArgumentTypeDetails
var_argsVarArgsThe filters to combine.

ee.Filter.area

Returns a filter that passes if the specified geometry has an area within the given range (inclusive).

UsageReturns
ee.Filter.area(min, max, maxError, geometrySelector)Filter
ArgumentTypeDetails
minFloatMinimum area in square meters (inclusive).
maxFloatMaximum area in square meters (inclusive).
maxErrorErrorMargin, default: nullThe maximum allowed error for computing the geometry's area.
geometrySelectorString, default: nullThe name of the geometry property to use for filtering. Leave blank or use '.geo' to operate on the object's geometry.

ee.Filter.aside

Calls a function passing this object as the first argument, and returning itself. Convenient e.g. when debugging:

var c = ee.ImageCollection('foo').aside(print)

.filterDate('2001-01-01', '2002-01-01').aside(print, 'In 2001')

.filterBounds(geom).aside(print, 'In region')

.aside(Map.addLayer, {min: 0, max: 142}, 'Filtered')

.select('a', 'b');

Returns the same object, for chaining.

UsageReturns
Filter.aside(func, var_args)ComputedObject
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
funcFunctionThe function to call.
var_argsVarArgsAny extra arguments to pass to the function.

ee.Filter.bounds

Creates a filter that passes if the object's geometry intersects the given geometry.

Returns the constructed filter.

UsageReturns
ee.Filter.bounds(geometry, errorMargin)Filter
ArgumentTypeDetails
geometryComputedObject|FeatureCollection|GeometryThe geometry, feature or collection to intersect with.
errorMarginComputedObject|Number, optionalAn optional error margin. If a number, interpreted as sphere surface meters.

ee.Filter.calendarRange

Returns a filter that passes if the object's timestamp falls within the given range of a calendar field. The month, day_of_year, day_of_month, and day_of_week are 1-based. Times are assumed to be in UTC. Weeks are assumed to begin on Monday as day 1. If end < start then this tests for value >= start OR value <= end, to allow for wrapping.

UsageReturns
ee.Filter.calendarRange(start, end, field)Filter
ArgumentTypeDetails
startIntegerThe start of the desired calendar field, inclusive.
endInteger, default: nullThe end of the desired calendar field, inclusive. Defaults to the same value as start.
fieldString, default: "day_of_year"The calendar field to filter over. Options are: `year`, `month`, `hour`, `minute`, `day_of_year`, `day_of_month`, and `day_of_week`.

ee.Filter.contains

Creates a unary or binary filter that passes if the left geometry contains the right geometry (empty geometries are not contained in anything).

UsageReturns
ee.Filter.contains(leftField, rightValue, rightField, leftValue, maxError)Filter
ArgumentTypeDetails
leftFieldString, default: nullA selector for the left operand. Should not be specified if leftValue is specified.
rightValueObject, default: nullThe value of the right operand. Should not be specified if rightField is specified.
rightFieldString, default: nullA selector for the right operand. Should not be specified if rightValue is specified.
leftValueObject, default: nullThe value of the left operand. Should not be specified if leftField is specified.
maxErrorErrorMargin, optionalThe maximum reprojection error allowed during filter application.

ee.Filter.date

Filter a collection by date range. The start and end may be Dates, numbers

(interpreted as milliseconds since 1970-01-01T00:00:00Z), or strings (such as '1996-01-01T08:00'). Based on 'system:time_start' property.

Returns the constructed filter.

UsageReturns
ee.Filter.date(start, end)Filter
ArgumentTypeDetails
startDate|Number|StringThe start date (inclusive).
endDate|Number|String, optionalThe end date (exclusive). Optional. If not specified, a 1-millisecond range starting at 'start' is created.

ee.Filter.dateRangeContains

Creates a unary or binary filter that passes if the left operand, a date range, contains the right operand, a date.

UsageReturns
ee.Filter.dateRangeContains(leftField, rightValue, rightField, leftValue)Filter
ArgumentTypeDetails
leftFieldString, default: nullA selector for the left operand. Should not be specified if leftValue is specified.
rightValueObject, default: nullThe value of the right operand. Should not be specified if rightField is specified.
rightFieldString, default: nullA selector for the right operand. Should not be specified if rightValue is specified.
leftValueObject, default: nullThe value of the left operand. Should not be specified if leftField is specified.

ee.Filter.dayOfYear

Returns a filter that passes if the object's timestamp falls within the given day-of-year range.

UsageReturns
ee.Filter.dayOfYear(start, end)Filter
ArgumentTypeDetails
startIntegerThe start of the desired day range, inclusive.
endIntegerThe end of the desired day range, inclusive.

ee.Filter.disjoint

Creates a unary or binary filter that passes unless the left geometry intersects the right geometry.

UsageReturns
ee.Filter.disjoint(leftField, rightValue, rightField, leftValue, maxError)Filter
ArgumentTypeDetails
leftFieldString, default: nullA selector for the left operand. Should not be specified if leftValue is specified.
rightValueObject, default: nullThe value of the right operand. Should not be specified if rightField is specified.
rightFieldString, default: nullA selector for the right operand. Should not be specified if rightValue is specified.
leftValueObject, default: nullThe value of the left operand. Should not be specified if leftField is specified.
maxErrorErrorMargin, optionalThe maximum reprojection error allowed during filter application.

ee.Filter.eq

Filter to metadata equal to the given value.

Returns the constructed filter.

UsageReturns
ee.Filter.eq(name, value)Filter
ArgumentTypeDetails
nameStringThe property name to filter on.
valueObjectThe value to compare against.

ee.Filter.equals

Creates a unary or binary filter that passes if the two operands are equals.

UsageReturns
ee.Filter.equals(leftField, rightValue, rightField, leftValue)Filter
ArgumentTypeDetails
leftFieldString, default: nullA selector for the left operand. Should not be specified if leftValue is specified.
rightValueObject, default: nullThe value of the right operand. Should not be specified if rightField is specified.
rightFieldString, default: nullA selector for the right operand. Should not be specified if rightValue is specified.
leftValueObject, default: nullThe value of the left operand. Should not be specified if leftField is specified.

ee.Filter.evaluate

Asynchronously retrieves the value of this object from the server and passes it to the provided callback function.

UsageReturns
Filter.evaluate(callback)
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunctionA function of the form function(success, failure), called when the server returns an answer. If the request succeeded, the success argument contains the evaluated result. If the request failed, the failure argument will contains an error message.

ee.Filter.expression

Constructs a filter tree from a string.

UsageReturns
ee.Filter.expression(expression)Filter
ArgumentTypeDetails
expressionStringA string to be parsed into a Filter object (e.g.: "property > value"). Supported operators include: >, >=, <, <=, ==, !=, (), !, && and ||.

ee.Filter.getInfo

Retrieves the value of this object from the server.

If no callback function is provided, the request is made synchronously. If a callback is provided, the request is made asynchronously.

The asynchronous mode is preferred because the synchronous mode stops all other code (for example, the EE Code Editor UI) while waiting for the server. To make an asynchronous request, evaluate() is preferred over getInfo().

Returns the computed value of this object.

UsageReturns
Filter.getInfo(callback)Object
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.Filter.greaterThan

Creates a unary or binary filter that passes if the left operand is greater than the right operand.

UsageReturns
ee.Filter.greaterThan(leftField, rightValue, rightField, leftValue)Filter
ArgumentTypeDetails
leftFieldString, default: nullA selector for the left operand. Should not be specified if leftValue is specified.
rightValueObject, default: nullThe value of the right operand. Should not be specified if rightField is specified.
rightFieldString, default: nullA selector for the right operand. Should not be specified if rightValue is specified.
leftValueObject, default: nullThe value of the left operand. Should not be specified if leftField is specified.

ee.Filter.greaterThanOrEquals

Creates a unary or binary filter that passes unless the left operand is less than the right operand.

UsageReturns
ee.Filter.greaterThanOrEquals(leftField, rightValue, rightField, leftValue)Filter
ArgumentTypeDetails
leftFieldString, default: nullA selector for the left operand. Should not be specified if leftValue is specified.
rightValueObject, default: nullThe value of the right operand. Should not be specified if rightField is specified.
rightFieldString, default: nullA selector for the right operand. Should not be specified if rightValue is specified.
leftValueObject, default: nullThe value of the left operand. Should not be specified if leftField is specified.

ee.Filter.gt

Filter on metadata greater than the given value.

Returns the constructed filter.

UsageReturns
ee.Filter.gt(name, value)Filter
ArgumentTypeDetails
nameStringThe property name to filter on.
valueObjectThe value to compare against.

ee.Filter.gte

Filter on metadata greater than or equal to the given value.

Returns the constructed filter.

UsageReturns
ee.Filter.gte(name, value)Filter
ArgumentTypeDetails
nameStringThe property name to filter on.
valueObjectThe value to compare against.

ee.Filter.hasType

Creates a unary or binary filter that passes if the left operand has the type, or is a subtype of the type named in the right operand.

UsageReturns
ee.Filter.hasType(leftField, rightValue, rightField, leftValue)Filter
ArgumentTypeDetails
leftFieldString, default: nullA selector for the left operand. Should not be specified if leftValue is specified.
rightValueObject, default: nullThe value of the right operand. Should not be specified if rightField is specified.
rightFieldString, default: nullA selector for the right operand. Should not be specified if rightValue is specified.
leftValueObject, default: nullThe value of the left operand. Should not be specified if leftField is specified.

ee.Filter.inList

Filter on metadata contained in a list.

Returns the constructed filter.

UsageReturns
ee.Filter.inList(leftField, rightValue, rightField, leftValue)Filter
ArgumentTypeDetails
leftFieldString, optionalA selector for the left operand. Should not be specified if leftValue is specified.
rightValueList, optionalThe value of the right operand. Should not be specified if rightField is specified.
rightFieldString, optionalA selector for the right operand. Should not be specified if rightValue is specified.
leftValueList, optionalThe value of the left operand. Should not be specified if leftField is specified.

ee.Filter.intersects

Creates a unary or binary filter that passes if the left geometry intersects the right geometry.

UsageReturns
ee.Filter.intersects(leftField, rightValue, rightField, leftValue, maxError)Filter
ArgumentTypeDetails
leftFieldString, default: nullA selector for the left operand. Should not be specified if leftValue is specified.
rightValueObject, default: nullThe value of the right operand. Should not be specified if rightField is specified.
rightFieldString, default: nullA selector for the right operand. Should not be specified if rightValue is specified.
leftValueObject, default: nullThe value of the left operand. Should not be specified if leftField is specified.
maxErrorErrorMargin, optionalThe maximum reprojection error allowed during filter application.

ee.Filter.isContained

Creates a unary or binary filter that passes if the right geometry contains the left geometry (empty geometries are not contained in anything).

UsageReturns
ee.Filter.isContained(leftField, rightValue, rightField, leftValue, maxError)Filter
ArgumentTypeDetails
leftFieldString, default: nullA selector for the left operand. Should not be specified if leftValue is specified.
rightValueObject, default: nullThe value of the right operand. Should not be specified if rightField is specified.
rightFieldString, default: nullA selector for the right operand. Should not be specified if rightValue is specified.
leftValueObject, default: nullThe value of the left operand. Should not be specified if leftField is specified.
maxErrorErrorMargin, optionalThe maximum reprojection error allowed during filter application.

ee.Filter.lessThan

Creates a unary or binary filter that passes if the left operand is less than the right operand.

UsageReturns
ee.Filter.lessThan(leftField, rightValue, rightField, leftValue)Filter
ArgumentTypeDetails
leftFieldString, default: nullA selector for the left operand. Should not be specified if leftValue is specified.
rightValueObject, default: nullThe value of the right operand. Should not be specified if rightField is specified.
rightFieldString, default: nullA selector for the right operand. Should not be specified if rightValue is specified.
leftValueObject, default: nullThe value of the left operand. Should not be specified if leftField is specified.

ee.Filter.lessThanOrEquals

Creates a unary or binary filter that passes unless the left operand is greater than the right operand.

UsageReturns
ee.Filter.lessThanOrEquals(leftField, rightValue, rightField, leftValue)Filter
ArgumentTypeDetails
leftFieldString, default: nullA selector for the left operand. Should not be specified if leftValue is specified.
rightValueObject, default: nullThe value of the right operand. Should not be specified if rightField is specified.
rightFieldString, default: nullA selector for the right operand. Should not be specified if rightValue is specified.
leftValueObject, default: nullThe value of the left operand. Should not be specified if leftField is specified.

ee.Filter.listContains

Creates a unary or binary filter that passes if the left operand, a list, contains the right operand.

UsageReturns
ee.Filter.listContains(leftField, rightValue, rightField, leftValue)Filter
ArgumentTypeDetails
leftFieldString, default: nullA selector for the left operand. Should not be specified if leftValue is specified.
rightValueObject, default: nullThe value of the right operand. Should not be specified if rightField is specified.
rightFieldString, default: nullA selector for the right operand. Should not be specified if rightValue is specified.
leftValueObject, default: nullThe value of the left operand. Should not be specified if leftField is specified.

ee.Filter.lt

Filter to metadata less than the given value.

Returns the constructed filter.

UsageReturns
ee.Filter.lt(name, value)Filter
ArgumentTypeDetails
nameStringThe property name to filter on.
valueObjectThe value to compare against.

ee.Filter.lte

Filter on metadata less than or equal to the given value.

Returns the constructed filter.

UsageReturns
ee.Filter.lte(name, value)Filter
ArgumentTypeDetails
nameStringThe property name to filter on.
valueObjectThe value to compare against.

ee.Filter.maxDifference

Creates a unary or binary filter that passes if the left and right operands, both numbers, are within a given maximum difference. If used as a join condition, this numeric difference is used as a join measure.

UsageReturns
ee.Filter.maxDifference(difference, leftField, rightValue, rightField, leftValue)Filter
ArgumentTypeDetails
differenceFloatThe maximum difference for which the filter will return true.
leftFieldString, default: nullA selector for the left operand. Should not be specified if leftValue is specified.
rightValueObject, default: nullThe value of the right operand. Should not be specified if rightField is specified.
rightFieldString, default: nullA selector for the right operand. Should not be specified if rightValue is specified.
leftValueObject, default: nullThe value of the left operand. Should not be specified if leftField is specified.

ee.Filter.neq

Filter to metadata not equal to the given value.

Returns the constructed filter.

UsageReturns
ee.Filter.neq(name, value)Filter
ArgumentTypeDetails
nameStringThe property name to filter on.
valueObjectThe value to compare against.

ee.Filter.not

Returns the opposite of the input filter, i.e. the resulting filter will match if and only if the input filter doesn't match.

UsageReturns
Filter.not()Filter
ArgumentTypeDetails
this: filterFilterThe Filter instance.

ee.Filter.notEquals

Creates a unary or binary filter that passes unless the two operands are equals.

UsageReturns
ee.Filter.notEquals(leftField, rightValue, rightField, leftValue)Filter
ArgumentTypeDetails
leftFieldString, default: nullA selector for the left operand. Should not be specified if leftValue is specified.
rightValueObject, default: nullThe value of the right operand. Should not be specified if rightField is specified.
rightFieldString, default: nullA selector for the right operand. Should not be specified if rightValue is specified.
leftValueObject, default: nullThe value of the left operand. Should not be specified if leftField is specified.

ee.Filter.notNull

Returns a filter that passes if all the named properties are not null.

UsageReturns
ee.Filter.notNull(properties)Filter
ArgumentTypeDetails
propertiesList

ee.Filter.or

Combine two or more filters using boolean OR.

Returns the constructed filter.

UsageReturns
ee.Filter.or(var_args)Filter
ArgumentTypeDetails
var_argsVarArgsThe filters to combine.

ee.Filter.rangeContains

Returns a filter that passes if the value of the selected field is in the specified range (inclusive).

UsageReturns
ee.Filter.rangeContains(field, minValue, maxValue)Filter
ArgumentTypeDetails
fieldStringA selector for the property being tested.
minValueObjectThe lower bound of the range.
maxValueObjectThe upper bound of the range.

ee.Filter.serialize

Returns the serialized representation of this object.

UsageReturns
Filter.serialize(legacy)String
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
legacyBoolean, optionalEnables legacy format.

ee.Filter.stringContains

Creates a unary or binary filter that passes if the left operand, a string, contains the right operand, also a string.

UsageReturns
ee.Filter.stringContains(leftField, rightValue, rightField, leftValue)Filter
ArgumentTypeDetails
leftFieldString, default: nullA selector for the left operand. Should not be specified if leftValue is specified.
rightValueObject, default: nullThe value of the right operand. Should not be specified if rightField is specified.
rightFieldString, default: nullA selector for the right operand. Should not be specified if rightValue is specified.
leftValueObject, default: nullThe value of the left operand. Should not be specified if leftField is specified.

ee.Filter.stringEndsWith

Creates a unary or binary filter that passes if the left operand, a string, ends with the right operand, also a string.

UsageReturns
ee.Filter.stringEndsWith(leftField, rightValue, rightField, leftValue)Filter
ArgumentTypeDetails
leftFieldString, default: nullA selector for the left operand. Should not be specified if leftValue is specified.
rightValueObject, default: nullThe value of the right operand. Should not be specified if rightField is specified.
rightFieldString, default: nullA selector for the right operand. Should not be specified if rightValue is specified.
leftValueObject, default: nullThe value of the left operand. Should not be specified if leftField is specified.

ee.Filter.stringStartsWith

Creates a unary or binary filter that passes if the left operand, a string, starts with the right operand, also a string.

UsageReturns
ee.Filter.stringStartsWith(leftField, rightValue, rightField, leftValue)Filter
ArgumentTypeDetails
leftFieldString, default: nullA selector for the left operand. Should not be specified if leftValue is specified.
rightValueObject, default: nullThe value of the right operand. Should not be specified if rightField is specified.
rightFieldString, default: nullA selector for the right operand. Should not be specified if rightValue is specified.
leftValueObject, default: nullThe value of the left operand. Should not be specified if leftField is specified.

ee.Filter.withinDistance

Creates a unary or binary filter that passes if the left geometry is within a specified distance of the right geometry. If used as a join condition, this distance is used as a join measure.

UsageReturns
ee.Filter.withinDistance(distance, leftField, rightValue, rightField, leftValue, maxError)Filter
ArgumentTypeDetails
distanceFloatThe maximum distance for which the filter will return true.
leftFieldString, default: nullA selector for the left operand. Should not be specified if leftValue is specified.
rightValueObject, default: nullThe value of the right operand. Should not be specified if rightField is specified.
rightFieldString, default: nullA selector for the right operand. Should not be specified if rightValue is specified.
leftValueObject, default: nullThe value of the left operand. Should not be specified if leftField is specified.
maxErrorErrorMargin, optionalThe maximum reprojection error allowed during filter application.

ee.Geometry

Creates a geometry.

UsageReturns
ee.Geometry(geoJson, proj, geodesic, evenOdd)Geometry
ArgumentTypeDetails
geoJsonObjectThe GeoJSON object describing the geometry or a ComputedObject to be reinterpreted as a Geometry. Supports CRS specifications as per the GeoJSON spec, but only allows named (rather than "linked" CRSs). If this includes a 'geodesic' field, and opt_geodesic is not specified, it will be used as opt_geodesic.
projProjection, optionalAn optional projection specification, either as a CRS ID code or as a WKT string. If specified, overrides any CRS found in the geoJson parameter. If unspecified and the geoJson does not declare a CRS, defaults to "EPSG:4326" (x=longitude, y=latitude).
geodesicBoolean, optionalWhether line segments should be interpreted as spherical geodesics. If false, indicates that line segments should be interpreted as planar lines in the specified CRS. If absent, defaults to true if the CRS is geographic (including the default EPSG:4326), or to false if the CRS is projected.
evenOddBoolean, optionalIf true, polygon interiors will be determined by the even/odd rule, where a point is inside if it crosses an odd number of edges to reach a point at infinity. Otherwise polygons use the left- inside rule, where interiors are on the left side of the shell's edges when walking the vertices in the given order. If unspecified, defaults to true.

ee.Geometry.BBox

Constructs a rectangle whose edges are lines of latitude and longitude.

The result is a planar WGS84 rectangle.

If (east - west) ≥ 360 then the longitude range will be normalized to -180 to

  +180; otherwise they will be treated as designating points on a circle (e.g. east may be numerically less than west).

UsageReturns
ee.Geometry.BBox(west, south, east, north)Geometry.BBox
ArgumentTypeDetails
westNumberThe westernmost enclosed longitude. Will be adjusted to lie in the range -180° to 180°.
southNumberThe southernmost enclosed latitude. If less than -90° (south pole), will be treated as -90°.
eastNumberThe easternmost enclosed longitude.
northNumberThe northernmost enclosed latitude. If greater than   +90° (north pole), will be treated as +90°.

ee.Geometry.BBox.area

Returns the area of the geometry. Area of points and line strings is 0, and the area of multi geometries is the sum of the areas of their components (intersecting areas are counted multiple times).

UsageReturns
BBox.area(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe geometry input.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in square meters.

ee.Geometry.BBox.aside

Calls a function passing this object as the first argument, and returning itself. Convenient e.g. when debugging:

var c = ee.ImageCollection('foo').aside(print)

.filterDate('2001-01-01', '2002-01-01').aside(print, 'In 2001')

.filterBounds(geom).aside(print, 'In region')

.aside(Map.addLayer, {min: 0, max: 142}, 'Filtered')

.select('a', 'b');

Returns the same object, for chaining.

UsageReturns
BBox.aside(func, var_args)ComputedObject
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
funcFunctionThe function to call.
var_argsVarArgsAny extra arguments to pass to the function.

ee.Geometry.BBox.bounds

Returns the bounding rectangle of the geometry.

UsageReturns
BBox.bounds(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryReturn the bounding box of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in WGS84.

ee.Geometry.BBox.buffer

Returns the input buffered by a given distance. If the distance is positive, the geometry is expanded, and if the distance is negative, the geometry is contracted.

UsageReturns
BBox.buffer(distance, maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry being buffered.
distanceFloatThe distance of the buffering, which may be negative. If no projection is specified, the unit is meters. Otherwise the unit is in the coordinate system of the projection.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when approximating the buffering circle and performing any necessary reprojection. If unspecified, defaults to 1% of the distance.
projProjection, default: nullIf specified, the buffering will be performed in this projection and the distance will be interpreted as units of the coordinate system of this projection. Otherwise the distance is interpereted as meters and the buffering is performed in a spherical coordinate system.

ee.Geometry.BBox.centroid

Returns a point at the center of the highest-dimension components of the geometry. Lower-dimensional components are ignored, so the centroid of a geometry containing two polygons, three lines and a point is equivalent to the centroid of a geometry containing just the two polygons.

UsageReturns
BBox.centroid(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCalculates the centroid of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in WGS84.

ee.Geometry.BBox.containedIn

Returns true if and only if one geometry is contained in the other.

UsageReturns
BBox.containedIn(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.BBox.contains

Returns true if and only if one geometry contains the other.

UsageReturns
BBox.contains(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.BBox.convexHull

Returns the convex hull of the given geometry. The convex hull of a single point is the point itself, the convex hull of collinear points is a line, and the convex hull of everything else is a polygon. Note that a degenerate polygon with all vertices on the same line will result in a line segment.

UsageReturns
BBox.convexHull(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCalculates the convex hull of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.BBox.coordinates

Returns a GeoJSON-style list of the geometry's coordinates.

UsageReturns
BBox.coordinates()List
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.BBox.coveringGrid

Returns a collection of features that cover this geometry, where each feature is a rectangle in the grid defined by the given projection.

UsageReturns
BBox.coveringGrid(proj, scale)FeatureCollection
ArgumentTypeDetails
this: geometryGeometryThe result is the grid cells that intersect with this region.
projProjectionThe projection in which to construct the grid. A feature is generated for each grid cell that intersects 'geometry', where cell corners are at integer-valued positions in the projection. If the projection is scaled in meters, the points will be on a grid of that size at the point of true scale.
scaleFloat, default: nullOverrides the scale of the projection, if provided. May be required if the projection isn't already scaled.

ee.Geometry.BBox.cutLines

Converts LineString, MultiLineString, and LinearRing geometries into a MultiLineString by cutting them into parts no longer than the given distance along their length. All other geometry types will be converted to an empty MultiLineString.

UsageReturns
BBox.cutLines(distances, maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCuts the lines of this geometry.
distancesListDistances along each LineString to cut the line into separate pieces, measured in units of the given proj, or meters if proj is unspecified.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullProjection of the result and distance measurements, or WGS84 if unspecified.

ee.Geometry.BBox.difference

Returns the result of subtracting the 'right' geometry from the 'left' geometry.

UsageReturns
BBox.difference(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.BBox.disjoint

Returns true if and only if the geometries are disjoint.

UsageReturns
BBox.disjoint(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.BBox.dissolve

Returns the union of the geometry. This leaves single geometries untouched, and unions multi geometries.

UsageReturns
BBox.dissolve(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to union.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the union will be performed in this projection. Otherwise it will be performed in a spherical coordinate system.

ee.Geometry.BBox.distance

Returns the minimum distance between two geometries.

UsageReturns
BBox.distance(right, maxError, proj)Float
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.BBox.edgesAreGeodesics

Returns true if the geometry edges, if any, are geodesics along a spherical model of the earth; if false, any edges are straight lines in the projection.

UsageReturns
BBox.edgesAreGeodesics()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.BBox.evaluate

Asynchronously retrieves the value of this object from the server and passes it to the provided callback function.

UsageReturns
BBox.evaluate(callback)
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunctionA function of the form function(success, failure), called when the server returns an answer. If the request succeeded, the success argument contains the evaluated result. If the request failed, the failure argument will contains an error message.

ee.Geometry.BBox.geodesic

If false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth.

UsageReturns
BBox.geodesic()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.BBox.geometries

Returns the list of geometries in a GeometryCollection, or a singleton list of the geometry for single geometries.

UsageReturns
BBox.geometries()List
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.BBox.getInfo

Retrieves the value of this object from the server.

If no callback function is provided, the request is made synchronously. If a callback is provided, the request is made asynchronously.

The asynchronous mode is preferred because the synchronous mode stops all other code (for example, the EE Code Editor UI) while waiting for the server. To make an asynchronous request, evaluate() is preferred over getInfo().

Returns the computed value of this object.

UsageReturns
BBox.getInfo(callback)Object
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.Geometry.BBox.intersection

Returns the intersection of the two geometries.

UsageReturns
BBox.intersection(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.BBox.intersects

Returns true if and only if the geometries intersect.

UsageReturns
BBox.intersects(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.BBox.isUnbounded

Returns whether the geometry is unbounded.

UsageReturns
BBox.isUnbounded()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.BBox.length

Returns the length of the linear parts of the geometry. Polygonal parts are ignored. The length of multi geometries is the sum of the lengths of their components.

UsageReturns
BBox.length(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe input geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in meters.

ee.Geometry.BBox.perimeter

Returns the length of the perimeter of the polygonal parts of the geometry. The perimeter of multi geometries is the sum of the perimeters of their components.

UsageReturns
BBox.perimeter(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe input geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in meters.

ee.Geometry.BBox.projection

Returns the projection of the geometry.

UsageReturns
BBox.projection()Projection
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.BBox.serialize

Returns the serialized representation of this object.

UsageReturns
BBox.serialize(legacy)String
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.
legacyBoolean, optionalEnables legacy format.

ee.Geometry.BBox.simplify

Simplifies the geometry to within a given error margin. Note that this does not respect the error margin requested by the consumer of this algorithm, unless maxError is explicitly specified to be null.

This overrides the default Earth Engine policy for propagating error margins, so regardless of the geometry accuracy requested from the output, the inputs will be requested with the error margin specified in the arguments to this algorithm. This results in consistent rendering at all zoom levels of a rendered vector map, but at lower zoom levels (i.e. zoomed out), the geometry won't be simplified, which may harm performance.

UsageReturns
BBox.simplify(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to simplify.
maxErrorErrorMarginThe maximum amount of error by which the result may differ from the input.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in the same projection as the input. If the error margin is in projected units, the margin will be interpreted as units of this projection

ee.Geometry.BBox.symmetricDifference

Returns the symmetric difference between two geometries.

UsageReturns
BBox.symmetricDifference(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.BBox.toGeoJSON

Returns a GeoJSON representation of the geometry.

UsageReturns
BBox.toGeoJSON()GeoJSONGeometry
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.

ee.Geometry.BBox.toGeoJSONString

Returns a GeoJSON string representation of the geometry.

UsageReturns
BBox.toGeoJSONString()String
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.

ee.Geometry.BBox.transform

Transforms the geometry to a specific projection.

UsageReturns
BBox.transform(proj, maxError)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to reproject.
projProjection, optionalThe target projection. Defaults to WGS84. If this has a geographic CRS, the edges of the geometry will be interpreted as geodesics. Otherwise they will be interpreted as straight lines in the projection.
maxErrorErrorMargin, default: nullThe maximum projection error.

ee.Geometry.BBox.type

Returns the GeoJSON type of the geometry.

UsageReturns
BBox.type()String
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.BBox.union

Returns the union of the two geometries.

UsageReturns
BBox.union(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.BBox.withinDistance

Returns true if and only if the geometries are within a specified distance.

UsageReturns
BBox.withinDistance(right, distance, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
distanceFloatThe distance threshold. If a projection is specified, the distance is in units of that projected coordinate system, otherwise it is in meters.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.LineString

Constructs an ee.Geometry describing a LineString.

For convenience, varargs may be used when all arguments are numbers. This allows creating geodesic EPSG:4326 LineStrings given an even number of arguments, e.g. ee.Geometry.LineString(aLng, aLat, bLng, bLat, ...).

UsageReturns
ee.Geometry.LineString(coords, proj, geodesic, maxError)Geometry.LineString
ArgumentTypeDetails
coordsListA list of at least two points. May be a list of coordinates in the GeoJSON 'LineString' format, a list of at least two ee.Geometry objects describing a point, or a list of at least four numbers defining the [x,y] coordinates of at least two points.
projProjection, optionalThe projection of this geometry. If unspecified, the default is the projection of the input ee.Geometry, or EPSG:4326 if there are no ee.Geometry inputs.
geodesicBoolean, optionalIf false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth. The default is the geodesic state of the inputs, or true if the inputs are numbers.
maxErrorErrorMargin, optionalMax error when input geometry must be reprojected to an explicitly requested result projection or geodesic state.

ee.Geometry.LineString.area

Returns the area of the geometry. Area of points and line strings is 0, and the area of multi geometries is the sum of the areas of their components (intersecting areas are counted multiple times).

UsageReturns
LineString.area(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe geometry input.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in square meters.

ee.Geometry.LineString.aside

Calls a function passing this object as the first argument, and returning itself. Convenient e.g. when debugging:

var c = ee.ImageCollection('foo').aside(print)

.filterDate('2001-01-01', '2002-01-01').aside(print, 'In 2001')

.filterBounds(geom).aside(print, 'In region')

.aside(Map.addLayer, {min: 0, max: 142}, 'Filtered')

.select('a', 'b');

Returns the same object, for chaining.

UsageReturns
LineString.aside(func, var_args)ComputedObject
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
funcFunctionThe function to call.
var_argsVarArgsAny extra arguments to pass to the function.

ee.Geometry.LineString.bounds

Returns the bounding rectangle of the geometry.

UsageReturns
LineString.bounds(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryReturn the bounding box of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in WGS84.

ee.Geometry.LineString.buffer

Returns the input buffered by a given distance. If the distance is positive, the geometry is expanded, and if the distance is negative, the geometry is contracted.

UsageReturns
LineString.buffer(distance, maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry being buffered.
distanceFloatThe distance of the buffering, which may be negative. If no projection is specified, the unit is meters. Otherwise the unit is in the coordinate system of the projection.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when approximating the buffering circle and performing any necessary reprojection. If unspecified, defaults to 1% of the distance.
projProjection, default: nullIf specified, the buffering will be performed in this projection and the distance will be interpreted as units of the coordinate system of this projection. Otherwise the distance is interpereted as meters and the buffering is performed in a spherical coordinate system.

ee.Geometry.LineString.centroid

Returns a point at the center of the highest-dimension components of the geometry. Lower-dimensional components are ignored, so the centroid of a geometry containing two polygons, three lines and a point is equivalent to the centroid of a geometry containing just the two polygons.

UsageReturns
LineString.centroid(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCalculates the centroid of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in WGS84.

ee.Geometry.LineString.containedIn

Returns true if and only if one geometry is contained in the other.

UsageReturns
LineString.containedIn(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.LineString.contains

Returns true if and only if one geometry contains the other.

UsageReturns
LineString.contains(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.LineString.convexHull

Returns the convex hull of the given geometry. The convex hull of a single point is the point itself, the convex hull of collinear points is a line, and the convex hull of everything else is a polygon. Note that a degenerate polygon with all vertices on the same line will result in a line segment.

UsageReturns
LineString.convexHull(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCalculates the convex hull of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.LineString.coordinates

Returns a GeoJSON-style list of the geometry's coordinates.

UsageReturns
LineString.coordinates()List
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.LineString.coveringGrid

Returns a collection of features that cover this geometry, where each feature is a rectangle in the grid defined by the given projection.

UsageReturns
LineString.coveringGrid(proj, scale)FeatureCollection
ArgumentTypeDetails
this: geometryGeometryThe result is the grid cells that intersect with this region.
projProjectionThe projection in which to construct the grid. A feature is generated for each grid cell that intersects 'geometry', where cell corners are at integer-valued positions in the projection. If the projection is scaled in meters, the points will be on a grid of that size at the point of true scale.
scaleFloat, default: nullOverrides the scale of the projection, if provided. May be required if the projection isn't already scaled.

ee.Geometry.LineString.cutLines

Converts LineString, MultiLineString, and LinearRing geometries into a MultiLineString by cutting them into parts no longer than the given distance along their length. All other geometry types will be converted to an empty MultiLineString.

UsageReturns
LineString.cutLines(distances, maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCuts the lines of this geometry.
distancesListDistances along each LineString to cut the line into separate pieces, measured in units of the given proj, or meters if proj is unspecified.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullProjection of the result and distance measurements, or WGS84 if unspecified.

ee.Geometry.LineString.difference

Returns the result of subtracting the 'right' geometry from the 'left' geometry.

UsageReturns
LineString.difference(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.LineString.disjoint

Returns true if and only if the geometries are disjoint.

UsageReturns
LineString.disjoint(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.LineString.dissolve

Returns the union of the geometry. This leaves single geometries untouched, and unions multi geometries.

UsageReturns
LineString.dissolve(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to union.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the union will be performed in this projection. Otherwise it will be performed in a spherical coordinate system.

ee.Geometry.LineString.distance

Returns the minimum distance between two geometries.

UsageReturns
LineString.distance(right, maxError, proj)Float
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.LineString.edgesAreGeodesics

Returns true if the geometry edges, if any, are geodesics along a spherical model of the earth; if false, any edges are straight lines in the projection.

UsageReturns
LineString.edgesAreGeodesics()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.LineString.evaluate

Asynchronously retrieves the value of this object from the server and passes it to the provided callback function.

UsageReturns
LineString.evaluate(callback)
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunctionA function of the form function(success, failure), called when the server returns an answer. If the request succeeded, the success argument contains the evaluated result. If the request failed, the failure argument will contains an error message.

ee.Geometry.LineString.geodesic

If false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth.

UsageReturns
LineString.geodesic()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.LineString.geometries

Returns the list of geometries in a GeometryCollection, or a singleton list of the geometry for single geometries.

UsageReturns
LineString.geometries()List
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.LineString.getInfo

Retrieves the value of this object from the server.

If no callback function is provided, the request is made synchronously. If a callback is provided, the request is made asynchronously.

The asynchronous mode is preferred because the synchronous mode stops all other code (for example, the EE Code Editor UI) while waiting for the server. To make an asynchronous request, evaluate() is preferred over getInfo().

Returns the computed value of this object.

UsageReturns
LineString.getInfo(callback)Object
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.Geometry.LineString.intersection

Returns the intersection of the two geometries.

UsageReturns
LineString.intersection(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.LineString.intersects

Returns true if and only if the geometries intersect.

UsageReturns
LineString.intersects(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.LineString.isUnbounded

Returns whether the geometry is unbounded.

UsageReturns
LineString.isUnbounded()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.LineString.length

Returns the length of the linear parts of the geometry. Polygonal parts are ignored. The length of multi geometries is the sum of the lengths of their components.

UsageReturns
LineString.length(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe input geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in meters.

ee.Geometry.LineString.perimeter

Returns the length of the perimeter of the polygonal parts of the geometry. The perimeter of multi geometries is the sum of the perimeters of their components.

UsageReturns
LineString.perimeter(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe input geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in meters.

ee.Geometry.LineString.projection

Returns the projection of the geometry.

UsageReturns
LineString.projection()Projection
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.LineString.serialize

Returns the serialized representation of this object.

UsageReturns
LineString.serialize(legacy)String
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.
legacyBoolean, optionalEnables legacy format.

ee.Geometry.LineString.simplify

Simplifies the geometry to within a given error margin. Note that this does not respect the error margin requested by the consumer of this algorithm, unless maxError is explicitly specified to be null.

This overrides the default Earth Engine policy for propagating error margins, so regardless of the geometry accuracy requested from the output, the inputs will be requested with the error margin specified in the arguments to this algorithm. This results in consistent rendering at all zoom levels of a rendered vector map, but at lower zoom levels (i.e. zoomed out), the geometry won't be simplified, which may harm performance.

UsageReturns
LineString.simplify(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to simplify.
maxErrorErrorMarginThe maximum amount of error by which the result may differ from the input.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in the same projection as the input. If the error margin is in projected units, the margin will be interpreted as units of this projection

ee.Geometry.LineString.symmetricDifference

Returns the symmetric difference between two geometries.

UsageReturns
LineString.symmetricDifference(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.LineString.toGeoJSON

Returns a GeoJSON representation of the geometry.

UsageReturns
LineString.toGeoJSON()GeoJSONGeometry
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.

ee.Geometry.LineString.toGeoJSONString

Returns a GeoJSON string representation of the geometry.

UsageReturns
LineString.toGeoJSONString()String
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.

ee.Geometry.LineString.transform

Transforms the geometry to a specific projection.

UsageReturns
LineString.transform(proj, maxError)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to reproject.
projProjection, optionalThe target projection. Defaults to WGS84. If this has a geographic CRS, the edges of the geometry will be interpreted as geodesics. Otherwise they will be interpreted as straight lines in the projection.
maxErrorErrorMargin, default: nullThe maximum projection error.

ee.Geometry.LineString.type

Returns the GeoJSON type of the geometry.

UsageReturns
LineString.type()String
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.LineString.union

Returns the union of the two geometries.

UsageReturns
LineString.union(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.LineString.withinDistance

Returns true if and only if the geometries are within a specified distance.

UsageReturns
LineString.withinDistance(right, distance, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
distanceFloatThe distance threshold. If a projection is specified, the distance is in units of that projected coordinate system, otherwise it is in meters.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.LinearRing

Constructs an ee.Geometry describing a LinearRing. If the last point is not equal to the first, a duplicate of the first point will be added at the end.

For convenience, varargs may be used when all arguments are numbers. This allows creating geodesic EPSG:4326 LinearRings given an even number of arguments, e.g. ee.Geometry.LinearRing(aLng, aLat, bLng, bLat, ..., aLng, aLat).

UsageReturns
ee.Geometry.LinearRing(coords, proj, geodesic, maxError)Geometry.LinearRing
ArgumentTypeDetails
coordsListA list of points in the ring. May be a list of coordinates in the GeoJSON 'LinearRing' format, a list of at least three ee.Geometry objects describing a point, or a list of at least six numbers defining the [x,y] coordinates of at least three points.
projProjection, optionalThe projection of this geometry. If unspecified, the default is the projection of the input ee.Geometry, or EPSG:4326 if there are no ee.Geometry inputs.
geodesicBoolean, optionalIf false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth. The default is the geodesic state of the inputs, or true if the inputs are numbers.
maxErrorErrorMargin, optionalMax error when input geometry must be reprojected to an explicitly requested result projection or geodesic state.

ee.Geometry.LinearRing.area

Returns the area of the geometry. Area of points and line strings is 0, and the area of multi geometries is the sum of the areas of their components (intersecting areas are counted multiple times).

UsageReturns
LinearRing.area(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe geometry input.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in square meters.

ee.Geometry.LinearRing.aside

Calls a function passing this object as the first argument, and returning itself. Convenient e.g. when debugging:

var c = ee.ImageCollection('foo').aside(print)

.filterDate('2001-01-01', '2002-01-01').aside(print, 'In 2001')

.filterBounds(geom).aside(print, 'In region')

.aside(Map.addLayer, {min: 0, max: 142}, 'Filtered')

.select('a', 'b');

Returns the same object, for chaining.

UsageReturns
LinearRing.aside(func, var_args)ComputedObject
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
funcFunctionThe function to call.
var_argsVarArgsAny extra arguments to pass to the function.

ee.Geometry.LinearRing.bounds

Returns the bounding rectangle of the geometry.

UsageReturns
LinearRing.bounds(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryReturn the bounding box of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in WGS84.

ee.Geometry.LinearRing.buffer

Returns the input buffered by a given distance. If the distance is positive, the geometry is expanded, and if the distance is negative, the geometry is contracted.

UsageReturns
LinearRing.buffer(distance, maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry being buffered.
distanceFloatThe distance of the buffering, which may be negative. If no projection is specified, the unit is meters. Otherwise the unit is in the coordinate system of the projection.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when approximating the buffering circle and performing any necessary reprojection. If unspecified, defaults to 1% of the distance.
projProjection, default: nullIf specified, the buffering will be performed in this projection and the distance will be interpreted as units of the coordinate system of this projection. Otherwise the distance is interpereted as meters and the buffering is performed in a spherical coordinate system.

ee.Geometry.LinearRing.centroid

Returns a point at the center of the highest-dimension components of the geometry. Lower-dimensional components are ignored, so the centroid of a geometry containing two polygons, three lines and a point is equivalent to the centroid of a geometry containing just the two polygons.

UsageReturns
LinearRing.centroid(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCalculates the centroid of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in WGS84.

ee.Geometry.LinearRing.containedIn

Returns true if and only if one geometry is contained in the other.

UsageReturns
LinearRing.containedIn(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.LinearRing.contains

Returns true if and only if one geometry contains the other.

UsageReturns
LinearRing.contains(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.LinearRing.convexHull

Returns the convex hull of the given geometry. The convex hull of a single point is the point itself, the convex hull of collinear points is a line, and the convex hull of everything else is a polygon. Note that a degenerate polygon with all vertices on the same line will result in a line segment.

UsageReturns
LinearRing.convexHull(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCalculates the convex hull of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.LinearRing.coordinates

Returns a GeoJSON-style list of the geometry's coordinates.

UsageReturns
LinearRing.coordinates()List
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.LinearRing.coveringGrid

Returns a collection of features that cover this geometry, where each feature is a rectangle in the grid defined by the given projection.

UsageReturns
LinearRing.coveringGrid(proj, scale)FeatureCollection
ArgumentTypeDetails
this: geometryGeometryThe result is the grid cells that intersect with this region.
projProjectionThe projection in which to construct the grid. A feature is generated for each grid cell that intersects 'geometry', where cell corners are at integer-valued positions in the projection. If the projection is scaled in meters, the points will be on a grid of that size at the point of true scale.
scaleFloat, default: nullOverrides the scale of the projection, if provided. May be required if the projection isn't already scaled.

ee.Geometry.LinearRing.cutLines

Converts LineString, MultiLineString, and LinearRing geometries into a MultiLineString by cutting them into parts no longer than the given distance along their length. All other geometry types will be converted to an empty MultiLineString.

UsageReturns
LinearRing.cutLines(distances, maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCuts the lines of this geometry.
distancesListDistances along each LineString to cut the line into separate pieces, measured in units of the given proj, or meters if proj is unspecified.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullProjection of the result and distance measurements, or WGS84 if unspecified.

ee.Geometry.LinearRing.difference

Returns the result of subtracting the 'right' geometry from the 'left' geometry.

UsageReturns
LinearRing.difference(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.LinearRing.disjoint

Returns true if and only if the geometries are disjoint.

UsageReturns
LinearRing.disjoint(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.LinearRing.dissolve

Returns the union of the geometry. This leaves single geometries untouched, and unions multi geometries.

UsageReturns
LinearRing.dissolve(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to union.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the union will be performed in this projection. Otherwise it will be performed in a spherical coordinate system.

ee.Geometry.LinearRing.distance

Returns the minimum distance between two geometries.

UsageReturns
LinearRing.distance(right, maxError, proj)Float
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.LinearRing.edgesAreGeodesics

Returns true if the geometry edges, if any, are geodesics along a spherical model of the earth; if false, any edges are straight lines in the projection.

UsageReturns
LinearRing.edgesAreGeodesics()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.LinearRing.evaluate

Asynchronously retrieves the value of this object from the server and passes it to the provided callback function.

UsageReturns
LinearRing.evaluate(callback)
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunctionA function of the form function(success, failure), called when the server returns an answer. If the request succeeded, the success argument contains the evaluated result. If the request failed, the failure argument will contains an error message.

ee.Geometry.LinearRing.geodesic

If false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth.

UsageReturns
LinearRing.geodesic()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.LinearRing.geometries

Returns the list of geometries in a GeometryCollection, or a singleton list of the geometry for single geometries.

UsageReturns
LinearRing.geometries()List
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.LinearRing.getInfo

Retrieves the value of this object from the server.

If no callback function is provided, the request is made synchronously. If a callback is provided, the request is made asynchronously.

The asynchronous mode is preferred because the synchronous mode stops all other code (for example, the EE Code Editor UI) while waiting for the server. To make an asynchronous request, evaluate() is preferred over getInfo().

Returns the computed value of this object.

UsageReturns
LinearRing.getInfo(callback)Object
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.Geometry.LinearRing.intersection

Returns the intersection of the two geometries.

UsageReturns
LinearRing.intersection(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.LinearRing.intersects

Returns true if and only if the geometries intersect.

UsageReturns
LinearRing.intersects(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.LinearRing.isUnbounded

Returns whether the geometry is unbounded.

UsageReturns
LinearRing.isUnbounded()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.LinearRing.length

Returns the length of the linear parts of the geometry. Polygonal parts are ignored. The length of multi geometries is the sum of the lengths of their components.

UsageReturns
LinearRing.length(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe input geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in meters.

ee.Geometry.LinearRing.perimeter

Returns the length of the perimeter of the polygonal parts of the geometry. The perimeter of multi geometries is the sum of the perimeters of their components.

UsageReturns
LinearRing.perimeter(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe input geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in meters.

ee.Geometry.LinearRing.projection

Returns the projection of the geometry.

UsageReturns
LinearRing.projection()Projection
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.LinearRing.serialize

Returns the serialized representation of this object.

UsageReturns
LinearRing.serialize(legacy)String
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.
legacyBoolean, optionalEnables legacy format.

ee.Geometry.LinearRing.simplify

Simplifies the geometry to within a given error margin. Note that this does not respect the error margin requested by the consumer of this algorithm, unless maxError is explicitly specified to be null.

This overrides the default Earth Engine policy for propagating error margins, so regardless of the geometry accuracy requested from the output, the inputs will be requested with the error margin specified in the arguments to this algorithm. This results in consistent rendering at all zoom levels of a rendered vector map, but at lower zoom levels (i.e. zoomed out), the geometry won't be simplified, which may harm performance.

UsageReturns
LinearRing.simplify(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to simplify.
maxErrorErrorMarginThe maximum amount of error by which the result may differ from the input.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in the same projection as the input. If the error margin is in projected units, the margin will be interpreted as units of this projection

ee.Geometry.LinearRing.symmetricDifference

Returns the symmetric difference between two geometries.

UsageReturns
LinearRing.symmetricDifference(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.LinearRing.toGeoJSON

Returns a GeoJSON representation of the geometry.

UsageReturns
LinearRing.toGeoJSON()GeoJSONGeometry
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.

ee.Geometry.LinearRing.toGeoJSONString

Returns a GeoJSON string representation of the geometry.

UsageReturns
LinearRing.toGeoJSONString()String
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.

ee.Geometry.LinearRing.transform

Transforms the geometry to a specific projection.

UsageReturns
LinearRing.transform(proj, maxError)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to reproject.
projProjection, optionalThe target projection. Defaults to WGS84. If this has a geographic CRS, the edges of the geometry will be interpreted as geodesics. Otherwise they will be interpreted as straight lines in the projection.
maxErrorErrorMargin, default: nullThe maximum projection error.

ee.Geometry.LinearRing.type

Returns the GeoJSON type of the geometry.

UsageReturns
LinearRing.type()String
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.LinearRing.union

Returns the union of the two geometries.

UsageReturns
LinearRing.union(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.LinearRing.withinDistance

Returns true if and only if the geometries are within a specified distance.

UsageReturns
LinearRing.withinDistance(right, distance, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
distanceFloatThe distance threshold. If a projection is specified, the distance is in units of that projected coordinate system, otherwise it is in meters.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiLineString

Constructs an ee.Geometry describing a MultiLineString.

For convenience, varargs may be used when all arguments are numbers. This allows creating geodesic EPSG:4326 MultiLineStrings with a single LineString, given an even number of arguments, e.g. ee.Geometry.MultiLineString(aLng, aLat, bLng, bLat, ...).

UsageReturns
ee.Geometry.MultiLineString(coords, proj, geodesic, maxError)Geometry.MultiLineString
ArgumentTypeDetails
coordsListA list of linestrings. May be a list of coordinates in the GeoJSON 'MultiLineString' format, a list of at least two ee.Geometry objects describing a LineString, or a list of numbers defining a single linestring.
projProjection, optionalThe projection of this geometry. If unspecified, the default is the projection of the input ee.Geometry, or EPSG:4326 if there are no ee.Geometry inputs.
geodesicBoolean, optionalIf false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth. The default is the geodesic state of the inputs, or true if the inputs are numbers.
maxErrorErrorMargin, optionalMax error when input geometry must be reprojected to an explicitly requested result projection or geodesic state.

ee.Geometry.MultiLineString.area

Returns the area of the geometry. Area of points and line strings is 0, and the area of multi geometries is the sum of the areas of their components (intersecting areas are counted multiple times).

UsageReturns
MultiLineString.area(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe geometry input.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in square meters.

ee.Geometry.MultiLineString.aside

Calls a function passing this object as the first argument, and returning itself. Convenient e.g. when debugging:

var c = ee.ImageCollection('foo').aside(print)

.filterDate('2001-01-01', '2002-01-01').aside(print, 'In 2001')

.filterBounds(geom).aside(print, 'In region')

.aside(Map.addLayer, {min: 0, max: 142}, 'Filtered')

.select('a', 'b');

Returns the same object, for chaining.

UsageReturns
MultiLineString.aside(func, var_args)ComputedObject
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
funcFunctionThe function to call.
var_argsVarArgsAny extra arguments to pass to the function.

ee.Geometry.MultiLineString.bounds

Returns the bounding rectangle of the geometry.

UsageReturns
MultiLineString.bounds(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryReturn the bounding box of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in WGS84.

ee.Geometry.MultiLineString.buffer

Returns the input buffered by a given distance. If the distance is positive, the geometry is expanded, and if the distance is negative, the geometry is contracted.

UsageReturns
MultiLineString.buffer(distance, maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry being buffered.
distanceFloatThe distance of the buffering, which may be negative. If no projection is specified, the unit is meters. Otherwise the unit is in the coordinate system of the projection.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when approximating the buffering circle and performing any necessary reprojection. If unspecified, defaults to 1% of the distance.
projProjection, default: nullIf specified, the buffering will be performed in this projection and the distance will be interpreted as units of the coordinate system of this projection. Otherwise the distance is interpereted as meters and the buffering is performed in a spherical coordinate system.

ee.Geometry.MultiLineString.centroid

Returns a point at the center of the highest-dimension components of the geometry. Lower-dimensional components are ignored, so the centroid of a geometry containing two polygons, three lines and a point is equivalent to the centroid of a geometry containing just the two polygons.

UsageReturns
MultiLineString.centroid(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCalculates the centroid of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in WGS84.

ee.Geometry.MultiLineString.containedIn

Returns true if and only if one geometry is contained in the other.

UsageReturns
MultiLineString.containedIn(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiLineString.contains

Returns true if and only if one geometry contains the other.

UsageReturns
MultiLineString.contains(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiLineString.convexHull

Returns the convex hull of the given geometry. The convex hull of a single point is the point itself, the convex hull of collinear points is a line, and the convex hull of everything else is a polygon. Note that a degenerate polygon with all vertices on the same line will result in a line segment.

UsageReturns
MultiLineString.convexHull(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCalculates the convex hull of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiLineString.coordinates

Returns a GeoJSON-style list of the geometry's coordinates.

UsageReturns
MultiLineString.coordinates()List
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.MultiLineString.coveringGrid

Returns a collection of features that cover this geometry, where each feature is a rectangle in the grid defined by the given projection.

UsageReturns
MultiLineString.coveringGrid(proj, scale)FeatureCollection
ArgumentTypeDetails
this: geometryGeometryThe result is the grid cells that intersect with this region.
projProjectionThe projection in which to construct the grid. A feature is generated for each grid cell that intersects 'geometry', where cell corners are at integer-valued positions in the projection. If the projection is scaled in meters, the points will be on a grid of that size at the point of true scale.
scaleFloat, default: nullOverrides the scale of the projection, if provided. May be required if the projection isn't already scaled.

ee.Geometry.MultiLineString.cutLines

Converts LineString, MultiLineString, and LinearRing geometries into a MultiLineString by cutting them into parts no longer than the given distance along their length. All other geometry types will be converted to an empty MultiLineString.

UsageReturns
MultiLineString.cutLines(distances, maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCuts the lines of this geometry.
distancesListDistances along each LineString to cut the line into separate pieces, measured in units of the given proj, or meters if proj is unspecified.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullProjection of the result and distance measurements, or WGS84 if unspecified.

ee.Geometry.MultiLineString.difference

Returns the result of subtracting the 'right' geometry from the 'left' geometry.

UsageReturns
MultiLineString.difference(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiLineString.disjoint

Returns true if and only if the geometries are disjoint.

UsageReturns
MultiLineString.disjoint(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiLineString.dissolve

Returns the union of the geometry. This leaves single geometries untouched, and unions multi geometries.

UsageReturns
MultiLineString.dissolve(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to union.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the union will be performed in this projection. Otherwise it will be performed in a spherical coordinate system.

ee.Geometry.MultiLineString.distance

Returns the minimum distance between two geometries.

UsageReturns
MultiLineString.distance(right, maxError, proj)Float
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiLineString.edgesAreGeodesics

Returns true if the geometry edges, if any, are geodesics along a spherical model of the earth; if false, any edges are straight lines in the projection.

UsageReturns
MultiLineString.edgesAreGeodesics()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.MultiLineString.evaluate

Asynchronously retrieves the value of this object from the server and passes it to the provided callback function.

UsageReturns
MultiLineString.evaluate(callback)
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunctionA function of the form function(success, failure), called when the server returns an answer. If the request succeeded, the success argument contains the evaluated result. If the request failed, the failure argument will contains an error message.

ee.Geometry.MultiLineString.geodesic

If false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth.

UsageReturns
MultiLineString.geodesic()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.MultiLineString.geometries

Returns the list of geometries in a GeometryCollection, or a singleton list of the geometry for single geometries.

UsageReturns
MultiLineString.geometries()List
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.MultiLineString.getInfo

Retrieves the value of this object from the server.

If no callback function is provided, the request is made synchronously. If a callback is provided, the request is made asynchronously.

The asynchronous mode is preferred because the synchronous mode stops all other code (for example, the EE Code Editor UI) while waiting for the server. To make an asynchronous request, evaluate() is preferred over getInfo().

Returns the computed value of this object.

UsageReturns
MultiLineString.getInfo(callback)Object
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.Geometry.MultiLineString.intersection

Returns the intersection of the two geometries.

UsageReturns
MultiLineString.intersection(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiLineString.intersects

Returns true if and only if the geometries intersect.

UsageReturns
MultiLineString.intersects(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiLineString.isUnbounded

Returns whether the geometry is unbounded.

UsageReturns
MultiLineString.isUnbounded()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.MultiLineString.length

Returns the length of the linear parts of the geometry. Polygonal parts are ignored. The length of multi geometries is the sum of the lengths of their components.

UsageReturns
MultiLineString.length(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe input geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in meters.

ee.Geometry.MultiLineString.perimeter

Returns the length of the perimeter of the polygonal parts of the geometry. The perimeter of multi geometries is the sum of the perimeters of their components.

UsageReturns
MultiLineString.perimeter(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe input geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in meters.

ee.Geometry.MultiLineString.projection

Returns the projection of the geometry.

UsageReturns
MultiLineString.projection()Projection
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.MultiLineString.serialize

Returns the serialized representation of this object.

UsageReturns
MultiLineString.serialize(legacy)String
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.
legacyBoolean, optionalEnables legacy format.

ee.Geometry.MultiLineString.simplify

Simplifies the geometry to within a given error margin. Note that this does not respect the error margin requested by the consumer of this algorithm, unless maxError is explicitly specified to be null.

This overrides the default Earth Engine policy for propagating error margins, so regardless of the geometry accuracy requested from the output, the inputs will be requested with the error margin specified in the arguments to this algorithm. This results in consistent rendering at all zoom levels of a rendered vector map, but at lower zoom levels (i.e. zoomed out), the geometry won't be simplified, which may harm performance.

UsageReturns
MultiLineString.simplify(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to simplify.
maxErrorErrorMarginThe maximum amount of error by which the result may differ from the input.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in the same projection as the input. If the error margin is in projected units, the margin will be interpreted as units of this projection

ee.Geometry.MultiLineString.symmetricDifference

Returns the symmetric difference between two geometries.

UsageReturns
MultiLineString.symmetricDifference(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiLineString.toGeoJSON

Returns a GeoJSON representation of the geometry.

UsageReturns
MultiLineString.toGeoJSON()GeoJSONGeometry
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.

ee.Geometry.MultiLineString.toGeoJSONString

Returns a GeoJSON string representation of the geometry.

UsageReturns
MultiLineString.toGeoJSONString()String
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.

ee.Geometry.MultiLineString.transform

Transforms the geometry to a specific projection.

UsageReturns
MultiLineString.transform(proj, maxError)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to reproject.
projProjection, optionalThe target projection. Defaults to WGS84. If this has a geographic CRS, the edges of the geometry will be interpreted as geodesics. Otherwise they will be interpreted as straight lines in the projection.
maxErrorErrorMargin, default: nullThe maximum projection error.

ee.Geometry.MultiLineString.type

Returns the GeoJSON type of the geometry.

UsageReturns
MultiLineString.type()String
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.MultiLineString.union

Returns the union of the two geometries.

UsageReturns
MultiLineString.union(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiLineString.withinDistance

Returns true if and only if the geometries are within a specified distance.

UsageReturns
MultiLineString.withinDistance(right, distance, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
distanceFloatThe distance threshold. If a projection is specified, the distance is in units of that projected coordinate system, otherwise it is in meters.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiPoint

Constructs an ee.Geometry describing a MultiPoint.

For convenience, varargs may be used when all arguments are numbers. This allows creating EPSG:4326 MultiPoints given an even number of arguments, e.g. ee.Geometry.MultiPoint(aLng, aLat, bLng, bLat, ...).

UsageReturns
ee.Geometry.MultiPoint(coords, proj)Geometry.MultiPoint
ArgumentTypeDetails
coordsListA list of points, each in the GeoJSON 'coordinates' format of a Point, or a list of the x,y coordinates in the given projection, or an ee.Geometry describing a point.
projProjection, optionalThe projection of this geometry. If unspecified, the default is the projection of the input ee.Geometry, or EPSG:4326 if there are no ee.Geometry inputs.

ee.Geometry.MultiPoint.area

Returns the area of the geometry. Area of points and line strings is 0, and the area of multi geometries is the sum of the areas of their components (intersecting areas are counted multiple times).

UsageReturns
MultiPoint.area(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe geometry input.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in square meters.

ee.Geometry.MultiPoint.aside

Calls a function passing this object as the first argument, and returning itself. Convenient e.g. when debugging:

var c = ee.ImageCollection('foo').aside(print)

.filterDate('2001-01-01', '2002-01-01').aside(print, 'In 2001')

.filterBounds(geom).aside(print, 'In region')

.aside(Map.addLayer, {min: 0, max: 142}, 'Filtered')

.select('a', 'b');

Returns the same object, for chaining.

UsageReturns
MultiPoint.aside(func, var_args)ComputedObject
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
funcFunctionThe function to call.
var_argsVarArgsAny extra arguments to pass to the function.

ee.Geometry.MultiPoint.bounds

Returns the bounding rectangle of the geometry.

UsageReturns
MultiPoint.bounds(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryReturn the bounding box of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in WGS84.

ee.Geometry.MultiPoint.buffer

Returns the input buffered by a given distance. If the distance is positive, the geometry is expanded, and if the distance is negative, the geometry is contracted.

UsageReturns
MultiPoint.buffer(distance, maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry being buffered.
distanceFloatThe distance of the buffering, which may be negative. If no projection is specified, the unit is meters. Otherwise the unit is in the coordinate system of the projection.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when approximating the buffering circle and performing any necessary reprojection. If unspecified, defaults to 1% of the distance.
projProjection, default: nullIf specified, the buffering will be performed in this projection and the distance will be interpreted as units of the coordinate system of this projection. Otherwise the distance is interpereted as meters and the buffering is performed in a spherical coordinate system.

ee.Geometry.MultiPoint.centroid

Returns a point at the center of the highest-dimension components of the geometry. Lower-dimensional components are ignored, so the centroid of a geometry containing two polygons, three lines and a point is equivalent to the centroid of a geometry containing just the two polygons.

UsageReturns
MultiPoint.centroid(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCalculates the centroid of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in WGS84.

ee.Geometry.MultiPoint.containedIn

Returns true if and only if one geometry is contained in the other.

UsageReturns
MultiPoint.containedIn(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiPoint.contains

Returns true if and only if one geometry contains the other.

UsageReturns
MultiPoint.contains(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiPoint.convexHull

Returns the convex hull of the given geometry. The convex hull of a single point is the point itself, the convex hull of collinear points is a line, and the convex hull of everything else is a polygon. Note that a degenerate polygon with all vertices on the same line will result in a line segment.

UsageReturns
MultiPoint.convexHull(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCalculates the convex hull of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiPoint.coordinates

Returns a GeoJSON-style list of the geometry's coordinates.

UsageReturns
MultiPoint.coordinates()List
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.MultiPoint.coveringGrid

Returns a collection of features that cover this geometry, where each feature is a rectangle in the grid defined by the given projection.

UsageReturns
MultiPoint.coveringGrid(proj, scale)FeatureCollection
ArgumentTypeDetails
this: geometryGeometryThe result is the grid cells that intersect with this region.
projProjectionThe projection in which to construct the grid. A feature is generated for each grid cell that intersects 'geometry', where cell corners are at integer-valued positions in the projection. If the projection is scaled in meters, the points will be on a grid of that size at the point of true scale.
scaleFloat, default: nullOverrides the scale of the projection, if provided. May be required if the projection isn't already scaled.

ee.Geometry.MultiPoint.cutLines

Converts LineString, MultiLineString, and LinearRing geometries into a MultiLineString by cutting them into parts no longer than the given distance along their length. All other geometry types will be converted to an empty MultiLineString.

UsageReturns
MultiPoint.cutLines(distances, maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCuts the lines of this geometry.
distancesListDistances along each LineString to cut the line into separate pieces, measured in units of the given proj, or meters if proj is unspecified.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullProjection of the result and distance measurements, or WGS84 if unspecified.

ee.Geometry.MultiPoint.difference

Returns the result of subtracting the 'right' geometry from the 'left' geometry.

UsageReturns
MultiPoint.difference(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiPoint.disjoint

Returns true if and only if the geometries are disjoint.

UsageReturns
MultiPoint.disjoint(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiPoint.dissolve

Returns the union of the geometry. This leaves single geometries untouched, and unions multi geometries.

UsageReturns
MultiPoint.dissolve(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to union.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the union will be performed in this projection. Otherwise it will be performed in a spherical coordinate system.

ee.Geometry.MultiPoint.distance

Returns the minimum distance between two geometries.

UsageReturns
MultiPoint.distance(right, maxError, proj)Float
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiPoint.edgesAreGeodesics

Returns true if the geometry edges, if any, are geodesics along a spherical model of the earth; if false, any edges are straight lines in the projection.

UsageReturns
MultiPoint.edgesAreGeodesics()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.MultiPoint.evaluate

Asynchronously retrieves the value of this object from the server and passes it to the provided callback function.

UsageReturns
MultiPoint.evaluate(callback)
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunctionA function of the form function(success, failure), called when the server returns an answer. If the request succeeded, the success argument contains the evaluated result. If the request failed, the failure argument will contains an error message.

ee.Geometry.MultiPoint.geodesic

If false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth.

UsageReturns
MultiPoint.geodesic()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.MultiPoint.geometries

Returns the list of geometries in a GeometryCollection, or a singleton list of the geometry for single geometries.

UsageReturns
MultiPoint.geometries()List
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.MultiPoint.getInfo

Retrieves the value of this object from the server.

If no callback function is provided, the request is made synchronously. If a callback is provided, the request is made asynchronously.

The asynchronous mode is preferred because the synchronous mode stops all other code (for example, the EE Code Editor UI) while waiting for the server. To make an asynchronous request, evaluate() is preferred over getInfo().

Returns the computed value of this object.

UsageReturns
MultiPoint.getInfo(callback)Object
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.Geometry.MultiPoint.intersection

Returns the intersection of the two geometries.

UsageReturns
MultiPoint.intersection(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiPoint.intersects

Returns true if and only if the geometries intersect.

UsageReturns
MultiPoint.intersects(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiPoint.isUnbounded

Returns whether the geometry is unbounded.

UsageReturns
MultiPoint.isUnbounded()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.MultiPoint.length

Returns the length of the linear parts of the geometry. Polygonal parts are ignored. The length of multi geometries is the sum of the lengths of their components.

UsageReturns
MultiPoint.length(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe input geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in meters.

ee.Geometry.MultiPoint.perimeter

Returns the length of the perimeter of the polygonal parts of the geometry. The perimeter of multi geometries is the sum of the perimeters of their components.

UsageReturns
MultiPoint.perimeter(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe input geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in meters.

ee.Geometry.MultiPoint.projection

Returns the projection of the geometry.

UsageReturns
MultiPoint.projection()Projection
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.MultiPoint.serialize

Returns the serialized representation of this object.

UsageReturns
MultiPoint.serialize(legacy)String
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.
legacyBoolean, optionalEnables legacy format.

ee.Geometry.MultiPoint.simplify

Simplifies the geometry to within a given error margin. Note that this does not respect the error margin requested by the consumer of this algorithm, unless maxError is explicitly specified to be null.

This overrides the default Earth Engine policy for propagating error margins, so regardless of the geometry accuracy requested from the output, the inputs will be requested with the error margin specified in the arguments to this algorithm. This results in consistent rendering at all zoom levels of a rendered vector map, but at lower zoom levels (i.e. zoomed out), the geometry won't be simplified, which may harm performance.

UsageReturns
MultiPoint.simplify(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to simplify.
maxErrorErrorMarginThe maximum amount of error by which the result may differ from the input.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in the same projection as the input. If the error margin is in projected units, the margin will be interpreted as units of this projection

ee.Geometry.MultiPoint.symmetricDifference

Returns the symmetric difference between two geometries.

UsageReturns
MultiPoint.symmetricDifference(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiPoint.toGeoJSON

Returns a GeoJSON representation of the geometry.

UsageReturns
MultiPoint.toGeoJSON()GeoJSONGeometry
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.

ee.Geometry.MultiPoint.toGeoJSONString

Returns a GeoJSON string representation of the geometry.

UsageReturns
MultiPoint.toGeoJSONString()String
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.

ee.Geometry.MultiPoint.transform

Transforms the geometry to a specific projection.

UsageReturns
MultiPoint.transform(proj, maxError)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to reproject.
projProjection, optionalThe target projection. Defaults to WGS84. If this has a geographic CRS, the edges of the geometry will be interpreted as geodesics. Otherwise they will be interpreted as straight lines in the projection.
maxErrorErrorMargin, default: nullThe maximum projection error.

ee.Geometry.MultiPoint.type

Returns the GeoJSON type of the geometry.

UsageReturns
MultiPoint.type()String
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.MultiPoint.union

Returns the union of the two geometries.

UsageReturns
MultiPoint.union(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiPoint.withinDistance

Returns true if and only if the geometries are within a specified distance.

UsageReturns
MultiPoint.withinDistance(right, distance, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
distanceFloatThe distance threshold. If a projection is specified, the distance is in units of that projected coordinate system, otherwise it is in meters.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiPolygon

Constructs an ee.Geometry describing a MultiPolygon.

For convenience, varargs may be used when all arguments are numbers. This allows creating geodesic EPSG:4326 MultiPolygons with a single Polygon with a single LinearRing given an even number of arguments, e.g. ee.Geometry.MultiPolygon(aLng, aLat, bLng, bLat, ..., aLng, aLat).

UsageReturns
ee.Geometry.MultiPolygon(coords, proj, geodesic, maxError, evenOdd)Geometry.MultiPolygon
ArgumentTypeDetails
coordsListA list of polygons. May be a list of coordinates in the GeoJSON 'MultiPolygon' format, a list of ee.Geometry objects describing a Polygon, or a list of numbers defining a single polygon boundary.
projProjection, optionalThe projection of this geometry. The default is the projection of the inputs, where Numbers are assumed to be EPSG:4326.
geodesicBoolean, optionalIf false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth. The default is the geodesic state of the inputs, or true if the inputs are numbers.
maxErrorErrorMargin, optionalMax error when input geometry must be reprojected to an explicitly requested result projection or geodesic state.
evenOddBoolean, optionalIf true, polygon interiors will be determined by the even/odd rule, where a point is inside if it crosses an odd number of edges to reach a point at infinity. Otherwise polygons use the left- inside rule, where interiors are on the left side of the shell's edges when walking the vertices in the given order. If unspecified, defaults to true.

ee.Geometry.MultiPolygon.area

Returns the area of the geometry. Area of points and line strings is 0, and the area of multi geometries is the sum of the areas of their components (intersecting areas are counted multiple times).

UsageReturns
MultiPolygon.area(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe geometry input.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in square meters.

ee.Geometry.MultiPolygon.aside

Calls a function passing this object as the first argument, and returning itself. Convenient e.g. when debugging:

var c = ee.ImageCollection('foo').aside(print)

.filterDate('2001-01-01', '2002-01-01').aside(print, 'In 2001')

.filterBounds(geom).aside(print, 'In region')

.aside(Map.addLayer, {min: 0, max: 142}, 'Filtered')

.select('a', 'b');

Returns the same object, for chaining.

UsageReturns
MultiPolygon.aside(func, var_args)ComputedObject
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
funcFunctionThe function to call.
var_argsVarArgsAny extra arguments to pass to the function.

ee.Geometry.MultiPolygon.bounds

Returns the bounding rectangle of the geometry.

UsageReturns
MultiPolygon.bounds(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryReturn the bounding box of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in WGS84.

ee.Geometry.MultiPolygon.buffer

Returns the input buffered by a given distance. If the distance is positive, the geometry is expanded, and if the distance is negative, the geometry is contracted.

UsageReturns
MultiPolygon.buffer(distance, maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry being buffered.
distanceFloatThe distance of the buffering, which may be negative. If no projection is specified, the unit is meters. Otherwise the unit is in the coordinate system of the projection.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when approximating the buffering circle and performing any necessary reprojection. If unspecified, defaults to 1% of the distance.
projProjection, default: nullIf specified, the buffering will be performed in this projection and the distance will be interpreted as units of the coordinate system of this projection. Otherwise the distance is interpereted as meters and the buffering is performed in a spherical coordinate system.

ee.Geometry.MultiPolygon.centroid

Returns a point at the center of the highest-dimension components of the geometry. Lower-dimensional components are ignored, so the centroid of a geometry containing two polygons, three lines and a point is equivalent to the centroid of a geometry containing just the two polygons.

UsageReturns
MultiPolygon.centroid(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCalculates the centroid of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in WGS84.

ee.Geometry.MultiPolygon.containedIn

Returns true if and only if one geometry is contained in the other.

UsageReturns
MultiPolygon.containedIn(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiPolygon.contains

Returns true if and only if one geometry contains the other.

UsageReturns
MultiPolygon.contains(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiPolygon.convexHull

Returns the convex hull of the given geometry. The convex hull of a single point is the point itself, the convex hull of collinear points is a line, and the convex hull of everything else is a polygon. Note that a degenerate polygon with all vertices on the same line will result in a line segment.

UsageReturns
MultiPolygon.convexHull(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCalculates the convex hull of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiPolygon.coordinates

Returns a GeoJSON-style list of the geometry's coordinates.

UsageReturns
MultiPolygon.coordinates()List
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.MultiPolygon.coveringGrid

Returns a collection of features that cover this geometry, where each feature is a rectangle in the grid defined by the given projection.

UsageReturns
MultiPolygon.coveringGrid(proj, scale)FeatureCollection
ArgumentTypeDetails
this: geometryGeometryThe result is the grid cells that intersect with this region.
projProjectionThe projection in which to construct the grid. A feature is generated for each grid cell that intersects 'geometry', where cell corners are at integer-valued positions in the projection. If the projection is scaled in meters, the points will be on a grid of that size at the point of true scale.
scaleFloat, default: nullOverrides the scale of the projection, if provided. May be required if the projection isn't already scaled.

ee.Geometry.MultiPolygon.cutLines

Converts LineString, MultiLineString, and LinearRing geometries into a MultiLineString by cutting them into parts no longer than the given distance along their length. All other geometry types will be converted to an empty MultiLineString.

UsageReturns
MultiPolygon.cutLines(distances, maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCuts the lines of this geometry.
distancesListDistances along each LineString to cut the line into separate pieces, measured in units of the given proj, or meters if proj is unspecified.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullProjection of the result and distance measurements, or WGS84 if unspecified.

ee.Geometry.MultiPolygon.difference

Returns the result of subtracting the 'right' geometry from the 'left' geometry.

UsageReturns
MultiPolygon.difference(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiPolygon.disjoint

Returns true if and only if the geometries are disjoint.

UsageReturns
MultiPolygon.disjoint(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiPolygon.dissolve

Returns the union of the geometry. This leaves single geometries untouched, and unions multi geometries.

UsageReturns
MultiPolygon.dissolve(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to union.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the union will be performed in this projection. Otherwise it will be performed in a spherical coordinate system.

ee.Geometry.MultiPolygon.distance

Returns the minimum distance between two geometries.

UsageReturns
MultiPolygon.distance(right, maxError, proj)Float
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiPolygon.edgesAreGeodesics

Returns true if the geometry edges, if any, are geodesics along a spherical model of the earth; if false, any edges are straight lines in the projection.

UsageReturns
MultiPolygon.edgesAreGeodesics()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.MultiPolygon.evaluate

Asynchronously retrieves the value of this object from the server and passes it to the provided callback function.

UsageReturns
MultiPolygon.evaluate(callback)
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunctionA function of the form function(success, failure), called when the server returns an answer. If the request succeeded, the success argument contains the evaluated result. If the request failed, the failure argument will contains an error message.

ee.Geometry.MultiPolygon.geodesic

If false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth.

UsageReturns
MultiPolygon.geodesic()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.MultiPolygon.geometries

Returns the list of geometries in a GeometryCollection, or a singleton list of the geometry for single geometries.

UsageReturns
MultiPolygon.geometries()List
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.MultiPolygon.getInfo

Retrieves the value of this object from the server.

If no callback function is provided, the request is made synchronously. If a callback is provided, the request is made asynchronously.

The asynchronous mode is preferred because the synchronous mode stops all other code (for example, the EE Code Editor UI) while waiting for the server. To make an asynchronous request, evaluate() is preferred over getInfo().

Returns the computed value of this object.

UsageReturns
MultiPolygon.getInfo(callback)Object
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.Geometry.MultiPolygon.intersection

Returns the intersection of the two geometries.

UsageReturns
MultiPolygon.intersection(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiPolygon.intersects

Returns true if and only if the geometries intersect.

UsageReturns
MultiPolygon.intersects(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiPolygon.isUnbounded

Returns whether the geometry is unbounded.

UsageReturns
MultiPolygon.isUnbounded()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.MultiPolygon.length

Returns the length of the linear parts of the geometry. Polygonal parts are ignored. The length of multi geometries is the sum of the lengths of their components.

UsageReturns
MultiPolygon.length(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe input geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in meters.

ee.Geometry.MultiPolygon.perimeter

Returns the length of the perimeter of the polygonal parts of the geometry. The perimeter of multi geometries is the sum of the perimeters of their components.

UsageReturns
MultiPolygon.perimeter(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe input geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in meters.

ee.Geometry.MultiPolygon.projection

Returns the projection of the geometry.

UsageReturns
MultiPolygon.projection()Projection
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.MultiPolygon.serialize

Returns the serialized representation of this object.

UsageReturns
MultiPolygon.serialize(legacy)String
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.
legacyBoolean, optionalEnables legacy format.

ee.Geometry.MultiPolygon.simplify

Simplifies the geometry to within a given error margin. Note that this does not respect the error margin requested by the consumer of this algorithm, unless maxError is explicitly specified to be null.

This overrides the default Earth Engine policy for propagating error margins, so regardless of the geometry accuracy requested from the output, the inputs will be requested with the error margin specified in the arguments to this algorithm. This results in consistent rendering at all zoom levels of a rendered vector map, but at lower zoom levels (i.e. zoomed out), the geometry won't be simplified, which may harm performance.

UsageReturns
MultiPolygon.simplify(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to simplify.
maxErrorErrorMarginThe maximum amount of error by which the result may differ from the input.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in the same projection as the input. If the error margin is in projected units, the margin will be interpreted as units of this projection

ee.Geometry.MultiPolygon.symmetricDifference

Returns the symmetric difference between two geometries.

UsageReturns
MultiPolygon.symmetricDifference(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiPolygon.toGeoJSON

Returns a GeoJSON representation of the geometry.

UsageReturns
MultiPolygon.toGeoJSON()GeoJSONGeometry
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.

ee.Geometry.MultiPolygon.toGeoJSONString

Returns a GeoJSON string representation of the geometry.

UsageReturns
MultiPolygon.toGeoJSONString()String
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.

ee.Geometry.MultiPolygon.transform

Transforms the geometry to a specific projection.

UsageReturns
MultiPolygon.transform(proj, maxError)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to reproject.
projProjection, optionalThe target projection. Defaults to WGS84. If this has a geographic CRS, the edges of the geometry will be interpreted as geodesics. Otherwise they will be interpreted as straight lines in the projection.
maxErrorErrorMargin, default: nullThe maximum projection error.

ee.Geometry.MultiPolygon.type

Returns the GeoJSON type of the geometry.

UsageReturns
MultiPolygon.type()String
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.MultiPolygon.union

Returns the union of the two geometries.

UsageReturns
MultiPolygon.union(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.MultiPolygon.withinDistance

Returns true if and only if the geometries are within a specified distance.

UsageReturns
MultiPolygon.withinDistance(right, distance, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
distanceFloatThe distance threshold. If a projection is specified, the distance is in units of that projected coordinate system, otherwise it is in meters.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Point

Constructs an ee.Geometry describing a point.

For convenience, varargs may be used when all arguments are numbers. This allows creating EPSG:4326 points, e.g. ee.Geometry.Point(lng, lat).

UsageReturns
ee.Geometry.Point(coords, proj)Geometry.Point
ArgumentTypeDetails
coordsListA list of two [x,y] coordinates in the given projection.
projProjection, optionalThe projection of this geometry, or EPSG:4326 if unspecified.

ee.Geometry.Point.area

Returns the area of the geometry. Area of points and line strings is 0, and the area of multi geometries is the sum of the areas of their components (intersecting areas are counted multiple times).

UsageReturns
Point.area(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe geometry input.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in square meters.

ee.Geometry.Point.aside

Calls a function passing this object as the first argument, and returning itself. Convenient e.g. when debugging:

var c = ee.ImageCollection('foo').aside(print)

.filterDate('2001-01-01', '2002-01-01').aside(print, 'In 2001')

.filterBounds(geom).aside(print, 'In region')

.aside(Map.addLayer, {min: 0, max: 142}, 'Filtered')

.select('a', 'b');

Returns the same object, for chaining.

UsageReturns
Point.aside(func, var_args)ComputedObject
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
funcFunctionThe function to call.
var_argsVarArgsAny extra arguments to pass to the function.

ee.Geometry.Point.bounds

Returns the bounding rectangle of the geometry.

UsageReturns
Point.bounds(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryReturn the bounding box of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in WGS84.

ee.Geometry.Point.buffer

Returns the input buffered by a given distance. If the distance is positive, the geometry is expanded, and if the distance is negative, the geometry is contracted.

UsageReturns
Point.buffer(distance, maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry being buffered.
distanceFloatThe distance of the buffering, which may be negative. If no projection is specified, the unit is meters. Otherwise the unit is in the coordinate system of the projection.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when approximating the buffering circle and performing any necessary reprojection. If unspecified, defaults to 1% of the distance.
projProjection, default: nullIf specified, the buffering will be performed in this projection and the distance will be interpreted as units of the coordinate system of this projection. Otherwise the distance is interpereted as meters and the buffering is performed in a spherical coordinate system.

ee.Geometry.Point.centroid

Returns a point at the center of the highest-dimension components of the geometry. Lower-dimensional components are ignored, so the centroid of a geometry containing two polygons, three lines and a point is equivalent to the centroid of a geometry containing just the two polygons.

UsageReturns
Point.centroid(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCalculates the centroid of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in WGS84.

ee.Geometry.Point.containedIn

Returns true if and only if one geometry is contained in the other.

UsageReturns
Point.containedIn(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Point.contains

Returns true if and only if one geometry contains the other.

UsageReturns
Point.contains(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Point.convexHull

Returns the convex hull of the given geometry. The convex hull of a single point is the point itself, the convex hull of collinear points is a line, and the convex hull of everything else is a polygon. Note that a degenerate polygon with all vertices on the same line will result in a line segment.

UsageReturns
Point.convexHull(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCalculates the convex hull of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Point.coordinates

Returns a GeoJSON-style list of the geometry's coordinates.

UsageReturns
Point.coordinates()List
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.Point.coveringGrid

Returns a collection of features that cover this geometry, where each feature is a rectangle in the grid defined by the given projection.

UsageReturns
Point.coveringGrid(proj, scale)FeatureCollection
ArgumentTypeDetails
this: geometryGeometryThe result is the grid cells that intersect with this region.
projProjectionThe projection in which to construct the grid. A feature is generated for each grid cell that intersects 'geometry', where cell corners are at integer-valued positions in the projection. If the projection is scaled in meters, the points will be on a grid of that size at the point of true scale.
scaleFloat, default: nullOverrides the scale of the projection, if provided. May be required if the projection isn't already scaled.

ee.Geometry.Point.cutLines

Converts LineString, MultiLineString, and LinearRing geometries into a MultiLineString by cutting them into parts no longer than the given distance along their length. All other geometry types will be converted to an empty MultiLineString.

UsageReturns
Point.cutLines(distances, maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCuts the lines of this geometry.
distancesListDistances along each LineString to cut the line into separate pieces, measured in units of the given proj, or meters if proj is unspecified.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullProjection of the result and distance measurements, or WGS84 if unspecified.

ee.Geometry.Point.difference

Returns the result of subtracting the 'right' geometry from the 'left' geometry.

UsageReturns
Point.difference(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Point.disjoint

Returns true if and only if the geometries are disjoint.

UsageReturns
Point.disjoint(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Point.dissolve

Returns the union of the geometry. This leaves single geometries untouched, and unions multi geometries.

UsageReturns
Point.dissolve(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to union.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the union will be performed in this projection. Otherwise it will be performed in a spherical coordinate system.

ee.Geometry.Point.distance

Returns the minimum distance between two geometries.

UsageReturns
Point.distance(right, maxError, proj)Float
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Point.edgesAreGeodesics

Returns true if the geometry edges, if any, are geodesics along a spherical model of the earth; if false, any edges are straight lines in the projection.

UsageReturns
Point.edgesAreGeodesics()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.Point.evaluate

Asynchronously retrieves the value of this object from the server and passes it to the provided callback function.

UsageReturns
Point.evaluate(callback)
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunctionA function of the form function(success, failure), called when the server returns an answer. If the request succeeded, the success argument contains the evaluated result. If the request failed, the failure argument will contains an error message.

ee.Geometry.Point.geodesic

If false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth.

UsageReturns
Point.geodesic()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.Point.geometries

Returns the list of geometries in a GeometryCollection, or a singleton list of the geometry for single geometries.

UsageReturns
Point.geometries()List
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.Point.getInfo

Retrieves the value of this object from the server.

If no callback function is provided, the request is made synchronously. If a callback is provided, the request is made asynchronously.

The asynchronous mode is preferred because the synchronous mode stops all other code (for example, the EE Code Editor UI) while waiting for the server. To make an asynchronous request, evaluate() is preferred over getInfo().

Returns the computed value of this object.

UsageReturns
Point.getInfo(callback)Object
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.Geometry.Point.intersection

Returns the intersection of the two geometries.

UsageReturns
Point.intersection(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Point.intersects

Returns true if and only if the geometries intersect.

UsageReturns
Point.intersects(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Point.isUnbounded

Returns whether the geometry is unbounded.

UsageReturns
Point.isUnbounded()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.Point.length

Returns the length of the linear parts of the geometry. Polygonal parts are ignored. The length of multi geometries is the sum of the lengths of their components.

UsageReturns
Point.length(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe input geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in meters.

ee.Geometry.Point.perimeter

Returns the length of the perimeter of the polygonal parts of the geometry. The perimeter of multi geometries is the sum of the perimeters of their components.

UsageReturns
Point.perimeter(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe input geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in meters.

ee.Geometry.Point.projection

Returns the projection of the geometry.

UsageReturns
Point.projection()Projection
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.Point.serialize

Returns the serialized representation of this object.

UsageReturns
Point.serialize(legacy)String
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.
legacyBoolean, optionalEnables legacy format.

ee.Geometry.Point.simplify

Simplifies the geometry to within a given error margin. Note that this does not respect the error margin requested by the consumer of this algorithm, unless maxError is explicitly specified to be null.

This overrides the default Earth Engine policy for propagating error margins, so regardless of the geometry accuracy requested from the output, the inputs will be requested with the error margin specified in the arguments to this algorithm. This results in consistent rendering at all zoom levels of a rendered vector map, but at lower zoom levels (i.e. zoomed out), the geometry won't be simplified, which may harm performance.

UsageReturns
Point.simplify(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to simplify.
maxErrorErrorMarginThe maximum amount of error by which the result may differ from the input.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in the same projection as the input. If the error margin is in projected units, the margin will be interpreted as units of this projection

ee.Geometry.Point.symmetricDifference

Returns the symmetric difference between two geometries.

UsageReturns
Point.symmetricDifference(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Point.toGeoJSON

Returns a GeoJSON representation of the geometry.

UsageReturns
Point.toGeoJSON()GeoJSONGeometry
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.

ee.Geometry.Point.toGeoJSONString

Returns a GeoJSON string representation of the geometry.

UsageReturns
Point.toGeoJSONString()String
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.

ee.Geometry.Point.transform

Transforms the geometry to a specific projection.

UsageReturns
Point.transform(proj, maxError)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to reproject.
projProjection, optionalThe target projection. Defaults to WGS84. If this has a geographic CRS, the edges of the geometry will be interpreted as geodesics. Otherwise they will be interpreted as straight lines in the projection.
maxErrorErrorMargin, default: nullThe maximum projection error.

ee.Geometry.Point.type

Returns the GeoJSON type of the geometry.

UsageReturns
Point.type()String
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.Point.union

Returns the union of the two geometries.

UsageReturns
Point.union(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Point.withinDistance

Returns true if and only if the geometries are within a specified distance.

UsageReturns
Point.withinDistance(right, distance, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
distanceFloatThe distance threshold. If a projection is specified, the distance is in units of that projected coordinate system, otherwise it is in meters.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Polygon

Constructs an ee.Geometry describing a polygon.

For convenience, varargs may be used when all arguments are numbers. This allows creating geodesic EPSG:4326 Polygons with a single LinearRing given an even number of arguments, e.g. ee.Geometry.Polygon(aLng, aLat, bLng, bLat, ..., aLng, aLat).

UsageReturns
ee.Geometry.Polygon(coords, proj, geodesic, maxError, evenOdd)Geometry.Polygon
ArgumentTypeDetails
coordsListA list of rings defining the boundaries of the polygon. May be a list of coordinates in the GeoJSON 'Polygon' format, a list of ee.Geometry objects describing a LinearRing, or a list of numbers defining a single polygon boundary.
projProjection, optionalThe projection of this geometry. The default is the projection of the inputs, where Numbers are assumed to be EPSG:4326.
geodesicBoolean, optionalIf false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth. The default is the geodesic state of the inputs, or true if the inputs are numbers.
maxErrorErrorMargin, optionalMax error when input geometry must be reprojected to an explicitly requested result projection or geodesic state.
evenOddBoolean, optionalIf true, polygon interiors will be determined by the even/odd rule, where a point is inside if it crosses an odd number of edges to reach a point at infinity. Otherwise polygons use the left- inside rule, where interiors are on the left side of the shell's edges when walking the vertices in the given order. If unspecified, defaults to true.

ee.Geometry.Polygon.area

Returns the area of the geometry. Area of points and line strings is 0, and the area of multi geometries is the sum of the areas of their components (intersecting areas are counted multiple times).

UsageReturns
Polygon.area(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe geometry input.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in square meters.

ee.Geometry.Polygon.aside

Calls a function passing this object as the first argument, and returning itself. Convenient e.g. when debugging:

var c = ee.ImageCollection('foo').aside(print)

.filterDate('2001-01-01', '2002-01-01').aside(print, 'In 2001')

.filterBounds(geom).aside(print, 'In region')

.aside(Map.addLayer, {min: 0, max: 142}, 'Filtered')

.select('a', 'b');

Returns the same object, for chaining.

UsageReturns
Polygon.aside(func, var_args)ComputedObject
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
funcFunctionThe function to call.
var_argsVarArgsAny extra arguments to pass to the function.

ee.Geometry.Polygon.bounds

Returns the bounding rectangle of the geometry.

UsageReturns
Polygon.bounds(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryReturn the bounding box of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in WGS84.

ee.Geometry.Polygon.buffer

Returns the input buffered by a given distance. If the distance is positive, the geometry is expanded, and if the distance is negative, the geometry is contracted.

UsageReturns
Polygon.buffer(distance, maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry being buffered.
distanceFloatThe distance of the buffering, which may be negative. If no projection is specified, the unit is meters. Otherwise the unit is in the coordinate system of the projection.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when approximating the buffering circle and performing any necessary reprojection. If unspecified, defaults to 1% of the distance.
projProjection, default: nullIf specified, the buffering will be performed in this projection and the distance will be interpreted as units of the coordinate system of this projection. Otherwise the distance is interpereted as meters and the buffering is performed in a spherical coordinate system.

ee.Geometry.Polygon.centroid

Returns a point at the center of the highest-dimension components of the geometry. Lower-dimensional components are ignored, so the centroid of a geometry containing two polygons, three lines and a point is equivalent to the centroid of a geometry containing just the two polygons.

UsageReturns
Polygon.centroid(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCalculates the centroid of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in WGS84.

ee.Geometry.Polygon.containedIn

Returns true if and only if one geometry is contained in the other.

UsageReturns
Polygon.containedIn(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Polygon.contains

Returns true if and only if one geometry contains the other.

UsageReturns
Polygon.contains(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Polygon.convexHull

Returns the convex hull of the given geometry. The convex hull of a single point is the point itself, the convex hull of collinear points is a line, and the convex hull of everything else is a polygon. Note that a degenerate polygon with all vertices on the same line will result in a line segment.

UsageReturns
Polygon.convexHull(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCalculates the convex hull of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Polygon.coordinates

Returns a GeoJSON-style list of the geometry's coordinates.

UsageReturns
Polygon.coordinates()List
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.Polygon.coveringGrid

Returns a collection of features that cover this geometry, where each feature is a rectangle in the grid defined by the given projection.

UsageReturns
Polygon.coveringGrid(proj, scale)FeatureCollection
ArgumentTypeDetails
this: geometryGeometryThe result is the grid cells that intersect with this region.
projProjectionThe projection in which to construct the grid. A feature is generated for each grid cell that intersects 'geometry', where cell corners are at integer-valued positions in the projection. If the projection is scaled in meters, the points will be on a grid of that size at the point of true scale.
scaleFloat, default: nullOverrides the scale of the projection, if provided. May be required if the projection isn't already scaled.

ee.Geometry.Polygon.cutLines

Converts LineString, MultiLineString, and LinearRing geometries into a MultiLineString by cutting them into parts no longer than the given distance along their length. All other geometry types will be converted to an empty MultiLineString.

UsageReturns
Polygon.cutLines(distances, maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCuts the lines of this geometry.
distancesListDistances along each LineString to cut the line into separate pieces, measured in units of the given proj, or meters if proj is unspecified.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullProjection of the result and distance measurements, or WGS84 if unspecified.

ee.Geometry.Polygon.difference

Returns the result of subtracting the 'right' geometry from the 'left' geometry.

UsageReturns
Polygon.difference(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Polygon.disjoint

Returns true if and only if the geometries are disjoint.

UsageReturns
Polygon.disjoint(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Polygon.dissolve

Returns the union of the geometry. This leaves single geometries untouched, and unions multi geometries.

UsageReturns
Polygon.dissolve(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to union.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the union will be performed in this projection. Otherwise it will be performed in a spherical coordinate system.

ee.Geometry.Polygon.distance

Returns the minimum distance between two geometries.

UsageReturns
Polygon.distance(right, maxError, proj)Float
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Polygon.edgesAreGeodesics

Returns true if the geometry edges, if any, are geodesics along a spherical model of the earth; if false, any edges are straight lines in the projection.

UsageReturns
Polygon.edgesAreGeodesics()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.Polygon.evaluate

Asynchronously retrieves the value of this object from the server and passes it to the provided callback function.

UsageReturns
Polygon.evaluate(callback)
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunctionA function of the form function(success, failure), called when the server returns an answer. If the request succeeded, the success argument contains the evaluated result. If the request failed, the failure argument will contains an error message.

ee.Geometry.Polygon.geodesic

If false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth.

UsageReturns
Polygon.geodesic()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.Polygon.geometries

Returns the list of geometries in a GeometryCollection, or a singleton list of the geometry for single geometries.

UsageReturns
Polygon.geometries()List
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.Polygon.getInfo

Retrieves the value of this object from the server.

If no callback function is provided, the request is made synchronously. If a callback is provided, the request is made asynchronously.

The asynchronous mode is preferred because the synchronous mode stops all other code (for example, the EE Code Editor UI) while waiting for the server. To make an asynchronous request, evaluate() is preferred over getInfo().

Returns the computed value of this object.

UsageReturns
Polygon.getInfo(callback)Object
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.Geometry.Polygon.intersection

Returns the intersection of the two geometries.

UsageReturns
Polygon.intersection(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Polygon.intersects

Returns true if and only if the geometries intersect.

UsageReturns
Polygon.intersects(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Polygon.isUnbounded

Returns whether the geometry is unbounded.

UsageReturns
Polygon.isUnbounded()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.Polygon.length

Returns the length of the linear parts of the geometry. Polygonal parts are ignored. The length of multi geometries is the sum of the lengths of their components.

UsageReturns
Polygon.length(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe input geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in meters.

ee.Geometry.Polygon.perimeter

Returns the length of the perimeter of the polygonal parts of the geometry. The perimeter of multi geometries is the sum of the perimeters of their components.

UsageReturns
Polygon.perimeter(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe input geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in meters.

ee.Geometry.Polygon.projection

Returns the projection of the geometry.

UsageReturns
Polygon.projection()Projection
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.Polygon.serialize

Returns the serialized representation of this object.

UsageReturns
Polygon.serialize(legacy)String
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.
legacyBoolean, optionalEnables legacy format.

ee.Geometry.Polygon.simplify

Simplifies the geometry to within a given error margin. Note that this does not respect the error margin requested by the consumer of this algorithm, unless maxError is explicitly specified to be null.

This overrides the default Earth Engine policy for propagating error margins, so regardless of the geometry accuracy requested from the output, the inputs will be requested with the error margin specified in the arguments to this algorithm. This results in consistent rendering at all zoom levels of a rendered vector map, but at lower zoom levels (i.e. zoomed out), the geometry won't be simplified, which may harm performance.

UsageReturns
Polygon.simplify(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to simplify.
maxErrorErrorMarginThe maximum amount of error by which the result may differ from the input.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in the same projection as the input. If the error margin is in projected units, the margin will be interpreted as units of this projection

ee.Geometry.Polygon.symmetricDifference

Returns the symmetric difference between two geometries.

UsageReturns
Polygon.symmetricDifference(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Polygon.toGeoJSON

Returns a GeoJSON representation of the geometry.

UsageReturns
Polygon.toGeoJSON()GeoJSONGeometry
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.

ee.Geometry.Polygon.toGeoJSONString

Returns a GeoJSON string representation of the geometry.

UsageReturns
Polygon.toGeoJSONString()String
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.

ee.Geometry.Polygon.transform

Transforms the geometry to a specific projection.

UsageReturns
Polygon.transform(proj, maxError)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to reproject.
projProjection, optionalThe target projection. Defaults to WGS84. If this has a geographic CRS, the edges of the geometry will be interpreted as geodesics. Otherwise they will be interpreted as straight lines in the projection.
maxErrorErrorMargin, default: nullThe maximum projection error.

ee.Geometry.Polygon.type

Returns the GeoJSON type of the geometry.

UsageReturns
Polygon.type()String
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.Polygon.union

Returns the union of the two geometries.

UsageReturns
Polygon.union(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Polygon.withinDistance

Returns true if and only if the geometries are within a specified distance.

UsageReturns
Polygon.withinDistance(right, distance, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
distanceFloatThe distance threshold. If a projection is specified, the distance is in units of that projected coordinate system, otherwise it is in meters.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Rectangle

Constructs an ee.Geometry describing a rectangular polygon.

For convenience, varargs may be used when all arguments are numbers. This allows creating EPSG:4326 Polygons given exactly four coordinates, e.g. ee.Geometry.Rectangle(minLng, minLat, maxLng, maxLat).

UsageReturns
ee.Geometry.Rectangle(coords, proj, geodesic, evenOdd)Geometry.Rectangle
ArgumentTypeDetails
coordsListThe minimum and maximum corners of the rectangle, as a list of two points each in the format of GeoJSON 'Point' coordinates, or a list of two ee.Geometry objects describing a point, or a list of four numbers in the order xMin, yMin, xMax, yMax.
projProjection, optionalThe projection of this geometry. If unspecified, the default is the projection of the input ee.Geometry, or EPSG:4326 if there are no ee.Geometry inputs.
geodesicBoolean, optionalIf false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth. The default is the geodesic state of the inputs, or true if the inputs are numbers.
evenOddBoolean, optionalIf true, polygon interiors will be determined by the even/odd rule, where a point is inside if it crosses an odd number of edges to reach a point at infinity. Otherwise polygons use the left- inside rule, where interiors are on the left side of the shell's edges when walking the vertices in the given order. If unspecified, defaults to true.

ee.Geometry.Rectangle.area

Returns the area of the geometry. Area of points and line strings is 0, and the area of multi geometries is the sum of the areas of their components (intersecting areas are counted multiple times).

UsageReturns
Rectangle.area(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe geometry input.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in square meters.

ee.Geometry.Rectangle.aside

Calls a function passing this object as the first argument, and returning itself. Convenient e.g. when debugging:

var c = ee.ImageCollection('foo').aside(print)

.filterDate('2001-01-01', '2002-01-01').aside(print, 'In 2001')

.filterBounds(geom).aside(print, 'In region')

.aside(Map.addLayer, {min: 0, max: 142}, 'Filtered')

.select('a', 'b');

Returns the same object, for chaining.

UsageReturns
Rectangle.aside(func, var_args)ComputedObject
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
funcFunctionThe function to call.
var_argsVarArgsAny extra arguments to pass to the function.

ee.Geometry.Rectangle.bounds

Returns the bounding rectangle of the geometry.

UsageReturns
Rectangle.bounds(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryReturn the bounding box of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in WGS84.

ee.Geometry.Rectangle.buffer

Returns the input buffered by a given distance. If the distance is positive, the geometry is expanded, and if the distance is negative, the geometry is contracted.

UsageReturns
Rectangle.buffer(distance, maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry being buffered.
distanceFloatThe distance of the buffering, which may be negative. If no projection is specified, the unit is meters. Otherwise the unit is in the coordinate system of the projection.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when approximating the buffering circle and performing any necessary reprojection. If unspecified, defaults to 1% of the distance.
projProjection, default: nullIf specified, the buffering will be performed in this projection and the distance will be interpreted as units of the coordinate system of this projection. Otherwise the distance is interpereted as meters and the buffering is performed in a spherical coordinate system.

ee.Geometry.Rectangle.centroid

Returns a point at the center of the highest-dimension components of the geometry. Lower-dimensional components are ignored, so the centroid of a geometry containing two polygons, three lines and a point is equivalent to the centroid of a geometry containing just the two polygons.

UsageReturns
Rectangle.centroid(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCalculates the centroid of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in WGS84.

ee.Geometry.Rectangle.containedIn

Returns true if and only if one geometry is contained in the other.

UsageReturns
Rectangle.containedIn(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Rectangle.contains

Returns true if and only if one geometry contains the other.

UsageReturns
Rectangle.contains(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Rectangle.convexHull

Returns the convex hull of the given geometry. The convex hull of a single point is the point itself, the convex hull of collinear points is a line, and the convex hull of everything else is a polygon. Note that a degenerate polygon with all vertices on the same line will result in a line segment.

UsageReturns
Rectangle.convexHull(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCalculates the convex hull of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Rectangle.coordinates

Returns a GeoJSON-style list of the geometry's coordinates.

UsageReturns
Rectangle.coordinates()List
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.Rectangle.coveringGrid

Returns a collection of features that cover this geometry, where each feature is a rectangle in the grid defined by the given projection.

UsageReturns
Rectangle.coveringGrid(proj, scale)FeatureCollection
ArgumentTypeDetails
this: geometryGeometryThe result is the grid cells that intersect with this region.
projProjectionThe projection in which to construct the grid. A feature is generated for each grid cell that intersects 'geometry', where cell corners are at integer-valued positions in the projection. If the projection is scaled in meters, the points will be on a grid of that size at the point of true scale.
scaleFloat, default: nullOverrides the scale of the projection, if provided. May be required if the projection isn't already scaled.

ee.Geometry.Rectangle.cutLines

Converts LineString, MultiLineString, and LinearRing geometries into a MultiLineString by cutting them into parts no longer than the given distance along their length. All other geometry types will be converted to an empty MultiLineString.

UsageReturns
Rectangle.cutLines(distances, maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCuts the lines of this geometry.
distancesListDistances along each LineString to cut the line into separate pieces, measured in units of the given proj, or meters if proj is unspecified.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullProjection of the result and distance measurements, or WGS84 if unspecified.

ee.Geometry.Rectangle.difference

Returns the result of subtracting the 'right' geometry from the 'left' geometry.

UsageReturns
Rectangle.difference(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Rectangle.disjoint

Returns true if and only if the geometries are disjoint.

UsageReturns
Rectangle.disjoint(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Rectangle.dissolve

Returns the union of the geometry. This leaves single geometries untouched, and unions multi geometries.

UsageReturns
Rectangle.dissolve(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to union.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the union will be performed in this projection. Otherwise it will be performed in a spherical coordinate system.

ee.Geometry.Rectangle.distance

Returns the minimum distance between two geometries.

UsageReturns
Rectangle.distance(right, maxError, proj)Float
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Rectangle.edgesAreGeodesics

Returns true if the geometry edges, if any, are geodesics along a spherical model of the earth; if false, any edges are straight lines in the projection.

UsageReturns
Rectangle.edgesAreGeodesics()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.Rectangle.evaluate

Asynchronously retrieves the value of this object from the server and passes it to the provided callback function.

UsageReturns
Rectangle.evaluate(callback)
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunctionA function of the form function(success, failure), called when the server returns an answer. If the request succeeded, the success argument contains the evaluated result. If the request failed, the failure argument will contains an error message.

ee.Geometry.Rectangle.geodesic

If false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth.

UsageReturns
Rectangle.geodesic()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.Rectangle.geometries

Returns the list of geometries in a GeometryCollection, or a singleton list of the geometry for single geometries.

UsageReturns
Rectangle.geometries()List
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.Rectangle.getInfo

Retrieves the value of this object from the server.

If no callback function is provided, the request is made synchronously. If a callback is provided, the request is made asynchronously.

The asynchronous mode is preferred because the synchronous mode stops all other code (for example, the EE Code Editor UI) while waiting for the server. To make an asynchronous request, evaluate() is preferred over getInfo().

Returns the computed value of this object.

UsageReturns
Rectangle.getInfo(callback)Object
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.Geometry.Rectangle.intersection

Returns the intersection of the two geometries.

UsageReturns
Rectangle.intersection(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Rectangle.intersects

Returns true if and only if the geometries intersect.

UsageReturns
Rectangle.intersects(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Rectangle.isUnbounded

Returns whether the geometry is unbounded.

UsageReturns
Rectangle.isUnbounded()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.Rectangle.length

Returns the length of the linear parts of the geometry. Polygonal parts are ignored. The length of multi geometries is the sum of the lengths of their components.

UsageReturns
Rectangle.length(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe input geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in meters.

ee.Geometry.Rectangle.perimeter

Returns the length of the perimeter of the polygonal parts of the geometry. The perimeter of multi geometries is the sum of the perimeters of their components.

UsageReturns
Rectangle.perimeter(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe input geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in meters.

ee.Geometry.Rectangle.projection

Returns the projection of the geometry.

UsageReturns
Rectangle.projection()Projection
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.Rectangle.serialize

Returns the serialized representation of this object.

UsageReturns
Rectangle.serialize(legacy)String
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.
legacyBoolean, optionalEnables legacy format.

ee.Geometry.Rectangle.simplify

Simplifies the geometry to within a given error margin. Note that this does not respect the error margin requested by the consumer of this algorithm, unless maxError is explicitly specified to be null.

This overrides the default Earth Engine policy for propagating error margins, so regardless of the geometry accuracy requested from the output, the inputs will be requested with the error margin specified in the arguments to this algorithm. This results in consistent rendering at all zoom levels of a rendered vector map, but at lower zoom levels (i.e. zoomed out), the geometry won't be simplified, which may harm performance.

UsageReturns
Rectangle.simplify(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to simplify.
maxErrorErrorMarginThe maximum amount of error by which the result may differ from the input.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in the same projection as the input. If the error margin is in projected units, the margin will be interpreted as units of this projection

ee.Geometry.Rectangle.symmetricDifference

Returns the symmetric difference between two geometries.

UsageReturns
Rectangle.symmetricDifference(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Rectangle.toGeoJSON

Returns a GeoJSON representation of the geometry.

UsageReturns
Rectangle.toGeoJSON()GeoJSONGeometry
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.

ee.Geometry.Rectangle.toGeoJSONString

Returns a GeoJSON string representation of the geometry.

UsageReturns
Rectangle.toGeoJSONString()String
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.

ee.Geometry.Rectangle.transform

Transforms the geometry to a specific projection.

UsageReturns
Rectangle.transform(proj, maxError)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to reproject.
projProjection, optionalThe target projection. Defaults to WGS84. If this has a geographic CRS, the edges of the geometry will be interpreted as geodesics. Otherwise they will be interpreted as straight lines in the projection.
maxErrorErrorMargin, default: nullThe maximum projection error.

ee.Geometry.Rectangle.type

Returns the GeoJSON type of the geometry.

UsageReturns
Rectangle.type()String
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.Rectangle.union

Returns the union of the two geometries.

UsageReturns
Rectangle.union(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.Rectangle.withinDistance

Returns true if and only if the geometries are within a specified distance.

UsageReturns
Rectangle.withinDistance(right, distance, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
distanceFloatThe distance threshold. If a projection is specified, the distance is in units of that projected coordinate system, otherwise it is in meters.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.area

Returns the area of the geometry. Area of points and line strings is 0, and the area of multi geometries is the sum of the areas of their components (intersecting areas are counted multiple times).

UsageReturns
Geometry.area(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe geometry input.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in square meters.

ee.Geometry.aside

Calls a function passing this object as the first argument, and returning itself. Convenient e.g. when debugging:

var c = ee.ImageCollection('foo').aside(print)

.filterDate('2001-01-01', '2002-01-01').aside(print, 'In 2001')

.filterBounds(geom).aside(print, 'In region')

.aside(Map.addLayer, {min: 0, max: 142}, 'Filtered')

.select('a', 'b');

Returns the same object, for chaining.

UsageReturns
Geometry.aside(func, var_args)ComputedObject
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
funcFunctionThe function to call.
var_argsVarArgsAny extra arguments to pass to the function.

ee.Geometry.bounds

Returns the bounding rectangle of the geometry.

UsageReturns
Geometry.bounds(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryReturn the bounding box of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in WGS84.

ee.Geometry.buffer

Returns the input buffered by a given distance. If the distance is positive, the geometry is expanded, and if the distance is negative, the geometry is contracted.

UsageReturns
Geometry.buffer(distance, maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry being buffered.
distanceFloatThe distance of the buffering, which may be negative. If no projection is specified, the unit is meters. Otherwise the unit is in the coordinate system of the projection.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when approximating the buffering circle and performing any necessary reprojection. If unspecified, defaults to 1% of the distance.
projProjection, default: nullIf specified, the buffering will be performed in this projection and the distance will be interpreted as units of the coordinate system of this projection. Otherwise the distance is interpereted as meters and the buffering is performed in a spherical coordinate system.

ee.Geometry.centroid

Returns a point at the center of the highest-dimension components of the geometry. Lower-dimensional components are ignored, so the centroid of a geometry containing two polygons, three lines and a point is equivalent to the centroid of a geometry containing just the two polygons.

UsageReturns
Geometry.centroid(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCalculates the centroid of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in WGS84.

ee.Geometry.containedIn

Returns true if and only if one geometry is contained in the other.

UsageReturns
Geometry.containedIn(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.contains

Returns true if and only if one geometry contains the other.

UsageReturns
Geometry.contains(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.convexHull

Returns the convex hull of the given geometry. The convex hull of a single point is the point itself, the convex hull of collinear points is a line, and the convex hull of everything else is a polygon. Note that a degenerate polygon with all vertices on the same line will result in a line segment.

UsageReturns
Geometry.convexHull(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCalculates the convex hull of this geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.coordinates

Returns a GeoJSON-style list of the geometry's coordinates.

UsageReturns
Geometry.coordinates()List
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.coveringGrid

Returns a collection of features that cover this geometry, where each feature is a rectangle in the grid defined by the given projection.

UsageReturns
Geometry.coveringGrid(proj, scale)FeatureCollection
ArgumentTypeDetails
this: geometryGeometryThe result is the grid cells that intersect with this region.
projProjectionThe projection in which to construct the grid. A feature is generated for each grid cell that intersects 'geometry', where cell corners are at integer-valued positions in the projection. If the projection is scaled in meters, the points will be on a grid of that size at the point of true scale.
scaleFloat, default: nullOverrides the scale of the projection, if provided. May be required if the projection isn't already scaled.

ee.Geometry.cutLines

Converts LineString, MultiLineString, and LinearRing geometries into a MultiLineString by cutting them into parts no longer than the given distance along their length. All other geometry types will be converted to an empty MultiLineString.

UsageReturns
Geometry.cutLines(distances, maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryCuts the lines of this geometry.
distancesListDistances along each LineString to cut the line into separate pieces, measured in units of the given proj, or meters if proj is unspecified.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullProjection of the result and distance measurements, or WGS84 if unspecified.

ee.Geometry.difference

Returns the result of subtracting the 'right' geometry from the 'left' geometry.

UsageReturns
Geometry.difference(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.disjoint

Returns true if and only if the geometries are disjoint.

UsageReturns
Geometry.disjoint(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.dissolve

Returns the union of the geometry. This leaves single geometries untouched, and unions multi geometries.

UsageReturns
Geometry.dissolve(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to union.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the union will be performed in this projection. Otherwise it will be performed in a spherical coordinate system.

ee.Geometry.distance

Returns the minimum distance between two geometries.

UsageReturns
Geometry.distance(right, maxError, proj)Float
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.edgesAreGeodesics

Returns true if the geometry edges, if any, are geodesics along a spherical model of the earth; if false, any edges are straight lines in the projection.

UsageReturns
Geometry.edgesAreGeodesics()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.evaluate

Asynchronously retrieves the value of this object from the server and passes it to the provided callback function.

UsageReturns
Geometry.evaluate(callback)
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunctionA function of the form function(success, failure), called when the server returns an answer. If the request succeeded, the success argument contains the evaluated result. If the request failed, the failure argument will contains an error message.

ee.Geometry.geodesic

If false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth.

UsageReturns
Geometry.geodesic()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.geometries

Returns the list of geometries in a GeometryCollection, or a singleton list of the geometry for single geometries.

UsageReturns
Geometry.geometries()List
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.getInfo

Retrieves the value of this object from the server.

If no callback function is provided, the request is made synchronously. If a callback is provided, the request is made asynchronously.

The asynchronous mode is preferred because the synchronous mode stops all other code (for example, the EE Code Editor UI) while waiting for the server. To make an asynchronous request, evaluate() is preferred over getInfo().

Returns the computed value of this object.

UsageReturns
Geometry.getInfo(callback)Object
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.Geometry.intersection

Returns the intersection of the two geometries.

UsageReturns
Geometry.intersection(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.intersects

Returns true if and only if the geometries intersect.

UsageReturns
Geometry.intersects(right, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.isUnbounded

Returns whether the geometry is unbounded.

UsageReturns
Geometry.isUnbounded()Boolean
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.length

Returns the length of the linear parts of the geometry. Polygonal parts are ignored. The length of multi geometries is the sum of the lengths of their components.

UsageReturns
Geometry.length(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe input geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in meters.

ee.Geometry.perimeter

Returns the length of the perimeter of the polygonal parts of the geometry. The perimeter of multi geometries is the sum of the perimeters of their components.

UsageReturns
Geometry.perimeter(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe input geometry.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in meters.

ee.Geometry.projection

Returns the projection of the geometry.

UsageReturns
Geometry.projection()Projection
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.serialize

Returns the serialized representation of this object.

UsageReturns
Geometry.serialize(legacy)String
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.
legacyBoolean, optionalEnables legacy format.

ee.Geometry.simplify

Simplifies the geometry to within a given error margin. Note that this does not respect the error margin requested by the consumer of this algorithm, unless maxError is explicitly specified to be null.

This overrides the default Earth Engine policy for propagating error margins, so regardless of the geometry accuracy requested from the output, the inputs will be requested with the error margin specified in the arguments to this algorithm. This results in consistent rendering at all zoom levels of a rendered vector map, but at lower zoom levels (i.e. zoomed out), the geometry won't be simplified, which may harm performance.

UsageReturns
Geometry.simplify(maxError, proj)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to simplify.
maxErrorErrorMarginThe maximum amount of error by which the result may differ from the input.
projProjection, default: nullIf specified, the result will be in this projection. Otherwise it will be in the same projection as the input. If the error margin is in projected units, the margin will be interpreted as units of this projection

ee.Geometry.symmetricDifference

Returns the symmetric difference between two geometries.

UsageReturns
Geometry.symmetricDifference(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.toGeoJSON

Returns a GeoJSON representation of the geometry.

UsageReturns
Geometry.toGeoJSON()GeoJSONGeometry
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.

ee.Geometry.toGeoJSONString

Returns a GeoJSON string representation of the geometry.

UsageReturns
Geometry.toGeoJSONString()String
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.

ee.Geometry.transform

Transforms the geometry to a specific projection.

UsageReturns
Geometry.transform(proj, maxError)Geometry
ArgumentTypeDetails
this: geometryGeometryThe geometry to reproject.
projProjection, optionalThe target projection. Defaults to WGS84. If this has a geographic CRS, the edges of the geometry will be interpreted as geodesics. Otherwise they will be interpreted as straight lines in the projection.
maxErrorErrorMargin, default: nullThe maximum projection error.

ee.Geometry.type

Returns the GeoJSON type of the geometry.

UsageReturns
Geometry.type()String
ArgumentTypeDetails
this: geometryGeometry

ee.Geometry.union

Returns the union of the two geometries.

UsageReturns
Geometry.union(right, maxError, proj)Geometry
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Geometry.withinDistance

Returns true if and only if the geometries are within a specified distance.

UsageReturns
Geometry.withinDistance(right, distance, maxError, proj)Boolean
ArgumentTypeDetails
this: leftGeometryThe geometry used as the left operand of the operation.
rightGeometryThe geometry used as the right operand of the operation.
distanceFloatThe distance threshold. If a projection is specified, the distance is in units of that projected coordinate system, otherwise it is in meters.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullThe 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.

ee.Image

An object to represent an Earth Engine image. This constructor accepts a variety of arguments:

  - A string: an EarthEngine asset id,

  - A string and a number: an EarthEngine asset id and version,

  - A number or ee.Array: creates a constant image,

  - A list: creates an image out of each list element and combines them into a single image,

  - An ee.Image: returns the argument,

  - Nothing: results in an empty transparent image.

UsageReturns
ee.Image(args)Image
ArgumentTypeDetails
argsImage|List, optionalConstructor argument.

ee.Image.abs

Computes the absolute value of the input.

UsageReturns
Image.abs()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.acos

Computes the arc cosine in radians of the input.

UsageReturns
Image.acos()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.add

Adds the first value to the second for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is the union of the input types.

UsageReturns
Image.add(image2)Image
ArgumentTypeDetails
this: image1ImageThe image from which the left operand bands are taken.
image2ImageThe image from which the right operand bands are taken.

ee.Image.addBands

Returns an image containing all bands copied from the first input and selected bands from the second input, optionally overwriting bands in the first image with the same name. The new image has the metadata and footprint from the first input image.

UsageReturns
Image.addBands(srcImg, names, overwrite)Image
ArgumentTypeDetails
this: dstImgImageAn image into which to copy bands.
srcImgImageAn image containing bands to copy.
namesList, default: nullOptional list of band names to copy. If names is omitted, all bands from srcImg will be copied over.
overwriteBoolean, default: falseIf true, bands from `srcImg` will override bands with the same names in `dstImg`. Otherwise the new band will be renamed with a numerical suffix (`foo` to `foo_1` unless `foo_1` exists, then `foo_2` unless it exists, etc).

ee.Image.and

Returns 1 if and only if both values are non-zero for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is boolean.

UsageReturns
Image.and(image2)Image
ArgumentTypeDetails
this: image1ImageThe image from which the left operand bands are taken.
image2ImageThe image from which the right operand bands are taken.

ee.Image.arrayAccum

Accumulates elements of each array pixel along the given axis, by setting each element of the result array pixel to the reduction of elements in that pixel along the given axis, up to and including the current position on the axis. May be used to make a cumulative sum, a monotonically increasing sequence, etc.

UsageReturns
Image.arrayAccum(axis, reducer)Image
ArgumentTypeDetails
this: inputImageInput image.
axisIntegerAxis along which to perform the cumulative sum.
reducerReducer, default: nullReducer to accumulate values. Default is SUM, to produce the cumulative sum of each vector along the given axis.

ee.Image.arrayArgmax

Computes the positional indices of the maximum value in image of array values. If there are multiple occurrences of the maximum, the indices reflect the first.

UsageReturns
Image.arrayArgmax()Image
ArgumentTypeDetails
this: imageImageThe input image.

ee.Image.arrayCat

Creates an array image by concatenating each array pixel along the given axis in each band.

UsageReturns
Image.arrayCat(image2, axis)Image
ArgumentTypeDetails
this: image1ImageFirst array image to concatenate.
image2ImageSecond array image to concatenate.
axisIntegerAxis to concatenate along.

ee.Image.arrayDimensions

Returns the number of dimensions in each array band, and 0 for scalar image bands.

UsageReturns
Image.arrayDimensions()Image
ArgumentTypeDetails
this: inputImageInput image.

ee.Image.arrayDotProduct

Computes the dot product of each pair of 1-D arrays in the bands of the input images.

UsageReturns
Image.arrayDotProduct(image2)Image
ArgumentTypeDetails
this: image1ImageFirst array image of 1-D vectors.
image2ImageSecond array image of 1-D vectors.

ee.Image.arrayFlatten

Converts a single band image of equal-shape multidimensional pixels to an image of scalar pixels, with one band for each element of the array.

UsageReturns
Image.arrayFlatten(coordinateLabels, separator)Image
ArgumentTypeDetails
this: imageImageImage of multidimensional pixels to flatten.
coordinateLabelsListName of each position along each axis. For example, 2x2 arrays with axes meaning 'day' and 'color' could have labels like [['monday', 'tuesday'], ['red', 'green']], resulting in band names'monday_red', 'monday_green', 'tuesday_red', and 'tuesday_green'.
separatorString, default: "_"Separator between array labels in each band name.

ee.Image.arrayGet

For each band, an output band of the same name is created with the value at the given position extracted from the input multidimensional pixel in that band.

UsageReturns
Image.arrayGet(position)Image
ArgumentTypeDetails
this: imageImageArray to get an element from.
positionImageThe coordinates of the element to get. There must be as many scalar bands as there are dimensions in the input image.

ee.Image.arrayLength

Returns the length of each pixel's array along the given axis.

UsageReturns
Image.arrayLength(axis)Image
ArgumentTypeDetails
this: inputImageInput image.
axisIntegerThe axis along which to take the length.

ee.Image.arrayLengths

Returns a 1D array image with the length of each array axis.

UsageReturns
Image.arrayLengths()Image
ArgumentTypeDetails
this: inputImageInput image.

ee.Image.arrayMask

Creates an array image where each array-valued pixel is masked with another array-valued pixel, retaining only the elements where the mask is non-zero. If the mask image has one band it will be applied to all the bands of 'input', otherwise they must have the same number of bands.

UsageReturns
Image.arrayMask(mask)Image
ArgumentTypeDetails
this: inputImageArray image to mask.
maskImageArray image to mask with.

ee.Image.arrayPad

Pads the array values in each pixel to be a fixed length. The pad value will be appended to each array to extend it to given length along each axis. All bands of the image must be array-valued and have the same dimensions.

UsageReturns
Image.arrayPad(lengths, pad)Image
ArgumentTypeDetails
this: imageImageArray image to pad.
lengthsListA list of desired lengths for each axis in the output arrays. Arrays are already as large or larger than the given length will be unchanged along that axis
padNumber, default: 0The value to pad with.

ee.Image.arrayProject

Projects the array in each pixel to a lower dimensional space by specifying the axes to retain. Dropped axes must be at most length 1.

UsageReturns
Image.arrayProject(axes)Image
ArgumentTypeDetails
this: inputImageInput image.
axesListThe axes to retain. Other axes will be discarded and must be at most length 1.

ee.Image.arrayReduce

Reduces elements of each array pixel.

UsageReturns
Image.arrayReduce(reducer, axes, fieldAxis)Image
ArgumentTypeDetails
this: inputImageInput image.
reducerReducerThe reducer to apply
axesListThe list of array axes to reduce in each pixel. The output will have a length of 1 in all these axes.
fieldAxisInteger, default: nullThe axis for the reducer's input and output fields. Only required if the reducer has multiple inputs or outputs.

ee.Image.arrayRepeat

Repeats each array pixel along the given axis. Each output pixel will have the shape of the input pixel, except length along the repeated axis, which will be multiplied by the number of copies.

UsageReturns
Image.arrayRepeat(axis, copies)Image
ArgumentTypeDetails
this: inputImageImage of array pixels to be repeated.
axisIntegerAxis along which to repeat each pixel's array.
copiesImageNumber of copies of each pixel.

ee.Image.arrayReshape

Converts array bands of an image with equally-shaped, possibly multidimensional pixels to an image of arrays with a new shape.

UsageReturns
Image.arrayReshape(lengths, dimensions)Image
ArgumentTypeDetails
this: imageImageThe image of arrays to reshape.
lengthsImageA 1 band image specifying the new lengths of each axis of the input image specified as a 1-D array per pixel. There should be 'dimensions' lengths values in each shape' array. If one of the lengths is -1, then the corresponding length for that axis will be computed such that the total size remains constant. In particular, a shape of [-1] flattens into 1-D. At most one component of shape can be -1.
dimensionsIntegerThe number of dimensions shared by all output array pixels.

ee.Image.arraySlice

Creates a subarray by slicing out each position along the given axis from the 'start' (inclusive) to 'end' (exclusive) by increments of 'step'. The result will have as many dimensions as the input, and the same length in all directions except the slicing axis, where the length will be the number of positions from 'start' to 'end' by 'step' that are in range of the input array's length along 'axis'. This means the result can be length 0 along the given axis if start=end, or if the start or end values are entirely out of range.

UsageReturns
Image.arraySlice(axis, start, end, step)Image
ArgumentTypeDetails
this: inputImageInput array image.
axisInteger, default: 0Axis to subset.
startImage, default: nullThe coordinate of the first slice (inclusive) along 'axis'. Negative numbers are used to position the start of slicing relative to the end of the array, where -1 starts at the last position on the axis, -2 starts at the next to last position, etc. There must one band for start indices, or one band per 'input' band. If this argument is not set or masked at some pixel, then the slice at that pixel will start at index 0.
endImage, default: nullThe coordinate (exclusive) at which to stop taking slices. By default this will be the length of the given axis. Negative numbers are used to position the end of slicing relative to the end of the array, where -1 will exclude the last position, -2 will exclude the last two positions, etc. There must be one band for end indices, or one band per 'input' band. If this argument is not set or masked at some pixel, then the slice at that pixel will end just after the last index.
stepInteger, default: 1The separation between slices along 'axis'; a slice will be taken at each whole multiple of 'step' from 'start' (inclusive) to 'end' (exclusive). Must be positive.

ee.Image.arraySort

Sorts elements of each array pixel along one axis.

UsageReturns
Image.arraySort(keys)Image
ArgumentTypeDetails
this: imageImageArray image to sort.
keysImage, default: nullOptional keys to sort by. If not provided, the values are used as the keys. The keys can only have multiple elements along one axis, which determines the direction to sort in.

ee.Image.arrayTranspose

Transposes two dimensions of each array pixel.

UsageReturns
Image.arrayTranspose(axis1, axis2)Image
ArgumentTypeDetails
this: inputImageInput image.
axis1Integer, default: 0First axis to swap.
axis2Integer, default: 1Second axis to swap.

ee.Image.aside

Calls a function passing this object as the first argument, and returning itself. Convenient e.g. when debugging:

var c = ee.ImageCollection('foo').aside(print)

.filterDate('2001-01-01', '2002-01-01').aside(print, 'In 2001')

.filterBounds(geom).aside(print, 'In region')

.aside(Map.addLayer, {min: 0, max: 142}, 'Filtered')

.select('a', 'b');

Returns the same object, for chaining.

UsageReturns
Image.aside(func, var_args)ComputedObject
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
funcFunctionThe function to call.
var_argsVarArgsAny extra arguments to pass to the function.

ee.Image.asin

Computes the arc sine in radians of the input.

UsageReturns
Image.asin()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.atan

Computes the arc tangent in radians of the input.

UsageReturns
Image.atan()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.atan2

Calculates the angle formed by the 2D vector [x, y] for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is float.

UsageReturns
Image.atan2(image2)Image
ArgumentTypeDetails
this: image1ImageThe image from which the left operand bands are taken.
image2ImageThe image from which the right operand bands are taken.

ee.Image.bandNames

Returns a list containing the names of the bands of an image.

UsageReturns
Image.bandNames()List
ArgumentTypeDetails
this: imageImageThe image from which to get band names.

ee.Image.bandTypes

Returns a dictionary of the image's band types.

UsageReturns
Image.bandTypes()Dictionary
ArgumentTypeDetails
this: imageImageThe image from which to get band types.

ee.Image.bitCount

Calculates the number of one-bits in the 64-bit two's complement binary representation of the input.

UsageReturns
Image.bitCount()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.bitsToArrayImage

Turns the bits of an integer into a 1-D array. The array has a lengthup to the highest 'on' bit in the input.

UsageReturns
Image.bitsToArrayImage()Image
ArgumentTypeDetails
this: inputImageInput image.

ee.Image.bitwiseAnd

Calculates the bitwise AND of the input values for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is the union of the input types.

UsageReturns
Image.bitwiseAnd(image2)Image
ArgumentTypeDetails
this: image1ImageThe image from which the left operand bands are taken.
image2ImageThe image from which the right operand bands are taken.

ee.Image.bitwiseNot

Calculates the bitwise NOT of the input, in the smallest signed integer type that can hold the input.

UsageReturns
Image.bitwiseNot()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.bitwiseOr

Calculates the bitwise OR of the input values for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is the union of the input types.

UsageReturns
Image.bitwiseOr(image2)Image
ArgumentTypeDetails
this: image1ImageThe image from which the left operand bands are taken.
image2ImageThe image from which the right operand bands are taken.

ee.Image.bitwiseXor

Calculates the bitwise XOR of the input values for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is the union of the input types.

UsageReturns
Image.bitwiseXor(image2)Image
ArgumentTypeDetails
this: image1ImageThe image from which the left operand bands are taken.
image2ImageThe image from which the right operand bands are taken.

ee.Image.blend

Overlays one image on top of another. The images are blended together using the masks as opacity. If either of images has only 1 band, it is replicated to match the number of bands in the other image.

UsageReturns
Image.blend(top)Image
ArgumentTypeDetails
this: bottomImageThe bottom image.
topImageThe top image.

ee.Image.byte

Casts the input value to an unsigned 8-bit integer.

UsageReturns
Image.byte()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.cast

Casts some or all bands of an image to the specified types.

UsageReturns
Image.cast(bandTypes, bandOrder)Image
ArgumentTypeDetails
this: imageImageThe image to cast.
bandTypesDictionaryA dictionary from band name to band types. Types can be PixelTypes or strings. The valid strings are: 'int8', 'int16', 'int32', 'int64', 'uint8', 'uint16', 'uint32', 'byte', 'short', 'int', 'long', 'float' and 'double'. If bandTypes includes bands that are not already in the input image, they will be added to the image as transparent bands. If bandOrder isn't also specified, new bands will be appended in alphabetical order.
bandOrderList, default: nullA list specifying the order of the bands in the result. If specified, must match the full list of bands in the result.

ee.Image.cat

Combines the given images into a single image which contains all bands from all of the images.

If two or more bands share a name, they are suffixed with an incrementing index.

The resulting image will have the metadata from the first input image, only.

This function will promote constant values into constant images.

Returns the combined image.

UsageReturns
ee.Image.cat(var_args)Image
ArgumentTypeDetails
var_argsVarArgsThe images to be combined.

ee.Image.cbrt

Computes the cubic root of the input.

UsageReturns
Image.cbrt()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.ceil

Computes the smallest integer greater than or equal to the input.

UsageReturns
Image.ceil()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.changeProj

Tweaks the projection of the input image, moving each pixel from its location in srcProj to the same coordinates in dstProj.

UsageReturns
Image.changeProj(srcProj, dstProj)Image
ArgumentTypeDetails
this: inputImage
srcProjProjectionThe original projection.
dstProjProjectionThe new projection.

ee.Image.clamp

Clamps the values in all bands of an image to all lie within the specified range.

UsageReturns
Image.clamp(low, high)Image
ArgumentTypeDetails
this: inputImageThe image to clamp.
lowFloatThe minimum allowed value in the range.
highFloatThe maximum allowed value in the range.

ee.Image.classify

Classifies an image.

UsageReturns
Image.classify(classifier, outputName)Image
ArgumentTypeDetails
this: imageImageThe image to classify. Bands are extracted from this image by name, and it must contain all the bands named in the classifier's schema.
classifierClassifierThe classifier to use.
outputNameString, default: "classification"The name of the band to be added. If the classifier produces more than 1 output, this name is ignored.

ee.Image.clip

Clips an image to a Geometry or Feature.

The output bands correspond exactly to the input bands, except data not covered by the geometry is masked. The output image retains the metadata of the input image.

Use clipToCollection to clip an image to a FeatureCollection.

Returns the clipped image.

UsageReturns
Image.clip(geometry)Image
ArgumentTypeDetails
this: imageImageThe Image instance.
geometryFeature|Geometry|ObjectThe Geometry or Feature to clip to.

ee.Image.clipToBoundsAndScale

Clips an image to the bounds of a Geometry, and scales the clipped image to a particular size or scale.

UsageReturns
Image.clipToBoundsAndScale(geometry, width, height, maxDimension, scale)Image
ArgumentTypeDetails
this: inputImageThe image to clip and scale.
geometryGeometry, default: nullThe Geometry to clip the image to. The image will be clipped to the bounding box, in the image's projection, of this geometry.
widthInteger, default: nullThe width to scale the image to, in pixels. Must be provided along with "height". Exclusive with "maxDimension" and "scale".
heightInteger, default: nullThe height to scale the image to, in pixels. Must be provided along with "width". Exclusive with "maxDimension" and "scale".
maxDimensionInteger, default: nullThe maximum dimension to scale the image to, in pixels. Exclusive with "width", "height" and "scale".
scaleFloat, default: nullIf scale is specified, then the projection is scaled by dividing the specified scale value by the nominal size of a meter in the image's projection. Exclusive with "width", "height" and "maxDimension".

ee.Image.clipToCollection

Clips an image to a FeatureCollection. The output bands correspond exactly the input bands, except data not covered by the geometry of at least one feature from the collection is masked. The output image retains the metadata of the input image.

UsageReturns
Image.clipToCollection(collection)Image
ArgumentTypeDetails
this: inputImageThe image to clip.
collectionObjectThe FeatureCollection to clip to.

ee.Image.cluster

Applies a clusterer to an image. Returns a new image with a single band containing values from 0 to N, indicating the cluster each pixel is assigned to.

UsageReturns
Image.cluster(clusterer, outputName)Image
ArgumentTypeDetails
this: imageImageThe image to cluster. Must contain all the bands in the clusterer's schema.
clustererClustererThe clusterer to use.
outputNameString, default: "cluster"The name of the output band.

ee.Image.connectedComponents

Finds connected components with the same value of the first band of the input and labels them with a globally unique value. Connectedness is specified by the given kernel. Objects larger than maxSize are considered background, and are masked.

UsageReturns
Image.connectedComponents(connectedness, maxSize)Image
ArgumentTypeDetails
this: imageImageThe image to label.
connectednessKernelConnectedness kernel.
maxSizeIntegerMaximum size of objects to be labeled.

ee.Image.connectedPixelCount

Generate an image where each pixel contains the number of 4- or 8-connected neighbors (including itself).

UsageReturns
Image.connectedPixelCount(maxSize, eightConnected)Image
ArgumentTypeDetails
this: inputImageThe input image.
maxSizeInteger, default: 100The maximum size of the neighborhood in pixels.
eightConnectedBoolean, default: trueWhether to use 8-connected rather 4-connected rules.

ee.Image.constant

Generates an image containing a constant value everywhere.

UsageReturns
ee.Image.constant(value)Image
ArgumentTypeDetails
valueObjectThe value of the pixels in the constant image. Must be a number or an Array or a list of numbers or Arrays.

ee.Image.convolve

Convolves each band of an image with the given kernel.

UsageReturns
Image.convolve(kernel)Image
ArgumentTypeDetails
this: imageImageThe image to convolve.
kernelKernelThe kernel to convolve with.

ee.Image.copyProperties

Copies metadata properties from one element to another.

UsageReturns
Image.copyProperties(source, properties, exclude)Element
ArgumentTypeDetails
this: destinationElement, default: nullThe object whose properties to override.
sourceElement, default: nullThe object from which to copy the properties.
propertiesList, default: nullThe properties to copy. If omitted, all ordinary (i.e. non-system) properties are copied.
excludeList, default: nullThe list of properties to exclude when copying all properties. Must not be specified if properties is.

ee.Image.cos

Computes the cosine of the input in radians.

UsageReturns
Image.cos()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.cosh

Computes the hyperbolic cosine of the input.

UsageReturns
Image.cosh()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.cumulativeCost

Computes a cumulative cost map based on an image containing costs to traverse each pixel and an image containing source locations.

Each output band represents the cumulative cost over the corresponding input cost band.

UsageReturns
Image.cumulativeCost(source, maxDistance, geodeticDistance)Image
ArgumentTypeDetails
this: costImageAn image representing the cost to traverse each pixel. Masked pixels can't be traversed. When comparing pixel traversal costs, we use band-wise dictionary ordering. Ancillary cost bands are only considered when paths over primary bands are equal cost.
sourceImageA single-band image representing the sources. A pixel value different from 0 defines a source pixel.
maxDistanceFloatMaximum distance for computation, in meters.
geodeticDistanceBoolean, default: trueIf true, geodetic distance along the curved surface is used, assuming a spherical Earth of radius 6378137.0. If false, euclidean distance in the 2D plane of the map projection is used (faster, but less accurate).

ee.Image.date

Returns the acquisition time of an image as a Date object. This helper function is equivalent to ee.Date(image.get('system:time_start')).

UsageReturns
Image.date()Date
ArgumentTypeDetails
this: imageImageThe image whose acquisition time to return.

ee.Image.derivative

Computes the X and Y discrete derivatives for each band in the input image, in pixel coordinates.

For each band of the input image, the output image will have two bands named with the suffixes _x and _y, containing the respective derivatives.

UsageReturns
Image.derivative()Image
ArgumentTypeDetails
this: imageImageThe input image.

ee.Image.digamma

Computes the digamma function of the input.

UsageReturns
Image.digamma()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.directionalDistanceTransform

For each zero-valued pixel in the source, get the distance to the nearest non-zero pixels in the given direction.

Returns a band of floating point distances called "distance".

UsageReturns
Image.directionalDistanceTransform(angle, maxDistance, labelBand)Image
ArgumentTypeDetails
this: sourceImageThe source image.
angleFloatThe angle, in degrees, at which to search for non-zero pixels.
maxDistanceIntegerThe maximum distance, in pixels, over which to search.
labelBandString, default: nullIf provided, multi-band inputs are permitted and only this band is used for searching. All other bands are returned and populated with the per-band values found at the searched non-zero pixels in the label band.

ee.Image.displace

Warps an image using an image of displacements.

UsageReturns
Image.displace(displacement, mode, maxOffset)Image
ArgumentTypeDetails
this: imageImageThe image to warp.
displacementImageAn image containing displacement values. The first band is interpreted as the 'X' displacement and the second as the 'Y' displacement. Each displacement pixel is a [dx,dy] vector added to the pixel location to determine the corresponding pixel location in 'image'. Displacements are interpreted as meters in the default projection of the displacement image.
modeString, default: "bicubic"The interpolation mode to use. One of 'nearest_neighbor', 'bilinear' or 'bicubic'.
maxOffsetFloat, default: nullThe maximum absolute offset in the displacement image. Providing this may improve processing performance.

ee.Image.displacement

Determines displacements required to register an image to a reference image while allowing local, rubber sheet deformations. Displacements are computed in the CRS of the reference image, at a scale dictated by the lowest resolution of the following three projections: input image projection, reference image projection, and requested projection. The displacements are then transformed into the user-specified projection for output.

UsageReturns
Image.displacement(referenceImage, maxOffset, projection, patchWidth, stiffness)Image
ArgumentTypeDetails
this: imageImageThe image to register.
referenceImageImageThe image to register to.
maxOffsetFloatThe maximum offset allowed when attempting to align the input images, in meters. Using a smaller value can reduce computation time significantly, but it must still be large enough to cover the greatest displacement within the entire image region.
projectionProjection, default: nullThe projection in which to output displacement values. The default is the projection of the first band of the reference image.
patchWidthFloat, default: nullPatch size for detecting image offsets, in meters. This should be set large enough to capture texture, as well as large enough that ignorable objects are small within the patch. Default is null. Patch size will be determined automatically if not provided.
stiffnessFloat, default: 5Enforces a stiffness constraint on the solution. Valid values are in the range [0,10]. The stiffness is used for outlier rejection when determining displacements at adjacent grid points. Higher values move the solution towards a rigid transformation. Lower values allow more distortion or warping of the image during registration.

ee.Image.distance

Computes the distance to the nearest non-zero pixel in each band, using the specified distance kernel.

UsageReturns
Image.distance(kernel, skipMasked)Image
ArgumentTypeDetails
this: imageImageThe input image.
kernelKernel, default: nullThe distance kernel. One of chebyshev, euclidean, or manhattan.
skipMaskedBoolean, default: trueMask output pixels if the corresponding input pixel is masked.

ee.Image.divide

Divides the first value by the second, returning 0 for division by 0 for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is the union of the input types.

UsageReturns
Image.divide(image2)Image
ArgumentTypeDetails
this: image1ImageThe image from which the left operand bands are taken.
image2ImageThe image from which the right operand bands are taken.

ee.Image.double

Casts the input value to a 64-bit float.

UsageReturns
Image.double()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.entropy

Computes the windowed entropy for each band using the specified kernel centered on each input pixel. Entropy is computed as -sum(p * log2(p)), where p is the normalized probability of occurrence of the values encountered in each window.

UsageReturns
Image.entropy(kernel)Image
ArgumentTypeDetails
this: imageImageThe image for which to compute the entropy.
kernelKernelA kernel specifying the window in which to compute.

ee.Image.eq

Returns 1 if and only if the first value is equal to the second for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is boolean.

UsageReturns
Image.eq(image2)Image
ArgumentTypeDetails
this: image1ImageThe image from which the left operand bands are taken.
image2ImageThe image from which the right operand bands are taken.

ee.Image.erf

Computes the error function of the input.

UsageReturns
Image.erf()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.erfInv

Computes the inverse error function of the input.

UsageReturns
Image.erfInv()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.erfc

Computes the complementary error function of the input.

UsageReturns
Image.erfc()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.erfcInv

Computes the inverse complementary error function of the input.

UsageReturns
Image.erfcInv()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.evaluate

Asynchronously retrieves the value of this object from the server and passes it to the provided callback function.

UsageReturns
Image.evaluate(callback)
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunctionA function of the form function(success, failure), called when the server returns an answer. If the request succeeded, the success argument contains the evaluated result. If the request failed, the failure argument will contains an error message.

ee.Image.exp

Computes the Euler's number e raised to the power of the input.

UsageReturns
Image.exp()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.expression

Evaluates an arithmetic expression on an image, possibly involving additional images.

The bands of the primary input image are available using the built-in function b(), as b(0) or b('band_name').

Variables in the expression are interpreted as additional image parameters which must be supplied in opt_map. The bands of each such image can be accessed like image.band_name or image[0].

Both b() and image[] allow multiple arguments, to specify multiple bands, such as b(1, 'name', 3). Calling b() with no arguments, or using a variable by itself, returns all bands of the image.

If the result of an expression is a single band, it can be assigned a name using the '=' operator (e.g.: x = a + b).

Returns the image computed by the provided expression.

UsageReturns
Image.expression(expression, map)Image
ArgumentTypeDetails
this: imageImageThe Image instance.
expressionStringThe expression to evaluate.
mapDictionary, optionalA map of input images available by name.

ee.Image.fastDistanceTransform

Returns the distance, as determined by the specified distance metric, to the nearest non-zero valued pixel in the input. The output contains values for all pixels within the given neighborhood size, regardless of the input's mask. Note: the default distance metric returns squared distance.

UsageReturns
Image.fastDistanceTransform(neighborhood, units, metric)Image
ArgumentTypeDetails
this: imageImageThe input image.
neighborhoodInteger, default: 256Neighborhood size in pixels.
unitsString, default: "pixels"The units of the neighborhood, currently only 'pixels' are supported.
metricString, default: "squared_euclidean"Distance metric to use: options are `squared_euclidean`, `manhattan` or `chebyshev`.

ee.Image.first

Selects the value of the first value for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is the union of the input types.

UsageReturns
Image.first(image2)Image
ArgumentTypeDetails
this: image1ImageThe image from which the left operand bands are taken.
image2ImageThe image from which the right operand bands are taken.

ee.Image.firstNonZero

Selects the first value if it is non-zero, and the second value otherwise for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is the union of the input types.

UsageReturns
Image.firstNonZero(image2)Image
ArgumentTypeDetails
this: image1ImageThe image from which the left operand bands are taken.
image2ImageThe image from which the right operand bands are taken.

ee.Image.float

Casts the input value to a 32-bit float.

UsageReturns
Image.float()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.floor

Computes the largest integer less than or equal to the input.

UsageReturns
Image.floor()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.focalMax

Applies a morphological reducer() filter to each band of an image using a named or custom kernel.

UsageReturns
Image.focalMax(radius, kernelType, units, iterations, kernel)Image
ArgumentTypeDetails
this: imageImageThe image to which to apply the operations.
radiusFloat, default: 1.5The radius of the kernel to use.
kernelTypeString, default: "circle"The type of kernel to use. Options include: 'circle', 'square', 'cross', 'plus', octagon' and 'diamond'.
unitsString, default: "pixels"If a kernel is not specified, this determines whether the kernel is in meters or pixels.
iterationsInteger, default: 1The number of times to apply the given kernel.
kernelKernel, default: nullA custom kernel. If used, kernelType and radius are ignored.

ee.Image.focalMean

Applies a morphological mean filter to each band of an image using a named or custom kernel.

UsageReturns
Image.focalMean(radius, kernelType, units, iterations, kernel)Image
ArgumentTypeDetails
this: imageImageThe image to which to apply the operations.
radiusFloat, default: 1.5The radius of the kernel to use.
kernelTypeString, default: "circle"The type of kernel to use. Options include: 'circle', 'square', 'cross', 'plus', octagon' and 'diamond'.
unitsString, default: "pixels"If a kernel is not specified, this determines whether the kernel is in meters or pixels.
iterationsInteger, default: 1The number of times to apply the given kernel.
kernelKernel, default: nullA custom kernel. If used, kernelType and radius are ignored.

ee.Image.focalMedian

Applies a morphological reducer() filter to each band of an image using a named or custom kernel.

UsageReturns
Image.focalMedian(radius, kernelType, units, iterations, kernel)Image
ArgumentTypeDetails
this: imageImageThe image to which to apply the operations.
radiusFloat, default: 1.5The radius of the kernel to use.
kernelTypeString, default: "circle"The type of kernel to use. Options include: 'circle', 'square', 'cross', 'plus', octagon' and 'diamond'.
unitsString, default: "pixels"If a kernel is not specified, this determines whether the kernel is in meters or pixels.
iterationsInteger, default: 1The number of times to apply the given kernel.
kernelKernel, default: nullA custom kernel. If used, kernelType and radius are ignored.

ee.Image.focalMin

Applies a morphological reducer() filter to each band of an image using a named or custom kernel.

UsageReturns
Image.focalMin(radius, kernelType, units, iterations, kernel)Image
ArgumentTypeDetails
this: imageImageThe image to which to apply the operations.
radiusFloat, default: 1.5The radius of the kernel to use.
kernelTypeString, default: "circle"The type of kernel to use. Options include: 'circle', 'square', 'cross', 'plus', octagon' and 'diamond'.
unitsString, default: "pixels"If a kernel is not specified, this determines whether the kernel is in meters or pixels.
iterationsInteger, default: 1The number of times to apply the given kernel.
kernelKernel, default: nullA custom kernel. If used, kernelType and radius are ignored.

ee.Image.focalMode

Applies a morphological reducer() filter to each band of an image using a named or custom kernel.

UsageReturns
Image.focalMode(radius, kernelType, units, iterations, kernel)Image
ArgumentTypeDetails
this: imageImageThe image to which to apply the operations.
radiusFloat, default: 1.5The radius of the kernel to use.
kernelTypeString, default: "circle"The type of kernel to use. Options include: 'circle', 'square', 'cross', 'plus', octagon' and 'diamond'.
unitsString, default: "pixels"If a kernel is not specified, this determines whether the kernel is in meters or pixels.
iterationsInteger, default: 1The number of times to apply the given kernel.
kernelKernel, default: nullA custom kernel. If used, kernelType and radius are ignored.

ee.Image.gamma

Computes the gamma function of the input.

UsageReturns
Image.gamma()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.gammainc

Calculates the regularized lower incomplete Gamma function γ(x,a) for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is float.

UsageReturns
Image.gammainc(image2)Image
ArgumentTypeDetails
this: image1ImageThe image from which the left operand bands are taken.
image2ImageThe image from which the right operand bands are taken.

ee.Image.geometry

Returns the geometry of a given feature in a given projection.

UsageReturns
Image.geometry(maxError, proj, geodesics)Geometry
ArgumentTypeDetails
this: featureElementThe feature from which the geometry is taken.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the geometry will be in this projection. If unspecified, the geometry will be in its default projection.
geodesicsBoolean, default: nullIf true, the geometry will have geodesic edges. If false, it will have edges as straight lines in the specified projection. If null, the edge interpretation will be the same as the original geometry. This argument is ignored if proj is not specified.

ee.Image.get

Extract a property from a feature.

UsageReturns
Image.get(property)
ArgumentTypeDetails
this: objectElementThe feature to extract the property from.
propertyStringThe property to extract.

ee.Image.getArray

Extract a property from a feature.

UsageReturns
Image.getArray(property)Array
ArgumentTypeDetails
this: objectElementThe feature to extract the property from.
propertyStringThe property to extract.

ee.Image.getDownloadURL

Get a download URL for small chunks of image data in GeoTIFF or NumPy format. Maximum request size is 32 MB, maximum grid dimension is 10000.

Use getThumbURL for RGB visualization formats PNG and JPG.

Returns returns a download URL, or undefined if a callback was specified.

UsageReturns
Image.getDownloadURL(params, callback)Object|String
ArgumentTypeDetails
this: imageImageThe Image instance.
paramsObjectAn object containing download options with the following possible values:
name: a base name to use when constructing filenames. Only applicable when format is "ZIPPED_GEO_TIFF" (default) or filePerBand is true. Defaults to the image id (or "download" for computed images) when format is "ZIPPED_GEO_TIFF" or filePerBand is true, otherwise a random character string is generated. Band names are appended when filePerBand is true.
bands: a description of the bands to download. Must be an array of band names or an array of dictionaries, each with the following keys (optional parameters apply only when filePerBand is true):
  • id: the name of the band, a string, required.
  • crs: an optional CRS string defining the band projection.
  • crs_transform: an optional array of 6 numbers specifying an affine transform from the specified CRS, in row-major order: [xScale, xShearing, xTranslation, yShearing, yScale, yTranslation]
  • dimensions: an optional array of two integers defining the width and height to which the band is cropped.
  • scale: an optional number, specifying the scale in meters of the band; ignored if crs and crs_transform are specified.
crs: a default CRS string to use for any bands that do not explicitly specify one.
crs_transform: a default affine transform to use for any bands that do not specify one, of the same format as the crs_transform of bands.
dimensions: default image cropping dimensions to use for any bands that do not specify them.
scale: a default scale to use for any bands that do not specify one; ignored if crs and crs_transform are specified.
region: a polygon specifying a region to download; ignored if crs and crs_transform is specified.
filePerBand: whether to produce a separate GeoTIFF per band (boolean). Defaults to true. If false, a single GeoTIFF is produced and all band-level transformations will be ignored.
format: the download format. One of:
  • "ZIPPED_GEO_TIFF" (GeoTIFF file(s) wrapped in a zip file, default)
  • "GEO_TIFF" (GeoTIFF file)
  • "NPY" (NumPy binary format)
If "GEO_TIFF" or "NPY", filePerBand and all band-level transformations will be ignored. Loading a NumPy output results in a structured array.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.Image.getInfo

An imperative function that returns information about this image via an AJAX call.

Returns a description of the image. Includes:

  - bands - a list containing metadata about the bands in the collection.

  - properties - a dictionary containing the image's metadata properties.

UsageReturns
Image.getInfo(callback)ImageDescription
ArgumentTypeDetails
this: imageImageThe Image instance.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously. If supplied, will be called with the first parameter if successful and the second if unsuccessful.

ee.Image.getMapId

An imperative function that returns a map ID and optional token, suitable for generating a Map overlay.

Returns an object which may be passed to ee.data.getTileUrl or ui.Map.addLayer. Undefined if a callback was specified.

UsageReturns
Image.getMapId(visParams, callback)MapId|Object
ArgumentTypeDetails
this: imageImageThe Image instance.
visParamsImageVisualizationParameters, optionalThe visualization parameters.
callbackFunction, optionalAn async callback. If not supplied, the call is made synchronously.

ee.Image.getNumber

Extract a property from a feature.

UsageReturns
Image.getNumber(property)Number
ArgumentTypeDetails
this: objectElementThe feature to extract the property from.
propertyStringThe property to extract.

ee.Image.getString

Extract a property from a feature.

UsageReturns
Image.getString(property)String
ArgumentTypeDetails
this: objectElementThe feature to extract the property from.
propertyStringThe property to extract.

ee.Image.getThumbId

Applies transformations and returns the thumbId.

Returns the thumb ID and optional token, or null if a callback is specified.

UsageReturns
Image.getThumbId(params, callback)ThumbnailId
ArgumentTypeDetails
this: imageImageThe Image instance.
paramsObjectParameters identical to ee.data.getMapId, plus, optionally:
dimensions (a number or pair of numbers in format WIDTHxHEIGHT) Maximum dimensions of the thumbnail to render, in pixels. If only one number is passed, it is used as the maximum, and the other dimension is computed by proportional scaling.
region Geospatial region of the image to render, it may be an ee.Geometry, GeoJSON, or an array of lat/lon points (E,S,W,N). If not set the default is the bounds image.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.Image.getThumbURL

Get a thumbnail URL for this image.

Returns a thumbnail URL, or undefined if a callback was specified.

UsageReturns
Image.getThumbURL(params, callback)Object|String
ArgumentTypeDetails
this: imageImageThe Image instance.
paramsObjectParameters identical to ee.data.getMapId, plus, optionally:
dimensions (a number or pair of numbers in format WIDTHxHEIGHT) Maximum dimensions of the thumbnail to render, in pixels. If only one number is passed, it is used as the maximum, and the other dimension is computed by proportional scaling.
region Geospatial region of the image to render, it may be an ee.Geometry, GeoJSON, or an array of lat/lon points (E,S,W,N). If not set the default is the bounds image.
format (string) Either 'png' or 'jpg'.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.Image.glcmTexture

Computes texture metrics from the Gray Level Co-occurrence Matrix around each pixel of every band. The GLCM is a tabulation of how often different combinations of pixel brightness values (grey levels) occur in an image. It counts the number of times a pixel of value X lies next to a pixel of value Y, in a particular direction and distance. and then derives statistics from this tabulation.

This implementation computes the 14 GLCM metrics proposed by Haralick, and 4 additional metrics from Conners. Inputs are required to be integer valued.

The output consists of 18 bands per input band if directional averaging is on and 18 bands per directional pair in the kernel, if not:

ASM: f1, Angular Second Moment; measures the number of repeated pairs

CONTRAST: f2, Contrast; measures the local contrast of an image

CORR: f3, Correlation; measures the correlation between pairs of pixels

VAR: f4, Variance; measures how spread out the distribution of gray-levels is

IDM: f5, Inverse Difference Moment; measures the homogeneity

SAVG: f6, Sum Average

SVAR: f7, Sum Variance

SENT: f8, Sum Entropy

ENT: f9, Entropy. Measures the randomness of a gray-level distribution

DVAR: f10, Difference variance

DENT: f11, Difference entropy

IMCORR1: f12, Information Measure of Corr. 1

IMCORR2: f13, Information Measure of Corr. 2

MAXCORR: f14, Max Corr. Coefficient. (not computed)

DISS: Dissimilarity

INERTIA: Inertia

SHADE: Cluster Shade

PROM: Cluster prominence

More information can be found in the two papers: Haralick et. al, 'Textural Features for Image Classification', http://doi.org/10.1109/TSMC.1973.4309314 and Conners, et al, Segmentation of a high-resolution urban scene using texture operators', http://doi.org/10.1016/0734-189X(84)90197-X.

UsageReturns
Image.glcmTexture(size, kernel, average)Image
ArgumentTypeDetails
this: imageImageThe image for which to compute texture metrics.
sizeInteger, default: 1The size of the neighborhood to include in each GLCM.
kernelKernel, default: nullA kernel specifying the x and y offsets over which to compute the GLCMs. A GLCM is computed for each pixel in the kernel that is non-zero, except the center pixel and as long as a GLCM hasn't already been computed for the same direction and distance. For example, if either or both of the east and west pixels are set, only 1 (horizontal) GLCM is computed. Kernels are scanned from left to right and top to bottom. The default is a 3x3 square, resulting in 4 GLCMs with the offsets (-1, -1), (0, -1), (1, -1) and (-1, 0).
averageBoolean, default: trueIf true, the directional bands for each metric are averaged.

ee.Image.gradient

Calculates the x and y gradient.

UsageReturns
Image.gradient()Image
ArgumentTypeDetails
this: inputImageThe input image.

ee.Image.gt

Returns 1 if and only if the first value is greater than the second for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is boolean.

UsageReturns
Image.gt(image2)Image
ArgumentTypeDetails
this: image1ImageThe image from which the left operand bands are taken.
image2ImageThe image from which the right operand bands are taken.

ee.Image.gte

Returns 1 if and only if the first value is greater than or equal to the second for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is boolean.

UsageReturns
Image.gte(image2)Image
ArgumentTypeDetails
this: image1ImageThe image from which the left operand bands are taken.
image2ImageThe image from which the right operand bands are taken.

ee.Image.hersDescriptor

Creates a dictionary of Histogram Error Ring Statistic (HERS) descriptor arrays from square array properties of an element. The HERS radius is taken to be the array's (side_length - 1) / 2.

UsageReturns
Image.hersDescriptor(selectors, buckets, peakWidthScale)Dictionary
ArgumentTypeDetails
this: elementElementThe element with array properties.
selectorsList, default: nullThe array properties for which descriptors will be created. Selected array properties must be square, floating point arrays. Defaults to all array properties.
bucketsInteger, default: 100The number of HERS buckets. Defaults to 100.
peakWidthScaleFloat, default: 1The HERS peak width scale. Defaults to 1.0.

ee.Image.hersFeature

Computes the Histogram Error Ring Statistic (HERS) for each pixel in each band matching the keys in the descriptor. Only the bands for which HERS could be computed are returned.

UsageReturns
Image.hersFeature(reference, peakWidthScale)Image
ArgumentTypeDetails
this: imageImageThe input image.
referenceDictionaryThe reference descriptor computed with ee.Feature.hersDescriptor(...).
peakWidthScaleFloat, default: 1The HERS peak width scale.

ee.Image.hersImage

Computes the Histogram Error Ring Statistic (HERS) for each pair of pixels in each band present in both images. Only the bands for which HERS could be computed are returned.

UsageReturns
Image.hersImage(image2, radius, buckets, peakWidthScale)Image
ArgumentTypeDetails
this: imageImageThe input image.
image2ImageThe image to compare.
radiusIntegerThe radius of the window.
bucketsInteger, default: 100The number of HERS buckets.
peakWidthScaleFloat, default: 1The HERS peak width scale.

ee.Image.hsvToRgb

Transforms the image from the HSV color space to the RGB color space. Expects a 3 band image in the range [0, 1], and produces three bands: red, green and blue with values in the range [0, 1].

UsageReturns
Image.hsvToRgb()Image
ArgumentTypeDetails
this: imageImageThe image to transform.

ee.Image.hypot

Calculates the magnitude of the 2D vector [x, y] for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is float.

UsageReturns
Image.hypot(image2)Image
ArgumentTypeDetails
this: image1ImageThe image from which the left operand bands are taken.
image2ImageThe image from which the right operand bands are taken.

ee.Image.id

Returns the ID of a given element within a collection. Objects outside collections are not guaranteed to have IDs.

UsageReturns
Image.id()String
ArgumentTypeDetails
this: elementElementThe element from which the ID is taken.

ee.Image.int

Casts the input value to a signed 32-bit integer.

UsageReturns
Image.int()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.int16

Casts the input value to a signed 16-bit integer.

UsageReturns
Image.int16()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.int32

Casts the input value to a signed 32-bit integer.

UsageReturns
Image.int32()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.int64

Casts the input value to a signed 64-bit integer.

UsageReturns
Image.int64()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.int8

Casts the input value to a signed 8-bit integer.

UsageReturns
Image.int8()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.interpolate

Interpolates each point in the first band of the input image into the piecewise-linear function specified by the x and y arrays. The x values must be strictly increasing. If an input point is less than the first or greater than the last x value, then the output is specified by the "behavior" argument: "extrapolate" specifies the output value is extrapolated from the two nearest points, "clamp" specifies the output value is taken from the nearest point, "input" specifies the output value is copied from the input and "mask" specifies the output value is masked.

UsageReturns
Image.interpolate(x, y, behavior)Image
ArgumentTypeDetails
this: imageImageThe image to which the interpolation is applied.
xListThe x axis (input) values in the piecewise function.
yListThe y axis (output) values in the piecewise function.
behaviorString, default: "extrapolate"The behavior for points that are outside of the range of the supplied function. Options are: 'extrapolate', 'clamp', 'mask' or 'input'.

ee.Image.lanczos

Computes the Lanczos approximation of the input.

UsageReturns
Image.lanczos()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.leftShift

Calculates the left shift of v1 by v2 bits for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is the union of the input types.

UsageReturns
Image.leftShift(image2)Image
ArgumentTypeDetails
this: image1ImageThe image from which the left operand bands are taken.
image2ImageThe image from which the right operand bands are taken.

ee.Image.linkCollection

Links the source image to a matching image from an image collection.

Any specified bands or metadata will be added to the source image from the image found in the collection, and if the bands or metadata are already present they will be overwritten. If a matching image is not found, any new or updated bands will be fully masked and any new or updated metadata will be null. The output footprint will be the same as the source image footprint.

A match is determined if the source image and an image in the collection have a specific equivalent metadata property. If more than one collection image would match, the collection image selected is arbitrary. By default, images are matched on their 'system:index' metadata property.

This linking function is a convenience method for adding bands to a target image based on a specified shared metadata property and is intended to support linking collections that apply different processing/product generation to the same source imagery. For more expressive linking known as 'joining', see https://developers.google.com/earth-engine/guides/joins_intro.

UsageReturns
Image.linkCollection(imageCollection, linkedBands, linkedProperties, matchPropertyName)Image
ArgumentTypeDetails
this: inputImageThe source image a matching image in the collection will be linked to.
imageCollectionImageCollectionThe image collection searched to extract an image matching the source.
linkedBandsObject, default: nullA band name or list of band names to add or update from the matching image.
linkedPropertiesObject, default: nullA metadata property or list of properties to add or update from the matching image.
matchPropertyNameString, default: "system:index"The metadata property name to use as a match criteria.

ee.Image.load

Returns the image given its ID.

UsageReturns
ee.Image.load(id, version)Image
ArgumentTypeDetails
idStringThe asset ID of the image.
versionLong, default: -1The version of the asset. -1 signifies the latest version.

ee.Image.loadGeoTIFF

Loads a GeoTIFF as an Image.

UsageReturns
ee.Image.loadGeoTIFF(uri)Image
ArgumentTypeDetails
uriStringThe Cloud Storage URI of the GeoTIFF to load.

ee.Image.log

Computes the natural logarithm of the input.

UsageReturns
Image.log()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.log10

Computes the base-10 logarithm of the input.

UsageReturns
Image.log10()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.long

Casts the input value to a signed 64-bit integer.

UsageReturns
Image.long()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.lt

Returns 1 if and only if the first value is less than the second for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is boolean.

UsageReturns
Image.lt(image2)Image
ArgumentTypeDetails
this: image1ImageThe image from which the left operand bands are taken.
image2ImageThe image from which the right operand bands are taken.

ee.Image.lte

Returns 1 if and only if the first value is less than or equal to the second for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is boolean.

UsageReturns
Image.lte(image2)Image
ArgumentTypeDetails
this: image1ImageThe image from which the left operand bands are taken.
image2ImageThe image from which the right operand bands are taken.

ee.Image.mask

Gets or sets an image's mask. The output image retains the metadata and footprint of the input image. Pixels where the mask changes from zero to another value will be filled with zeros, or the values closest to zero within the range of the pixel type.

UsageReturns
Image.mask(mask)Image
ArgumentTypeDetails
this: imageImageThe input image.
maskImage, default: nullThe mask image. If specified, the input image is copied to the output but given the mask by the values of this image. If this is a single band, it is used for all bands in the input image. If not specified, returns an image created from the mask of the input image, scaled to the range [0:1] (invalid = 0, valid = 1.0).

ee.Image.matrixCholeskyDecomposition

Calculates the Cholesky decomposition of a matrix. The Cholesky decomposition is a decomposition into the form L * L' where L is a lower triangular matrix. The input must be a symmetric positive-definite matrix. Returns an image with 1 band named 'L'.

UsageReturns
Image.matrixCholeskyDecomposition()Image
ArgumentTypeDetails
this: imageImageImage of 2-D matrices to be decomposed.

ee.Image.matrixDeterminant

Computes the determinant of the matrix.

UsageReturns
Image.matrixDeterminant()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.matrixDiagonal

Computes the diagonal of the matrix in a single column.

UsageReturns
Image.matrixDiagonal()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.matrixFnorm

Computes the Frobenius norm of the matrix.

UsageReturns
Image.matrixFnorm()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.matrixIdentity

Creates an image where each pixel is a 2D identity matrix of the given size.

UsageReturns
ee.Image.matrixIdentity(size)Image
ArgumentTypeDetails
sizeIntegerThe length of each axis.

ee.Image.matrixInverse

Computes the inverse of the matrix.

UsageReturns
Image.matrixInverse()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.matrixLUDecomposition

Calculates the LU matrix decomposition such that P×input=L×U, where L is lower triangular (with unit diagonal terms), U is upper triangular and P is a partial pivot permutation matrix. The input matrix must be square. Returns an image with bands named 'L', 'U' and 'P'.

UsageReturns
Image.matrixLUDecomposition()Image
ArgumentTypeDetails
this: imageImageImage of 2-D matrices to be decomposed.

ee.Image.matrixMultiply

Returns the matrix multiplication A * B for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is the union of the input types.

UsageReturns
Image.matrixMultiply(image2)Image
ArgumentTypeDetails
this: image1ImageThe image from which the left operand bands are taken.
image2ImageThe image from which the right operand bands are taken.

ee.Image.matrixPseudoInverse

Computes the Moore-Penrose pseudoinverse of the matrix.

UsageReturns
Image.matrixPseudoInverse()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.matrixQRDecomposition

Calculates the QR-decomposition of a matrix into two matrices Q and R such that input = QR, where Q is orthogonal, and R is upper triangular. Returns an image with bands named 'Q' and 'R'.

UsageReturns
Image.matrixQRDecomposition()Image
ArgumentTypeDetails
this: imageImageImage of 2-D matrices to be decomposed.

ee.Image.matrixSingularValueDecomposition

Calculates the Singular Value Decomposition of the input matrix into U×S×V', such that U and V are orthogonal and S is diagonal. Returns an image with bands named 'U', 'S' and 'V'.

UsageReturns
Image.matrixSingularValueDecomposition()Image
ArgumentTypeDetails
this: imageImageImage of 2-D matrices to be decomposed.

ee.Image.matrixSolve

Solves for x in the matrix equation A * x = B, finding a least-squares solution if A is overdetermined for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is the union of the input types.

UsageReturns
Image.matrixSolve(image2)Image
ArgumentTypeDetails
this: image1ImageThe image from which the left operand bands are taken.
image2ImageThe image from which the right operand bands are taken.

ee.Image.matrixToDiag

Computes a square diagonal matrix from a single column matrix.

UsageReturns
Image.matrixToDiag()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.matrixTrace

Computes the trace of the matrix.

UsageReturns
Image.matrixTrace()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.matrixTranspose

Transposes two dimensions of each array pixel.

UsageReturns
Image.matrixTranspose(axis1, axis2)Image
ArgumentTypeDetails
this: inputImageInput image.
axis1Integer, default: 0First axis to swap.
axis2Integer, default: 1Second axis to swap.

ee.Image.max

Selects the maximum of the first and second values for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is the union of the input types.

UsageReturns
Image.max(image2)Image
ArgumentTypeDetails
this: image1ImageThe image from which the left operand bands are taken.
image2ImageThe image from which the right operand bands are taken.

ee.Image.medialAxis

Computes the discrete medial axis of the zero valued pixels of the first band of the input. Outputs 4 bands:

 medial - the medial axis points, scaled by the distance.

 coverage - the number of points supporting each medial axis point.

 xlabel - the horizontal distance to the power point for each pixel.

 ylabel - the vertical distance to the power point for each pixel.

UsageReturns
Image.medialAxis(neighborhood, units)Image
ArgumentTypeDetails
this: imageImageThe input image.
neighborhoodInteger, default: 256Neighborhood size in pixels.
unitsString, default: "pixels"The units of the neighborhood, currently only 'pixels' are supported.

ee.Image.metadata

Generates a constant image of type double from a metadata property.

UsageReturns
Image.metadata(property, name)Image
ArgumentTypeDetails
this: imageImageThe image from which to get the metadata
propertyStringThe property from which to take the value.
nameString, default: nullThe name for the output band. If unspecified, it will be the same as the property name.

ee.Image.min

Selects the minimum of the first and second values for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is the union of the input types.

UsageReturns
Image.min(image2)Image
ArgumentTypeDetails
this: image1ImageThe image from which the left operand bands are taken.
image2ImageThe image from which the right operand bands are taken.

ee.Image.mod

Calculates the remainder of the first value divided by the second for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is the union of the input types.

UsageReturns
Image.mod(image2)Image
ArgumentTypeDetails
this: image1ImageThe image from which the left operand bands are taken.
image2ImageThe image from which the right operand bands are taken.

ee.Image.multiply

Multiplies the first value by the second for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is the union of the input types.

UsageReturns
Image.multiply(image2)Image
ArgumentTypeDetails
this: image1ImageThe image from which the left operand bands are taken.
image2ImageThe image from which the right operand bands are taken.

ee.Image.neighborhoodToArray

Turns the neighborhood of each pixel in a scalar image into a 2D array. Axes 0 and 1 of the output array correspond to Y and X axes of the image, respectively. The output image will have as many bands as the input; each output band has the same mask as the corresponding input band. The footprint and metadata of the input image are preserved.

UsageReturns
Image.neighborhoodToArray(kernel, defaultValue)Image
ArgumentTypeDetails
this: imageImageThe image to get pixels from; must be scalar-valued.
kernelKernelThe kernel specifying the shape of the neighborhood. Only fixed, square and rectangle kernels are supported. Weights are ignored; only the shape of the kernel is used.
defaultValueFloat, default: 0The value to use in the output arrays to replace the invalid (masked) pixels of the input. If the band type is integral, the fractional part of this value is discarded; in all cases, the value is clamped to the value range of the band.

ee.Image.neighborhoodToBands

Turn the neighborhood of a pixel into a set of bands. The neighborhood is specified using a Kernel, and only non-zero-weight kernel values are used. The weights of the kernel is otherwise ignored.

Each input band produces x * y output bands. Each output band is named 'input_x_y' where x and y indicate the pixel's location in the kernel. For example, a 3x3 kernel operating on a 2-band image produces 18 output bands.

UsageReturns
Image.neighborhoodToBands(kernel)Image
ArgumentTypeDetails
this: imageImageThe image to get pixels from.
kernelKernelThe kernel specifying the neighborhood. Zero-weight values are ignored.

ee.Image.neq

Returns 1 if and only if the first value is not equal to the second for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is boolean.

UsageReturns
Image.neq(image2)Image
ArgumentTypeDetails
this: image1ImageThe image from which the left operand bands are taken.
image2ImageThe image from which the right operand bands are taken.

ee.Image.normalizedDifference

Computes the normalized difference between two bands. If the bands to use are not specified, uses the first two bands. The normalized difference is computed as (first − second) / (first + second). Note that the returned image band name is 'nd', the input image properties are not retained in the output image, and a negative pixel value in either input band will cause the output pixel to be masked. To avoid masking negative input values, use ee.Image.expression() to compute normalized difference.

UsageReturns
Image.normalizedDifference(bandNames)Image
ArgumentTypeDetails
this: inputImageThe input image.
bandNamesList, default: nullA list of names specifying the bands to use. If not specified, the first and second bands are used.

ee.Image.not

Returns 0 if the input is non-zero, and 1 otherwise.

UsageReturns
Image.not()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.or

Returns 1 if and only if either input value is non-zero for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is boolean.

UsageReturns
Image.or(image2)Image
ArgumentTypeDetails
this: image1ImageThe image from which the left operand bands are taken.
image2ImageThe image from which the right operand bands are taken.

ee.Image.paint

Paints the geometries of a collection onto an image, using the given 'color' value to replace each band's values where any geometry covers the image (or, if a line width is specified, where the perimeters do).

This algorithm is most suitable for converting categorical data from feature properties to pixels in an image; if you wish to visualize a collection, consider using FeatureCollection.style instead, which supports RGB colors whereas this algorithm is strictly 'monochrome' (using single numeric values).

UsageReturns
Image.paint(featureCollection, color, width)Image
ArgumentTypeDetails
this: imageImageThe image on which the collection is painted.
featureCollectionFeatureCollectionThe collection painted onto the image.
colorObject, default: 0The pixel value to paint into every band of the input image, either as a number which will be used for all features, or the name of a numeric property to take from each feature in the collection.
widthObject, default: nullLine width, either as a number which will be the line width for all geometries, or the name of a numeric property to take from each feature in the collection. If unspecified, the geometries will be filled instead of outlined.

ee.Image.pixelArea

Generate an image in which the value of each pixel is the area of that pixel in square meters. The returned image has a single band called "area."

UsageReturns
ee.Image.pixelArea()Image

No arguments.

ee.Image.pixelCoordinates

Creates a two band image containing the x and y coordinates of each pixel in the given projection.
UsageReturns
ee.Image.pixelCoordinates(projection)Image
ArgumentTypeDetails
projectionProjectionThe projection in which to provide pixels.

ee.Image.pixelLonLat

Creates an image with two bands named 'longitude' and 'latitude', containing the longitude and latitude at each pixel, in degrees.

UsageReturns
ee.Image.pixelLonLat()Image

No arguments.

ee.Image.polynomial

Compute a polynomial at each pixel using the given coefficients.
UsageReturns
Image.polynomial(coefficients)Image
ArgumentTypeDetails
this: imageImageThe input image.
coefficientsListThe polynomial coefficients in increasing order of degree starting with the constant term.

ee.Image.pow

Raises the first value to the power of the second for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is float.

UsageReturns
Image.pow(image2)Image
ArgumentTypeDetails
this: image1ImageThe image from which the left operand bands are taken.
image2ImageThe image from which the right operand bands are taken.

ee.Image.projection

Returns the default projection of an Image. Throws an error if the bands of the image don't all have the same projection.

UsageReturns
Image.projection()Projection
ArgumentTypeDetails
this: imageImageThe image from which to get the projection.

ee.Image.propertyNames

Returns the names of properties on this element.

UsageReturns
Image.propertyNames()List
ArgumentTypeDetails
this: elementElement

ee.Image.random

Generates a random number at each pixel location. When using the 'uniform' distribution, outputs are in the range of [0 to 1). Using the 'normal' distribution, the outputs have μ=0, 𝛔=1, but no explicit limits.

UsageReturns
ee.Image.random(seed, distribution)Image
ArgumentTypeDetails
seedLong, default: 0Seed for the random number generator.
distributionString, default: "uniform"The distribution type of random numbers to produce. One of 'uniform' or 'normal'.

ee.Image.randomVisualizer

Creates a visualization image by assigning a random color to each unique value of the pixels of the first band. The first three bands of the output image will contain 8-bit R, G and B values, followed by all bands of the input image.

UsageReturns
Image.randomVisualizer()Image
ArgumentTypeDetails
this: imageImageImage with at least one band.

ee.Image.reduce

Applies a reducer to all of the bands of an image.

The reducer must have a single input and will be called at each pixel to reduce the stack of band values.

The output image will have one band for each reducer output.

UsageReturns
Image.reduce(reducer)Image
ArgumentTypeDetails
this: imageImageThe image to reduce.
reducerReducerThe reducer to apply to the given image.

ee.Image.reduceConnectedComponents

Applies a reducer to all of the pixels inside of each 'object'. Pixels are considered to belong to an object if they are connected (8-way) and have the same value in the 'label' band. The label band is only used to identify the connectedness; the rest are provided as inputs to the reducer.

UsageReturns
Image.reduceConnectedComponents(reducer, labelBand, maxSize)Image
ArgumentTypeDetails
this: imageImageThe input image.
reducerReducerThe reducer to apply to pixels within the connected component.
labelBandString, default: nullThe name of the band to use to detect connectedness. If unspecified, the first band is used.
maxSizeInteger, default: 256Size of the neighborhood to consider when aggregating values. Any objects larger than maxSize in either the horizontal or vertical dimension will be masked, since portions of the object might be outside of the neighborhood.

ee.Image.reduceNeighborhood

Applies the given reducer to the neighborhood around each pixel, as determined by the given kernel. If the reducer has a single input, it will be applied separately to each band of the collection; otherwise it must have the same number of inputs as the input image has bands.

The reducer output names determine the names of the output bands: reducers with multiple inputs will use the output names directly, while reducers with a single input will prefix the output name with the input band name (e.g. '10_mean', '20_mean', etc.).

Reducers with weighted inputs can have the input weight based on the input mask, the kernel value, or the smaller of those two.

UsageReturns
Image.reduceNeighborhood(reducer, kernel, inputWeight, skipMasked, optimization)Image
ArgumentTypeDetails
this: imageImageThe input image.
reducerReducerThe reducer to apply to pixels within the neighborhood.
kernelKernelThe kernel defining the neighborhood.
inputWeightString, default: "kernel"One of 'mask', 'kernel', or 'min'.
skipMaskedBoolean, default: trueMask output pixels if the corresponding input pixel is masked.
optimizationString, default: nullOptimization strategy. Options are 'boxcar' and 'window'. The 'boxcar' method is a fast method for computing count, sum or mean. It requires a homogeneous kernel, a single-input reducer and either MASK, KERNEL or no weighting. The 'window' method uses a running window, and has the same requirements as 'boxcar', but can use any single input reducer. Both methods require considerable additional memory.

ee.Image.reduceRegion

Apply a reducer to all the pixels in a specific region.

Either the reducer must have the same number of inputs as the input image has bands, or it must have a single input and will be repeated for each band.

Returns a dictionary of the reducer's outputs.

UsageReturns
Image.reduceRegion(reducer, geometry, scale, crs, crsTransform, bestEffort, maxPixels, tileScale)Dictionary
ArgumentTypeDetails
this: imageImageThe image to reduce.
reducerReducerThe reducer to apply.
geometryGeometry, default: nullThe region over which to reduce data. Defaults to the footprint of the image's first band.
scaleFloat, default: nullA nominal scale in meters of the projection to work in.
crsProjection, default: nullThe projection to work in. If unspecified, the projection of the image's first band is used. If specified in addition to scale, rescaled to the specified scale.
crsTransformList, default: nullThe list of CRS transform values. This is a row-major ordering of the 3x2 transform matrix. This option is mutually exclusive with 'scale', and replaces any transform already set on the projection.
bestEffortBoolean, default: falseIf the polygon would contain too many pixels at the given scale, compute and use a larger scale which would allow the operation to succeed.
maxPixelsLong, default: 10000000The maximum number of pixels to reduce.
tileScaleFloat, default: 1A scaling factor between 0.1 and 16 used to adjust aggregation tile size; setting a larger tileScale (e.g. 2 or 4) uses smaller tiles and may enable computations that run out of memory with the default.

ee.Image.reduceRegions

Apply a reducer over the area of each feature in the given collection.

The reducer must have the same number of inputs as the input image has bands.

Returns the input features, each augmented with the corresponding reducer outputs.

UsageReturns
Image.reduceRegions(collection, reducer, scale, crs, crsTransform, tileScale)FeatureCollection
ArgumentTypeDetails
this: imageImageThe image to reduce.
collectionFeatureCollectionThe features to reduce over.
reducerReducerThe reducer to apply.
scaleFloat, default: nullA nominal scale in meters of the projection to work in.
crsProjection, default: nullThe projection to work in. If unspecified, the projection of the image's first band is used. If specified in addition to scale, rescaled to the specified scale.
crsTransformList, default: nullThe list of CRS transform values. This is a row-major ordering of the 3x2 transform matrix. This option is mutually exclusive with 'scale', and will replace any transform already set on the projection.
tileScaleFloat, default: 1A scaling factor used to reduce aggregation tile size; using a larger tileScale (e.g. 2 or 4) may enable computations that run out of memory with the default.

ee.Image.reduceResolution

Enables reprojection using the given reducer to combine all input pixels corresponding to each output pixel. If the reducer has a single input, it will be applied separately to each band of the collection; otherwise it must have the same number of inputs as the input image has bands.

The reducer output names determine the names of the output bands: reducers with multiple inputs will use the output names directly, reducers with a single input and single output will preserve the input band names, and reducers with a single input and multiple outputs will prefix the output name with the input band name (e.g. '10_mean', '10_stdDev', '20_mean', '20_stdDev', etc.).

Reducer input weights will be the product of the input mask and the fraction of the output pixel covered by the input pixel.

UsageReturns
Image.reduceResolution(reducer, bestEffort, maxPixels)Image
ArgumentTypeDetails
this: imageImageThe input image.
reducerReducerThe reducer to apply to be used for combining pixels.
bestEffortBoolean, default: falseIf using the input at its default resolution would require too many pixels, start with already-reduced input pixels from a pyramid level that allows the operation to succeed.
maxPixelsInteger, default: 64The maximum number of input pixels to combine for each output pixel. Setting this too large will cause out-of-memory problems.

ee.Image.reduceToVectors

Convert an image to a feature collection by reducing homogeneous regions. Given an image containing a band of labeled segments and zero or more additional bands, runs a reducer over the pixels in each segment producing a feature per segment.

Either the reducer must have one fewer inputs than the image has bands, or it must have a single input and will be repeated for each band.

UsageReturns
Image.reduceToVectors(reducer, geometry, scale, geometryType, eightConnected, labelProperty, crs, crsTransform, bestEffort, maxPixels, tileScale, geometryInNativeProjection)FeatureCollection
ArgumentTypeDetails
this: imageImageThe input image. The first band is expected to be an integer type; adjacent pixels will be in the same segment if they have the same value in this band.
reducerReducer, default: nullThe reducer to apply. Its inputs will be taken from the image's bands after dropping the first band. Defaults to Reducer.countEvery()
geometryGeometry, default: nullThe region over which to reduce data. Defaults to the footprint of the image's first band.
scaleFloat, default: nullA nominal scale in meters of the projection to work in.
geometryTypeString, default: "polygon"How to choose the geometry of each generated feature; one of 'polygon' (a polygon enclosing the pixels in the segment), 'bb' (a rectangle bounding the pixels), or 'centroid' (the centroid of the pixels).
eightConnectedBoolean, default: trueIf true, diagonally-connected pixels are considered adjacent; otherwise only pixels that share an edge are.
labelPropertyString, default: "label"If non-null, the value of the first band will be saved as the specified property of each feature.
crsProjection, default: nullThe projection to work in. If unspecified, the projection of the image's first band is used. If specified in addition to scale, rescaled to the specified scale.
crsTransformList, default: nullThe list of CRS transform values. This is a row-major ordering of the 3x2 transform matrix. This option is mutually exclusive with 'scale', and replaces any transform already set on the projection.
bestEffortBoolean, default: falseIf the polygon would contain too many pixels at the given scale, compute and use a larger scale which would allow the operation to succeed.
maxPixelsLong, default: 10000000The maximum number of pixels to reduce.
tileScaleFloat, default: 1A scaling factor used to reduce aggregation tile size; using a larger tileScale (e.g. 2 or 4) may enable computations that run out of memory with the default.
geometryInNativeProjectionBoolean, default: falseCreate geometries in the pixel projection, rather than WGS84.

ee.Image.regexpRename

Renames the bands of an image by applying a regular expression replacement to the current band names. Any bands not matched by the regex will be copied over without renaming.

UsageReturns
Image.regexpRename(regex, replacement, all)Image
ArgumentTypeDetails
this: inputImageThe image containing the bands to rename.
regexStringA regular expression to match in each band name.
replacementStringThe text with which to replace each match. Supports $n syntax for captured values.
allBoolean, default: trueIf true, all matches in a given string will be replaced. Otherwise, only the first match in each string will be replaced.

ee.Image.register

Registers an image to a reference image while allowing local, rubber sheet deformations. Displacements are computed in the CRS of the reference image, at a scale dictated by the lowest resolution of the following three projections: input image projection, reference image projection, and requested projection. The displacements then applied to the input image to register it with the reference.

UsageReturns
Image.register(referenceImage, maxOffset, patchWidth, stiffness)Image
ArgumentTypeDetails
this: imageImageThe image to register.
referenceImageImageThe image to register to.
maxOffsetFloatThe maximum offset allowed when attempting to align the input images, in meters. Using a smaller value can reduce computation time significantly, but it must still be large enough to cover the greatest displacement within the entire image region.
patchWidthFloat, default: nullPatch size for detecting image offsets, in meters. This should be set large enough to capture texture, as well as large enough that ignorable objects are small within the patch. Default is null. Patch size will be determined automatically if notprovided.
stiffnessFloat, default: 5Enforces a stiffness constraint on the solution. Valid values are in the range [0,10]. The stiffness is used for outlier rejection when determining displacements at adjacent grid points. Higher values move the solution towards a rigid transformation. Lower values allow more distortion or warping of the image during registration.

ee.Image.remap

Maps from input values to output values, represented by two parallel lists. Any input values not included in the input list are either set to defaultValue if it is given, or masked if it isn't. Note that inputs containing floating point values might sometimes fail to match due to floating point precision errors.

UsageReturns
Image.remap(from, to, defaultValue, bandName)Image
ArgumentTypeDetails
this: imageImageThe image to which the remapping is applied.
fromListThe source values (numbers or ee.Array). All values in this list will be mapped to the corresponding value in 'to'.
toListThe destination values (numbers or ee.Array). These are used to replace the corresponding values in 'from'. Must have the same number of values as 'from'.
defaultValueObject, default: nullThe default value to replace values that weren't matched by a value in 'from'. If not specified, unmatched values are masked out.
bandNameString, default: nullThe name of the band to remap. If not specified, the first band in the image is used.

ee.Image.rename

Rename the bands of an image.

Returns the renamed image.

UsageReturns
Image.rename(var_args)Image
ArgumentTypeDetails
this: imageImageThe Image instance.
var_argsListThe new names for the bands. Must match the number of bands in the Image.

ee.Image.reproject

Force an image to be computed in a given projection and resolution.

UsageReturns
Image.reproject(crs, crsTransform, scale)Image
ArgumentTypeDetails
this: imageImageThe image to reproject.
crsProjectionThe CRS to project the image to.
crsTransformList, default: nullThe list of CRS transform values. This is a row-major ordering of the 3x2 transform matrix. This option is mutually exclusive with the scale option, and replaces any transform already on the projection.
scaleFloat, default: nullIf scale is specified, then the projection is scaled by dividing the specified scale value by the nominal size of a meter in the specified projection. If scale is not specified, then the scale of the given projection will be used.

ee.Image.resample

An algorithm that returns an image identical to its argument, but which uses bilinear or bicubic interpolation (rather than the default nearest-neighbor) to compute pixels in projections other than its native projection or other levels of the same image pyramid.

This relies on the input image's default projection being meaningful, and so cannot be used on composites, for example. (Instead, you should resample the images that are used to create the composite.)

UsageReturns
Image.resample(mode)Image
ArgumentTypeDetails
this: imageImageThe Image to resample.
modeString, default: "bilinear"The interpolation mode to use. One of 'bilinear' or 'bicubic'.)

ee.Image.rgb

Create a 3-band image specifically for visualization. This uses the first band in each image.

Returns the combined image.

UsageReturns
ee.Image.rgb(r, g, b)Image
ArgumentTypeDetails
rImageThe red image.
gImageThe green image.
bImageThe blue image.

ee.Image.rgbToHsv

Transforms the image from the RGB color space to the HSV color space. Expects a 3 band image in the range [0, 1], and produces three bands: hue, saturation and value with values in the range [0, 1].

UsageReturns
Image.rgbToHsv()Image
ArgumentTypeDetails
this: imageImageThe image to transform.

ee.Image.rightShift

Calculates the signed right shift of v1 by v2 bits for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is the union of the input types.

UsageReturns
Image.rightShift(image2)Image
ArgumentTypeDetails
this: image1ImageThe image from which the left operand bands are taken.
image2ImageThe image from which the right operand bands are taken.

ee.Image.round

Computes the integer nearest to the input.

UsageReturns
Image.round()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.rsedTransform

Computes the 2D maximal height surface created by placing an inverted parabola over each non-zero pixel of the input image, where the pixel's value is the height of the parabola. Viewed as a binary image (zero/not-zero) this is equivalent to buffering each non-zero input pixel by the square root of its value, in pixels.

UsageReturns
Image.rsedTransform(neighborhood, units)Image
ArgumentTypeDetails
this: imageImageThe input image.
neighborhoodInteger, default: 256Neighborhood size in pixels.
unitsString, default: "pixels"The units of the neighborhood, currently only 'pixels' are supported.

ee.Image.sample

Samples the pixels of an image, returning them as a FeatureCollection. Each feature will have 1 property per band in the input image. Note that the default behavior is to drop features that intersect masked pixels, which result in null-valued properties (see dropNulls argument).

UsageReturns
Image.sample(region, scale, projection, factor, numPixels, seed, dropNulls, tileScale, geometries)FeatureCollection
ArgumentTypeDetails
this: imageImageThe image to sample.
regionGeometry, default: nullThe region to sample from. If unspecified, uses the image's whole footprint.
scaleFloat, default: nullA nominal scale in meters of the projection to sample in.
projectionProjection, default: nullThe projection in which to sample. If unspecified, the projection of the image's first band is used. If specified in addition to scale, rescaled to the specified scale.
factorFloat, default: nullA subsampling factor, within (0, 1]. If specified, 'numPixels' must not be specified. Defaults to no subsampling.
numPixelsLong, default: nullThe approximate number of pixels to sample. If specified, 'factor' must not be specified.
seedInteger, default: 0A randomization seed to use for subsampling.
dropNullsBoolean, default: truePost filter the result to drop features that have null-valued properties.
tileScaleFloat, default: 1A scaling factor used to reduce aggregation tile size; using a larger tileScale (e.g. 2 or 4) may enable computations that run out of memory with the default.
geometriesBoolean, default: falseIf true, adds the center of the sampled pixel as the geometry property of the output feature. Otherwise, geometries will be omitted (saving memory).

ee.Image.sampleRectangle

Extracts a rectangular region of pixels from an image into a ND array per band. The arrays are returned in a feature retaining the same properties as the image and a geometry the same as that used to sample the image (or the image footprint if unspecified). Each band is sampled in its input projection, and if no geometry is specified, sampled using its footprint. For scalar bands, the output array is 2D. For array bands the output array is (2+N)D where N is the number of dimensions in the original band. If sampling array bands, all arrays must have the same number of elements. If a band's sampled region is entirely masked and a default array value is specified, the default array value is used in-lieu of sampling the image.

UsageReturns
Image.sampleRectangle(region, properties, defaultValue, defaultArrayValue)Feature
ArgumentTypeDetails
this: imageImageThe image to sample.
regionGeometry, default: nullThe region whose projected bounding box is used to sample the image. Defaults to the footprint in each band.
propertiesList, default: nullThe properties to copy over from the sampled image. Defaults to all non-system properties.
defaultValueFloat, default: nullA default value used when a sampled pixel is masked or outside a band's footprint.
defaultArrayValueArray, default: nullA default value used when a sampled array pixel is masked or outside a band's footprint.

ee.Image.sampleRegions

Converts each pixel of an image (at a given scale) that intersects one or more regions to a Feature, returning them as a FeatureCollection. Each output feature will have one property per band of the input image, as well as any specified properties copied from the input feature.

Note that geometries will be snapped to pixel centers.

UsageReturns
Image.sampleRegions(collection, properties, scale, projection, tileScale, geometries)FeatureCollection
ArgumentTypeDetails
this: imageImageThe image to sample.
collectionFeatureCollectionThe regions to sample over.
propertiesList, default: nullThe list of properties to copy from each input feature. Defaults to all non-system properties.
scaleFloat, default: nullA nominal scale in meters of the projection to sample in. If unspecified, the scale of the image's first band is used.
projectionProjection, default: nullThe projection in which to sample. If unspecified, the projection of the image's first band is used. If specified in addition to scale, rescaled to the specified scale.
tileScaleFloat, default: 1A scaling factor used to reduce aggregation tile size; using a larger tileScale (e.g. 2 or 4) may enable computations that run out of memory with the default.
geometriesBoolean, default: falseIf true, the results will include a point geometry per sampled pixel. Otherwise, geometries will be omitted (saving memory).

ee.Image.select

Selects bands from an image.

Returns an image with the selected bands.

UsageReturns
Image.select(var_args)Image
ArgumentTypeDetails
this: imageImageThe Image instance.
var_argsVarArgsOne of two possibilities:
  • Any number of non-list arguments. All of these will be interpreted as band selectors. These can be band names, regexes, or numeric indices. E.g. selected = image.select('a', 'b', 3, 'd');
  • Two lists. The first will be used as band selectors and the second as new names for the selected bands. The number of new names must match the number of selected bands. E.g. selected = image.select(['a', 4], ['newA', 'newB']);

ee.Image.selfMask

Updates an image's mask at all positions where the existing mask is not zero using the value of the image as the new mask value. The output image retains the metadata and footprint of the input image.

UsageReturns
Image.selfMask()Image
ArgumentTypeDetails
this: imageImageThe image to mask with itself.

ee.Image.serialize

Returns the serialized representation of this object.

UsageReturns
Image.serialize(legacy)String
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
legacyBoolean, optionalEnables legacy format.

ee.Image.set

Overrides one or more metadata properties of an Element.

Returns the element with the specified properties overridden.

UsageReturns
Image.set(var_args)Element
ArgumentTypeDetails
this: elementElementThe Element instance.
var_argsVarArgsEither a dictionary of properties, or a vararg sequence of properties, e.g. key1, value1, key2, value2, ...

ee.Image.setDefaultProjection

Set a default projection to be applied to this image. The projection's resolution may be overridden by later operations.

UsageReturns
Image.setDefaultProjection(crs, crsTransform, scale)Image
ArgumentTypeDetails
this: imageImageThe image to reproject.
crsProjectionThe CRS to project the image to.
crsTransformList, default: nullThe list of CRS transform values. This is a row-major ordering of the 3x2 transform matrix. This option is mutually exclusive with the scale option, and replaces any transform already on the projection.
scaleFloat, default: nullIf scale is specified, then the projection is scaled by dividing the specified scale value by the nominal size of a meter in the specified projection. If scale is not specified, then the scale of the given projection will be used.

ee.Image.short

Casts the input value to a signed 16-bit integer.

UsageReturns
Image.short()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.signum

Computes the signum function (sign) of the input; zero if the input is zero, 1 if the input is greater than zero, -1 if the input is less than zero.

UsageReturns
Image.signum()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.sin

Computes the sine of the input in radians.

UsageReturns
Image.sin()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.sinh

Computes the hyperbolic sine of the input.

UsageReturns
Image.sinh()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.sldStyle

Styles a raster input with the provided OGC SLD styling.

Points of note:

 * OGC SLD 1.0 and OGC SE 1.1 are supported.

 * The XML document passed in can be complete, or just the SldRasterSymbolizer element and down.

 * Exactly one SldRasterSymbolizer is required.

 * Bands may be selected by their proper EarthEngine names or using numeric identifiers ("1", "2", ...). Proper EarthEngine names are tried first.

 * The Histogram and Normalize contrast stretch mechanisms are supported.

 * The type="values", type="intervals" and type="ramp" attributes for ColorMap element in SLD 1.0 (GeoServer extensions) are supported.

 * Opacity is only taken into account when it is 0.0 (transparent). Non-zero opacity values are treated as completely opaque.

 * The OverlapBehavior definition is currently ignored.

 * The ShadedRelief mechanism is not currently supported.

 * The ImageOutline mechanism is not currently supported.

 * The Geometry element is ignored.

The output image will have histogram_bandname metadata if histogram equalization or normalization is requested.

UsageReturns
Image.sldStyle(sldXml)Image
ArgumentTypeDetails
this: inputImageThe image to rendering using the SLD.
sldXmlStringThe OGC SLD 1.0 or 1.1 document (or fragment).

ee.Image.slice

Selects a contiguous group of bands from an image by position.

UsageReturns
Image.slice(start, end)Image
ArgumentTypeDetails
this: imageImageThe image from which to select bands.
startIntegerWhere to start the selection. Negative numbers select from the end, counting backwards.
endInteger, default: nullWhere to end the selection. If omitted, selects all bands from the start position to the end.

ee.Image.spectralDilation

Computes the spectral/spatial dilation of an image by computing the spectral distance of each pixel under a structuring kernel from the centroid of all pixels under the kernel and taking the most distant result. See 'Spatial/spectral endmember extraction by multidimensional morphological operations.' IEEE transactions on geoscience and remote sensing 40.9 (2002): 2025-2041.

UsageReturns
Image.spectralDilation(metric, kernel, useCentroid)Image
ArgumentTypeDetails
this: imageImageThe input image.
metricString, default: "sam"The spectral distance metric to use. One of 'sam' (spectral angle mapper), 'sid' (spectral information divergence), 'sed' (squared euclidean distance), or 'emd' (earth movers distance).
kernelKernel, default: nullConnectedness kernel. Defaults to a square of radius 1 (8-way connected).
useCentroidBoolean, default: falseIf true, distances are computed from the mean of all pixels under the kernel instead of the kernel's center pixel.

ee.Image.spectralDistance

Computes the per-pixel spectral distance between two images. If the images are array based then only the first band of each image is used; otherwise all bands are involved in the distance computation. The two images are therefore expected to contain the same number of bands or have the same 1-dimensional array length.

UsageReturns
Image.spectralDistance(image2, metric)Image
ArgumentTypeDetails
this: image1ImageThe first image.
image2ImageThe second image.
metricString, default: "sam"The spectral distance metric to use. One of 'sam' (spectral angle mapper), 'sid' (spectral information divergence), 'sed' (squared euclidean distance), or 'emd' (earth movers distance).

ee.Image.spectralErosion

Computes the spectral/spatial erosion of an image by computing the spectral distance of each pixel under a structuring kernel from the centroid of all pixels under the kernel and taking the closest result. See 'Spatial/spectral endmember extraction by multidimensional morphological operations.' IEEE transactions on geoscience and remote sensing 40.9 (2002): 2025-2041.

UsageReturns
Image.spectralErosion(metric, kernel, useCentroid)Image
ArgumentTypeDetails
this: imageImageThe input image.
metricString, default: "sam"The spectral distance metric to use. One of 'sam' (spectral angle mapper), 'sid' (spectral information divergence), 'sed' (squared euclidean distance), or 'emd' (earth movers distance).
kernelKernel, default: nullConnectedness kernel. Defaults to a square of radius 1 (8-way connected).
useCentroidBoolean, default: falseIf true, distances are computed from the mean of all pixels under the kernel instead of the kernel's center pixel.

ee.Image.spectralGradient

Computes the spectral gradient over all bands of an image (or the first band if the image is Array typed) by computing the per-pixel difference between the spectral erosion and dilation with a given structuring kernel and distance metric. See: Plaza, Antonio, et al. 'Spatial/spectral endmember extraction by multidimensional morphological operations.' IEEE transactions on geoscience and remote sensing 40.9 (2002): 2025-2041.

UsageReturns
Image.spectralGradient(metric, kernel, useCentroid)Image
ArgumentTypeDetails
this: imageImageThe input image.
metricString, default: "sam"The spectral distance metric to use. One of 'sam' (spectral angle mapper), 'sid' (spectral information divergence), 'sed' (squared euclidean distance), or 'emd' (earth movers distance).
kernelKernel, default: nullConnectedness kernel. Defaults to a square of radius 1 (8-way connected).
useCentroidBoolean, default: falseIf true, distances are computed from the mean of all pixels under the kernel instead of the kernel's center pixel.

ee.Image.sqrt

Computes the square root of the input.

UsageReturns
Image.sqrt()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.stratifiedSample

Extracts a stratified random sample of points from an image. Extracts the specified number of samples for each distinct value discovered within the 'classBand'. Returns a FeatureCollection of 1 Feature per extracted point, with each feature having 1 property per band in the input image. If there are less than the specified number of samples available for a given class value, then all of the points for that class will be included. Requires that the classBand contain integer values.

UsageReturns
Image.stratifiedSample(numPoints, classBand, region, scale, projection, seed, classValues, classPoints, dropNulls, tileScale, geometries)FeatureCollection
ArgumentTypeDetails
this: imageImageThe image to sample.
numPointsIntegerThe default number of points to sample in each class. Can be overridden for specific classes using the 'classValues' and 'classPoints' properties.
classBandString, default: nullThe name of the band containing the classes to use for stratification. If unspecified, the first band of the input image is used.
regionGeometry, default: nullThe region to sample from. If unspecified, the input image's whole footprint is used.
scaleFloat, default: nullA nominal scale in meters of the projection to sample in. Defaults to the scale of the first band of the input image.
projectionProjection, default: nullThe projection in which to sample. If unspecified, the projection of the input image's first band is used. If specified in addition to scale, rescaled to the specified scale.
seedInteger, default: 0A randomization seed to use for subsampling.
classValuesList, default: nullA list of class values for which to override the numPoints parameter. Must be the same size as classPoints or null.
classPointsList, default: nullA list of the per-class maximum number of pixels to sample for each class in the classValues list. Must be the same size as classValues or null.
dropNullsBoolean, default: trueSkip pixels in which any band is masked.
tileScaleFloat, default: 1A scaling factor used to reduce aggregation tile size; using a larger tileScale (e.g. 2 or 4) may enable computations that run out of memory with the default.
geometriesBoolean, default: falseIf true, the results will include a geometry per sampled pixel. Otherwise, geometries will be omitted (saving memory).

ee.Image.subtract

Subtracts the second value from the first for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is the union of the input types.

UsageReturns
Image.subtract(image2)Image
ArgumentTypeDetails
this: image1ImageThe image from which the left operand bands are taken.
image2ImageThe image from which the right operand bands are taken.

ee.Image.tan

Computes the tangent of the input in radians.

UsageReturns
Image.tan()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.tanh

Computes the hyperbolic tangent of the input.

UsageReturns
Image.tanh()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.toArray

Concatenates pixels from each band into a single array per pixel. The result will be masked if any input bands are masked.

UsageReturns
Image.toArray(axis)Image
ArgumentTypeDetails
this: imageImageImage of bands to convert to an array per pixel. Bands must have scalar pixels, or array pixels with equal dimensionality.
axisInteger, default: 0Axis to concatenate along; must be at least 0 and at most the dimension of the inputs. If the axis equals the dimension of the inputs, the result will have 1 more dimension than the inputs.

ee.Image.toByte

Casts the input value to an unsigned 8-bit integer.

UsageReturns
Image.toByte()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.toDictionary

Extract properties from a feature as a dictionary.

UsageReturns
Image.toDictionary(properties)Dictionary
ArgumentTypeDetails
this: elementElementThe feature to extract the property from.
propertiesList, default: nullThe list of properties to extract. Defaults to all non-system properties.

ee.Image.toDouble

Casts the input value to a 64-bit float.

UsageReturns
Image.toDouble()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.toFloat

Casts the input value to a 32-bit float.

UsageReturns
Image.toFloat()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.toInt

Casts the input value to a signed 32-bit integer.

UsageReturns
Image.toInt()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.toInt16

Casts the input value to a signed 16-bit integer.

UsageReturns
Image.toInt16()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.toInt32

Casts the input value to a signed 32-bit integer.

UsageReturns
Image.toInt32()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.toInt64

Casts the input value to a signed 64-bit integer.

UsageReturns
Image.toInt64()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.toInt8

Casts the input value to a signed 8-bit integer.

UsageReturns
Image.toInt8()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.toLong

Casts the input value to a signed 64-bit integer.

UsageReturns
Image.toLong()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.toShort

Casts the input value to a signed 16-bit integer.

UsageReturns
Image.toShort()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.toUint16

Casts the input value to an unsigned 16-bit integer.

UsageReturns
Image.toUint16()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.toUint32

Casts the input value to an unsigned 32-bit integer.

UsageReturns
Image.toUint32()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.toUint8

Casts the input value to an unsigned 8-bit integer.

UsageReturns
Image.toUint8()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.translate

Translate the input image.

UsageReturns
Image.translate(x, y, units, proj)Image
ArgumentTypeDetails
this: inputImage
xFloat
yFloat
unitsString, default: "meters"The units for x and y; 'meters' or 'pixels'.
projProjection, default: nullThe projection in which to translate the image; defaults to the projection of the first band.

ee.Image.trigamma

Computes the trigamma function of the input.

UsageReturns
Image.trigamma()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.uint16

Casts the input value to an unsigned 16-bit integer.

UsageReturns
Image.uint16()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.uint32

Casts the input value to an unsigned 32-bit integer.

UsageReturns
Image.uint32()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.uint8

Casts the input value to an unsigned 8-bit integer.

UsageReturns
Image.uint8()Image
ArgumentTypeDetails
this: valueImageThe image to which the operation is applied.

ee.Image.unitScale

Scales the input so that the range of input values [low, high] becomes [0, 1]. Values outside the range are NOT clamped. This algorithm always produces floating point pixels.

UsageReturns
Image.unitScale(low, high)Image
ArgumentTypeDetails
this: inputImageThe image to scale.
lowFloatThe value mapped to 0.
highFloatThe value mapped to 1.

ee.Image.unmask

Replaces mask and value of the input image with the mask and value of another image at all positions where the input mask is zero. The output image retains the metadata of the input image. By default, the output image also retains the footprint of the input, but setting sameFootprint to false allows to extend the footprint.

UsageReturns
Image.unmask(value, sameFootprint)Image
ArgumentTypeDetails
this: inputImageInput image.
valueImage, default: nullNew value and mask for the masked pixels of the input image. If not specified, defaults to constant zero image which is valid everywhere.
sameFootprintBoolean, default: trueIf true (or unspecified), the output retains the footprint of the input image. If false, the footprint of the output is the union of the input footprint with the footprint of the value image.

ee.Image.unmix

Unmix each pixel with the given endmembers, by computing the pseudo-inverse and multiplying it through each pixel. Returns an image of doubles with the same number of bands as endmembers.

UsageReturns
Image.unmix(endmembers, sumToOne, nonNegative)Image
ArgumentTypeDetails
this: imageImageThe input image.
endmembersListThe endmembers to unmix with.
sumToOneBoolean, default: falseConstrain the outputs to sum to one.
nonNegativeBoolean, default: falseConstrain the outputs to be non-negative.

ee.Image.updateMask

Updates an image's mask at all positions where the existing mask is not zero. The output image retains the metadata and footprint of the input image.

UsageReturns
Image.updateMask(mask)Image
ArgumentTypeDetails
this: imageImageInput image.
maskImageNew mask for the image, as a floating-point value in the range [0, 1] (invalid = 0, valid = 1). If this image has a single band, it is used for all bands in the input image; otherwise, must have the same number of bands as the input image.

ee.Image.visualize

Produces an RGB or grayscale visualization of an image. Each of the gain, bias, min, max and gamma arguments can take either a single value, which will be applied to all bands, or a list of values the same length as bands.

UsageReturns
Image.visualize(bands, gain, bias, min, max, gamma, opacity, palette, forceRgbOutput)Image
ArgumentTypeDetails
this: imageImageThe image to visualize.
bandsObject, default: nullA list of the bands to visualize. If empty, the first 3 are used.
gainObject, default: nullThe visualization gain(s) to use.
biasObject, default: nullThe visualization bias(es) to use.
minObject, default: nullThe value(s) to map to RGB8 value 0.
maxObject, default: nullThe value(s) to map to RGB8 value 255.
gammaObject, default: nullThe gamma correction factor(s) to use.
opacityNumber, default: nullThe opacity scaling factor to use.
paletteObject, default: nullThe color palette to use. List of CSS color identifiers or hexadecimal color strings (e.g. ['red', '00FF00', 'bluevlolet']).
forceRgbOutputBoolean, default: falseWhether to produce RGB output even for single-band inputs.

ee.Image.where

Performs conditional replacement of values.

For each pixel in each band of 'input', if the corresponding pixel in 'test' is nonzero, output the corresponding pixel in value, otherwise output the input pixel.

If at a given pixel, either test or value is masked, the input value is used. If the input is masked, nothing is done.

The output bands have the same names as the input bands. The output type of each band is the larger of the input and value types. The output image retains the metadata and footprint of the input image.

UsageReturns
Image.where(test, value)Image
ArgumentTypeDetails
this: inputImageThe input image.
testImageThe test image. The pixels of this image determines which of the input pixels is returned. If this is a single band, it is used for all bands in the input image. This may not be an array image.
valueImageThe output value to use where test is not zero. If this is a single band, it is used for all bands in the input image.

ee.Image.zeroCrossing

Finds zero-crossings on each band of an image.

UsageReturns
Image.zeroCrossing()Image
ArgumentTypeDetails
this: imageImageThe image from which to compute zero crossings.

ee.ImageCollection

ImageCollections can be constructed from the following arguments:

  - A string: assumed to be the name of a collection,

  - A list of images, or anything that can be used to construct an image.

  - A single image.

  - A computed object - reinterpreted as a collection.

UsageReturns
ee.ImageCollection(args)ImageCollection
ArgumentTypeDetails
argsComputedObject|Image|ListThe constructor arguments.

ee.ImageCollection.aggregate_array

Aggregates over a given property of the objects in a collection, calculating a list of all the values of the selected property.

UsageReturns
ImageCollection.aggregate_array(property)List
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.ImageCollection.aggregate_count

Aggregates over a given property of the objects in a collection, calculating the number of non-null values of the property.

UsageReturns
ImageCollection.aggregate_count(property)Number
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.ImageCollection.aggregate_count_distinct

Aggregates over a given property of the objects in a collection, calculating the number of distinct values for the selected property.

UsageReturns
ImageCollection.aggregate_count_distinct(property)Number
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.ImageCollection.aggregate_first

Aggregates over a given property of the objects in a collection, calculating the property value of the first object in the collection.

UsageReturns
ImageCollection.aggregate_first(property)
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.ImageCollection.aggregate_histogram

Aggregates over a given property of the objects in a collection, calculating a histogram of the selected property.

UsageReturns
ImageCollection.aggregate_histogram(property)Dictionary
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.ImageCollection.aggregate_max

Aggregates over a given property of the objects in a collection, calculating the maximum of the values of the selected property.

UsageReturns
ImageCollection.aggregate_max(property)
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.ImageCollection.aggregate_mean

Aggregates over a given property of the objects in a collection, calculating the mean of the selected property.

UsageReturns
ImageCollection.aggregate_mean(property)Number
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.ImageCollection.aggregate_min

Aggregates over a given property of the objects in a collection, calculating the minimum of the values of the selected property.

UsageReturns
ImageCollection.aggregate_min(property)
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.ImageCollection.aggregate_product

Aggregates over a given property of the objects in a collection, calculating the product of the values of the selected property.

UsageReturns
ImageCollection.aggregate_product(property)Number
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.ImageCollection.aggregate_sample_sd

Aggregates over a given property of the objects in a collection, calculating the sample std. deviation of the values of the selected property.

UsageReturns
ImageCollection.aggregate_sample_sd(property)Number
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.ImageCollection.aggregate_sample_var

Aggregates over a given property of the objects in a collection, calculating the sample variance of the values of the selected property.

UsageReturns
ImageCollection.aggregate_sample_var(property)Number
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.ImageCollection.aggregate_stats

Aggregates over a given property of the objects in a collection, calculating the sum, min, max, mean, sample standard deviation, sample variance, total standard deviation and total variance of the selected property.

UsageReturns
ImageCollection.aggregate_stats(property)Dictionary
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.ImageCollection.aggregate_sum

Aggregates over a given property of the objects in a collection, calculating the sum of the values of the selected property.

UsageReturns
ImageCollection.aggregate_sum(property)Number
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.ImageCollection.aggregate_total_sd

Aggregates over a given property of the objects in a collection, calculating the total std. deviation of the values of the selected property.

UsageReturns
ImageCollection.aggregate_total_sd(property)Number
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.ImageCollection.aggregate_total_var

Aggregates over a given property of the objects in a collection, calculating the total variance of the values of the selected property.

UsageReturns
ImageCollection.aggregate_total_var(property)Number
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

ee.ImageCollection.and

Reduces an image collection by setting each pixel to 1 iff all the non-masked values at that pixel are non-zero across the stack of all matching bands. Bands are matched by name.

UsageReturns
ImageCollection.and()Image
ArgumentTypeDetails
this: collectionImageCollectionThe image collection to reduce.

ee.ImageCollection.aside

Calls a function passing this object as the first argument, and returning itself. Convenient e.g. when debugging:

var c = ee.ImageCollection('foo').aside(print)

.filterDate('2001-01-01', '2002-01-01').aside(print, 'In 2001')

.filterBounds(geom).aside(print, 'In region')

.aside(Map.addLayer, {min: 0, max: 142}, 'Filtered')

.select('a', 'b');

Returns the same object, for chaining.

UsageReturns
ImageCollection.aside(func, var_args)ComputedObject
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
funcFunctionThe function to call.
var_argsVarArgsAny extra arguments to pass to the function.

ee.ImageCollection.cast

Casts some or all bands of each image in an ImageCollection to the specified types.

UsageReturns
ImageCollection.cast(bandTypes, bandOrder)ImageCollection
ArgumentTypeDetails
this: collectionImageCollectionThe image collection to cast.
bandTypesDictionaryA dictionary from band name to band types. Types can be PixelTypes or strings. The valid strings are: 'int8', 'int16', 'int32', 'int64', 'uint8', 'uint16', 'uint32', 'byte', 'short', 'int', 'long', 'float' and 'double'. Must include all bands already in any image in the collection. If this includes bands that are not already in an input image, they will be added to the image as transparent bands.
bandOrderListA list specifying the order of the bands in the result.Must match the keys of bandTypes.

ee.ImageCollection.combine

Makes a new collection that is a copy of the images in primary, adding all the bands from the image in secondary with a matching ID. If there are no matching IDs, the resulting collection will be empty. This is equivalent to an inner join on ID with merging of the bands of the result.

Note that this algorithm assumes that for a matching pair of inputs, both have the same footprint and metadata.

UsageReturns
ImageCollection.combine(secondary, overwrite)ImageCollection
ArgumentTypeDetails
this: primaryImageCollectionThe primary collection to join.
secondaryImageCollectionThe secondary collection to join.
overwriteBoolean, default: falseIf true, bands with the same name will get overwritten. If false, bands with the same name will be renamed.

ee.ImageCollection.copyProperties

Copies metadata properties from one element to another.

UsageReturns
ImageCollection.copyProperties(source, properties, exclude)Element
ArgumentTypeDetails
this: destinationElement, default: nullThe object whose properties to override.
sourceElement, default: nullThe object from which to copy the properties.
propertiesList, default: nullThe properties to copy. If omitted, all ordinary (i.e. non-system) properties are copied.
excludeList, default: nullThe list of properties to exclude when copying all properties. Must not be specified if properties is.

ee.ImageCollection.count

Reduces an image collection by calculating the number of images with a valid mask at each pixel across the stack of all matching bands. Bands are matched by name.

UsageReturns
ImageCollection.count()Image
ArgumentTypeDetails
this: collectionImageCollectionThe image collection to reduce.

ee.ImageCollection.distance

Produces a DOUBLE image where each pixel is the distance in meters from the pixel center to the nearest Point, LineString, or polygonal boundary in the collection. Note distance is also measured within interiors of polygons. Pixels that are not within 'searchRadius' meters of a geometry will be masked out.

Distances are computed on a sphere, so there is a small error proportional to the latitude difference between each pixel and the nearest geometry.

UsageReturns
ImageCollection.distance(searchRadius, maxError)Image
ArgumentTypeDetails
this: featuresFeatureCollectionFeature collection from which to get features used to compute pixel distances.
searchRadiusFloat, default: 100000Maximum distance in meters from each pixel to look for edges. Pixels will be masked unless there are edges within this distance.
maxErrorFloat, default: 100Maximum reprojection error in meters, only used if the input polylines require reprojection. If '0' is provided, then this operation will fail if projection is required.

ee.ImageCollection.distinct

Removes duplicates from a collection. Note that duplicates are determined using a strong hash over the serialized form of the selected properties.

UsageReturns
ImageCollection.distinct(properties)FeatureCollection
ArgumentTypeDetails
this: collectionFeatureCollectionThe input collection from which objects will be selected.
propertiesObjectA property name or a list of property names to use for comparison. The '.geo' property can be included to compare object geometries.

ee.ImageCollection.draw

Paints a vector collection for visualization. Not intended for use as input to other algorithms.

UsageReturns
ImageCollection.draw(color, pointRadius, strokeWidth)Image
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to draw.
colorStringA hex string in the format RRGGBB specifying the color to use for drawing the features.
pointRadiusInteger, default: 3The radius in pixels of the point markers.
strokeWidthInteger, default: 2The width in pixels of lines and polygon borders.

ee.ImageCollection.errorMatrix

Computes a 2D error matrix for a collection by comparing two columns of a collection: one containing the actual values, and one containing predicted values.The values are expected to be small contiguous integers, starting from 0. Axis 0 (the rows) of the matrix correspond to the actual values, and Axis 1 (the columns) to the predicted values.

UsageReturns
ImageCollection.errorMatrix(actual, predicted, order)ConfusionMatrix
ArgumentTypeDetails
this: collectionFeatureCollectionThe input collection.
actualStringThe name of the property containing the actual value.
predictedStringThe name of the property containing the predicted value.
orderList, default: nullA list of the expected values. If this argument is not specified, the values are assumed to be contiguous and span the range 0 to maxValue. If specified, only values matching this list are used, and the matrix will have dimensions and order matching the this list.

ee.ImageCollection.evaluate

Asynchronously retrieves the value of this object from the server and passes it to the provided callback function.

UsageReturns
ImageCollection.evaluate(callback)
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunctionA function of the form function(success, failure), called when the server returns an answer. If the request succeeded, the success argument contains the evaluated result. If the request failed, the failure argument will contains an error message.

ee.ImageCollection.filter

Apply a filter to this collection.

Returns the filtered collection.

UsageReturns
ImageCollection.filter(filter)Collection
ArgumentTypeDetails
this: collectionCollectionThe Collection instance.
filterFilterA filter to apply to this collection.

ee.ImageCollection.filterBounds

Shortcut to filter a collection by intersection with geometry. Items in the collection with a footprint that fails to intersect the given geometry will be excluded.

This is equivalent to this.filter(ee.Filter.bounds(...)).

Returns the filtered collection.

UsageReturns
ImageCollection.filterBounds(geometry)Collection
ArgumentTypeDetails
this: collectionCollectionThe Collection instance.
geometryComputedObject|FeatureCollection|GeometryThe geometry, feature or collection to intersect with.

ee.ImageCollection.filterDate

Shortcut to filter a collection by a date range. The start and end may be Dates, numbers (interpreted as milliseconds since 1970-01-01T00:00:00Z), or strings (such as '1996-01-01T08:00'). Based on 'system:time_start'.

This is equivalent to this.filter(ee.Filter.date(...)); see the ee.Filter type for other date filtering options.

Returns the filtered collection.

UsageReturns
ImageCollection.filterDate(start, end)Collection
ArgumentTypeDetails
this: collectionCollectionThe Collection instance.
startDate|Number|StringThe start date (inclusive).
endDate|Number|String, optionalThe end date (exclusive). Optional. If not specified, a 1-millisecond range starting at 'start' is created.

ee.ImageCollection.first

Returns the first entry from a given collection.

UsageReturns
ImageCollection.first()Image
ArgumentTypeDetails
this: imagecollectionImageCollectionThe ImageCollection instance.

ee.ImageCollection.flatten

Flattens collections of collections.

UsageReturns
ImageCollection.flatten()FeatureCollection
ArgumentTypeDetails
this: collectionFeatureCollectionThe input collection of collections.

ee.ImageCollection.formaTrend

Computes the long and short term trends of a time series or optionally, the trends of the ratio of the time series and a covariate. The long term trend is estimated from the linear term of a regression on the full time series. The short term trend is computed as the windowed minimum over the time series.

The time series and covariate series are expected to contain a single band each, and the time series is expected to be evenly spaced in time. The output is 4 float bands: the long and short term trends, the t-test of the long term trend against the time series, and the Bruce Hansen test of parameter stability.

UsageReturns
ImageCollection.formaTrend(covariates, windowSize)Image
ArgumentTypeDetails
this: timeSeriesImageCollectionCollection from which to extract trends.
covariatesImageCollection, default: nullCofactors to use in the trend analysis.
windowSizeInteger, default: 6Short term trend analysis window size, in images.

ee.ImageCollection.fromImages

Returns the image collection containing the given images.

UsageReturns
ee.ImageCollection.fromImages(images)ImageCollection
ArgumentTypeDetails
imagesListThe images to include in the collection.

ee.ImageCollection.geometry

Extracts and merges the geometries of a collection. Requires that all the geometries in the collection share the projection and edge interpretation.

UsageReturns
ImageCollection.geometry(maxError)Geometry
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection whose geometries will be extracted.
maxErrorErrorMargin, optionalAn error margin to use when merging geometries.

ee.ImageCollection.get

Extract a property from a feature.

UsageReturns
ImageCollection.get(property)
ArgumentTypeDetails
this: objectElementThe feature to extract the property from.
propertyStringThe property to extract.

ee.ImageCollection.getArray

Extract a property from a feature.

UsageReturns
ImageCollection.getArray(property)Array
ArgumentTypeDetails
this: objectElementThe feature to extract the property from.
propertyStringThe property to extract.

ee.ImageCollection.getFilmstripThumbURL

Get the URL of a tiled thumbnail for this ImageCollection.

Returns a thumbnail URL, or undefined if a callback was specified.

UsageReturns
ImageCollection.getFilmstripThumbURL(params, callback)Object|String
ArgumentTypeDetails
this: imagecollectionImageCollectionThe ImageCollection instance.
paramsObjectParameters identical to ee.data.getMapId, plus, optionally:
dimensions (a number or pair of numbers in format WIDTHxHEIGHT) Maximum dimensions of each thumbnail frame to render, in pixels. If only one number is passed, it is used as the maximum, and the other dimension is computed by proportional scaling.
region (E,S,W,N or GeoJSON) Geospatial region of the image to render. By default, the whole image.
format (string) Encoding format. Only 'png' or 'jpg' are accepted.
callbackFunction, optionalAn optional callback which handles the resulting URL string. If not supplied, the call is made synchronously.

ee.ImageCollection.getInfo

An imperative function that returns all the known information about this collection via an AJAX call.

Returns a collection description whose fields include:

  - features: a list containing metadata about the images in the collection.

  - bands: a dictionary describing the bands of the images in this collection.

  - properties: an optional dictionary containing the collection's metadata properties.

UsageReturns
ImageCollection.getInfo(callback)ImageCollectionDescription
ArgumentTypeDetails
this: imagecollectionImageCollectionThe ImageCollection instance.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously. If supplied, will be called with the first parameter if successful and the second if unsuccessful.

ee.ImageCollection.getMapId

An imperative function that returns a map ID via a synchronous AJAX call.

This mosaics the collection to a single image and return a map ID suitable for building a Google Maps overlay.

Returns returns a map ID and optional token, which may be passed to ee.data.getTileUrl or ui.Map.addLayer. Undefined if a callback was specified.

UsageReturns
ImageCollection.getMapId(visParams, callback)MapId|Object
ArgumentTypeDetails
this: imagecollectionImageCollectionThe ImageCollection instance.
visParamsObject, optionalThe visualization parameters.
callbackFunction, optionalAn async callback. If not supplied, the call is made synchronously.

ee.ImageCollection.getNumber

Extract a property from a feature.

UsageReturns
ImageCollection.getNumber(property)Number
ArgumentTypeDetails
this: objectElementThe feature to extract the property from.
propertyStringThe property to extract.

ee.ImageCollection.getRegion

Output an array of values for each [pixel, band, image] tuple in an ImageCollection. The output contains rows of id, lon, lat, time, and all bands for each image that intersects each pixel in the given region. Attempting to extract more than 1048576 values will result in an error.

UsageReturns
ImageCollection.getRegion(geometry, scale, crs, crsTransform)List
ArgumentTypeDetails
this: collectionImageCollectionThe image collection to extract data from.
geometryGeometryThe region over which to extract data.
scaleFloat, default: nullA nominal scale in meters of the projection to work in.
crsProjection, optionalThe projection to work in. If unspecified, defaults to EPSG:4326. If specified in addition to scale, the projection is rescaled to the specified scale.
crsTransformList, default: nullThe array of CRS transform values. This is a row-major ordering of a 3x2 affine transform. This option is mutually exclusive with the scale option, and will replace any transform already set on the given projection.

ee.ImageCollection.getString

Extract a property from a feature.

UsageReturns
ImageCollection.getString(property)String
ArgumentTypeDetails
this: objectElementThe feature to extract the property from.
propertyStringThe property to extract.

ee.ImageCollection.getVideoThumbURL

Get the URL of an animated thumbnail for this ImageCollection.

Returns a thumbnail URL, or undefined if a callback was specified.

UsageReturns
ImageCollection.getVideoThumbURL(params, callback)Object|String
ArgumentTypeDetails
this: imagecollectionImageCollectionThe ImageCollection instance.
paramsObjectParameters identical to ee.data.getMapId, plus, optionally:
dimensions (a number or pair of numbers in format WIDTHxHEIGHT) Maximum dimensions of the thumbnail to render, in pixels. If only one number is passed, it is used as the maximum, and the other dimension is computed by proportional scaling.
region (E,S,W,N or GeoJSON) Geospatial region of the image to render. By default, the whole image.
format (string) Encoding format. Only 'gif' is accepted.
framesPerSecond (number) Animation speed.
callbackFunction, optionalAn optional callback which handles the resulting URL string. If not supplied, the call is made synchronously.

ee.ImageCollection.iterate

Applies a user-supplied function to each element of a collection. The user-supplied function is given two arguments: the current element, and the value returned by the previous call to iterate() or the first argument, for the first iteration. The result is the value returned by the final call to the user-supplied function.

Returns the result of the Collection.iterate() call.

UsageReturns
ImageCollection.iterate(algorithm, first)ComputedObject
ArgumentTypeDetails
this: collectionCollectionThe Collection instance.
algorithmFunctionThe function to apply to each element. Must take two arguments: an element of the collection and the value from the previous iteration.
firstObject, optionalThe initial state.

ee.ImageCollection.limit

Limit a collection to the specified number of elements, optionally sorting them by a specified property first.

Returns the limited collection.

UsageReturns
ImageCollection.limit(max, property, ascending)Collection
ArgumentTypeDetails
this: collectionCollectionThe Collection instance.
maxNumberThe number to limit the collection to.
propertyString, optionalThe property to sort by, if sorting.
ascendingBoolean, optionalWhether to sort in ascending or descending order. The default is true (ascending).

ee.ImageCollection.linkCollection

Links images in this collection to matching images from imageCollection.

For each source image in this collection, any specified bands or metadata will be added to the source image from the matching image found in

imageCollection. If bands or metadata are already present, they will be overwritten. If matching images are not found, any new or updated bands will be fully masked and any new or updated metadata will be null. The output footprint will be the same as the source image footprint.

Matches are determined if a source image and an image in imageCollection have a specific equivalent metadata property. If more than one collection image would match, the collection image selected is arbitrary. By default, images are matched on their 'system:index' metadata property.

This linking function is a convenience method for adding bands to target images based on a specified shared metadata property and is intended to support linking collections that apply different processing/product generation to the same source imagery. For more expressive linking known as

'joining', see https://developers.google.com/earth-engine/guides/joins_intro.

Returns the linked image collection.

UsageReturns
ImageCollection.linkCollection(imageCollection, linkedBands, linkedProperties, matchPropertyName)ImageCollection
ArgumentTypeDetails
this: imagecollectionImageCollectionThe ImageCollection instance.
imageCollectionImageCollectionThe image collection searched to find matches from this collection.
linkedBandsList, optionalOptional list of band names to add or update from matching images.
linkedPropertiesList, optionalOptional list of metadata properties to add or update from matching images.
matchPropertyNameString, optionalThe metadata property name to use as a match criteria. Defaults to "system:index".

ee.ImageCollection.load

Returns the image collection given its ID.

UsageReturns
ee.ImageCollection.load(id, version)ImageCollection
ArgumentTypeDetails
idStringThe asset ID of the image collection.
versionLong, default: nullThe version of the asset. -1 signifies the latest version.

ee.ImageCollection.map

Maps an algorithm over a collection.

Returns the mapped collection.

UsageReturns
ImageCollection.map(algorithm, dropNulls)Collection
ArgumentTypeDetails
this: collectionCollectionThe Collection instance.
algorithmFunctionThe operation to map over the images or features of the collection. A JavaScript function that receives an image or features and returns one. The function is called only once and the result is captured as a description, so it cannot perform imperative operations or rely on external state.
dropNullsBoolean, optionalIf true, the mapped algorithm is allowed to return nulls, and the elements for which it returns nulls will be dropped.

ee.ImageCollection.max

Reduces an image collection by calculating the maximum value of each pixel across the stack of all matching bands. Bands are matched by name.

UsageReturns
ImageCollection.max()Image
ArgumentTypeDetails
this: collectionImageCollectionThe image collection to reduce.

ee.ImageCollection.mean

Reduces an image collection by calculating the mean of all values at each pixel across the stack of all matching bands. Bands are matched by name.

UsageReturns
ImageCollection.mean()Image
ArgumentTypeDetails
this: collectionImageCollectionThe image collection to reduce.

ee.ImageCollection.median

Reduces an image collection by calculating the median of all values at each pixel across the stack of all matching bands. Bands are matched by name.

UsageReturns
ImageCollection.median()Image
ArgumentTypeDetails
this: collectionImageCollectionThe image collection to reduce.

ee.ImageCollection.merge

Merges two image collections into one. The result has all the images that were in either collection.

UsageReturns
ImageCollection.merge(collection2)ImageCollection
ArgumentTypeDetails
this: collection1ImageCollectionThe first collection to merge.
collection2ImageCollectionThe second collection to merge.

ee.ImageCollection.min

Reduces an image collection by calculating the minimum value of each pixel across the stack of all matching bands. Bands are matched by name.

UsageReturns
ImageCollection.min()Image
ArgumentTypeDetails
this: collectionImageCollectionThe image collection to reduce.

ee.ImageCollection.mode

Reduces an image collection by calculating the most common value at each pixel across the stack of all matching bands. Bands are matched by name.

UsageReturns
ImageCollection.mode()Image
ArgumentTypeDetails
this: collectionImageCollectionThe image collection to reduce.

ee.ImageCollection.mosaic

Composites all the images in a collection, using the mask.

UsageReturns
ImageCollection.mosaic()Image
ArgumentTypeDetails
this: collectionImageCollectionThe collection to mosaic.

ee.ImageCollection.or

Reduces an image collection by setting each pixel to 1 iff any of the non-masked values at that pixel are non-zero across the stack of all matching bands. Bands are matched by name.

UsageReturns
ImageCollection.or()Image
ArgumentTypeDetails
this: collectionImageCollectionThe image collection to reduce.

ee.ImageCollection.product

Reduces an image collection by calculating the product of all values at each pixel across the stack of all matching bands. Bands are matched by name.

UsageReturns
ImageCollection.product()Image
ArgumentTypeDetails
this: collectionImageCollectionThe image collection to reduce.

ee.ImageCollection.propertyNames

Returns the names of properties on this element.

UsageReturns
ImageCollection.propertyNames()List
ArgumentTypeDetails
this: elementElement

ee.ImageCollection.qualityMosaic

Composites all the images in a collection, using a quality band as a per-pixel ordering function.

UsageReturns
ImageCollection.qualityMosaic(qualityBand)Image
ArgumentTypeDetails
this: collectionImageCollectionThe collection to mosaic.
qualityBandStringThe name of the quality band in the collection.

ee.ImageCollection.randomColumn

Adds a column of deterministic pseudorandom numbers to a collection. The outputs are double-precision floating point numbers. When using the 'uniform' distribution (default), outputs are in the range of [0, 1). Using the 'normal' distribution, outputs have μ=0, 𝛔=1, but have no explicit limits.

UsageReturns
ImageCollection.randomColumn(columnName, seed, distribution)FeatureCollection
ArgumentTypeDetails
this: collectionFeatureCollectionThe input collection to which to add a random column.
columnNameString, default: "random"The name of the column to add.
seedLong, default: 0A seed used when generating the random numbers.
distributionString, default: "uniform"The distribution type of random numbers to produce; one of 'uniform' or 'normal'.

ee.ImageCollection.reduce

Applies a reducer across all of the images in a collection.

If the reducer has a single input, it will be applied separately to each band of the collection; otherwise it must have the same number of inputs as the collection has bands.

The reducer output names determine the names of the output bands: reducers with multiple inputs will use the output names directly, while reducers with a single input will prefix the output name with the input band name (e.g. '10_mean', '20_mean', etc.).

UsageReturns
ImageCollection.reduce(reducer, parallelScale)Image
ArgumentTypeDetails
this: collectionImageCollectionThe image collection to reduce.
reducerReducerThe reducer to apply to the given collection.
parallelScaleFloat, default: 1A scaling factor used to limit memory use; using a larger parallelScale (e.g. 2 or 4) may enable computations that run out of memory with the default.

ee.ImageCollection.reduceColumns

Apply a reducer to each element of a collection, using the given selectors to determine the inputs.

Returns a dictionary of results, keyed with the output names.

UsageReturns
ImageCollection.reduceColumns(reducer, selectors, weightSelectors)Dictionary
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
reducerReducerThe reducer to apply.
selectorsListA selector for each input of the reducer.
weightSelectorsList, default: nullA selector for each weighted input of the reducer.

ee.ImageCollection.reduceToImage

Creates an image from a feature collection by applying a reducer over the selected properties of all the features that intersect each pixel.

UsageReturns
ImageCollection.reduceToImage(properties, reducer)Image
ArgumentTypeDetails
this: collectionFeatureCollectionFeature collection to intersect with each output pixel.
propertiesListProperties to select from each feature and pass into the reducer.
reducerReducerA Reducer to combine the properties of each intersecting feature into a final result to store in the pixel.

ee.ImageCollection.remap

Remaps the value of a specific property in a collection. Takes two parallel lists and maps values found in one to values in the other. Any element with a value that is not specified in the first list is dropped from the output collection.

UsageReturns
ImageCollection.remap(lookupIn, lookupOut, columnName)FeatureCollection
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to be modified.
lookupInListThe input mapping values. Restricted to strings and integers.
lookupOutListThe output mapping values. Must be the same size as lookupIn.
columnNameStringThe name of the property to remap.

ee.ImageCollection.select

Select bands from each image in a collection.

Returns the image collection with selected bands.

UsageReturns
ImageCollection.select(selectors, names)ImageCollection
ArgumentTypeDetails
this: imagecollectionImageCollectionThe ImageCollection instance.
selectorsListA list of names, regexes or numeric indices specifying the bands to select.
namesList, optionalA list of new names for the output bands. Must match the number of bands selected.

ee.ImageCollection.serialize

Returns the serialized representation of this object.

UsageReturns
ImageCollection.serialize(legacy)String
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
legacyBoolean, optionalEnables legacy format.

ee.ImageCollection.set

Overrides one or more metadata properties of an Element.

Returns the element with the specified properties overridden.

UsageReturns
ImageCollection.set(var_args)Element
ArgumentTypeDetails
this: elementElementThe Element instance.
var_argsVarArgsEither a dictionary of properties, or a vararg sequence of properties, e.g. key1, value1, key2, value2, ...

ee.ImageCollection.size

Returns the number of elements in the collection.

UsageReturns
ImageCollection.size()Integer
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to count.

ee.ImageCollection.sort

Sort a collection by the specified property.

Returns the sorted collection.

UsageReturns
ImageCollection.sort(property, ascending)Collection
ArgumentTypeDetails
this: collectionCollectionThe Collection instance.
propertyStringThe property to sort by.
ascendingBoolean, optionalWhether to sort in ascending or descending order. The default is true (ascending).

ee.ImageCollection.style

Draw a vector collection for visualization using a simple style language.

UsageReturns
ImageCollection.style(color, pointSize, pointShape, width, fillColor, styleProperty, neighborhood, lineType)Image
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to draw.
colorString, default: "black"A default color (CSS 3.0 color value e.g. 'FF0000' or 'red') to use for drawing the features. Supports opacity (e.g.: 'FF000088' for 50% transparent red).
pointSizeInteger, default: 3The default size in pixels of the point markers.
pointShapeString, default: "circle"The default shape of the marker to draw at each point location. One of: `circle`, `square`, `diamond`, `cross`, `plus`, `pentagram`, `hexagram`, `triangle`, `triangle_up`, `triangle_down`, `triangle_left`, `triangle_right`, `pentagon`, `hexagon`, `star5`, `star6`. This argument also supports the following Matlab marker abbreviations: `o`, `s`, `d`, `x`, `+`, `p`, `h`, `^`, `v`, `<`, `>`.
widthFloat, default: 2The default line width for lines and outlines for polygons and point shapes.
fillColorString, default: nullThe color for filling polygons and point shapes. Defaults to 'color' at 0.66 opacity.
stylePropertyString, default: nullA per-feature property expected to contain a dictionary. Values in the dictionary override any default values for that feature.
neighborhoodInteger, default: 5If styleProperty is used and any feature has a pointSize or width larger than the defaults, tiling artifacts can occur. Specifies the maximum neighborhood (pointSize + width) needed for any feature.
lineTypeString, default: "solid"The default line style for lines and outlines of polygons and point shapes. Defaults to 'solid'. One of: solid, dotted, dashed.

ee.ImageCollection.sum

Reduces an image collection by calculating the sum of all values at each pixel across the stack of all matching bands. Bands are matched by name.

UsageReturns
ImageCollection.sum()Image
ArgumentTypeDetails
this: collectionImageCollectionThe image collection to reduce.

ee.ImageCollection.toArray

Converts an image collection into an image of 2D arrays. At each pixel, the images that have valid (unmasked) values in all bands are laid out along the first axis of the array in the order they appear in the image collection. The bands of each image are laid out along the second axis of the array, in the order the bands appear in that image. The array element type will be the union of the types of each band.

UsageReturns
ImageCollection.toArray()Image
ArgumentTypeDetails
this: collectionImageCollectionImage collection to convert to an array image. Bands must have scalar values, not array values.

ee.ImageCollection.toArrayPerBand

Concatenates multiple images into a single array image. The result will be masked if any input is masked.

UsageReturns
ImageCollection.toArrayPerBand(axis)Image
ArgumentTypeDetails
this: collectionImageCollectionImages to concatenate. A separate concatenation is done per band, so all the images must have the same dimensionality and shape per band, except length along the concatenation axis.
axisInteger, default: 0Axis to concatenate along; must be at least 0 and at most the minimum dimension of any band in the collection.

ee.ImageCollection.toBands

Converts a collection to a single multi-band image containing all of the bands of every image in the collection. Output bands are named by prefixing the existing band names with the image id from which it came (e.g.: 'image1_band1'). Note: The maximum number of bands is 5000

UsageReturns
ImageCollection.toBands()Image
ArgumentTypeDetails
this: collectionImageCollectionThe input collection.

ee.ImageCollection.toDictionary

Extract properties from a feature as a dictionary.

UsageReturns
ImageCollection.toDictionary(properties)Dictionary
ArgumentTypeDetails
this: elementElementThe feature to extract the property from.
propertiesList, default: nullThe list of properties to extract. Defaults to all non-system properties.

ee.ImageCollection.toList

Returns the elements of a collection as a list.

UsageReturns
ImageCollection.toList(count, offset)List
ArgumentTypeDetails
this: collectionFeatureCollectionThe input collection to fetch.
countIntegerThe maximum number of elements to fetch.
offsetInteger, default: 0The number of elements to discard from the start. If set, (offset + count) elements will be fetched and the first offset elements will be discarded.

ee.ImageCollection.union

Merges all geometries in a given collection into one and returns a collection containing a single feature with only an ID of 'union_result' and a geometry.

UsageReturns
ImageCollection.union(maxError)FeatureCollection
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection being merged.
maxErrorErrorMargin, default: nullThe maximum error allowed when performing any necessary reprojections. If not specified, defaults to the error margin requested from the output.

ee.Join.apply

Joins two collections.

UsageReturns
Join.apply(primary, secondary, condition)FeatureCollection
ArgumentTypeDetails
this: joinJoinThe join to apply; determines how the the results are constructed.
primaryFeatureCollectionThe primary collection.
secondaryFeatureCollectionThe secondary collection.
conditionFilterThe join condition used to select the matches from the two collections.

ee.Join.inner

Returns a join that pairs elements from the primary collection with matching elements from the secondary collection. Each result has a 'primary' property that contains the element from the primary collection, and a 'secondary' property containing the matching element from the secondary collection. If measureKey is specified, the join measure is also attached to the object as a property.

UsageReturns
ee.Join.inner(primaryKey, secondaryKey, measureKey)Join
ArgumentTypeDetails
primaryKeyString, default: "primary"The property name used to save the primary match.
secondaryKeyString, default: "secondary"The property name used to save the secondary match.
measureKeyString, default: nullAn optional property name used to save the measure of the join condition.

ee.Join.inverted

Returns a join that produces the elements of the primary collection that match no elements of the secondary collection. No properties are added to the results.

UsageReturns
ee.Join.inverted()Join

No arguments.

ee.Join.saveAll

Returns a join that pairs each element from the first collection with a group of matching elements from the second collection. The list of matches is added to each result as an additional property. If measureKey is specified, each match has the value of its join measure attached. Join measures are produced when withinDistance or maxDifference filters are used as the join condition.
UsageReturns
ee.Join.saveAll(matchesKey, ordering, ascending, measureKey, outer)Join
ArgumentTypeDetails
matchesKeyStringThe property name used to save the matches list.
orderingString, default: nullThe property on which to sort the matches list.
ascendingBoolean, default: trueWhether the ordering is ascending.
measureKeyString, default: nullAn optional property name used to save the measure of the join condition on each match.
outerBoolean, default: falseIf true, primary rows without matches will be included in the result.

ee.Join.saveBest

Returns a join that pairs each element from the first collection with a matching element from the second collection. The match with the best join measure is added to each result as an additional property. Join measures are produced when withinDistance or maxDifference filters are used as the join condition.

UsageReturns
ee.Join.saveBest(matchKey, measureKey, outer)Join
ArgumentTypeDetails
matchKeyStringThe key used to save the match.
measureKeyStringThe key used to save the measure of the join condition on the match.
outerBoolean, default: falseIf true, primary rows without matches will be included in the result.

ee.Join.saveFirst

Returns a join that pairs each element from the first collection with a matching element from the second collection. The first match is added to the result as an additional property.

UsageReturns
ee.Join.saveFirst(matchKey, ordering, ascending, measureKey, outer)Join
ArgumentTypeDetails
matchKeyStringThe property name used to save the match.
orderingString, default: nullThe property on which to sort the matches before selecting the first.
ascendingBoolean, default: trueWhether the ordering is ascending.
measureKeyString, default: nullAn optional property name used to save the measure of the join condition on the match.
outerBoolean, default: falseIf true, primary rows without matches will be included in the result.

ee.Join.simple

Returns a join that produces the elements of the primary collection that match any element of the secondary collection. No properties are added to the results.

UsageReturns
ee.Join.simple()Join

No arguments.

ee.Kernel.add

Adds two kernels (pointwise), after aligning their centers.
UsageReturns
Kernel.add(kernel2, normalize)Kernel
ArgumentTypeDetails
this: kernel1KernelThe first kernel.
kernel2KernelThe second kernel.
normalizeBoolean, default: falseNormalize the kernel.

ee.Kernel.chebyshev

Generates a distance kernel based on Chebyshev distance (greatest distance along any dimension).

UsageReturns
ee.Kernel.chebyshev(radius, units, normalize, magnitude)Kernel
ArgumentTypeDetails
radiusFloatThe radius of the kernel to generate.
unitsString, default: "pixels"The system of measurement for the kernel ('pixels' or 'meters'). If the kernel is specified in meters, it will resize when the zoom-level is changed.
normalizeBoolean, default: falseNormalize the kernel values to sum to 1.
magnitudeFloat, default: 1Scale each value by this amount.

ee.Kernel.circle

Generates a circle-shaped boolean kernel.

UsageReturns
ee.Kernel.circle(radius, units, normalize, magnitude)Kernel
ArgumentTypeDetails
radiusFloatThe radius of the kernel to generate.
unitsString, default: "pixels"The system of measurement for the kernel ('pixels' or 'meters'). If the kernel is specified in meters, it will resize when the zoom-level is changed.
normalizeBoolean, default: trueNormalize the kernel values to sum to 1.
magnitudeFloat, default: 1Scale each value by this amount.

ee.Kernel.compass

Generates a 3x3 Prewitt's Compass edge-detection kernel.

UsageReturns
ee.Kernel.compass(magnitude, normalize)Kernel
ArgumentTypeDetails
magnitudeFloat, default: 1Scale each value by this amount.
normalizeBoolean, default: falseNormalize the kernel values to sum to 1.

ee.Kernel.cross

Generates a cross-shaped boolean kernel.

UsageReturns
ee.Kernel.cross(radius, units, normalize, magnitude)Kernel
ArgumentTypeDetails
radiusFloatThe radius of the kernel to generate.
unitsString, default: "pixels"The system of measurement for the kernel ('pixels' or 'meters'). If the kernel is specified in meters, it will resize when the zoom-level is changed.
normalizeBoolean, default: trueNormalize the kernel values to sum to 1.
magnitudeFloat, default: 1Scale each value by this amount.

ee.Kernel.diamond

Generates a diamond-shaped boolean kernel.

UsageReturns
ee.Kernel.diamond(radius, units, normalize, magnitude)Kernel
ArgumentTypeDetails
radiusFloatThe radius of the kernel to generate.
unitsString, default: "pixels"The system of measurement for the kernel ('pixels' or 'meters'). If the kernel is specified in meters, it will resize when the zoom-level is changed.
normalizeBoolean, default: trueNormalize the kernel values to sum to 1.
magnitudeFloat, default: 1Scale each value by this amount.

ee.Kernel.euclidean

Generates a distance kernel based on Euclidean (straight-line) distance.

UsageReturns
ee.Kernel.euclidean(radius, units, normalize, magnitude)Kernel
ArgumentTypeDetails
radiusFloatThe radius of the kernel to generate.
unitsString, default: "pixels"The system of measurement for the kernel ('pixels' or 'meters'). If the kernel is specified in meters, it will resize when the zoom-level is changed.
normalizeBoolean, default: falseNormalize the kernel values to sum to 1.
magnitudeFloat, default: 1Scale each value by this amount.

ee.Kernel.fixed

Creates a Kernel.

UsageReturns
ee.Kernel.fixed(width, height, weights, x, y, normalize)Kernel
ArgumentTypeDetails
widthInteger, default: -1The width of the kernel in pixels.
heightInteger, default: -1The height of the kernel in pixels.
weightsListA 2-D list of [height] x [width] values to use as the weights of the kernel.
xInteger, default: -1The location of the focus, as an offset from the left.
yInteger, default: -1The location of the focus, as an offset from the top.
normalizeBoolean, default: falseNormalize the kernel values to sum to 1.

ee.Kernel.gaussian

Generates a Gaussian kernel from a sampled continuous Gaussian.

UsageReturns
ee.Kernel.gaussian(radius, sigma, units, normalize, magnitude)Kernel
ArgumentTypeDetails
radiusFloatThe radius of the kernel to generate.
sigmaFloat, default: 1Standard deviation of the Gaussian function (same units as radius).
unitsString, default: "pixels"The system of measurement for the kernel ('pixels' or 'meters'). If the kernel is specified in meters, it will resize when the zoom-level is changed.
normalizeBoolean, default: trueNormalize the kernel values to sum to 1.
magnitudeFloat, default: 1Scale each value by this amount.

ee.Kernel.inverse

Returns a kernel which has each of its weights multiplicatively inverted. Weights with a value of zero are not inverted and remain zero.

UsageReturns
Kernel.inverse()Kernel
ArgumentTypeDetails
this: kernelKernelThe kernel to have its entries inverted.

ee.Kernel.kirsch

Generates a 3x3 Kirsch's Compass edge-detection kernel.

UsageReturns
ee.Kernel.kirsch(magnitude, normalize)Kernel
ArgumentTypeDetails
magnitudeFloat, default: 1Scale each value by this amount.
normalizeBoolean, default: falseNormalize the kernel values to sum to 1.

ee.Kernel.laplacian4

Generates a 3x3 Laplacian-4 edge-detection kernel.

UsageReturns
ee.Kernel.laplacian4(magnitude, normalize)Kernel
ArgumentTypeDetails
magnitudeFloat, default: 1Scale each value by this amount.
normalizeBoolean, default: falseNormalize the kernel values to sum to 1.

ee.Kernel.laplacian8

Generates a 3x3 Laplacian-8 edge-detection kernel.

UsageReturns
ee.Kernel.laplacian8(magnitude, normalize)Kernel
ArgumentTypeDetails
magnitudeFloat, default: 1Scale each value by this amount.
normalizeBoolean, default: falseNormalize the kernel values to sum to 1.

ee.Kernel.manhattan

Generates a distance kernel based on rectilinear (city-block) distance.

UsageReturns
ee.Kernel.manhattan(radius, units, normalize, magnitude)Kernel
ArgumentTypeDetails
radiusFloatThe radius of the kernel to generate.
unitsString, default: "pixels"The system of measurement for the kernel ('pixels' or 'meters'). If the kernel is specified in meters, it will resize when the zoom-level is changed.
normalizeBoolean, default: falseNormalize the kernel values to sum to 1.
magnitudeFloat, default: 1Scale each value by this amount.

ee.Kernel.octagon

Generates an octagon-shaped boolean kernel.

UsageReturns
ee.Kernel.octagon(radius, units, normalize, magnitude)Kernel
ArgumentTypeDetails
radiusFloatThe radius of the kernel to generate.
unitsString, default: "pixels"The system of measurement for the kernel ('pixels' or 'meters'). If the kernel is specified in meters, it will resize when the zoom-level is changed.
normalizeBoolean, default: trueNormalize the kernel values to sum to 1.
magnitudeFloat, default: 1Scale each value by this amount.

ee.Kernel.plus

Generates a plus-shaped boolean kernel.

UsageReturns
ee.Kernel.plus(radius, units, normalize, magnitude)Kernel
ArgumentTypeDetails
radiusFloatThe radius of the kernel to generate.
unitsString, default: "pixels"The system of measurement for the kernel ('pixels' or 'meters'). If the kernel is specified in meters, it will resize when the zoom-level is changed.
normalizeBoolean, default: trueNormalize the kernel values to sum to 1.
magnitudeFloat, default: 1Scale each value by this amount.

ee.Kernel.prewitt

Generates a 3x3 Prewitt edge-detection kernel.

UsageReturns
ee.Kernel.prewitt(magnitude, normalize)Kernel
ArgumentTypeDetails
magnitudeFloat, default: 1Scale each value by this amount.
normalizeBoolean, default: falseNormalize the kernel values to sum to 1.

ee.Kernel.rectangle

Generates a rectangular-shaped kernel.

UsageReturns
ee.Kernel.rectangle(xRadius, yRadius, units, normalize, magnitude)Kernel
ArgumentTypeDetails
xRadiusFloatThe horizontal radius of the kernel to generate.
yRadiusFloatThe vertical radius of the kernel to generate.
unitsString, default: "pixels"The system of measurement for the kernel ("pixels" or "meters"). If the kernel is specified in meters, it will resize when the zoom-level is changed.
normalizeBoolean, default: trueNormalize the kernel values to sum to 1.
magnitudeFloat, default: 1Scale each value by this amount.

ee.Kernel.roberts

Generates a 2x2 Roberts edge-detection kernel.

UsageReturns
ee.Kernel.roberts(magnitude, normalize)Kernel
ArgumentTypeDetails
magnitudeFloat, default: 1Scale each value by this amount.
normalizeBoolean, default: falseNormalize the kernel values to sum to 1.

ee.Kernel.rotate

Creates a Kernel.

UsageReturns
Kernel.rotate(rotations)Kernel
ArgumentTypeDetails
this: kernelKernelThe kernel to be rotated.
rotationsIntegerNumber of 90 deg. rotations to make (negative numbers rotate counterclockwise).

ee.Kernel.sobel

Generates a 3x3 Sobel edge-detection kernel.

UsageReturns
ee.Kernel.sobel(magnitude, normalize)Kernel
ArgumentTypeDetails
magnitudeFloat, default: 1Scale each value by this amount.
normalizeBoolean, default: falseNormalize the kernel values to sum to 1.

ee.Kernel.square

Generates a square-shaped boolean kernel.

UsageReturns
ee.Kernel.square(radius, units, normalize, magnitude)Kernel
ArgumentTypeDetails
radiusFloatThe radius of the kernel to generate.
unitsString, default: "pixels"The system of measurement for the kernel ('pixels' or 'meters'). If the kernel is specified in meters, it will resize when the zoom-level is changed.
normalizeBoolean, default: trueNormalize the kernel values to sum to 1.
magnitudeFloat, default: 1Scale each value by this amount.

ee.List

Constructs a new list.

UsageReturns
ee.List(list)List
ArgumentTypeDetails
listListA list or a computed object.

ee.List.add

Appends the element to the end of list.

UsageReturns
List.add(element)List
ArgumentTypeDetails
this: listList
elementObject

ee.List.aside

Calls a function passing this object as the first argument, and returning itself. Convenient e.g. when debugging:

var c = ee.ImageCollection('foo').aside(print)

.filterDate('2001-01-01', '2002-01-01').aside(print, 'In 2001')

.filterBounds(geom).aside(print, 'In region')

.aside(Map.addLayer, {min: 0, max: 142}, 'Filtered')

.select('a', 'b');

Returns the same object, for chaining.

UsageReturns
List.aside(func, var_args)ComputedObject
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
funcFunctionThe function to call.
var_argsVarArgsAny extra arguments to pass to the function.

ee.List.cat

Concatenates the contents of other onto list.

UsageReturns
List.cat(other)List
ArgumentTypeDetails
this: listList
otherList

ee.List.contains

Returns true if list contains element.

UsageReturns
List.contains(element)Boolean
ArgumentTypeDetails
this: listList
elementObject

ee.List.containsAll

Returns true if list contains all of the elements of other, regardless of order.

UsageReturns
List.containsAll(other)Boolean
ArgumentTypeDetails
this: listList
otherList

ee.List.distinct

Returns a copy of list without duplicate elements.

UsageReturns
List.distinct()List
ArgumentTypeDetails
this: listList

ee.List.equals

Returns true if list contains the same elements as other, in the same order.

UsageReturns
List.equals(other)Boolean
ArgumentTypeDetails
this: listList
otherList

ee.List.evaluate

Asynchronously retrieves the value of this object from the server and passes it to the provided callback function.

UsageReturns
List.evaluate(callback)
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunctionA function of the form function(success, failure), called when the server returns an answer. If the request succeeded, the success argument contains the evaluated result. If the request failed, the failure argument will contains an error message.

ee.List.filter

Filters a list to only the elements that match the given filter. To filter list items that aren't images or features, test a property named 'item', e.g.: ee.Filter.gt('item', 3)

UsageReturns
List.filter(filter)List
ArgumentTypeDetails
this: listList
filterFilter

ee.List.flatten

Flattens any sublists into a single list.

UsageReturns
List.flatten()List
ArgumentTypeDetails
this: listList

ee.List.frequency

Returns the number of elements in list equal to element.

UsageReturns
List.frequency(element)Integer
ArgumentTypeDetails
this: listList
elementObject

ee.List.get

Returns the element at the specified position in list. A negative index counts backwards from the end of the list.

UsageReturns
List.get(index)Object
ArgumentTypeDetails
this: listList
indexInteger

ee.List.getArray

Returns the array at the specified position in list. A negative index counts backwards from the end of the list. If the value is not a array, an error will occur.

UsageReturns
List.getArray(index)Array
ArgumentTypeDetails
this: listList
indexInteger

ee.List.getGeometry

Returns the geometry at the specified position in list. A negative index counts backwards from the end of the list. If the value is not a geometry, an error will occur.

UsageReturns
List.getGeometry(index)Geometry
ArgumentTypeDetails
this: listList
indexInteger

ee.List.getInfo

Retrieves the value of this object from the server.

If no callback function is provided, the request is made synchronously. If a callback is provided, the request is made asynchronously.

The asynchronous mode is preferred because the synchronous mode stops all other code (for example, the EE Code Editor UI) while waiting for the server. To make an asynchronous request, evaluate() is preferred over getInfo().

Returns the computed value of this object.

UsageReturns
List.getInfo(callback)Object
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.List.getNumber

Returns the number at the specified position in list. A negative index counts backwards from the end of the list. If the value is not a number, an error will occur.

UsageReturns
List.getNumber(index)Number
ArgumentTypeDetails
this: listList
indexInteger

ee.List.getString

Returns the string at the specified position in list. A negative index counts backwards from the end of the list. If the value is not a string, an error will occur.

UsageReturns
List.getString(index)String
ArgumentTypeDetails
this: listList
indexInteger

ee.List.indexOf

Returns the position of the first occurrence of target in list, or -1 if list does not contain target.

UsageReturns
List.indexOf(element)Integer
ArgumentTypeDetails
this: listList
elementObject

ee.List.indexOfSublist

Returns the starting position of the first occurrence of target within list, or -1 if there is no such occurrence.

UsageReturns
List.indexOfSublist(target)Integer
ArgumentTypeDetails
this: listList
targetList

ee.List.insert

Inserts element at the specified position in list. A negative index counts backwards from the end of the list.

UsageReturns
List.insert(index, element)List
ArgumentTypeDetails
this: listList
indexInteger
elementObject

ee.List.iterate

Iterate an algorithm over a list. The algorithm is expected to take two objects, the current list item, and the result from the previous iteration or the value of first for the first iteration.

UsageReturns
List.iterate(function, first)Object
ArgumentTypeDetails
this: listList
functionAlgorithm
firstObject

ee.List.join

Returns a string containing the elements of the list joined together with the specified separator between elements.

UsageReturns
List.join(separator)String
ArgumentTypeDetails
this: listList
separatorString, default: ""

ee.List.lastIndexOfSubList

Returns the starting position of the last occurrence of target within list, or -1 if there is no such occurrence.

UsageReturns
List.lastIndexOfSubList(target)Integer
ArgumentTypeDetails
this: listList
targetList

ee.List.length

Returns the number of elements in list.

UsageReturns
List.length()Integer
ArgumentTypeDetails
this: listList

ee.List.map

Map an algorithm over a list. The algorithm is expected to take an Object and return an Object.

UsageReturns
List.map(baseAlgorithm, dropNulls)List
ArgumentTypeDetails
this: listList
baseAlgorithmAlgorithm
dropNullsBoolean, default: falseIf true, the mapped algorithm is allowed to return nulls, and the elements for which it returns nulls will be dropped.

ee.List.reduce

Apply a reducer to a list. If the reducer takes more than 1 input, then each element in the list is assumed to be a list of inputs. If the reducer returns a single output, it is returned directly, otherwise returns a dictionary containing the named reducer outputs.

UsageReturns
List.reduce(reducer)Object
ArgumentTypeDetails
this: listList
reducerReducer

ee.List.remove

Removes the first occurrence of the specified element from list, if it is present.

UsageReturns
List.remove(element)List
ArgumentTypeDetails
this: listList
elementObject

ee.List.removeAll

Removes from list all of the elements that are contained in other list.

UsageReturns
List.removeAll(other)List
ArgumentTypeDetails
this: listList
otherList

ee.List.repeat

Returns a new list containing value repeated count times.

UsageReturns
ee.List.repeat(value, count)List
ArgumentTypeDetails
valueObject
countInteger

ee.List.replace

Replaces the first occurrence of oldVal in list with newVal.

UsageReturns
List.replace(oldval, newval)List
ArgumentTypeDetails
this: listList
oldvalObject
newvalObject

ee.List.replaceAll

Replaces all occurrences of oldVal in list with newVal.

UsageReturns
List.replaceAll(oldval, newval)List
ArgumentTypeDetails
this: listList
oldvalObject
newvalObject

ee.List.reverse

Reverses the order of the elements in list.

UsageReturns
List.reverse()List
ArgumentTypeDetails
this: listList

ee.List.rotate

Rotates the elements of the list by the specified distance.

UsageReturns
List.rotate(distance)List
ArgumentTypeDetails
this: listList
distanceInteger

ee.List.sequence

Generate a sequence of numbers from start to end (inclusive) in increments of step, or in count equally-spaced increments. If end is not specified it is computed from start + step * count, so at least one of end or count must be specified.

UsageReturns
ee.List.sequence(start, end, step, count)List
ArgumentTypeDetails
startNumber
endNumber, default: null
stepNumber, default: 1
countInteger, default: null

ee.List.serialize

Returns the serialized representation of this object.

UsageReturns
List.serialize(legacy)String
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
legacyBoolean, optionalEnables legacy format.

ee.List.set

Replaces the value at the specified position in list with element. A negative index counts backwards from the end of the list.

UsageReturns
List.set(index, element)List
ArgumentTypeDetails
this: listList
indexInteger
elementObject

ee.List.shuffle

Randomly permute the specified list. Note that the permutation order will always be the same for any given seed, unless the value for seed is 'false'.

UsageReturns
List.shuffle(seed)List
ArgumentTypeDetails
this: listList
seedObject, default: nullA long integer to use as a seed for the randomization. If the boolean value of 'false' is passed, then a completely random and unreproducible order will be generated.

ee.List.size

Returns the number of elements in list.

UsageReturns
List.size()Integer
ArgumentTypeDetails
this: listList

ee.List.slice

Returns a portion of list between the start index, inclusive, and end index, exclusive. Negative values for start or end count backwards from the end of the list. Values greater than the size of the list are legal but are truncated to the size of list.

UsageReturns
List.slice(start, end, step)List
ArgumentTypeDetails
this: listList
startInteger
endInteger, default: null
stepInteger, default: null

ee.List.sort

Sorts the list into ascending order. If the 'keys' argument is provided, then it is sorted first, and the elements of 'list' are placed in the same order.

UsageReturns
List.sort(keys)List
ArgumentTypeDetails
this: listListThe list to sort.
keysList, default: nullOptional keys to sort by. If 'keys' is provided, it must have the same length as 'list'.

ee.List.splice

Starting at the start index, removes count elements from list and insert the contents of other at that location. If start is negative, it counts backwards from the end of the list.

UsageReturns
List.splice(start, count, other)List
ArgumentTypeDetails
this: listList
startInteger
countInteger
otherList, default: null

ee.List.swap

Swaps the elements at the specified positions. A negative position counts backwards from the end of the list.

UsageReturns
List.swap(pos1, pos2)List
ArgumentTypeDetails
this: listList
pos1Integer
pos2Integer

ee.List.unzip

Transposes a list of lists, extracting the first element of each inner list into one list the second elements into another, etc., up to the length of the shortest inner list. The remaining items are discarded. The result is a list of lists.

UsageReturns
List.unzip()List
ArgumentTypeDetails
this: listList

ee.List.zip

Pairs the elements of two lists to create a list of two-element lists. When the input lists are of different sizes, the final list has the same size as the shortest one.

UsageReturns
List.zip(other)List
ArgumentTypeDetails
this: listList
otherList

ee.Model.fromAiPlatformPredictor

Returns an ee.Model from a description of an AI Platform prediction model. (See https://cloud.google.com/ml-engine/).

UsageReturns
ee.Model.fromAiPlatformPredictor(projectName, projectId, modelName, version, region, inputProperties, inputTypeOverride, inputShapes, proj, fixInputProj, inputTileSize, inputOverlapSize, outputTileSize, outputBands, outputProperties, outputMultiplier)Model
ArgumentTypeDetails
projectNameObject, default: nullThe Google Cloud project that owns the model. Deprecated: use "projectId" instead.
projectIdString, default: nullThe ID of the Google Cloud project that owns the model.
modelNameString, default: nullThe name of the model.
versionString, default: nullThe model version. Defaults to the AI Platform default model version.
regionString, default: nullThe model deployment region. Defaults to "us-central1".
inputPropertiesList, default: nullProperties passed with each prediction instance. Image predictions are tiled, so these properties will be replicated into each image tile instance. Defaults to no properties.
inputTypeOverrideDictionary, default: nullTypes to which model inputs will be coerced if specified. Both Image bands and Image/Feature properties are valid.
inputShapesDictionary, default: nullThe fixed shape of input array bands. For each array band not specified, the fixed array shape will be automatically deduced from a non-masked pixel.
projProjection, default: nullThe input projection at which to sample all bands. Defaults to the default projection of an image's first band.
fixInputProjBoolean, default: nullIf true, pixels will be sampled in a fixed projection specified by 'proj'. The output projection is used otherwise. Defaults to false.
inputTileSizeList, default: nullRectangular dimensions of pixel tiles passed in to prediction instances. Required for image predictions.
inputOverlapSizeList, default: nullAmount of adjacent-tile overlap in X/Y along each edge of pixel tiles passed in to prediction instances. Defaults to [0, 0].
outputTileSizeList, default: nullRectangular dimensions of pixel tiles returned from AI Platform. Defaults to the value in 'inputTileSize'.
outputBandsDictionary, default: nullA map from output band names to a dictionary of output band info. Valid band info fields are 'type' and 'dimensions'. 'type' should be a ee.PixelType describing the output band, and 'dimensions' is an optional integer with the number of dimensions in that band e.g.: "outputBands: {'p': {'type': ee.PixelType.int8(), 'dimensions': 1}}". Required for image predictions.
outputPropertiesDictionary, default: nullA map from output property names to a dictionary of output property info. Valid property info fields are 'type' and 'dimensions'. 'type' should be a ee.PixelType describing the output property, and 'dimensions' is an optional integer with the number of dimensions for that property if it is an array e.g.: "outputBands: {'p': {'type': ee.PixelType.int8(), 'dimensions': 1}}". Required for predictions from FeatureCollections.
outputMultiplierFloat, default: nullAn approximation to the increase in data volume for the model outputs over the model inputs. If specified this must be >= 1. This is only needed if the model produces more data than it consumes, e.g. a model that takes 5 bands and produces 10 outputs per pixel.

ee.Model.fromVertexAi

Returns an ee.Model from a description of a Vertex AI model endpoint. (See https://cloud.google.com/vertex-ai).

UsageReturns
ee.Model.fromVertexAi(endpoint, inputProperties, inputTypeOverride, inputShapes, proj, fixInputProj, inputTileSize, inputOverlapSize, outputTileSize, outputBands, outputProperties, outputMultiplier, maxPayloadBytes, payloadFormat)Model
ArgumentTypeDetails
endpointString, default: nullThe endpoint name for predictions.
inputPropertiesList, default: nullProperties passed with each prediction instance. Image predictions are tiled, so these properties will be replicated into each image tile instance. Defaults to no properties.
inputTypeOverrideDictionary, default: nullTypes to which model inputs will be coerced if specified. Both Image bands and Image/Feature properties are valid.
inputShapesDictionary, default: nullThe fixed shape of input array bands. For each array band not specified, the fixed array shape will be automatically deduced from a non-masked pixel.
projProjection, default: nullThe input projection at which to sample all bands. Defaults to the default projection of an image's first band.
fixInputProjBoolean, default: nullIf true, pixels will be sampled in a fixed projection specified by 'proj'. The output projection is used otherwise. Defaults to false.
inputTileSizeList, default: nullRectangular dimensions of pixel tiles passed in to prediction instances. Required for image predictions.
inputOverlapSizeList, default: nullAmount of adjacent-tile overlap in X/Y along each edge of pixel tiles passed in to prediction instances. Defaults to [0, 0].
outputTileSizeList, default: nullRectangular dimensions of pixel tiles returned from AI Platform. Defaults to the value in 'inputTileSize'.
outputBandsDictionary, default: nullA map from output band names to a dictionary of output band info. Valid band info fields are 'type' and 'dimensions'. 'type' should be a ee.PixelType describing the output band, and 'dimensions' is an optional integer with the number of dimensions in that band e.g.: "outputBands: {'p': {'type': ee.PixelType.int8(), 'dimensions': 1}}". Required for image predictions.
outputPropertiesDictionary, default: nullA map from output property names to a dictionary of output property info. Valid property info fields are 'type' and 'dimensions'. 'type' should be a ee.PixelType describing the output property, and 'dimensions' is an optional integer with the number of dimensions for that property if it is an array e.g.: "outputBands: {'p': {'type': ee.PixelType.int8(), 'dimensions': 1}}". Required for predictions from FeatureCollections.
outputMultiplierFloat, default: nullAn approximation to the increase in data volume for the model outputs over the model inputs. If specified this must be >= 1. This is only needed if the model produces more data than it consumes, e.g. a model that takes 5 bands and produces 10 outputs per pixel.
maxPayloadBytesLong, default: nullThe prediction payload size limit in bytes. Defaults to 1.5MB (1500000 bytes)
payloadFormatString, default: nullThe payload format of entries in prediction requests and responses. One of: ['SERIALIZED_TF_TENSORS, 'RAW_JSON', 'ND_ARRAYS']. Defaults to 'SERIALIZED_TF_TENSORS'.

ee.Model.predictImage

Make predictions from pixel tiles of an image. The predictions are merged as bands with the input image.

The model will receive 0s in place of masked pixels. The masks of predicted output bands are the minimum of the masks of the inputs.

UsageReturns
Model.predictImage(image)Image
ArgumentTypeDetails
this: modelModel
imageImageThe input image.

ee.Model.predictProperties

Make predictions for each feature in a collection. Predicted properties are merged with the properties of the input feature.

UsageReturns
Model.predictProperties(collection)FeatureCollection
ArgumentTypeDetails
this: modelModel
collectionFeatureCollectionThe input collection.

ee.Number

Constructs a new Number.

UsageReturns
ee.Number(number)Number
ArgumentTypeDetails
numberNumber|ObjectA number or a computed object.

ee.Number.abs

Computes the absolute value of the input.

UsageReturns
Number.abs()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.acos

Computes the arc cosine in radians of the input.

UsageReturns
Number.acos()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.add

Adds the first value to the second.

UsageReturns
Number.add(right)Number
ArgumentTypeDetails
this: leftNumberThe left-hand value.
rightNumberThe right-hand value.

ee.Number.and

Returns 1 if and only if both values are non-zero.

UsageReturns
Number.and(right)Number
ArgumentTypeDetails
this: leftNumberThe left-hand value.
rightNumberThe right-hand value.

ee.Number.aside

Calls a function passing this object as the first argument, and returning itself. Convenient e.g. when debugging:

var c = ee.ImageCollection('foo').aside(print)

.filterDate('2001-01-01', '2002-01-01').aside(print, 'In 2001')

.filterBounds(geom).aside(print, 'In region')

.aside(Map.addLayer, {min: 0, max: 142}, 'Filtered')

.select('a', 'b');

Returns the same object, for chaining.

UsageReturns
Number.aside(func, var_args)ComputedObject
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
funcFunctionThe function to call.
var_argsVarArgsAny extra arguments to pass to the function.

ee.Number.asin

Computes the arc sine in radians of the input.

UsageReturns
Number.asin()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.atan

Computes the arc tangent in radians of the input.

UsageReturns
Number.atan()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.atan2

Calculates the angle formed by the 2D vector [x, y].

UsageReturns
Number.atan2(right)Number
ArgumentTypeDetails
this: leftNumberThe left-hand value.
rightNumberThe right-hand value.

ee.Number.bitCount

Calculates the number of one-bits in the 64-bit two's complement binary representation of the input.

UsageReturns
Number.bitCount()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.bitwiseAnd

Calculates the bitwise AND of the input values.

UsageReturns
Number.bitwiseAnd(right)Number
ArgumentTypeDetails
this: leftNumberThe left-hand value.
rightNumberThe right-hand value.

ee.Number.bitwiseNot

Calculates the bitwise NOT of the input, in the smallest signed integer type that can hold the input.

UsageReturns
Number.bitwiseNot()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.bitwiseOr

Calculates the bitwise OR of the input values.

UsageReturns
Number.bitwiseOr(right)Number
ArgumentTypeDetails
this: leftNumberThe left-hand value.
rightNumberThe right-hand value.

ee.Number.bitwiseXor

Calculates the bitwise XOR of the input values.

UsageReturns
Number.bitwiseXor(right)Number
ArgumentTypeDetails
this: leftNumberThe left-hand value.
rightNumberThe right-hand value.

ee.Number.byte

Casts the input value to an unsigned 8-bit integer.

UsageReturns
Number.byte()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.cbrt

Computes the cubic root of the input.

UsageReturns
Number.cbrt()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.ceil

Computes the smallest integer greater than or equal to the input.

UsageReturns
Number.ceil()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.clamp

Clamps the value to lie within the range of min to max.

UsageReturns
Number.clamp(min, max)Number
ArgumentTypeDetails
this: numberNumber
minFloat
maxFloat

ee.Number.cos

Computes the cosine of the input in radians.

UsageReturns
Number.cos()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.cosh

Computes the hyperbolic cosine of the input.

UsageReturns
Number.cosh()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.digamma

Computes the digamma function of the input.

UsageReturns
Number.digamma()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.divide

Divides the first value by the second, returning 0 for division by 0.

UsageReturns
Number.divide(right)Number
ArgumentTypeDetails
this: leftNumberThe left-hand value.
rightNumberThe right-hand value.

ee.Number.double

Casts the input value to a 64-bit float.

UsageReturns
Number.double()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.eq

Returns 1 if and only if the first value is equal to the second.

UsageReturns
Number.eq(right)Number
ArgumentTypeDetails
this: leftNumberThe left-hand value.
rightNumberThe right-hand value.

ee.Number.erf

Computes the error function of the input.

UsageReturns
Number.erf()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.erfInv

Computes the inverse error function of the input.

UsageReturns
Number.erfInv()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.erfc

Computes the complementary error function of the input.

UsageReturns
Number.erfc()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.erfcInv

Computes the inverse complementary error function of the input.

UsageReturns
Number.erfcInv()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.evaluate

Asynchronously retrieves the value of this object from the server and passes it to the provided callback function.

UsageReturns
Number.evaluate(callback)
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunctionA function of the form function(success, failure), called when the server returns an answer. If the request succeeded, the success argument contains the evaluated result. If the request failed, the failure argument will contains an error message.

ee.Number.exp

Computes the Euler's number e raised to the power of the input.

UsageReturns
Number.exp()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.expression

Computes a numeric expression.

UsageReturns
ee.Number.expression(expression, vars)Number
ArgumentTypeDetails
expressionStringA mathematical expression string to be evaluated. In addition to the standard arithmetic, boolean and relational operators, expressions also support any function in Number, the '.' operator to extract child elements from the 'vars' dictionary, and mathematical constants Math.PI and Math.E
varsDictionary, default: nullA dictionary of named values that can be used in the expression.

ee.Number.first

Selects the value of the first value.

UsageReturns
Number.first(right)Number
ArgumentTypeDetails
this: leftNumberThe left-hand value.
rightNumberThe right-hand value.

ee.Number.firstNonZero

Selects the first value if it is non-zero, and the second value otherwise.

UsageReturns
Number.firstNonZero(right)Number
ArgumentTypeDetails
this: leftNumberThe left-hand value.
rightNumberThe right-hand value.

ee.Number.float

Casts the input value to a 32-bit float.

UsageReturns
Number.float()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.floor

Computes the largest integer less than or equal to the input.

UsageReturns
Number.floor()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.format

Convert a number to a string using printf-style formatting.

UsageReturns
Number.format(pattern)String
ArgumentTypeDetails
this: numberNumberThe number to convert to a string.
patternString, default: "%s"A printf-style format string. For example, '%.2f' produces numbers formatted like '3.14', and '%05d' produces numbers formatted like '00042'. The format string must satisfy the following criteria:
  1. Zero or more prefix characters.
  2. Exactly one '%'.
  3. Zero or more modifier characters in the set [#-+ 0,(.\d].
  4. Exactly one conversion character in the set [sdoxXeEfgGaA].
  5. Zero or more suffix characters.
For more about format strings, see https://docs.oracle.com/javase/7/docs/api/java/util/Formatter.html

ee.Number.gamma

Computes the gamma function of the input.

UsageReturns
Number.gamma()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.gammainc

Calculates the regularized lower incomplete Gamma function γ(x,a).

UsageReturns
Number.gammainc(right)Number
ArgumentTypeDetails
this: leftNumberThe left-hand value.
rightNumberThe right-hand value.

ee.Number.getInfo

Retrieves the value of this object from the server.

If no callback function is provided, the request is made synchronously. If a callback is provided, the request is made asynchronously.

The asynchronous mode is preferred because the synchronous mode stops all other code (for example, the EE Code Editor UI) while waiting for the server. To make an asynchronous request, evaluate() is preferred over getInfo().

Returns the computed value of this object.

UsageReturns
Number.getInfo(callback)Object
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.Number.gt

Returns 1 if and only if the first value is greater than the second.

UsageReturns
Number.gt(right)Number
ArgumentTypeDetails
this: leftNumberThe left-hand value.
rightNumberThe right-hand value.

ee.Number.gte

Returns 1 if and only if the first value is greater than or equal to the second.

UsageReturns
Number.gte(right)Number
ArgumentTypeDetails
this: leftNumberThe left-hand value.
rightNumberThe right-hand value.

ee.Number.hypot

Calculates the magnitude of the 2D vector [x, y].

UsageReturns
Number.hypot(right)Number
ArgumentTypeDetails
this: leftNumberThe left-hand value.
rightNumberThe right-hand value.

ee.Number.int

Casts the input value to a signed 32-bit integer.

UsageReturns
Number.int()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.int16

Casts the input value to a signed 16-bit integer.

UsageReturns
Number.int16()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.int32

Casts the input value to a signed 32-bit integer.

UsageReturns
Number.int32()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.int64

Casts the input value to a signed 64-bit integer.

UsageReturns
Number.int64()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.int8

Casts the input value to a signed 8-bit integer.

UsageReturns
Number.int8()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.lanczos

Computes the Lanczos approximation of the input.

UsageReturns
Number.lanczos()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.leftShift

Calculates the left shift of v1 by v2 bits.

UsageReturns
Number.leftShift(right)Number
ArgumentTypeDetails
this: leftNumberThe left-hand value.
rightNumberThe right-hand value.

ee.Number.log

Computes the natural logarithm of the input.

UsageReturns
Number.log()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.log10

Computes the base-10 logarithm of the input.

UsageReturns
Number.log10()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.long

Casts the input value to a signed 64-bit integer.

UsageReturns
Number.long()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.lt

Returns 1 if and only if the first value is less than the second.

UsageReturns
Number.lt(right)Number
ArgumentTypeDetails
this: leftNumberThe left-hand value.
rightNumberThe right-hand value.

ee.Number.lte

Returns 1 if and only if the first value is less than or equal to the second.

UsageReturns
Number.lte(right)Number
ArgumentTypeDetails
this: leftNumberThe left-hand value.
rightNumberThe right-hand value.

ee.Number.max

Selects the maximum of the first and second values.

UsageReturns
Number.max(right)Number
ArgumentTypeDetails
this: leftNumberThe left-hand value.
rightNumberThe right-hand value.

ee.Number.min

Selects the minimum of the first and second values.

UsageReturns
Number.min(right)Number
ArgumentTypeDetails
this: leftNumberThe left-hand value.
rightNumberThe right-hand value.

ee.Number.mod

Calculates the remainder of the first value divided by the second.

UsageReturns
Number.mod(right)Number
ArgumentTypeDetails
this: leftNumberThe left-hand value.
rightNumberThe right-hand value.

ee.Number.multiply

Multiplies the first value by the second.

UsageReturns
Number.multiply(right)Number
ArgumentTypeDetails
this: leftNumberThe left-hand value.
rightNumberThe right-hand value.

ee.Number.neq

Returns 1 if and only if the first value is not equal to the second.

UsageReturns
Number.neq(right)Number
ArgumentTypeDetails
this: leftNumberThe left-hand value.
rightNumberThe right-hand value.

ee.Number.not

Returns 0 if the input is non-zero, and 1 otherwise.

UsageReturns
Number.not()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.or

Returns 1 if and only if either input value is non-zero.

UsageReturns
Number.or(right)Number
ArgumentTypeDetails
this: leftNumberThe left-hand value.
rightNumberThe right-hand value.

ee.Number.parse

Convert a string to a number.

UsageReturns
ee.Number.parse(input, radix)Number
ArgumentTypeDetails
inputStringThe string to convert to a number.
radixInteger, default: 10An integer representing the base number system from which to convert. If input is not an integer, radix must equal 10 or not be specified.

ee.Number.pow

Raises the first value to the power of the second.

UsageReturns
Number.pow(right)Number
ArgumentTypeDetails
this: leftNumberThe left-hand value.
rightNumberThe right-hand value.

ee.Number.rightShift

Calculates the signed right shift of v1 by v2 bits.

UsageReturns
Number.rightShift(right)Number
ArgumentTypeDetails
this: leftNumberThe left-hand value.
rightNumberThe right-hand value.

ee.Number.round

Computes the integer nearest to the input.

UsageReturns
Number.round()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.serialize

Returns the serialized representation of this object.

UsageReturns
Number.serialize(legacy)String
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
legacyBoolean, optionalEnables legacy format.

ee.Number.short

Casts the input value to a signed 16-bit integer.

UsageReturns
Number.short()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.signum

Computes the signum function (sign) of the input; zero if the input is zero, 1 if the input is greater than zero, -1 if the input is less than zero.

UsageReturns
Number.signum()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.sin

Computes the sine of the input in radians.

UsageReturns
Number.sin()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.sinh

Computes the hyperbolic sine of the input.

UsageReturns
Number.sinh()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.sqrt

Computes the square root of the input.

UsageReturns
Number.sqrt()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.subtract

Subtracts the second value from the first.

UsageReturns
Number.subtract(right)Number
ArgumentTypeDetails
this: leftNumberThe left-hand value.
rightNumberThe right-hand value.

ee.Number.tan

Computes the tangent of the input in radians.

UsageReturns
Number.tan()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.tanh

Computes the hyperbolic tangent of the input.

UsageReturns
Number.tanh()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.toByte

Casts the input value to an unsigned 8-bit integer.

UsageReturns
Number.toByte()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.toDouble

Casts the input value to a 64-bit float.

UsageReturns
Number.toDouble()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.toFloat

Casts the input value to a 32-bit float.

UsageReturns
Number.toFloat()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.toInt

Casts the input value to a signed 32-bit integer.

UsageReturns
Number.toInt()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.toInt16

Casts the input value to a signed 16-bit integer.

UsageReturns
Number.toInt16()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.toInt32

Casts the input value to a signed 32-bit integer.

UsageReturns
Number.toInt32()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.toInt64

Casts the input value to a signed 64-bit integer.

UsageReturns
Number.toInt64()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.toInt8

Casts the input value to a signed 8-bit integer.

UsageReturns
Number.toInt8()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.toLong

Casts the input value to a signed 64-bit integer.

UsageReturns
Number.toLong()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.toShort

Casts the input value to a signed 16-bit integer.

UsageReturns
Number.toShort()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.toUint16

Casts the input value to an unsigned 16-bit integer.

UsageReturns
Number.toUint16()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.toUint32

Casts the input value to an unsigned 32-bit integer.

UsageReturns
Number.toUint32()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.toUint8

Casts the input value to an unsigned 8-bit integer.

UsageReturns
Number.toUint8()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.trigamma

Computes the trigamma function of the input.

UsageReturns
Number.trigamma()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.uint16

Casts the input value to an unsigned 16-bit integer.

UsageReturns
Number.uint16()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.uint32

Casts the input value to an unsigned 32-bit integer.

UsageReturns
Number.uint32()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.uint8

Casts the input value to an unsigned 8-bit integer.

UsageReturns
Number.uint8()Number
ArgumentTypeDetails
this: inputNumberThe input value.

ee.Number.unitScale

Scales the input so that the range of input values [min, max] becomes [0, 1]. Values outside the range are NOT clamped. If min == max, 0 is returned.

UsageReturns
Number.unitScale(min, max)Number
ArgumentTypeDetails
this: numberNumber
minFloat
maxFloat

ee.PixelType

Returns a PixelType of the given precision with the given limits per element, and an optional dimensionality.

UsageReturns
ee.PixelType(precision, minValue, maxValue, dimensions)PixelType
ArgumentTypeDetails
precisionObjectThe pixel precision, one of 'int', 'float', or 'double'.
minValueNumber, default: nullThe minimum value of pixels of this type. If precision is 'float' or 'double', this can be null, signifying negative infinity.
maxValueNumber, default: nullThe maximum value of pixels of this type. If precision is 'float' or 'double', this can be null, signifying positive infinity.
dimensionsInteger, default: 0The number of dimensions in which pixels of this type can vary; 0 is a scalar, 1 is a vector, 2 is a matrix, etc.

ee.PixelType.dimensions

Returns the number of dimensions for this type. Will be 0 for scalar values and >= 1 for array values.

UsageReturns
PixelType.dimensions()Integer
ArgumentTypeDetails
this: pixelTypePixelType

ee.PixelType.double

Returns the 64-bit floating point pixel type.

UsageReturns
ee.PixelType.double()PixelType

No arguments.

ee.PixelType.float

Returns the 32-bit floating point pixel type.
UsageReturns
ee.PixelType.float()PixelType

No arguments.

ee.PixelType.int16

Returns the 16-bit signed integer pixel type.
UsageReturns
ee.PixelType.int16()PixelType

No arguments.

ee.PixelType.int32

Returns the 32-bit signed integer pixel type.
UsageReturns
ee.PixelType.int32()PixelType

No arguments.

ee.PixelType.int64

Returns the 64-bit signed integer pixel type.
UsageReturns
ee.PixelType.int64()PixelType

No arguments.

ee.PixelType.int8

Returns the 8-bit signed integer pixel type.
UsageReturns
ee.PixelType.int8()PixelType

No arguments.

ee.PixelType.maxValue

Returns the maximum value of the PixelType.
UsageReturns
PixelType.maxValue()Number
ArgumentTypeDetails
this: pixelTypePixelType

ee.PixelType.minValue

Returns the minimum value of the PixelType.

UsageReturns
PixelType.minValue()Number
ArgumentTypeDetails
this: pixelTypePixelType

ee.PixelType.precision

Returns the precision of the PixelType. One of 'int', 'float', or 'double'.

UsageReturns
PixelType.precision()String
ArgumentTypeDetails
this: pixelTypePixelType

ee.PixelType.uint16

Returns the 16-bit unsigned integer pixel type.

UsageReturns
ee.PixelType.uint16()PixelType

No arguments.

ee.PixelType.uint32

Returns the 32-bit unsigned integer pixel type.
UsageReturns
ee.PixelType.uint32()PixelType

No arguments.

ee.PixelType.uint8

Returns the 8-bit unsigned integer pixel type.
UsageReturns
ee.PixelType.uint8()PixelType

No arguments.

ee.Projection

Returns a Projection with the given base coordinate system and the given transform between projected coordinates and the base. If no transform is specified, the identity transform is assumed.
UsageReturns
ee.Projection(crs, transform, transformWkt)Projection
ArgumentTypeDetails
crsObjectThe base coordinate reference system of this Projection, given as a well-known authority code (e.g. 'EPSG:4326') or a WKT string.
transformList, default: nullThe transform between projected coordinates and the base coordinate system, specified as a 2x3 affine transform matrix in row-major order: [xScale, xShearing, xTranslation, yShearing, yScale, yTranslation]. May not specify both this and 'transformWkt'.
transformWktString, default: nullThe transform between projected coordinates and the base coordinate system, specified as a WKT string. May not specify both this and 'transform'.

ee.Projection.atScale

Returns the projection scaled such that its units have the given scale in linear meters, as measured at the point of true scale.

UsageReturns
Projection.atScale(meters)Projection
ArgumentTypeDetails
this: projectionProjection
metersFloat

ee.Projection.crs

Returns the authority code (e.g. 'EPSG:4326') for the base coordinate system of this projection, or null if the base coordinate system is not found in any available database.

UsageReturns
Projection.crs()String
ArgumentTypeDetails
this: projectionProjection

ee.Projection.nominalScale

Returns the linear scale in meters of the units of this projection, as measured at the point of true scale.

UsageReturns
Projection.nominalScale()Float
ArgumentTypeDetails
this: projProjection

ee.Projection.scale

Returns the projection scaled by the given amount in each axis.

UsageReturns
Projection.scale(x, y)Projection
ArgumentTypeDetails
this: projectionProjection
xFloat
yFloat

ee.Projection.transform

Returns a WKT representation of the transform of this Projection. This is the transform that converts from projected coordinates to the base coordinate system.

UsageReturns
Projection.transform()String
ArgumentTypeDetails
this: projectionProjection

ee.Projection.translate

Returns the projection translated by the given amount in each axis.

UsageReturns
Projection.translate(x, y)Projection
ArgumentTypeDetails
this: projectionProjection
xFloat
yFloat

ee.Projection.wkt

Returns a WKT representation of the base coordinate system of this Projection.

UsageReturns
Projection.wkt()String
ArgumentTypeDetails
this: projectionProjection

ee.Reducer.allNonZero

Returns a Reducer that returns 1 if all of its inputs are non-zero, 0 otherwise.

UsageReturns
ee.Reducer.allNonZero()Reducer

No arguments.

ee.Reducer.anyNonZero

Returns a Reducer that returns 1 if any of its inputs are non-zero, 0 otherwise.
UsageReturns
ee.Reducer.anyNonZero()Reducer

No arguments.

ee.Reducer.autoHistogram

Create a reducer that will compute a histogram of the inputs. The output is a Nx2 array of the lower bucket bounds and the counts (or cumulative counts) of each bucket, and is suitable for use per-pixel.
UsageReturns
ee.Reducer.autoHistogram(maxBuckets, minBucketWidth, maxRaw, cumulative)Reducer
ArgumentTypeDetails
maxBucketsInteger, default: nullThe maximum number of buckets to use when building a histogram; will be rounded up to a power of 2.
minBucketWidthFloat, default: nullThe minimum histogram bucket width, or null to allow any power of 2.
maxRawInteger, default: nullThe number of values to accumulate before building the initial histogram.
cumulativeBoolean, default: false

ee.Reducer.bitwiseAnd

Returns a Reducer that computes the bitwise-and summation of its inputs.

UsageReturns
ee.Reducer.bitwiseAnd()Reducer

No arguments.

ee.Reducer.bitwiseOr

Returns a Reducer that computes the bitwise-or summation of its inputs.
UsageReturns
ee.Reducer.bitwiseOr()Reducer

No arguments.

ee.Reducer.centeredCovariance

Creates a reducer that reduces some number of 1-D arrays of the same length N to a covariance matrix of shape NxN. WARNING: this reducer requires that the data has been mean centered.
UsageReturns
ee.Reducer.centeredCovariance()Reducer

No arguments.

ee.Reducer.circularMean

Returns a Reducer that computes the (weighted) circular mean of its inputs, which are expected to be in radians. Output will be in the range (-π to π).
UsageReturns
ee.Reducer.circularMean()Reducer

No arguments.

ee.Reducer.circularStddev

Returns a Reducer that computes the (weighted) circular standard deviation of its inputs, which are expected to be in radians, using the sqrt(-2 * ln(R)) formula.
UsageReturns
ee.Reducer.circularStddev()Reducer

No arguments.

ee.Reducer.circularVariance

Returns a Reducer that computes the (weighted) circular variance of its inputs, which are expected to be in radians.
UsageReturns
ee.Reducer.circularVariance()Reducer

No arguments.

ee.Reducer.combine

Creates a Reducer that runs two reducers in parallel. The combined reducer's outputs will be those of reducer1 followed by those of reducer2, where the output names of reducer2 are prefixed with the given string. If sharedInputs is true, the reducers must have the same number of inputs, and the combined reducer's will match them; if it is false, the inputs of the combined reducer will be those of reducer1 followed by those of reducer2.
UsageReturns
Reducer.combine(reducer2, outputPrefix, sharedInputs)Reducer
ArgumentTypeDetails
this: reducer1Reducer
reducer2Reducer
outputPrefixString, default: ""Prefix for reducer2's output names.
sharedInputsBoolean, default: false

ee.Reducer.count

Returns a Reducer that computes the number of non-null inputs.

UsageReturns
ee.Reducer.count()Reducer

No arguments.

ee.Reducer.countDistinct

Returns a Reducer that computes the number of distinct inputs.
UsageReturns
ee.Reducer.countDistinct()Reducer

No arguments.

ee.Reducer.countDistinctNonNull

Returns a Reducer that computes the number of distinct inputs, ignoring nulls.
UsageReturns
ee.Reducer.countDistinctNonNull()Reducer

No arguments.

ee.Reducer.countEvery

Returns a Reducer that computes the number of inputs.
UsageReturns
ee.Reducer.countEvery()Reducer

No arguments.

ee.Reducer.countRuns

Returns a Reducer that computes the number of runs of distinct, non-null inputs.
UsageReturns
ee.Reducer.countRuns()Reducer

No arguments.

ee.Reducer.covariance

Creates a reducer that reduces some number of 1-D arrays of the same length N to a covariance matrix of shape NxN. This reducer uses the one-pass covariance formula from Sandia National Laboratories Technical Report SAND2008-6212, which can lose accuracy if the values span a large range.
UsageReturns
ee.Reducer.covariance()Reducer

No arguments.

ee.Reducer.disaggregate

Separates aggregate inputs (Arrays, Lists or Dictionaries) into individual items that are then each passed to the specified reducer. When used on dictionaries, the dictionary keys are ignored. Non-aggregated inputs (ie: numbers or strings) are passed to the underlying reducer directly.
UsageReturns
Reducer.disaggregate(axis)Reducer
ArgumentTypeDetails
this: reducerReducerThe reducer for which to disaggregate inputs.
axisInteger, default: nullIf specified, indicates an array axis along which to disaggregate. If not specified, arrays are completely disaggregated. Ignored for non-array types.

ee.Reducer.first

Returns a Reducer that returns the first of its inputs.

UsageReturns
ee.Reducer.first()Reducer

No arguments.

ee.Reducer.firstNonNull

Returns a Reducer that returns the first of its non-null inputs.
UsageReturns
ee.Reducer.firstNonNull()Reducer

No arguments.

ee.Reducer.fixed2DHistogram

Creates a reducer that will compute a 2D histogram of the inputs using a fixed number of fixed width bins. Values outside of the [min, max) range on either axis are ignored. The output is a 2D array of counts, and 2 1-D arrays of bucket lower edges for the xAxis and the yXais. This reducer is suitable for use per-pixel, however it is always unweighted. The maximum count for any bucket is 2^31 - 1.
UsageReturns
ee.Reducer.fixed2DHistogram(xMin, xMax, xSteps, yMin, yMax, ySteps)Reducer
ArgumentTypeDetails
xMinFloatThe lower (inclusive) bound of the first bucket on the X axis.
xMaxFloatThe upper (exclusive) bound of the last bucket on the X axis.
xStepsIntegerThe number of buckets to use on the X axis.
yMinFloatThe lower (inclusive) bound of the first bucket on the Y axis.
yMaxFloatThe upper (exclusive) bound of the last bucket on the Y axis.
yStepsIntegerThe number of buckets to use on the Y axis.

ee.Reducer.fixedHistogram

Creates a reducer that will compute a histogram of the inputs using a fixed number of fixed width bins. Values outside of the [min, max) range are ignored. The output is a Nx2 array of bucket lower edges and counts (or cumulative counts) and is suitable for use per-pixel.

UsageReturns
ee.Reducer.fixedHistogram(min, max, steps, cumulative)Reducer
ArgumentTypeDetails
minFloatThe lower (inclusive) bound of the first bucket.
maxFloatThe upper (exclusive) bound of the last bucket.
stepsIntegerThe number of buckets to use.
cumulativeBoolean, default: falseWhen true, generates a cumulative histogram.

ee.Reducer.forEach

Creates a Reducer by combining a copy of the given reducer for each output name in the given list. If the reducer has a single output, the output names are used as-is; otherwise they are prefixed to the original output names.

UsageReturns
Reducer.forEach(outputNames)Reducer
ArgumentTypeDetails
this: reducerReducer
outputNamesList

ee.Reducer.forEachBand

Creates a Reducer by combining a copy of the given reducer for each band in the given image, using the band names as output names.

UsageReturns
Reducer.forEachBand(image)Reducer
ArgumentTypeDetails
this: reducerReducer
imageImage

ee.Reducer.forEachElement

Separately reduces each position in array inputs of equal shape, producing an array output of the same shape.

For example, with the 'sum' reducer applied to 5 arrays with shape 2x2, the output will be a 2x2 array, where each position is the sum of the 5 values at that position.

UsageReturns
Reducer.forEachElement()Reducer
ArgumentTypeDetails
this: reducerReducerThe reducer to apply to each array element.

ee.Reducer.frequencyHistogram

Returns a Reducer that returns a (weighted) frequency table of its inputs.

UsageReturns
ee.Reducer.frequencyHistogram()Reducer

No arguments.

ee.Reducer.geometricMedian

Creates a reducer that computes the geometric median across a set of inputs.
UsageReturns
ee.Reducer.geometricMedian(numX, eta, initialStepSize)Reducer
ArgumentTypeDetails
numXIntegerThe number of input dimensions.
etaFloat, default: 0.001The minimum improvement in the solution used as a stopping criteria for the solver.
initialStepSizeFloat, default: 10The initial step size used in the solver.

ee.Reducer.getOutputs

Returns a list of the output names of the given reducer.

UsageReturns
Reducer.getOutputs()List
ArgumentTypeDetails
this: reducerReducer

ee.Reducer.group

Groups reducer records by the value of a given input, and reduces each group with the given reducer.

UsageReturns
Reducer.group(groupField, groupName)Reducer
ArgumentTypeDetails
this: reducerReducerThe reducer to apply to each group, without the group field.
groupFieldInteger, default: 0The field that contains record groups.
groupNameString, default: "group"The dictionary key that contains the group. Defaults to 'group'.

ee.Reducer.histogram

Create a reducer that will compute a histogram of the inputs.

UsageReturns
ee.Reducer.histogram(maxBuckets, minBucketWidth, maxRaw)Reducer
ArgumentTypeDetails
maxBucketsInteger, default: nullThe maximum number of buckets to use when building a histogram; will be rounded up to a power of 2.
minBucketWidthFloat, default: nullThe minimum histogram bucket width, or null to allow any power of 2.
maxRawInteger, default: nullThe number of values to accumulate before building the initial histogram.

ee.Reducer.intervalMean

Creates a Reducer to compute the mean of all inputs in the specified percentile range. For small numbers of inputs (up to maxRaw) the mean will be computed directly; for larger numbers of inputs the mean will be derived from a histogram.

UsageReturns
ee.Reducer.intervalMean(minPercentile, maxPercentile, maxBuckets, minBucketWidth, maxRaw)Reducer
ArgumentTypeDetails
minPercentileFloatThe lower bound of the percentile range.
maxPercentileFloatThe upper bound of the percentile range.
maxBucketsInteger, default: nullThe maximum number of buckets to use when building a histogram; will be rounded up to a power of 2.
minBucketWidthFloat, default: nullThe minimum histogram bucket width, or null to allow any power of 2.
maxRawInteger, default: nullThe number of values to accumulate before building the initial histogram.

ee.Reducer.kendallsCorrelation

Creates a reducer that computes the Kendall's Tau-b rank correlation. A positive tau value indicates an increasing trend; negative value indicates a decreasing trend. See https://commons.apache.org/proper/commons-math/javadocs/api-3.6/org/apache/commons/math3/stat/correlation/KendallsCorrelation.html for details.

UsageReturns
ee.Reducer.kendallsCorrelation(numInputs)Reducer
ArgumentTypeDetails
numInputsInteger, default: 1The number of inputs to expect (1 or 2). If 1 is specified, automatically generates sequence numbers for the x value (meaning there can be no ties).

ee.Reducer.kurtosis

Returns a Reducer that Computes the kurtosis of its inputs.

UsageReturns
ee.Reducer.kurtosis()Reducer

No arguments.

ee.Reducer.last

Returns a Reducer that returns the last of its inputs.
UsageReturns
ee.Reducer.last()Reducer

No arguments.

ee.Reducer.lastNonNull

Returns a Reducer that returns the last of its non-null inputs.
UsageReturns
ee.Reducer.lastNonNull()Reducer

No arguments.

ee.Reducer.linearFit

Returns a Reducer that computes the slope and offset for a (weighted) linear regression of 2 inputs. The inputs are expected to be x data followed by y data..
UsageReturns
ee.Reducer.linearFit()Reducer

No arguments.

ee.Reducer.linearRegression

Creates a reducer that computes a linear least squares regression with numX independent variables and numY dependent variables. Each input tuple will have values for the independent variables followed by the dependent variables. The first output is a coefficients array with dimensions (numX, numY); each column contains the coefficients for the corresponding dependent variable. The second output is a vector of the root mean square of the residuals of each dependent variable. Both outputs are null if the system is underdetermined, e.g. the number of inputs is less than or equal to numX.
UsageReturns
ee.Reducer.linearRegression(numX, numY)Reducer
ArgumentTypeDetails
numXIntegerThe number of input dimensions.
numYInteger, default: 1The number of output dimensions.

ee.Reducer.max

Creates a reducer that outputs the maximum value of its (first) input. If numInputs is greater than one, also outputs the corresponding values of the additional inputs.

UsageReturns
ee.Reducer.max(numInputs)Reducer
ArgumentTypeDetails
numInputsInteger, default: 1The number of inputs.

ee.Reducer.mean

Returns a Reducer that computes the (weighted) arithmetic mean of its inputs.

UsageReturns
ee.Reducer.mean()Reducer

No arguments.

ee.Reducer.median

Create a reducer that will compute the median of the inputs. For small numbers of inputs (up to maxRaw) the median will be computed directly; for larger numbers of inputs the median will be derived from a histogram.
UsageReturns
ee.Reducer.median(maxBuckets, minBucketWidth, maxRaw)Reducer
ArgumentTypeDetails
maxBucketsInteger, default: nullThe maximum number of buckets to use when building a histogram; will be rounded up to a power of 2.
minBucketWidthFloat, default: nullThe minimum histogram bucket width, or null to allow any power of 2.
maxRawInteger, default: nullThe number of values to accumulate before building the initial histogram.

ee.Reducer.min

Creates a reducer that outputs the minimum value of its (first) input. If numInputs is greater than one, also outputs the corresponding values of the additional inputs.

UsageReturns
ee.Reducer.min(numInputs)Reducer
ArgumentTypeDetails
numInputsInteger, default: 1The number of inputs.

ee.Reducer.minMax

Returns a Reducer that computes the minimum and maximum of its inputs.

UsageReturns
ee.Reducer.minMax()Reducer

No arguments.

ee.Reducer.mode

Create a reducer that will compute the mode of the inputs. For small numbers of inputs (up to maxRaw) the mode will be computed directly; for larger numbers of inputs the mode will be derived from a histogram.
UsageReturns
ee.Reducer.mode(maxBuckets, minBucketWidth, maxRaw)Reducer
ArgumentTypeDetails
maxBucketsInteger, default: nullThe maximum number of buckets to use when building a histogram; will be rounded up to a power of 2.
minBucketWidthFloat, default: nullThe minimum histogram bucket width, or null to allow any power of 2.
maxRawInteger, default: nullThe number of values to accumulate before building the initial histogram.

ee.Reducer.pearsonsCorrelation

Creates a two-input reducer that computes Pearson's product-moment correlation coefficient and the 2-sided p-value test for correlation = 0.

UsageReturns
ee.Reducer.pearsonsCorrelation()Reducer

No arguments.

ee.Reducer.percentile

Create a reducer that will compute the specified percentiles, e.g. given [0, 50, 100] will produce outputs named 'p0', 'p50', and 'p100' with the min, median, and max respectively. For small numbers of inputs (up to maxRaw) the percentiles will be computed directly; for larger numbers of inputs the percentiles will be derived from a histogram.
UsageReturns
ee.Reducer.percentile(percentiles, outputNames, maxBuckets, minBucketWidth, maxRaw)Reducer
ArgumentTypeDetails
percentilesListA list of numbers between 0 and 100.
outputNamesList, default: nullA list of names for the outputs, or null to get default names.
maxBucketsInteger, default: nullThe maximum number of buckets to use when building a histogram; will be rounded up to a power of 2.
minBucketWidthFloat, default: nullThe minimum histogram bucket width, or null to allow any power of 2.
maxRawInteger, default: nullThe number of values to accumulate before building the initial histogram.

ee.Reducer.product

Returns a Reducer that computes the product of its inputs.

UsageReturns
ee.Reducer.product()Reducer

No arguments.

ee.Reducer.repeat

Creates a Reducer by combining the specified number of copies of the given reducer. Output names are the same as the given reducer, but each is a list of the corresponding output from each of the reducers.
UsageReturns
Reducer.repeat(count)Reducer
ArgumentTypeDetails
this: reducerReducer
countInteger

ee.Reducer.ridgeRegression

Creates a reducer that computes a ridge regression with numX independent variables (not including constant) followed by numY dependent variables. Ridge regression is a form of Tikhonov regularization which shrinks the regression coefficients by imposing a penalty on their size. With this implementation of ridge regression there NO NEED to include a constant value for bias.

The first output is a coefficients array with dimensions (numX + 1, numY); each column contains the coefficients for the corresponding dependent variable plus the intercept for the dependent variable in the last column. Additional outputs are a vector of the root mean square of the residuals of each dependent variable and a vector of p-values for each dependent variable. Outputs are null if the system is underdetermined, e.g. the number of inputs is less than numX + 1.

UsageReturns
ee.Reducer.ridgeRegression(numX, numY, lambda)Reducer
ArgumentTypeDetails
numXIntegerthe number of independent variables being regressed.
numYInteger, default: 1the number of dependent variables.
lambdaFloat, default: 0.1Regularization parameter.

ee.Reducer.robustLinearRegression

Creates a reducer that computes a robust least squares regression with numX independent variables and numY dependent variables, using iteratively reweighted least squares with the Talwar cost function. A point is considered an outlier if the RMS of residuals is greater than beta.

Each input tuple will have values for the independent variables followed by the dependent variables.

The first output is a coefficients array with dimensions (numX, numY); each column contains the coefficients for the corresponding dependent variable. The second is a vector of the root mean square of the residuals of each dependent variable. Both outputs are null if the system is underdetermined, e.g. the number of inputs is less than numX.

UsageReturns
ee.Reducer.robustLinearRegression(numX, numY, beta)Reducer
ArgumentTypeDetails
numXIntegerThe number of input dimensions.
numYInteger, default: 1The number of output dimensions.
betaFloat, default: nullResidual error outlier margin. If null, a default value will be computed.

ee.Reducer.sampleStdDev

Returns a Reducer that computes the sample standard deviation of its inputs.

UsageReturns
ee.Reducer.sampleStdDev()Reducer

No arguments.

ee.Reducer.sampleVariance

Returns a Reducer that computes the sample variance of its inputs.
UsageReturns
ee.Reducer.sampleVariance()Reducer

No arguments.

ee.Reducer.sensSlope

Creates a two-input reducer that computes the Sen's slope estimator. The inputs are expected to be x data followed by y data. It returns two double values; the estimated slope and the offset.
UsageReturns
ee.Reducer.sensSlope()Reducer

No arguments.

ee.Reducer.setOutputs

Returns a Reducer with the same inputs as the given Reducer, but with outputs renamed and/or removed.
UsageReturns
Reducer.setOutputs(outputs)Reducer
ArgumentTypeDetails
this: reducerReducer
outputsListThe new output names; any output whose name is null or empty will be dropped.

ee.Reducer.skew

Returns a Reducer that Computes the skewness of its inputs.

UsageReturns
ee.Reducer.skew()Reducer

No arguments.

ee.Reducer.spearmansCorrelation

Creates a two-input reducer that computes the Spearman's rank-moment correlation. See https://commons.apache.org/proper/commons-math/javadocs/api-3.6/org/apache/commons/math3/stat/correlation/SpearmansCorrelation.html for details.
UsageReturns
ee.Reducer.spearmansCorrelation()Reducer

No arguments.

ee.Reducer.splitWeights

Returns a Reducer with the same outputs as the given Reducer, but with each weighted input replaced by two unweighted inputs.
UsageReturns
Reducer.splitWeights()Reducer
ArgumentTypeDetails
this: reducerReducer

ee.Reducer.stdDev

Returns a Reducer that computes the standard deviation of its inputs.

UsageReturns
ee.Reducer.stdDev()Reducer

No arguments.

ee.Reducer.sum

Returns a Reducer that computes the (weighted) sum of its inputs.
UsageReturns
ee.Reducer.sum()Reducer

No arguments.

ee.Reducer.toCollection

Returns a reducer that collects its inputs into a FeatureCollection.
UsageReturns
ee.Reducer.toCollection(propertyNames, numOptional)Reducer
ArgumentTypeDetails
propertyNamesListThe property names that will be defined on each output feature; determines the number of reducer inputs.
numOptionalInteger, default: 0The last numOptional inputs will be considered optional; the other inputs must be non-null or the input tuple will be dropped.

ee.Reducer.toList

Creates a reducer that collects its inputs into a list, optionally grouped into tuples.

UsageReturns
ee.Reducer.toList(tupleSize, numOptional)Reducer
ArgumentTypeDetails
tupleSizeInteger, default: nullThe size of each output tuple, or null for no grouping. Also determines the number of inputs (null tupleSize has 1 input).
numOptionalInteger, default: 0The last numOptional inputs will be considered optional; the other inputs must be non-null or the input tuple will be dropped.

ee.Reducer.unweighted

Returns a Reducer with the same inputs and outputs as the given Reducer, but with no weighted inputs.

UsageReturns
Reducer.unweighted()Reducer
ArgumentTypeDetails
this: reducerReducer

ee.Reducer.variance

Returns a Reducer that computes the variance of its inputs.

UsageReturns
ee.Reducer.variance()Reducer

No arguments.

ee.String

Constructs a new String.
UsageReturns
ee.String(string)String
ArgumentTypeDetails
stringObject|StringA string or a computed object.

ee.String.aside

Calls a function passing this object as the first argument, and returning itself. Convenient e.g. when debugging:

var c = ee.ImageCollection('foo').aside(print)

.filterDate('2001-01-01', '2002-01-01').aside(print, 'In 2001')

.filterBounds(geom).aside(print, 'In region')

.aside(Map.addLayer, {min: 0, max: 142}, 'Filtered')

.select('a', 'b');

Returns the same object, for chaining.

UsageReturns
String.aside(func, var_args)ComputedObject
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
funcFunctionThe function to call.
var_argsVarArgsAny extra arguments to pass to the function.

ee.String.cat

Concatenates two strings.

UsageReturns
String.cat(string2)String
ArgumentTypeDetails
this: string1StringThe first string.
string2StringThe second string.

ee.String.compareTo

Compares two strings lexicographically. Returns: the value 0 if the two strings are lexicographically equal; a value less than 0 if string1 is less than string2; and a value greater than 0 if string1 is lexicographically greater than string2.

UsageReturns
String.compareTo(string2)Integer
ArgumentTypeDetails
this: string1StringThe string to compare.
string2StringThe string to be compared.

ee.String.decodeJSON

Decodes a JSON string.

UsageReturns
String.decodeJSON()Object
ArgumentTypeDetails
this: stringStringThe string to decode.

ee.String.encodeJSON

Encodes an object to JSON. Supports primitives, lists and dictionaries.

UsageReturns
ee.String.encodeJSON(object)String
ArgumentTypeDetails
objectObjectThe object to encode.

ee.String.equals

Checks for string equality with a given object. Returns true if the target is a string and is lexicographically equal to the reference, or false otherwise.

UsageReturns
String.equals(target)Boolean
ArgumentTypeDetails
this: referenceStringThe string to compare for equality.
targetObjectThe second object to check for equality.

ee.String.evaluate

Asynchronously retrieves the value of this object from the server and passes it to the provided callback function.

UsageReturns
String.evaluate(callback)
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunctionA function of the form function(success, failure), called when the server returns an answer. If the request succeeded, the success argument contains the evaluated result. If the request failed, the failure argument will contains an error message.

ee.String.getInfo

Retrieves the value of this object from the server.

If no callback function is provided, the request is made synchronously. If a callback is provided, the request is made asynchronously.

The asynchronous mode is preferred because the synchronous mode stops all other code (for example, the EE Code Editor UI) while waiting for the server. To make an asynchronous request, evaluate() is preferred over getInfo().

Returns the computed value of this object.

UsageReturns
String.getInfo(callback)Object
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.String.index

Searches a string for the first occurrence of a substring. Returns the index of the first match, or -1.

UsageReturns
String.index(pattern)Integer
ArgumentTypeDetails
this: targetStringThe string to search.
patternStringThe string to find.

ee.String.length

Returns the length of a string.

UsageReturns
String.length()Integer
ArgumentTypeDetails
this: stringStringThe string from which to get the length.

ee.String.match

Matches a string against a regular expression. Returns a list of matching strings.

UsageReturns
String.match(regex, flags)List
ArgumentTypeDetails
this: inputStringThe string in which to search.
regexStringThe regular expression to match.
flagsString, default: ""A string specifying a combination of regular expression flags, specifically one or more of: 'g' (global match) or 'i' (ignore case)

ee.String.replace

Returns a new string with some or all matches of a pattern replaced.

UsageReturns
String.replace(regex, replacement, flags)String
ArgumentTypeDetails
this: inputStringThe string in which to search.
regexStringThe regular expression to match.
replacementStringThe string that replaces the matched substring.
flagsString, default: ""A string specifying a combination of regular expression flags, specifically one or more of: 'g' (global match) or 'i' (ignore case)

ee.String.rindex

Searches a string for the last occurrence of a substring. Returns the index of the first match, or -1.

UsageReturns
String.rindex(pattern)Integer
ArgumentTypeDetails
this: targetStringThe string to search.
patternStringThe string to find.

ee.String.serialize

Returns the serialized representation of this object.

UsageReturns
String.serialize(legacy)String
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
legacyBoolean, optionalEnables legacy format.

ee.String.slice

Returns a substring of the given string. If the specified range exceeds the length of the string, returns a shorter substring.

UsageReturns
String.slice(start, end)String
ArgumentTypeDetails
this: stringStringThe string to subset.
startIntegerThe beginning index, inclusive. Negative numbers count backwards from the end of the string.
endInteger, default: nullThe ending index, exclusive. Defaults to the length of the string. Negative numbers count backwards from the end of the string.

ee.String.split

Splits a string on a regular expression, Returning a list of strings.

UsageReturns
String.split(regex, flags)List
ArgumentTypeDetails
this: stringStringThe string to split.
regexStringA regular expression to split on. If regex is the empty string, then the input string is split into individual characters.
flagsString, default: ""A string specifying the regular expression flag: 'i' (ignore case)

ee.String.toLowerCase

Converts all of the characters in a string to lower case.

UsageReturns
String.toLowerCase()String
ArgumentTypeDetails
this: stringStringThe string to convert to lower case.

ee.String.toUpperCase

Converts all of the characters in a string to upper case.

UsageReturns
String.toUpperCase()String
ArgumentTypeDetails
this: stringStringThe string to convert to upper case.

ee.String.trim

Returns a string whose value is the original string, with any leading and trailing whitespace removed.

UsageReturns
String.trim()String
ArgumentTypeDetails
this: stringStringThe string to trim.

ee.Terrain.aspect

Calculates aspect in degrees from a terrain DEM.

The local gradient is computed using the 4-connected neighbors of each pixel, so missing values will occur around the edges of an image.

UsageReturns
ee.Terrain.aspect(input)Image
ArgumentTypeDetails
inputImageAn elevation image, in meters.

ee.Terrain.fillMinima

Fills local minima. Only works on INT types.

UsageReturns
ee.Terrain.fillMinima(image, borderValue, neighborhood)Image
ArgumentTypeDetails
imageImageThe image to fill.
borderValueLong, default: nullThe border value.
neighborhoodInteger, default: 50The size of the neighborhood to compute over.

ee.Terrain.hillShadow

Creates a shadow band, with output 1 where pixels are illumunated and 0 where they are shadowed. Takes as input an elevation band, azimuth and zenith of the light source in degrees, a neighborhood size, and whether or not to apply hysteresis when a shadow appears. Currently, this algorithm only works for Mercator projections, in which light rays are parallel.

UsageReturns
ee.Terrain.hillShadow(image, azimuth, zenith, neighborhoodSize, hysteresis)Image
ArgumentTypeDetails
imageImageThe image to which to apply the shadow algorithm, in which each pixel should represent an elevation in meters.
azimuthFloatAzimuth in degrees.
zenithFloatZenith in degrees.
neighborhoodSizeInteger, default: 0Neighborhood size.
hysteresisBoolean, default: falseUse hysteresis. Less physically accurate, but may generate better images.

ee.Terrain.hillshade

Computes a simple hillshade from a DEM.

UsageReturns
ee.Terrain.hillshade(input, azimuth, elevation)Image
ArgumentTypeDetails
inputImageAn elevation image, in meters.
azimuthFloat, default: 270The illumination azimuth in degrees from north.
elevationFloat, default: 45The illumination elevation in degrees.

ee.Terrain.products

Calculates slope, aspect, and a simple hillshade from a terrain DEM.

Expects an image containing either a single band of elevation, measured in meters, or if there's more than one band, one named 'elevation'. Adds output bands named 'slope' and 'aspect' measured in degrees plus an unsigned byte output band named 'hillshade' for visualization. All other bands and metadata are copied from the input image. The local gradient is computed using the 4-connected neighbors of each pixel, so missing values will occur around the edges of an image.

UsageReturns
ee.Terrain.products(input)Image
ArgumentTypeDetails
inputImageAn elevation image, in meters.

ee.Terrain.slope

Calculates slope in degrees from a terrain DEM.

The local gradient is computed using the 4-connected neighbors of each pixel, so missing values will occur around the edges of an image.

UsageReturns
ee.Terrain.slope(input)Image
ArgumentTypeDetails
inputImageAn elevation image, in meters.

ee.apply

Call a function with a dictionary of named arguments.

Returns an object representing the called function. If the signature specifies a recognized return type, the returned value will be cast to that type.

UsageReturns
ee.apply(func, namedArgs)ComputedObject
ArgumentTypeDetails
funcFunction|StringThe function to call. Either an ee.Function object or the name of an API function.
namedArgsObjectA dictionary of arguments to the function.

ee.call

Call a function with the given positional arguments.

Returns an object representing the called function. If the signature specifies a recognized return type, the returned value will be cast to that type.

UsageReturns
ee.call(func, var_args)ComputedObject
ArgumentTypeDetails
funcFunction|StringThe function to call. Either an ee.Function object or the name of an API function.
var_argsVarArgsPositional arguments to pass to the function.

ee.data.authenticateViaOauth

Configures client-side authentication of EE API calls through the Google APIs Client Library for JavaScript. The library will be loaded automatically if it is not already loaded on the page. The user will be asked to grant the application identified by clientId access to their EE data if they have not done so previously.

This or another authentication method should be called before ee.initialize().

Note that if the user has not previously granted access to the application identified by the client ID, by default this will try to pop up a dialog window prompting the user to grant the required permission. However, this popup can be blocked by the browser. To avoid this, specify the opt_onImmediateFailed callback, and in it render an in-page login button, then call ee.data.authenticateViaPopup() from the click event handler of this button. This stops the browser from blocking the popup, as it is now the direct result of a user action.

The auth token will be refreshed automatically when possible. You can safely assume that all async calls will be sent with the appropriate credentials. For synchronous calls, however, you should check for an auth token with ee.data.getAuthToken() and call ee.data.refreshAuthToken() manually if there is none. The token refresh operation is asynchronous and cannot be performed behind-the-scenes on-demand prior to synchronous calls.

UsageReturns
ee.data.authenticateViaOauth(clientId, success, error, extraScopes, onImmediateFailed, suppressDefaultScopes)
ArgumentTypeDetails
clientIdStringThe application's OAuth client ID, or null to disable authenticated calls. This can be obtained through the Google Developers Console. The project must have a JavaScript origin that corresponds to the domain where the script is running.
successFunctionThe function to call if authentication succeeded.
errorFunction, optionalThe function to call if authentication failed, passed the error message. If authentication in immediate (behind-the-scenes) mode fails and opt_onImmediateFailed is specified, that function is called instead of opt_error.
extraScopesList, optionalExtra OAuth scopes to request.
onImmediateFailedFunction, optionalThe function to call if automatic behind-the-scenes authentication fails. Defaults to ee.data.authenticateViaPopup(), bound to the passed callbacks.
suppressDefaultScopesBoolean, optionalWhen true, only scopes specified in opt_extraScopes are requested; the default scopes are not requested unless explicitly specified in opt_extraScopes.

ee.data.authenticateViaPopup

Shows a popup asking for the user's permission. Should only be called if ee.data.authenticate() called its opt_onImmediateFailed argument in the past.

May be blocked by pop-up blockers if called outside a user-initiated handler.

UsageReturns
ee.data.authenticateViaPopup(success, error)
ArgumentTypeDetails
successFunction, optionalThe function to call if authentication succeeds.
errorFunction, optionalThe function to call if authentication fails, passing the error message.

ee.data.authenticateViaPrivateKey

Configures server-side authentication of EE API calls through the Google APIs Node.js Client. Private key authentication is strictly for server-side API calls: for browser-based applications, use ee.data.authenticateViaOauth(). No user interaction (e.g. authentication popup) is necessary when using server-side authentication.

This or another authentication method should be called before ee.initialize().

The auth token will be refreshed automatically when possible. You can safely assume that all async calls will be sent with the appropriate credentials. For synchronous calls, however, you should check for an auth token with ee.data.getAuthToken() and call ee.data.refreshAuthToken() manually if there is none. The token refresh operation is asynchronous and cannot be performed behind-the-scenes, on demand, prior to synchronous calls.

UsageReturns
ee.data.authenticateViaPrivateKey(privateKey, success, error, extraScopes, suppressDefaultScopes)
ArgumentTypeDetails
privateKeyAuthPrivateKeyJSON content of private key.
successFunction, optionalThe function to call if authentication succeeded.
errorFunction, optionalThe function to call if authentication failed, passed the error message.
extraScopesList, optionalExtra OAuth scopes to request.
suppressDefaultScopesBoolean, optionalWhen true, only scopes specified in opt_extraScopes are requested; the default scopes are not not requested unless explicitly specified in opt_extraScopes.

ee.data.cancelOperation

Cancels the given operation(s).

UsageReturns
ee.data.cancelOperation(operationName, callback)
ArgumentTypeDetails
operationNameListOperation name(s).
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously. The callback is passed an empty object.

ee.data.computeValue

Sends a request to compute a value.

Returns result

UsageReturns
ee.data.computeValue(obj, callback)Object|Value
ArgumentTypeDetails
objObject
callbackFunction, optional

ee.data.copyAsset

Copies the asset from sourceId into destinationId.

UsageReturns
ee.data.copyAsset(sourceId, destinationId, overwrite, callback)
ArgumentTypeDetails
sourceIdStringThe ID of the asset to copy.
destinationIdStringThe ID of the new asset created by copying.
overwriteBoolean, optionalOverwrite any existing destination asset ID.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously. The callback is passed an empty object and an error message, if any.

ee.data.createAsset

Creates an asset from a JSON value. To create an empty image collection or folder, pass in a "value" object with a "type" key whose value is one of ee.data.AssetType.* (i.e. "ImageCollection" or "Folder").

Returns a description of the saved asset, including a generated ID, or null if a callback is specified.

UsageReturns
ee.data.createAsset(value, path, force, properties, callback)Object
ArgumentTypeDetails
valueObjectAn object describing the asset to create.
pathString, optionalAn optional desired ID, including full path.
forceBoolean, optionalForce overwrite.
propertiesObject, optionalThe keys and values of the properties to set
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.data.createAssetHome

Attempts to create a home root folder (e.g. "users/joe") for the current user. This results in an error if the user already has a home root folder or the requested ID is unavailable.

UsageReturns
ee.data.createAssetHome(requestedId, callback)
ArgumentTypeDetails
requestedIdStringThe requested ID of the home folder (e.g. "users/joe").
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.data.createFolder

Creates an asset folder.

Returns a description of the newly created folder.

UsageReturns
ee.data.createFolder(path, force, callback)Object
ArgumentTypeDetails
pathStringThe path of the folder to create.
forceBoolean, optionalForce overwrite.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.data.deleteAsset

Deletes the asset with the given id.

UsageReturns
ee.data.deleteAsset(assetId, callback)
ArgumentTypeDetails
assetIdStringThe ID of the asset to delete.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously. The callback is passed an empty object and an error message, if any.

ee.data.getAsset

Load info for an asset, given an asset id.

Returns the value call results, or null if a callback is specified.

UsageReturns
ee.data.getAsset(id, callback)Object
ArgumentTypeDetails
idStringThe asset to be retrieved.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.data.getAssetAcl

Returns the access control list of the asset with the given ID.

The authenticated user must be a writer or owner of an asset to see its ACL.

UsageReturns
ee.data.getAssetAcl(assetId, callback)AssetAcl
ArgumentTypeDetails
assetIdStringThe ID of the asset to check.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.data.getAssetRootQuota

Returns quota usage details for the asset root with the given ID.

Usage notes:

  - The id must be a root folder like "users/foo" (not "users/foo/bar").

  - The authenticated user must own the asset root to see its quota usage.

UsageReturns
ee.data.getAssetRootQuota(rootId, callback)AssetQuotaDetails
ArgumentTypeDetails
rootIdStringThe ID of the asset root to check, e.g. "users/foo".
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.data.getDownloadId

Get a Download ID.

Returns a download id and token, or null if a callback is specified.

UsageReturns
ee.data.getDownloadId(params, callback)DownloadId
ArgumentTypeDetails
paramsObjectAn object containing download options with the following possible values:
name: a base name to use when constructing filenames. Only applicable when format is "ZIPPED_GEO_TIFF" (default) or filePerBand is true. Defaults to the image id (or "download" for computed images) when format is "ZIPPED_GEO_TIFF" or filePerBand is true, otherwise a random character string is generated. Band names are appended when filePerBand is true.
bands: a description of the bands to download. Must be an array of band names or an array of dictionaries, each with the following keys (optional parameters apply only when filePerBand is true):
  • id: the name of the band, a string, required.
  • crs: an optional CRS string defining the band projection.
  • crs_transform: an optional array of 6 numbers specifying an affine transform from the specified CRS, in row-major order: [xScale, xShearing, xTranslation, yShearing, yScale, yTranslation]
  • dimensions: an optional array of two integers defining the width and height to which the band is cropped.
  • scale: an optional number, specifying the scale in meters of the band; ignored if crs and crs_transform are specified.
crs: a default CRS string to use for any bands that do not explicitly specify one.
crs_transform: a default affine transform to use for any bands that do not specify one, of the same format as the crs_transform of bands.
dimensions: default image cropping dimensions to use for any bands that do not specify them.
scale: a default scale to use for any bands that do not specify one; ignored if crs and crs_transform are specified.
region: a polygon specifying a region to download; ignored if crs and crs_transform is specified.
filePerBand: whether to produce a separate GeoTIFF per band (boolean). Defaults to true. If false, a single GeoTIFF is produced and all band-level transformations will be ignored.
format: the download format. One of:
  • "ZIPPED_GEO_TIFF" (GeoTIFF file(s) wrapped in a zip file, default)
  • "GEO_TIFF" (GeoTIFF file)
  • "NPY" (NumPy binary format)
If "GEO_TIFF" or "NPY", filePerBand and all band-level transformations will be ignored. Loading a NumPy output results in a structured array.
id: deprecated, use image parameter.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.data.getFeatureViewTilesKey

Get a tiles key for a given map or asset. The tiles key can be passed to an instance of FeatureViewTileSource which can be rendered on a base map outside of the Code Editor.

Returns the call results. Null if a callback is specified.

UsageReturns
ee.data.getFeatureViewTilesKey(params, callback)FeatureViewTilesKey
ArgumentTypeDetails
paramsFeatureViewVisualizationParametersThe visualization parameters as a (client-side) JavaScript object. For FeatureView assets:
assetId (string) The asset ID for which to obtain a tiles key.
visParams (Object) The visualization parameters for this layer.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.data.getFilmstripThumbId

Get a Filmstrip Thumbnail Id for a given asset.

Returns the thumb ID and optional token, or null if a callback is specified.

UsageReturns
ee.data.getFilmstripThumbId(params, callback)ThumbnailId
ArgumentTypeDetails
paramsFilmstripThumbnailOptionsParameters to make the request with.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.data.getMapId

Get a Map ID for a given asset

Returns the mapId call results, which may be passed to ee.data.getTileUrl or ui.Map.addLayer. Null if a callback is specified.

UsageReturns
ee.data.getMapId(params, callback)RawMapId
ArgumentTypeDetails
paramsImageVisualizationParametersThe visualization parameters as a (client-side) JavaScript object. For Images and ImageCollections:
image (JSON string) The image to render.
version (number) Version number of image (or latest).
bands (comma-separated strings) Comma-delimited list of band names to be mapped to RGB.
min (comma-separated numbers) Value (or one per band) to map onto 00.
max (comma-separated numbers) Value (or one per band) to map onto FF.
gain (comma-separated numbers) Gain (or one per band) to map onto 00-FF.
bias (comma-separated numbers) Offset (or one per band) to map onto 00-FF.
gamma (comma-separated numbers) Gamma correction factor (or one per band).
palette (comma-separated strings) List of CSS-style color strings (single-band previews only).
opacity (number) a number between 0 and 1 for opacity.
format (string) Either "jpg" or "png".
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.data.getOperation

Gets information on an operation or list of operations.

See more details on Operations here: https://cloud.google.com/apis/design/design_patterns#long_running_operations

Returns operation status, or a map from operation names to status. Each Operation contains:

  - name: operation name in the format projects/X/operations/Y

  - done: true when operation has finished running.

  - error: may be set when done=true. Contains message and other fields from https://cloud.google.com/tasks/docs/reference/rpc/google.rpc#status

  - metadata, which contains

    + state: PENDING, RUNNING, CANCELLING, SUCCEEDED, CANCELLED, or FAILED

    + description: Supplied task description

    + type: EXPORT_IMAGE, EXPORT_FEATURES, etc.

    + create_time: Time the operation was first submitted.

    + update_time: Timestamp of most recent update.

    + start_time: Time the operation started, when so.

    + end_time: Time the operation finished running, when so.

    + attempt: Number of retries of this task, starting at 1.

    + destination_uris: Resources output by this operation.

    + batch_eecu_usage_seconds: CPU used by this operation.

UsageReturns
ee.data.getOperation(operationName, callback)Dictionary|api.Operation
ArgumentTypeDetails
operationNameListOperation name(s).
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.data.getTableDownloadId

Get a download ID.

Returns a download id and token, or null if a callback is specified.

UsageReturns
ee.data.getTableDownloadId(params, callback)DownloadId
ArgumentTypeDetails
paramsObjectAn object containing table download options with the following possible values:
table: The feature collection to download.
format: The download format, CSV, JSON, KML, KMZ or TF_RECORD.
selectors: List of strings of selectors that can be used to determine which attributes will be downloaded.
filename: The name of the file that will be downloaded.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.data.getThumbId

Get a Thumbnail Id for a given asset.

Returns the thumb ID and optional token, or null if a callback is specified.

UsageReturns
ee.data.getThumbId(params, callback)ThumbnailId
ArgumentTypeDetails
paramsThumbnailOptionsAn object containing thumbnail options with the following possible values:
image (ee.Image) The image to make a thumbnail.
bands (array of strings) An array of band names.
format (string) The file format ("png", "jpg", "geotiff").
name (string): The base name.
Use ee.Image.getThumbURL for region, dimensions, and visualization options support.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.data.getTileUrl

Generate a URL for map tiles from a Map ID and coordinates. If formatTileUrl is not present, we generate it by using or guessing the urlFormat string, and add urlFormat and formatTileUrl to id for future use.

Returns the tile URL.

UsageReturns
ee.data.getTileUrl(id, x, y, z)String
ArgumentTypeDetails
idRawMapIdThe Map ID to generate tiles for.
xNumberThe tile x coordinate.
yNumberThe tile y coordinate.
zNumberThe tile zoom level.

ee.data.getVideoThumbId

Get a Video Thumbnail Id for a given asset.

Returns the thumb ID and optional token, or null if a callback is specified.

UsageReturns
ee.data.getVideoThumbId(params, callback)ThumbnailId
ArgumentTypeDetails
paramsVideoThumbnailOptionsParameters to make the request with.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.data.getWorkloadTag

Returns the currently set workload tag.

UsageReturns
ee.data.getWorkloadTag()String

No arguments.

ee.data.listAssets

Returns a list of the contents in an asset collection or folder, in an object that includes an `assets` array and an optional `nextPageToken`.
UsageReturns
ee.data.listAssets(parent, params, callback)api.ListAssetsResponse
ArgumentTypeDetails
parentStringThe ID of the collection or folder to list.
paramsapi.ProjectsAssetsListAssetsNamedParameters, optionalAn object containing optional request parameters with the following possible values:
pageSize (string) The number of results to return. Defaults to 1000.
pageToken (string) The token for the page of results to return.
filter (string) An additional filter query to apply. Example query: properties.my_property>=1 AND properties.my_property<2 AND startTime >= "2019-01-01T00:00:00.000Z" AND endTime < "2020-01-01T00:00:00.000Z" AND intersects("{'type':'Point','coordinates':[0,0]}") See https://google.aip.dev/160 for how to construct a query.
view (string) Specifies how much detail is returned in the list. Either "FULL" (default) for all image properties or "BASIC".
callbackFunction, optionalIf not supplied, the call is made synchronously.

ee.data.listBuckets

Returns top-level assets and folders for the Cloud Project or user. Leave the project field blank to use the current project.

UsageReturns
ee.data.listBuckets(project, callback)api.ListAssetsResponse
ArgumentTypeDetails
projectString, optionalProject to query, e.g. "projects/my-project". Defaults to current project. Use "projects/earthengine-legacy" for user home folders.
callbackFunction, optionalIf not supplied, the call is made synchronously.

ee.data.listFeatures

List features for a given table asset.

Returns the call results. Null if a callback is specified.

UsageReturns
ee.data.listFeatures(asset, params, callback)api.ListFeaturesResponse
ArgumentTypeDetails
assetStringThe table asset ID to query.
paramsapi.ProjectsAssetsListFeaturesNamedParametersAn object containing request parameters with the following possible values:
pageSize (number): An optional maximum number of results per page, default is 1000.
pageToken (string): An optional token identifying a page of results the server should return, usually taken from the response object.
region (string): If present, a geometry defining a query region, specified as a GeoJSON geometry string (see RFC 7946).
filter (comma-separated strings): If present, specifies additional simple property filters (see https://google.aip.dev/160).
callbackFunction, optionalAn optional callback, called with two parameters: the first is the resulting list of features and the second is an error string on failure. If not supplied, the call is made synchronously.

ee.data.listImages

Returns a list of the contents in an image collection, in an object that includes an images array and an optional nextPageToken.

UsageReturns
ee.data.listImages(parent, params, callback)ListImagesResponse
ArgumentTypeDetails
parentStringThe ID of the image collection to list.
paramsObject, optionalAn object containing optional request parameters with the following possible values:
pageSize (string) The number of results to return. Defaults to 1000.
pageToken (string) The token page of results to return.
startTime (ISO 8601 string) The minimum start time (inclusive).
endTime (ISO 8601 string) The maximum end time (exclusive).
region (GeoJSON or WKT string) A region to filter on.
properties (list of strings) A list of property filters to apply, for example: ["classification=urban", "size>=2"].
filter (string) An additional filter query to apply. Example query: properties.my_property>=1 AND properties.my_property<2 AND startTime >= "2019-01-01T00:00:00.000Z" AND endTime < "2020-01-01T00:00:00.000Z" AND intersects("{'type':'Point','coordinates':[0,0]}") See https://google.aip.dev/160 for how to construct a query.
view (string) Specifies how much detail is returned in the list. Either "FULL" (default) for all image properties or "BASIC".
callbackFunction, optionalIf not supplied, the call is made synchronously.

ee.data.listOperations

Returns see getOperation for details on the Operation object.

UsageReturns
ee.data.listOperations(limit, callback)List
ArgumentTypeDetails
limitNumber, optionalMaximum number of results to return.
callbackFunction, optional

ee.data.makeDownloadUrl

Create a download URL from a docid and token.

Returns the download URL.

UsageReturns
ee.data.makeDownloadUrl(id)String
ArgumentTypeDetails
idDownloadIdA download id and token.

ee.data.makeTableDownloadUrl

Create a table download URL from a docid and token.

Returns the download URL.

UsageReturns
ee.data.makeTableDownloadUrl(id)String
ArgumentTypeDetails
idDownloadIdA table download id and token.

ee.data.makeThumbUrl

Create a thumbnail URL from a thumbid and token.

Returns the thumbnail URL.

UsageReturns
ee.data.makeThumbUrl(id)String
ArgumentTypeDetails
idThumbnailIdA thumbnail ID and token.

ee.data.newTaskId

Generates an "unsubmitted" ID for a long-running task.

Before tasks are submitted, they may be assigned IDs to track them. The server ensures that the same ID cannot be reused. These IDs have a UUID format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

Tasks that are running on the server have a ID without hyphens. This is returned by ee.data.startProcessing and other batch methods.

Returns an array containing generated ID strings, or null if a callback is specified.

UsageReturns
ee.data.newTaskId(count, callback)List
ArgumentTypeDetails
countNumber, optionalThe number of IDs to generate, one by default.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.data.renameAsset

Renames the asset from sourceId to destinationId.

UsageReturns
ee.data.renameAsset(sourceId, destinationId, callback)
ArgumentTypeDetails
sourceIdStringThe ID of the asset to rename.
destinationIdStringThe new ID of the asset.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously. The callback is passed an empty object and an error message, if any.

ee.data.resetWorkloadTag

Resets the tag back to the default. If resetDefault parameter is set to true, the default will be set to empty before resetting.

UsageReturns
ee.data.resetWorkloadTag(resetDefault)
ArgumentTypeDetails
resetDefaultBoolean, optional

ee.data.setAssetAcl

Sets the access control list of the asset with the given ID.

The owner ACL cannot be changed, and the final ACL of the asset is constructed by merging the OWNER entries of the old ACL with the incoming ACL record.

The authenticated user must be a writer or owner of an asset to set its ACL.

UsageReturns
ee.data.setAssetAcl(assetId, aclUpdate, callback)
ArgumentTypeDetails
assetIdStringThe ID of the asset to set the ACL on.
aclUpdateAssetAclUpdateThe updated ACL.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously. The callback is passed an empty object.

ee.data.setDefaultWorkloadTag

Sets the workload tag, and as the default for which to reset back to.

For example, calling ee.data.resetWorkloadTag() will reset the workload tag back to the default chosen here. To reset the default back to none, pass in an empty string or pass in true to ee.data.resetWorkloadTag(true), like so.

Workload tag must be 1 - 63 characters, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots

(.), and alphanumerics between, or an empty string to reset the default back to none.

UsageReturns
ee.data.setDefaultWorkloadTag(tag)
ArgumentTypeDetails
tagString

ee.data.setWorkloadTag

Sets the workload tag, used to label computation and exports.

Workload tag must be 1 - 63 characters, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots

(.), and alphanumerics between, or an empty string to clear the workload tag.

UsageReturns
ee.data.setWorkloadTag(tag)
ArgumentTypeDetails
tagString

ee.data.startIngestion

Creates an image asset ingestion task.

See ee.data.startProcessing for details on task IDs and response format.

UsageReturns
ee.data.startIngestion(taskId, request, callback)ProcessingResponse
ArgumentTypeDetails
taskIdStringUnsubmitted ID for the task (obtained from newTaskId).
requestIngestionRequestThe object that describes the ingestion.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.data.startProcessing

Create processing task that exports or pre-renders an image.

Return value is null if a callback is specified.

Returns an object with fields:

  - taskId: Submitted task ID (without hyphens).

  - name: Full operation name in the format projects/X/operations/Y

  - started: will be 'OK'

  - note: may have value 'ALREADY_EXISTS' if an identical task with the same unsubmitted ID already exists.

UsageReturns
ee.data.startProcessing(taskId, params, callback)ProcessingResponse
ArgumentTypeDetails
taskIdStringUnsubmitted ID for the task (obtained from newTaskId). Used to identify duplicated tasks; may be null. The server will create and return a submitted ID.
paramsObjectThe object that describes the processing task; only fields that are common for all processing types are documented here. type (string) Either 'EXPORT_IMAGE', 'EXPORT_FEATURES', 'EXPORT_VIDEO' or 'EXPORT_TILES'. json (string) JSON description of the image.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.data.startTableIngestion

Creates a table asset ingestion task.

See ee.data.startProcessing for details on task IDs and response format.

UsageReturns
ee.data.startTableIngestion(taskId, request, callback)ProcessingResponse
ArgumentTypeDetails
taskIdStringUnsubmitted ID for the task (obtained from newTaskId).
requestTableIngestionRequestThe object that describes the ingestion.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.data.updateAsset

Updates an asset.

The authenticated user must be a writer or owner of the asset.

UsageReturns
ee.data.updateAsset(assetId, asset, updateFields, callback)Object
ArgumentTypeDetails
assetIdStringThe ID of the asset to update.
assetapi.EarthEngineAssetThe updated version of the asset, containing only the new values of the fields to be updated. Only the "start_time", "end_time", and "properties" fields can be updated. If a value is named in "updateMask", but is unset in "asset", then that value will be deleted from the asset.
updateFieldsListA list of the field names to update. This may contain: "start_time" or "end_time" to update the corresponding timestamp, "properties.PROPERTY_NAME" to update a given property, or "properties" to update all properties. If the list is empty, all properties and both timestamps will be updated.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.data.updateTask

Update one or more tasks' properties. For now, only the following properties may be updated: State (to CANCELLED)

Returns an array of updated tasks, or null if a callback is specified.

UsageReturns
ee.data.updateTask(taskId, action, callback)List
ArgumentTypeDetails
taskIdListSubmitted ID of the task or an array of multiple task IDs. May also contain operation names.
actionTaskUpdateActionsAction performed on tasks.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

ee.initialize

Initialize the library. If this hasn't been called by the time any object constructor is used, it will be called then. If this is called a second time with a different baseurl or tileurl, this doesn't do an un-initialization of e.g.: the previously loaded Algorithms, but will overwrite them and let point at alternate servers.

If initialize() is first called in asynchronous mode (by passing a success callback), any future asynchronous mode calls will add their callbacks to a queue and all the callbacks will be run together.

If a synchronous mode call is made after any number of asynchronous calls, it will block and execute all the previously supplied callbacks before returning.

In most cases, an authorization token should be set before the library is initialized, either with ee.data.authorize() or ee.data.setAuthToken().

In Python, this method is named ee.Initialize, with a capital I. Note that some parameters differ between JavaScript and Python. In addition to opt_url and project below, Python also supports: credentials - a google.oauth2.Credentials object or 'persistent' to use stored credentials (the default); http_transport - a httplib2.Http client.

UsageReturns
ee.initialize(baseurl, tileurl, successCallback, errorCallback, xsrfToken, project)
ArgumentTypeDetails
baseurlString, optionalThe Earth Engine REST API endpoint. (Python argument name: opt_url)
tileurlString, optionalThe Earth Engine REST tile endpoint, this is optional and defaults to baseurl. (JavaScript only)
successCallbackFunction, optionalAn optional callback to be invoked when the initialization is successful. If not provided, the initialization is done synchronously. (JavaScript only)
errorCallbackFunction, optionalAn optional callback to be invoked with an error if the initialization fails. (JavaScript only)
xsrfTokenString, optionalA string to pass in the "xsrfToken" parameter of EE API XHRs. (JavaScript only)
projectString, optionalOptional client project ID or number to use when making API calls. (Python argument name: project)

ee.reset

Reset the library to its base state. Useful for re-initializing to a different server.

UsageReturns
ee.reset()

No arguments.

Export.classifier.toAsset

Creates a batch task to export an ee.Classifier as an Earth Engine asset.
UsageReturns
Export.classifier.toAsset(classifier, description, assetId)
ArgumentTypeDetails
classifierComputedObjectThe classifier to export.
descriptionString, optionalA human-readable name of the task. Defaults to "myExportClassifierTask".
assetIdString, optionalThe destination asset ID.

Export.image.toAsset

Creates a batch task to export an Image as a raster to an Earth Engine asset. Tasks can be started from the Tasks tab.

UsageReturns
Export.image.toAsset(image, description, assetId, pyramidingPolicy, dimensions, region, scale, crs, crsTransform, maxPixels, shardSize, priority)
ArgumentTypeDetails
imageImageThe image to export.
descriptionString, optionalA human-readable name of the task. Defaults to "myExportImageTask".
assetIdString, optionalThe destination asset ID.
pyramidingPolicyObject, optionalThe pyramiding policy to apply to each band in the image, keyed by band name. Values must be one of: mean, sample, min, max, or mode. Defaults to "mean". A special key, ".default" may be used to change the default for all bands.
dimensionsNumber|String, optionalThe dimensions to use for the exported image. Takes either a single positive integer as the maximum dimension or "WIDTHxHEIGHT" where WIDTH and HEIGHT are each positive integers.
regionGeometry.LinearRing|Geometry.Polygon|String, optionalA LinearRing, Polygon, or coordinates representing region to export. These may be specified as the Geometry objects or coordinates serialized as a string.
scaleNumber, optionalResolution in meters per pixel. Defaults to 1000.
crsString, optionalCRS to use for the exported image.
crsTransformList, optionalAffine transform to use for the exported image. Requires "crs" to be defined.
maxPixelsNumber, optionalRestrict the number of pixels in the export. By default, you will see an error if the export exceeds 1e8 pixels. Setting this value explicitly allows one to raise or lower this limit.
shardSizeNumber, optionalSize in pixels of the tiles in which this image will be computed. Defaults to 256.
priorityNumber, optionalThe priority of the task within the project. Higher priority tasks are scheduled sooner. Must be an integer between 0 and 9999. Defaults to 100.

Export.image.toCloudStorage

Creates a batch task to export an Image as a raster to Google Cloud Storage. Tasks can be started from the Tasks tab.

"crsTransform", "scale", and "dimensions" are mutually exclusive.

UsageReturns
Export.image.toCloudStorage(image, description, bucket, fileNamePrefix, dimensions, region, scale, crs, crsTransform, maxPixels, shardSize, fileDimensions, skipEmptyTiles, fileFormat, formatOptions, priority)
ArgumentTypeDetails
imageImageThe image to export.
descriptionString, optionalA human-readable name of the task. Defaults to "myExportImageTask".
bucketString, optionalThe Cloud Storage destination bucket.
fileNamePrefixString, optionalThe string used as the output's prefix. A trailing "/" indicates a path. Defaults to the task's description.
dimensionsNumber|String, optionalThe dimensions to use for the exported image. Takes either a single positive integer as the maximum dimension or "WIDTHxHEIGHT" where WIDTH and HEIGHT are each positive integers.
regionGeometry.LinearRing|Geometry.Polygon|String, optionalA LinearRing, Polygon, or coordinates representing region to export. These may be specified as the Geometry objects or coordinates serialized as a string.
scaleNumber, optionalResolution in meters per pixel. Defaults to 1000.
crsString, optionalCRS to use for the exported image.
crsTransformList, optionalAffine transform to use for the exported image. Requires "crs" to be defined.
maxPixelsNumber, optionalRestrict the number of pixels in the export. By default, you will see an error if the export exceeds 1e8 pixels. Setting this value explicitly allows one to raise or lower this limit.
shardSizeNumber, optionalSize in pixels of the tiles in which this image will be computed. Defaults to 256.
fileDimensionsList, optionalThe dimensions in pixels of each image file, if the image is too large to fit in a single file. May specify a single number to indicate a square shape, or an array of two dimensions to indicate (width,height). Note that the image will still be clipped to the overall image dimensions. Must be a multiple of shardSize.
skipEmptyTilesBoolean, optionalIf true, skip writing empty (i.e. fully-masked) image tiles. Defaults to false. Only supported on GeoTIFF exports.
fileFormatString, optionalThe string file format to which the image is exported. Currently only 'GeoTIFF' and 'TFRecord' are supported, defaults to 'GeoTIFF'.
formatOptionsImageExportFormatConfig, optionalA dictionary of string keys to format-specific options. For 'GeoTIFF': 'cloudOptimized' (Boolean), 'noData' (float). For 'TFRecord': see https://developers.google.com/earth-engine/guides/tfrecord#formatoptions
priorityNumber, optionalThe priority of the task within the project. Higher priority tasks are scheduled sooner. Must be an integer between 0 and 9999. Defaults to 100.

Export.image.toDrive

Creates a batch task to export an Image as a raster to Drive. Tasks can be started from the Tasks tab. "crsTransform", "scale", and "dimensions" are mutually exclusive.

UsageReturns
Export.image.toDrive(image, description, folder, fileNamePrefix, dimensions, region, scale, crs, crsTransform, maxPixels, shardSize, fileDimensions, skipEmptyTiles, fileFormat, formatOptions, priority)
ArgumentTypeDetails
imageImageThe image to export.
descriptionString, optionalA human-readable name of the task. May contain letters, numbers, -, _ (no spaces). Defaults to "myExportImageTask".
folderString, optionalThe Google Drive Folder that the export will reside in. Note: (a) if the folder name exists at any level, the output is written to it, (b) if duplicate folder names exist, output is written to the most recently modified folder, (c) if the folder name does not exist, a new folder will be created at the root, and (d) folder names with separators (e.g. 'path/to/file') are interpreted as literal strings, not system paths. Defaults to Drive root.
fileNamePrefixString, optionalThe filename prefix. May contain letters, numbers, -, _ (no spaces). Defaults to the description.
dimensionsNumber|String, optionalThe dimensions to use for the exported image. Takes either a single positive integer as the maximum dimension or "WIDTHxHEIGHT" where WIDTH and HEIGHT are each positive integers.
regionGeometry.LinearRing|Geometry.Polygon|String, optionalA LinearRing, Polygon, or coordinates representing region to export. These may be specified as the Geometry objects or coordinates serialized as a string.
scaleNumber, optionalResolution in meters per pixel. Defaults to 1000.
crsString, optionalCRS to use for the exported image.
crsTransformList, optionalAffine transform to use for the exported image. Requires "crs" to be defined.
maxPixelsNumber, optionalRestrict the number of pixels in the export. By default, you will see an error if the export exceeds 1e8 pixels. Setting this value explicitly allows one to raise or lower this limit.
shardSizeNumber, optionalSize in pixels of the tiles in which this image will be computed. Defaults to 256.
fileDimensionsList, optionalThe dimensions in pixels of each image file, if the image is too large to fit in a single file. May specify a single number to indicate a square shape, or an array of two dimensions to indicate (width,height). Note that the image will still be clipped to the overall image dimensions. Must be a multiple of shardSize.
skipEmptyTilesBoolean, optionalIf true, skip writing empty (i.e. fully-masked) image tiles. Defaults to false. Only supported on GeoTIFF exports.
fileFormatString, optionalThe string file format to which the image is exported. Currently only 'GeoTIFF' and 'TFRecord' are supported, defaults to 'GeoTIFF'.
formatOptionsImageExportFormatConfig, optionalA dictionary of string keys to format-specific options. For 'GeoTIFF': 'cloudOptimized' (Boolean), 'noData' (float). For 'TFRecord': see https://developers.google.com/earth-engine/guides/tfrecord#formatoptions
priorityNumber, optionalThe priority of the task within the project. Higher priority tasks are scheduled sooner. Must be an integer between 0 and 9999. Defaults to 100.

Export.map.toCloudStorage

Creates a batch task to export an Image as a rectangular pyramid of map tiles for use with web map viewers. The map tiles will be accompanied by a reference index.html file that displays them using the Google Maps API, and an earth.html file for opening the map on Google Earth.

UsageReturns
Export.map.toCloudStorage(image, description, bucket, fileFormat, path, writePublicTiles, maxZoom, scale, minZoom, region, skipEmptyTiles, mapsApiKey, bucketCorsUris, priority)
ArgumentTypeDetails
imageImageThe image to export as tiles.
descriptionString, optionalA human-readable name of the task. Defaults to "myExportMapTask".
bucketString, optionalThe destination bucket to write to.
fileFormatString, optionalThe map tiles' file format, one of "auto", "png", or "jpg". Defaults to "auto", which means that opaque tiles will be encoded as "jpg" and tiles with transparency will be encoded as "png".
pathString, optionalThe string used as the output's path. A trailing "/" is optional. Defaults to the task's description.
writePublicTilesBoolean, optionalWhether to write public tiles instead of using the bucket's default object ACL. Defaults to true and requires invoker to be OWNER of bucket.
maxZoomNumber, optionalThe maximum zoom level of the map tiles to export.
scaleNumber, optionalThe max image resolution in meters per pixel, as an alternative to "maxZoom". The scale will be converted to the most appropriate maximum zoom level at the equator.
minZoomNumber, optionalThe optional minimum zoom level of the map tiles to export. Defaults to zero.
regionGeometry.LinearRing|Geometry.Polygon|String, optionalA LinearRing, Polygon, or coordinates representing region to export. These may be specified as the Geometry objects or coordinates serialized as a string. Map tiles will be produced in the rectangular region containing this geometry.
skipEmptyTilesBoolean, optionalIf true, skip writing empty (i.e. fully-transparent) map tiles. Defaults to false. Only supported on GeoTIFF exports.
mapsApiKeyString, optionalUsed in index.html to initialize the Google Maps API. This removes the "development purposes only" message from the map.
bucketCorsUrisList, optionalA list of domains (e.g. https://code.earthengine.google.com) that are allowed to retrieve the exported tiles from JavaScript. Setting the tiles to public is not enough to allow them to be accessible by a web page, so you must explicitly give domains access to the bucket. This is known as Cross-Origin-Resource-Sharing, or CORS. You can allow all domains to have access using "*", but this is generally discouraged. See https://cloud.google.com/storage/docs/cross-origin for more details.
priorityNumber, optionalThe priority of the task within the project. Higher priority tasks are scheduled sooner. Must be an integer between 0 and 9999. Defaults to 100.

Export.table.toAsset

Creates a batch task to export a feature collection to an Earth Engine table asset. Tasks can be started from the Tasks tab.

UsageReturns
Export.table.toAsset(collection, description, assetId, maxVertices, priority)
ArgumentTypeDetails
collectionFeatureCollectionThe feature collection to export.
descriptionString, optionalA human-readable name of the task. Defaults to "myExportTableTask".
assetIdString, optionalThe destination asset ID.
maxVerticesNumber, optionalMax number of uncut vertices per geometry; geometries with more vertices will be cut into pieces smaller than this size.
priorityNumber, optionalThe priority of the task within the project. Higher priority tasks are scheduled sooner. Must be an integer between 0 and 9999. Defaults to 100.

Export.table.toBigQuery

Creates a batch task to export a FeatureCollection to BigQuery. Tasks can be started from the Tasks tab.

Note that this feature is in Preview, and the API and behavior may change significantly. For more information, see https://developers.google.com/earth-engine/guides/export_to_bigquery

UsageReturns
Export.table.toBigQuery(collection, description, table, overwrite, append, selectors, maxVertices, priority)
ArgumentTypeDetails
collectionFeatureCollectionThe feature collection to export.
descriptionString, optionalA human-readable name of the task. Defaults to "myExportTableTask".
tableString, optionalThe fully-qualifed BigQuery destination table in the following format: "project_id.dataset_id.table_id".
overwriteBoolean, optional[Not yet supported.] Whether the existing table should be overwritten by the result of this export. Defaults to false. The `overwrite` and `append` parameters cannot be `true` simultaneously. The export fails if the table already exists and both `overwrite` and `append` are `false`.
appendBoolean, optionalWhether table data should be appended if the table already exists and has a compatible schema. Defaults to false. The `overwrite` and `append` parameters cannot be `true` simultaneously. The export fails if the table already exists and both `overwrite` and `append` are `false`.
selectorsList, optionalA list of properties to include in the export; either a single string with comma-separated names or a list of strings.
maxVerticesNumber, optionalMax number of uncut vertices per geometry; geometries with more vertices will be cut into pieces smaller than this size.
priorityNumber, optionalThe priority of the task within the project. Higher priority tasks are scheduled sooner. Must be an integer between 0 and 9999. Defaults to 100.

Export.table.toCloudStorage

Creates a batch task to export a FeatureCollection as a table to Google Cloud Storage. Tasks can be started from the Tasks tab.

UsageReturns
Export.table.toCloudStorage(collection, description, bucket, fileNamePrefix, fileFormat, selectors, maxVertices, priority)
ArgumentTypeDetails
collectionFeatureCollectionThe feature collection to export.
descriptionString, optionalA human-readable name of the task. Defaults to "myExportTableTask".
bucketString, optionalThe Cloud Storage destination bucket.
fileNamePrefixString, optionalThe string used as the output's prefix. A trailing "/" indicates a path. Defaults to the description.
fileFormatString, optionalThe output format: "CSV" (default), "GeoJSON", "KML", "KMZ", "SHP", or "TFRecord".
selectorsList, optionalA list of properties to include in the export; either a single string with comma-separated names or a list of strings.
maxVerticesNumber, optionalMax number of uncut vertices per geometry; geometries with more vertices will be cut into pieces smaller than this size.
priorityNumber, optionalThe priority of the task within the project. Higher priority tasks are scheduled sooner. Must be an integer between 0 and 9999. Defaults to 100.

Export.table.toDrive

Creates a batch task to export a FeatureCollection as a table to Drive. Tasks can be started from the Tasks tab.

UsageReturns
Export.table.toDrive(collection, description, folder, fileNamePrefix, fileFormat, selectors, maxVertices, priority)
ArgumentTypeDetails
collectionFeatureCollectionThe feature collection to export.
descriptionString, optionalA human-readable name of the task. May contain letters, numbers, -, _ (no spaces). Defaults to "myExportTableTask".
folderString, optionalThe Google Drive Folder that the export will reside in. Note: (a) if the folder name exists at any level, the output is written to it, (b) if duplicate folder names exist, output is written to the most recently modified folder, (c) if the folder name does not exist, a new folder will be created at the root, and (d) folder names with separators (e.g. 'path/to/file') are interpreted as literal strings, not system paths. Defaults to Drive root.
fileNamePrefixString, optionalThe filename prefix. May contain letters, numbers, -, _ (no spaces). Defaults to the description.
fileFormatString, optionalThe output format: "CSV" (default), "GeoJSON", "KML", "KMZ", or "SHP", or "TFRecord".
selectorsList, optionalA list of properties to include in the export; either a single string with comma-separated names or a list of strings.
maxVerticesNumber, optionalMax number of uncut vertices per geometry; geometries with more vertices will be cut into pieces smaller than this size.
priorityNumber, optionalThe priority of the task within the project. Higher priority tasks are scheduled sooner. Must be an integer between 0 and 9999. Defaults to 100.

Export.table.toFeatureView

Creates a batch task to export a FeatureCollection to a FeatureView asset. Tasks can be started from the Tasks tab.

UsageReturns
Export.table.toFeatureView(collection, description, assetId, maxFeaturesPerTile, thinningStrategy, thinningRanking, zOrderRanking, priority)
ArgumentTypeDetails
collectionFeatureCollectionThe feature collection to export.
descriptionString, optionalA human-readable name of the task. May contain letters, numbers, -, _ (no spaces). Defaults to "myExportTableTask".
assetIdString, optionalThe destination asset ID. May contain letters, numbers, -, _, and / (no spaces).
maxFeaturesPerTileNumber, optionalThe max number of features that can intersect a tile. Can be a value between 0 and 2000; defaults to 500. Warning: Setting the max number of features to a value higher than 1000 may result in dropped tiles.
thinningStrategyString, optionalThe thinning strategy to use. Can either be HIGHER_DENSITY or GLOBALLY_CONSISTENT. Defaults to HIGHER_DENSITY. When thinning at a particular level of detail on the map, a higher density thinning strategy means that it tries to come as close as possible to the maxFeaturesPerTile limit for each tile. Globally-consistent thinning means that if a feature is removed by thinning, then all other features with equal or worse thinning rank will also be removed.
thinningRankingList, optionalComma-separated ranking rules defining the priority of how features should be thinned on the map. Defaults to ".minZoomLevel ASC". Each rule should be defined by a rule type and a direction (ASC or DESC), separated by a space. Valid rule types are: ".geometryType", ".minZoomLevel", or a feature property name. The value ".geometryType" refers to points, lines, and polygons. The value ".minZoomLevel" refers to the minimum zoom level that a feature is visible. Points are visible at all zoom levels, so they have the smallest minZoomLevel. For example, a valid set of ranking rules could be: 'my-property DESC, .geometryType ASC, .minZoomLevel ASC'. The same set of rules expressed as a list of strings would be: ['my-property DESC', '.geometryType ASC', '.minZoomLevel ASC']. This means when thinning at a particular level of detail on the map, prioritize features with a larger "my-property" value first (thin features with a smaller value of "my-property"), prioritize features with a smaller geometry type (e.g. thin out polygons before lines and thinning out lines before points), and prioritize features with a smaller minimum zoom level (points over large polygons over smaller polygons).
zOrderRankingList, optionalComma-separated ranking rules defining the z-order (stack order) of features displayed on the map. Defaults to ".minZoomLevel ASC". Uses the same format as thinningRanking. Each rule should be defined by a rule type and a direction (ASC or DESC), separated by a space. Valid rule types are: ".geometryType", ".minZoomLevel", or a feature property name. The value ".geometryType" refers to points, lines, and polygons. The value ".minZoomLevel" refers to the minimum zoom level that a feature is visible. Points are visible at all zoom levels, so they have the smallest minZoomLevel. For example, a valid set of ranking rules could be: 'my-property DESC, .geometryType ASC, .minZoomLevel ASC'. The same set of rules expressed as a list of strings would be: ['my-property DESC', '.geometryType ASC', '.minZoomLevel ASC']. This means when determining z-order of features at a particular level of detail on the map, features with a larger "my-property" value appear under features with a smaller value, features with a smaller geometry type appear under features with a larger geometry type (e.g. points under lines and lines under polygons), and features with a smaller min zoom level (larger features) appear under features with a larger min zoom level (smaller features).
priorityNumber, optionalThe priority of the task within the project. Higher priority tasks are scheduled sooner. Must be an integer between 0 and 9999. Defaults to 100.

Export.video.toCloudStorage

Creates a batch task to export an ImageCollection as a video to Google Cloud Storage. The collection must only contain RGB images. Tasks can be started from the Tasks tab. "crsTransform", "scale", and "dimensions" are mutually exclusive.

UsageReturns
Export.video.toCloudStorage(collection, description, bucket, fileNamePrefix, framesPerSecond, dimensions, region, scale, crs, crsTransform, maxPixels, maxFrames, priority)
ArgumentTypeDetails
collectionImageCollectionThe image collection to export.
descriptionString, optionalA human-readable name of the task. Defaults to "myExportVideoTask".
bucketString, optionalThe Cloud Storage destination bucket.
fileNamePrefixString, optionalThe string used as the output's prefix. A trailing "/" indicates a path. Defaults to the description.
framesPerSecondNumber, optionalThe framerate of the exported video. Must be a value between 0.1 and 100. Defaults to 1.
dimensionsNumber|String, optionalThe dimensions to use for the exported image. Takes either a single positive integer as the maximum dimension or "WIDTHxHEIGHT" where WIDTH and HEIGHT are each positive integers.
regionGeometry.LinearRing|Geometry.Polygon|String, optionalA LinearRing, Polygon, or coordinates representing region to export. These may be specified as the Geometry objects or coordinates serialized as a string.
scaleNumber, optionalResolution in meters per pixel.
crsString, optionalCRS to use for the exported image. Defaults to the Google Maps Mercator projection, SR-ORG:6627.
crsTransformString, optionalAffine transform to use for the exported image. Requires "crs" to be defined.
maxPixelsNumber, optionalRestrict the number of pixels in the export. By default, you will see an error if the export exceeds 1e8 pixels. Setting this value explicitly allows one to raise or lower this limit.
maxFramesNumber, optionalSet the maximum number of frames to export. By default, a maximum of 1000 frames may be exported. By setting this explicitly, you may raise or lower this limit.
priorityNumber, optionalThe priority of the task within the project. Higher priority tasks are scheduled sooner. Must be an integer between 0 and 9999. Defaults to 100.

Export.video.toDrive

Creates a batch task to export an ImageCollection as a video to Drive. The collection must only contain RGB images. Tasks can be started from the Tasks tab. "crsTransform", "scale", and "dimensions" are mutually exclusive.

UsageReturns
Export.video.toDrive(collection, description, folder, fileNamePrefix, framesPerSecond, dimensions, region, scale, crs, crsTransform, maxPixels, maxFrames, priority)
ArgumentTypeDetails
collectionImageCollectionThe image collection to export.
descriptionString, optionalA human-readable name of the task. May contain letters, numbers, -, _ (no spaces). Defaults to "myExportVideoTask".
folderString, optionalThe Google Drive Folder that the export will reside in. Note: (a) if the folder name exists at any level, the output is written to it, (b) if duplicate folder names exist, output is written to the most recently modified folder, (c) if the folder name does not exist, a new folder will be created at the root, and (d) folder names with separators (e.g. 'path/to/file') are interpreted as literal strings, not system paths. Defaults to Drive root.
fileNamePrefixString, optionalThe filename prefix. May contain letters, numbers, -, _ (no spaces). Defaults to the description.
framesPerSecondNumber, optionalThe framerate of the exported video. Must be a value between 0.1 and 100. Defaults to 1.
dimensionsNumber|String, optionalThe dimensions to use for the exported image. Takes either a single positive integer as the maximum dimension or "WIDTHxHEIGHT" where WIDTH and HEIGHT are each positive integers.
regionGeometry.LinearRing|Geometry.Polygon|String, optionalA LinearRing, Polygon, or coordinates representing region to export. These may be specified as the Geometry objects or coordinates serialized as a string.
scaleNumber, optionalResolution in meters per pixel.
crsString, optionalCRS to use for the exported image. Defaults to the Google Maps Mercator projection, SR-ORG:6627.
crsTransformString, optionalAffine transform to use for the exported image. Requires "crs" to be defined.
maxPixelsNumber, optionalRestrict the number of pixels in the export. By default, you will see an error if the export exceeds 1e8 pixels. Setting this value explicitly allows one to raise or lower this limit.
maxFramesNumber, optionalSet the maximum number of frames to export. By default, a maximum of 1000 frames may be exported. By setting this explicitly, you may raise or lower this limit.
priorityNumber, optionalThe priority of the task within the project. Higher priority tasks are scheduled sooner. Must be an integer between 0 and 9999. Defaults to 100.

Map.add

Adds an item to the map. Can also be used to add widgets like ui.Label as well as some non-widget objects like ui.Map.Layer.

Returns the map.

UsageReturns
Map.add(item)ui.Map
ArgumentTypeDetails
itemObjectThe item to add.

Map.addLayer

Adds a given EE object to the map as a layer.

Returns the new map layer.

UsageReturns
Map.addLayer(eeObject, visParams, name, shown, opacity)ui.Map.Layer
ArgumentTypeDetails
eeObjectCollection|Feature|Image|RawMapIdThe object to add to the map.
visParamsFeatureVisualizationParameters|ImageVisualizationParameters, optionalThe visualization parameters. For Images and ImageCollection, see ee.data.getMapId for valid parameters. For Features and FeatureCollections, the only supported key is "color", as a CSS 3.0 color string or a hex string in "RRGGBB" format. Ignored when eeObject is a map ID.
nameString, optionalThe name of the layer. Defaults to "Layer N".
shownBoolean, optionalA flag indicating whether the layer should be on by default.
opacityNumber, optionalThe layer's opacity represented as a number between 0 and 1. Defaults to 1.

Map.centerObject

Centers the map view on a given object.

Returns the map.

UsageReturns
Map.centerObject(object, zoom, onComplete)ui.Map
ArgumentTypeDetails
objectElement|GeometryAn object to center on - a geometry, image or feature.
zoomNumber, optionalThe zoom level, from 0 to 24. If unspecified, computed based on the object's bounding box.
onCompleteFunction, optionalA callback which is triggered after the recentering completes successfully. Passing this parameter causes the `centerObject` operation to run asynchronously.

Map.clear

Clears the map by removing all layers, listeners, and widgets and restoring the options to their defaults.

Returns the map.

UsageReturns
Map.clear()ui.Map

No arguments.

Map.drawingTools

Returns the Map's drawing tools, which can be used to create and edit shapes on the map.
UsageReturns
Map.drawingTools()ui.Map.DrawingTools

No arguments.

Map.getBounds

Returns the bounds of the current map view, as a list in the format [west, south, east, north] in degrees.
UsageReturns
Map.getBounds(asGeoJSON)GeoJSONGeometry|List|String
ArgumentTypeDetails
asGeoJSONBoolean, optionalIf true, returns map bounds as GeoJSON.

Map.getCenter

Returns the coordinates at the center of the map.

UsageReturns
Map.getCenter()Geometry.Point

No arguments.

Map.getScale

Returns the approximate pixel scale of the current map view, in meters.
UsageReturns
Map.getScale()Number|String

No arguments.

Map.getZoom

Returns the current zoom level of the map.
UsageReturns
Map.getZoom()Number

No arguments.

Map.layers

Returns the list of layers associated with the default map.
UsageReturns
Map.layers()ui.data.ActiveList

No arguments.

Map.onChangeBounds

Registers a callback that's fired when the map bounds change. This is fired during pan, zoom, and when the map's bounds are changed programmatically. Returns an ID which can be passed to unlisten() to unregister the callback.
UsageReturns
Map.onChangeBounds(callback)String
ArgumentTypeDetails
callbackFunctionThe callback to fire when the map bounds change. The callback is passed two parameters: an object containing the coordinates of the new map center (with keys lon, lat, and zoom) and the map widget itself.

Map.onChangeCenter

Registers a callback that's fired when the map center changes. This is fired during pan or when the map's center is changed programmatically.

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
Map.onChangeCenter(callback)String
ArgumentTypeDetails
callbackFunctionThe callback to fire when the map center changes. The callback is passed two parameters: an object containing the coordinates of the new center (with keys lon and lat) and the map widget itself.

Map.onChangeZoom

Registers a callback that's fired when the map zoom level changes.

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
Map.onChangeZoom(callback)String
ArgumentTypeDetails
callbackFunctionThe callback to fire when the map zoom change. The callback is passed two parameters: the new zoom level and the map widget itself.

Map.onClick

Registers a callback that's fired when the map is clicked.

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
Map.onClick(callback)String
ArgumentTypeDetails
callbackFunctionThe callback to fire when the map is clicked. The callback is passed an object containing the coordinates of the clicked point (with keys lon and lat) and the map widget.

Map.onIdle

Registers a callback that's fired when the map stops moving.

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
Map.onIdle(callback)String
ArgumentTypeDetails
callbackFunctionThe callback to fire when the map becomes idle. The callback is passed two parameters: an object containing the coordinates of the map center (with keys lon, lat, and zoom) and the map widget itself.

Map.onTileLoaded

Registers a callback that's fired when a map tile has been loaded.

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
Map.onTileLoaded(callback)String
ArgumentTypeDetails
callbackFunctionCalled with an array of per layer values. Each value is the fraction of tiles still pending: a value of 0 means there are no more tiles to load for the layer.

Map.remove

Removes the given item from the map, if it exists.

Returns the removed item or null if it hadn't been added to the map.

UsageReturns
Map.remove(item)Object
ArgumentTypeDetails
itemObjectThe item to remove.

Map.setCenter

Centers the map view at a given coordinates with the given zoom level.

Returns the map.

UsageReturns
Map.setCenter(lon, lat, zoom)ui.Map
ArgumentTypeDetails
lonNumberThe longitude of the center, in degrees.
latNumberThe latitude of the center, in degrees.
zoomNumber, optionalThe zoom level, from 0 to 24.

Map.setControlVisibility

Sets the visibility of the controls on the map.

Returns this ui.Map.

UsageReturns
Map.setControlVisibility(all, layerList, zoomControl, scaleControl, mapTypeControl, fullscreenControl, drawingToolsControl)ui.Map
ArgumentTypeDetails
allBoolean, optionalWhether to show all controls. False hides all controls; true shows all controls. Overridden by individually set parameters. Note that setting this explicitly will affect any additional controls added in the future.
layerListBoolean, optionalWhen false, hides the layer list panel or, when true, allows the layer list panel's visibility to be determined by the presence of layers in the list. The default is to show the list.
zoomControlBoolean, optionalWhether the zoom control is visible. Defaults to true.
scaleControlBoolean, optionalWhether to show the control which indicates the scale at the map's current zoom level. Defaults to true.
mapTypeControlBoolean, optionalWhether to show the control that allows the user to change the base map. Defaults to true.
fullscreenControlBoolean, optionalWhether to show the control that allows the user to make the map full-screen. Defaults to true.
drawingToolsControlBoolean, optionalWhether to show the control that allows the user to add or edit the geometry drawing tools. Defaults to true.

Map.setGestureHandling

Controls how gestures are handled on the map.

See https://developers.google.com/maps/documentation/javascript/reference/map#MapOptions.gestureHandling.

UsageReturns
Map.setGestureHandling(option)
ArgumentTypeDetails
optionStringThe option that controls how gestures are handled on the map. Allowed values:
  • "cooperative": Scroll events and one-finger touch gestures scroll the page, and do not zoom or pan the map. Two-finger touch gestures pan and zoom the map. Scroll events with a ctrl key or ⌘ key pressed zoom the map. In this mode the map cooperates with the page.
  • "greedy": All touch gestures and scroll events pan or zoom the map.
  • "none": The map cannot be panned or zoomed by user gestures.
  • "auto": (default) Gesture handling is either cooperative or greedy, depending on whether the page is scrollable or in an iframe.

Map.setLocked

Limits panning and zooming on the map.

  - To lock both panning and zooming, set locked to true and nothing else.

  - To allow panning and limit the min and max zoom, set locked to false and supply the minZoom and maxZoom parameters.

  - To disallow panning and limit min and max zoom, set locked to true and supply the minZoom and maxZoom parameters.

  - To reset the map to default, set locked to false and nothing else.

UsageReturns
Map.setLocked(locked, minZoom, maxZoom)
ArgumentTypeDetails
lockedBooleanWhether the map should be locked or not.
minZoomNumber, optional(optional) The minimum zoom for the map, between 0 and 24, inclusive.
maxZoomNumber, optional(optional) The maximum zoom for the map, between 0 and 24, inclusive.

Map.setOptions

Modifies the Google Maps basemap. Allows for:

1) Setting the current MapType. 2) Providing custom styles for the basemap (MapTypeStyles). 3) Setting the list of available mapTypesIds for the basemap.

If called with no parameters, resets the map type to the google default.

Returns the map.

UsageReturns
Map.setOptions(mapTypeId, styles, types)ui.Map
ArgumentTypeDetails
mapTypeIdString, optionalA mapTypeId to set the basemap to. Can be one of "ROADMAP", "SATELLITE", "HYBRID" or "TERRAIN" to select one of the standard Google Maps API map types, or one of the keys specified in the opt_styles dictionary. If left as null and only 1 style is specified in opt_styles, that style will be used.
stylesObject, optionalA dictionary of custom MapTypeStyle objects keyed with a name that will appear in the map's Map Type Controls. See: https://developers.google.com/maps/documentation/javascript/reference#MapTypeStyle
typesList, optionalA list of mapTypeIds to make available. If omitted, but opt_styles is specified, appends all of the style keys to the standard Google Maps API map types.

Map.setZoom

Sets the zoom level of the map.

Returns this ui.Map.

UsageReturns
Map.setZoom(zoom)ui.Map
ArgumentTypeDetails
zoomNumberThe zoom level, from 0 to 24, to set for the map.

Map.style

Returns the Map's style ActiveDictionary, which can be modified to update the Map's styles.

In addition to the standard UI API styles listed in the ui.Panel.style() documentation, the Map supports the following custom style option:

  - cursor, which can be 'crosshair' or 'hand' (default)

UsageReturns
Map.style()ui.data.ActiveDictionary

No arguments.

Map.unlisten

Deletes callbacks.
UsageReturns
Map.unlisten(idOrType)
ArgumentTypeDetails
idOrTypeString, optionalEither an ID returned by listen() when a callback was registered, an event type, or nothing. If an ID is passed, the corresponding callback is deleted. If an event type is passed, all callbacks registered with that event type are deleted. If nothing is passed, all callbacks are deleted.

Map.widgets

Returns the list of the widgets currently on the map.

UsageReturns
Map.widgets()ui.data.ActiveList

No arguments.

exports

The reserved namespace for exporting objects as module members.
UsageReturns
exports()

No arguments.

print

Prints the arguments to the console.
UsageReturns
print(var_args)
ArgumentTypeDetails
var_argsVarArgsThe objects to print.

require

Retrieves the script found at a given path as a module. The module is used to access exposed members of the required script.

Returns returns an object that represents exported members from the required module.

UsageReturns
require(path)Object
ArgumentTypeDetails
pathStringThe path to the script to include as a module. Paths must be absolute, such as: "users/homeFolder/repo:path/to/file".

ui.Button

A clickable button with a text label.

UsageReturns
ui.Button(label, onClick, disabled, style, imageUrl)ui.Button
ArgumentTypeDetails
labelString, optionalThe button's label. Defaults to an empty string.
onClickFunction, optionalA callback fired when the button is clicked. The callback is passed the button widget.
disabledBoolean, optionalWhether the button is disabled. Defaults to false.
styleObject, optionalAn object of allowed CSS styles with their values to be set for this widget. Defaults to an empty object.
imageUrlString, optionalOptional image url. If provided, the button will be rendered as an image and the value text will be shown on mouse hover. Only data: urls and icons loaded from gstatic.com are allowed.

ui.Button.getDisabled

Returns whether the button is disabled.

UsageReturns
Button.getDisabled()Boolean
ArgumentTypeDetails
this: ui.buttonui.ButtonThe ui.Button instance.

ui.Button.getImageUrl

Returns the url of the image if it exists.

UsageReturns
Button.getImageUrl()String
ArgumentTypeDetails
this: ui.buttonui.ButtonThe ui.Button instance.

ui.Button.getLabel

Returns the button's label.

UsageReturns
Button.getLabel()String
ArgumentTypeDetails
this: ui.buttonui.ButtonThe ui.Button instance.

ui.Button.onClick

Registers a callback that's fired when the button is clicked.

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
Button.onClick(callback)String
ArgumentTypeDetails
this: ui.buttonui.ButtonThe ui.Button instance.
callbackFunctionThe callback to fire when the button is clicked. The callback is passed the button widget.

ui.Button.setDisabled

Sets whether the button is disabled.

Returns this button.

UsageReturns
Button.setDisabled(disabled)ui.Button
ArgumentTypeDetails
this: ui.buttonui.ButtonThe ui.Button instance.
disabledBooleanWhether the button is disabled.

ui.Button.setImageUrl

Shows the button as image, which will render instead of the label text.

Returns this button.

UsageReturns
Button.setImageUrl(imageUrl)ui.Button
ArgumentTypeDetails
this: ui.buttonui.ButtonThe ui.Button instance.
imageUrlStringThe url of the image.

ui.Button.setLabel

Sets the button's label.

Returns this button.

UsageReturns
Button.setLabel(label)ui.Button
ArgumentTypeDetails
this: ui.buttonui.ButtonThe ui.Button instance.
labelStringThe button's label.

ui.Button.style

Returns the widget's style ActiveDictionary, which can be modified to update the widget's styles.

Properties which behave like their CSS counterparts:

  - height, maxHeight, minHeight (e.g. '100px')

  - width, maxWidth, minWidth (e.g. '100px')

  - padding, margin (e.g. '4px 4px 4px 4px' or simply '4px')

  - color, backgroundColor (e.g. 'red' or '#FF0000')

  - border (e.g. '1px solid black')

  - fontSize (e.g. '24px')

  - fontStyle (e.g. 'italic')

  - fontWeight (e.g. 'bold' or '100')

  - fontFamily (e.g. 'monospace' or 'serif')

  - textAlign (e.g. 'left' or 'center')

  - textDecoration (e.g. 'underline' or 'line-through')

  - whiteSpace (e.g. 'nowrap' or 'pre')

  - shown (true or false)

Supported custom layout properties (see ui.Panel.Layout documentation):

  - stretch ('horizontal', 'vertical', 'both')

  - position ('top-right', 'top-center', 'top-left', 'bottom-right', ...)

UsageReturns
Button.style()ui.data.ActiveDictionary
ArgumentTypeDetails
this: ui.widgetui.WidgetThe ui.Widget instance.

ui.Button.unlisten

Deletes callbacks.

UsageReturns
Button.unlisten(idOrType)
ArgumentTypeDetails
this: ui.widgetui.WidgetThe ui.Widget instance.
idOrTypeString, optionalEither an ID returned by an onEventType() function during callback registration, an event type, or nothing. If an ID is passed, the corresponding callback is deleted. If an event type is passed, all callbacks for that type are deleted. If nothing is passed, all callbacks are deleted.

ui.Chart

A chart widget.

UsageReturns
ui.Chart(dataTable, chartType, options, view, downloadable)ui.Chart
ArgumentTypeDetails
dataTableList, optionalA 2-D array of data or a Google Visualization DataTable literal. See: http://developers.google.com/chart/interactive/docs/reference#DataTable
chartTypeString, optionalThe chart type; e.g 'ScatterChart', 'LineChart', and 'ColumnChart'. For the complete list of charts, see: https://developers.google.com/chart/interactive/docs/gallery
optionsObject, optionalAn object defining chart style options such as:
title (string) The title of the chart.
colors (Array) An array of colors used to draw the chart.
Its format should follow the Google Visualization API's options: https://developers.google.com/chart/interactive/docs/customizing_charts
viewObject, optionalSets a DataView initializer object, which acts as a filter over the underlying data. See: https://developers.google.com/chart/interactive/docs/reference#DataView
downloadableBoolean, optionalWhether the chart can be downloaded as CSV, SVG, and PNG. Defaults to true.

ui.Chart.array.values

Generates a Chart from an array. Plots separate series for each 1-D vector along the given axis.

  - X-axis = Array index along axis, optionally labeled by xLabels.

  - Y-axis = Value.

  - Series = Vector, described by indices of the non-axis array axes.

Returns a chart.

UsageReturns
ui.Chart.array.values(array, axis, xLabels)ui.Chart
ArgumentTypeDetails
arrayArray|ListArray to chart.
axisNumberThe axis along which to generate the 1-D vector series.
xLabelsArray|List, optionalLabels for ticks along the x-axis of the chart.

ui.Chart.feature.byFeature

Generates a Chart from a set of features. Plots the value of one or more properties for each feature:

  - X-axis = Features labeled by xProperty (default: 'system:index').

  - Y-axis = Values of yProperties (default: all properties).

  - Series = Names of yProperties.

The values are ordered along the x-axis in the same order as the input features.

Returns a chart.

UsageReturns
ui.Chart.feature.byFeature(features, xProperty, yProperties)ui.Chart
ArgumentTypeDetails
featuresFeature|FeatureCollection|ListThe features to include in the chart.
xPropertyString, optionalThe property used as the value of each feature on the x-axis. Defaults to 'system:index'.
yPropertiesList, optionalProperty or properties used on the y-axis. If omitted, all properties of all features will be charted on the y-axis (except xProperty).

ui.Chart.feature.byProperty

Generates a Chart from a set of features. Plots property values of one or more features.

  - X-axis = Property name, labeled by xProperties (default: all properties).

  - Y-axis = Property value (must be numeric).

  - Series = Features, labeled by seriesProperty (default: 'system:index').

All properties except seriesProperty are included on the x-axis by default.

Returns a chart.

UsageReturns
ui.Chart.feature.byProperty(features, xProperties, seriesProperty)ui.Chart
ArgumentTypeDetails
featuresFeature|FeatureCollection|ListThe features to include in the chart.
xPropertiesList, optionalOne of (1) a property to be plotted on the x-axis; (2) a list of properties to be plotted on the x-axis; or (3) a (property, label) dictionary specifying labels for properties to be used as values on the x-axis. If omitted, all properties will be plotted on the x-axis, labeled with their names.
seriesPropertyString, optionalThe name of the property used to label each feature in the legend. Defaults to 'system:index'.

ui.Chart.feature.groups

Generates a Chart from a set of features. Plots the value of a given property across groups of features. Features with the same value of groupProperty will be grouped and plotted as a single series.

  - X-axis = xProperty values.

  - Y-axis = yProperty values.

  - Series = Feature groups, by seriesProperty.

Returns a chart.

UsageReturns
ui.Chart.feature.groups(features, xProperty, yProperty, seriesProperty)ui.Chart
ArgumentTypeDetails
featuresFeature|FeatureCollection|ListThe features to include in the chart.
xPropertyStringProperty to be used as the label for each feature on the x-axis.
yPropertyStringProperty to be plotted on the y-axis.
seriesPropertyStringProperty used to determine feature groups. Features with the same value of groupProperty will be plotted as a single series on the chart.

ui.Chart.feature.histogram

Generates a Chart from a set of features. Computes and plots a histogram of the given property.

  - X-axis = Histogram buckets (of property value).

  - Y-axis = Frequency (i.e. the number of features whose value of property lands within the x-axis bucket bounds).

Returns a chart.

UsageReturns
ui.Chart.feature.histogram(features, property, maxBuckets, minBucketWidth, maxRaw)ui.Chart
ArgumentTypeDetails
featuresFeature|FeatureCollection|ListThe features to include in the chart.
propertyStringThe name of the property to generate the histogram for.
maxBucketsNumber, optionalThe maximum number of buckets to use when building a histogram; will be rounded up to a power of 2. Not used when the value of property is non-numeric.
minBucketWidthNumber, optionalThe minimum histogram bucket width, or null to allow any power of 2. Not used when property is non-numeric.
maxRawNumber, optionalThe number of values to accumulate before building the initial histogram. Not used when property is non-numeric.

ui.Chart.getChartType

Returns this chart's type; e.g 'ScatterChart', 'LineChart', and 'ColumnChart'. For the complete list of charts, see: https://developers.google.com/chart/interactive/docs/gallery

UsageReturns
Chart.getChartType()String
ArgumentTypeDetails
this: ui.chartui.ChartThe ui.Chart instance.

ui.Chart.getDataTable

Returns the DataTable containing data for this chart. See: http://developers.google.com/chart/interactive/docs/reference#DataTable

UsageReturns
Chart.getDataTable()Object
ArgumentTypeDetails
this: ui.chartui.ChartThe ui.Chart instance.

ui.Chart.getDownloadable

Returns whether the chart can be downloaded as CSV, SVG, and PNG.

UsageReturns
Chart.getDownloadable()Boolean
ArgumentTypeDetails
this: ui.chartui.ChartThe ui.Chart instance.

ui.Chart.getOptions

Returns this chart's options. See: https://developers.google.com/chart/interactive/docs/customizing_charts

UsageReturns
Chart.getOptions()Object
ArgumentTypeDetails
this: ui.chartui.ChartThe ui.Chart instance.

ui.Chart.getView

Returns this chart's DataView initializer object, which acts as a filter over the underlying data in the chart. See: https://developers.google.com/chart/interactive/docs/reference#DataView

UsageReturns
Chart.getView()Object
ArgumentTypeDetails
this: ui.chartui.ChartThe ui.Chart instance.

ui.Chart.image.byClass

Generates a Chart from an image. Plots derived band values in classified regions in an image.

  - X-axis = Band name (all bands except the class band are charted).

  - Y-axis = Band value.

  - Series = Class label.

Returns a chart.

UsageReturns
ui.Chart.image.byClass(image, classBand, region, reducer, scale, classLabels, xLabels)ui.Chart
ArgumentTypeDetails
imageImageClassified image to derive band values from.
classBandNumber|StringThe class label band in this image.
regionFeature|FeatureCollection|Geometry, optionalThe region to reduce. If omitted, uses the entire image.
reducerReducer, optionalReducer that generates the value(s) for the y-axis. Must return a single value per band. Defaults to ee.Reducer.mean().
scaleNumber, optionalScale to use with the reducer in meters.
classLabelsList., optionalA dictionary of labels used to identify classes in the series legend. If omitted, classes will be labeled with the value of classBand.
xLabelsList, optionalA list of labels used to label bands on the xAxis. Must have one fewer elements than the number of image bands. If omitted, bands will be labeled with their names. If the labels are numeric (e.g. wavelengths), x-axis will be continuous.

ui.Chart.image.byRegion

Generates a Chart from an image. Extracts and plots band values in one or more regions in the image, with each band in a separate series.

  - X-axis = Region labeled by xProperty (default: 'system:index')

  - Y-axis = Reducer output.

  - Series = Band name.

Returns a chart.

UsageReturns
ui.Chart.image.byRegion(image, regions, reducer, scale, xProperty)ui.Chart
ArgumentTypeDetails
imageImageImage to extract band values from.
regionsFeature|FeatureCollection|Geometry|List, optionalRegions to reduce. Defaults to the image's footprint.
reducerReducer, optionalReducer that generates the value(s) for the y-axis. Must return a single value per band. Defaults to ee.Reducer.mean().
scaleNumber, optionalScale to use with the reducer in meters.
xPropertyString, optionalProperty to be used as the label for each Region on the x-axis. Defaults to 'system:index'.

ui.Chart.image.doySeries

Generates a Chart from an ImageCollection. Plots derived values of each band in a region for a each day of the year.

  - X-axis: Day of year (startDay to endDay, defaults to 1 to 366).

  - Y-axis: Derived band value (reduced within the region and across years).

  - Series: Band names.

Returns a chart.

UsageReturns
ui.Chart.image.doySeries(imageCollection, region, regionReducer, scale, yearReducer, startDay, endDay)ui.Chart
ArgumentTypeDetails
imageCollectionImageCollectionThe ImageCollection to chart.
regionFeature|FeatureCollection|Geometry, optionalThe region to reduce. Defaults to the union of all geometries in the image collection.
regionReducerReducer, optionalReducer for aggregating band values within the region. Must return a single value. Defaults to ee.Reducer.mean().
scaleNumber, optionalScale to use with the region reducer in meters.
yearReducerReducer, optionalReducer for aggregating regionReducer outputs across years (for a given day). Must return a single value. Defaults to ee.Reducer.mean().
startDayNumber, optionalDay of year to start the series. Must be between 1 and 366.
endDayNumber, optionalDay of year to end the series. Must be between startDay and 366.

ui.Chart.image.doySeriesByRegion

Generates a Chart from an ImageCollection. Plots the derived value of the given band in different regions at each day-of-year.

  - X-axis: Day of year (startDay to endDay, defaults to 1 to 366).

  - Y-axis: Derived band value (reduced within the region and across years).

  - Series: Regions.

Returns a chart.

UsageReturns
ui.Chart.image.doySeriesByRegion(imageCollection, bandName, regions, regionReducer, scale, yearReducer, seriesProperty, startDay, endDay)ui.Chart
ArgumentTypeDetails
imageCollectionImageCollectionThe ImageCollection to chart.
bandNameNumber|StringThe name of the band to chart.
regionsFeature|FeatureCollection|Geometry|ListThe regions to reduce.
regionReducerReducer, optionalReducer for aggregating band values within the region. Must return a single value. Defaults to ee.Reducer.mean().
scaleNumber, optionalScale to use with the region reducer in meters.
yearReducerReducer, optionalReducer for aggregating band values across years (for a given day of year). Must return a single value. Defaults to ee.Reducer.mean().
seriesPropertyString, optionalProperty of features in opt_regions to be used for series labels. Defaults to 'system:index'.
startDayNumber, optionalDay of year to start the series. Must be between 1 and 366.
endDayNumber, optionalDay of year to end the series. Must be between startDay and 366.

ui.Chart.image.doySeriesByYear

Generates a Chart from an ImageCollection. Plots the derived value of the given band in a region for each day-of-year across different years.

  - X-axis: Day of year (startDay to endDay, defaults to 1 to 366).

  - Y-axis: Derived band value (reduced within the region).

  - Series: Years.

Returns a chart.

UsageReturns
ui.Chart.image.doySeriesByYear(imageCollection, bandName, region, regionReducer, scale, sameDayReducer, startDay, endDay)ui.Chart
ArgumentTypeDetails
imageCollectionImageCollectionThe ImageCollection to chart.
bandNameNumber|StringThe name of the band to chart.
regionFeature|FeatureCollection|Geometry, optionalThe region to reduce. Defaults to the union of all geometries in the image collection.
regionReducerReducer, optionalReducer for aggregating band values within the region. Must return a single value. Defaults to ee.Reducer.mean().
scaleNumber, optionalScale to use with the region reducer in meters.
sameDayReducerReducer, optionalReducer for aggregating band values across images with the same (DoY, year) pair. Must return a single value. Defaults to ee.Reducer.mean().
startDayNumber, optionalDay of year to start the series. Must be between 1 and 366.
endDayNumber, optionalDay of year to end the series. Must be between startDay and 366.

ui.Chart.image.histogram

Generates a Chart from an image. Computes and plots histograms of the values of the bands in the specified region of the image.

  - X-axis: Histogram buckets (of band value).

  - Y-axis: Frequency (number of pixels with a band value in the bucket).

Returns a chart.

UsageReturns
ui.Chart.image.histogram(image, region, scale, maxBuckets, minBucketWidth, maxRaw, maxPixels)ui.Chart
ArgumentTypeDetails
imageImageThe image to generate a histogram from.
regionFeature|FeatureCollection|Geometry, optionalThe region to reduce. If omitted, uses the entire image.
scaleNumber, optionalThe pixel scale used when applying the histogram reducer, in meters.
maxBucketsNumber, optionalThe maximum number of buckets to use when building a histogram; will be rounded up to a power of 2.
minBucketWidthNumber, optionalThe minimum histogram bucket width, or null to allow any power of 2.
maxRawNumber, optionalThe number of values to accumulate before building the initial histogram.
maxPixelsNumber, optionalIf specified, overrides the maximum number of pixels allowed in the histogram reduction. Defaults to 1e6.

ui.Chart.image.regions

Generates a Chart from an image. Extracts and plots the value of each band in one or more regions.

  - X-axis = Band labeled by xProperty (default: band name).

  - Y-axis = Reducer output.

  - Series = Region labeled by seriesProperty (default: 'system:index').

Returns a chart.

UsageReturns
ui.Chart.image.regions(image, regions, reducer, scale, seriesProperty, xLabels)ui.Chart
ArgumentTypeDetails
imageImageImage to extract band values from.
regionsFeature|FeatureCollection|Geometry|List, optionalRegions to reduce. Defaults to the image's footprint.
reducerReducer, optionalReducer that generates the value(s) for the y-axis. Must return a single value per band.
scaleNumber, optionalThe pixel scale in meters.
seriesPropertyString, optionalProperty to be used as the label for each region in the legend. Defaults to 'system:index'.
xLabelsList, optionalA list of labels used for bands on the x-axis. Must have the same number of elements as the image bands. If omitted, bands will be labeled with their names. If the labels are numeric (e.g. wavelengths), x-axis will be continuous.

ui.Chart.image.series

Generates a Chart from an ImageCollection. Plots derived values of each band in a region across images. Usually a time series.

  - X-axis: Image, labeled by xProperty value.

  - Y-axis: Band value.

  - Series: Band names.

Returns a chart.

UsageReturns
ui.Chart.image.series(imageCollection, region, reducer, scale, xProperty)ui.Chart
ArgumentTypeDetails
imageCollectionImageCollectionAn ImageCollection with data to be included in the chart.
regionFeature|FeatureCollection|GeometryThe region to reduce.
reducerReducer, optionalReducer that generates the values for the y-axis. Must return a single value. Defaults to ee.Reducer.mean().
scaleNumber, optionalScale to use with the reducer in meters.
xPropertyString, optionalProperty to be used as the label for each image on the x-axis. Defaults to 'system:time_start'.

ui.Chart.image.seriesByRegion

Generates a Chart from an image collection. Extracts and plots the value of the specified band in each region for each image in the collection. Usually a time series.

  - X-axis = Image labeled by xProperty (default: 'system:time_start').

  - Y-axis = Reducer output.

  - Series = Region labeled by seriesProperty (default: 'system:index').

Returns a chart.

UsageReturns
ui.Chart.image.seriesByRegion(imageCollection, regions, reducer, band, scale, xProperty, seriesProperty)ui.Chart
ArgumentTypeDetails
imageCollectionImageCollectionAn ImageCollection with data to be included in the chart.
regionsFeature|FeatureCollection|Geometry|ListThe regions to reduce.
reducerReducerReducer that generates the value for the y-axis. Must return a single value.
bandNumber|String, optionalThe band name to reduce using the reducer. Defaults to the first band.
scaleNumber, optionalScale to use with the reducer in meters.
xPropertyString, optionalProperty to be used as the label for each image on the x-axis. Defaults to 'system:time_start'.
seriesPropertyString, optionalProperty of features in opt_regions to be used for series labels. Defaults to 'system:index'.

ui.Chart.onClick

Registers a callback that's fired when the chart is clicked.

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
Chart.onClick(callback)String
ArgumentTypeDetails
this: ui.chartui.ChartThe ui.Chart instance.
callbackFunctionThe callback to fire when the chart is clicked. The callback is passed three arguments: the x-value, the y-value, and the series name. Time values are represented in UTC epoch milliseconds, like "system:time_start" values on assets. If the user clicks on a legend entry to select an entire series, the x- and y-values are null. If the user clicks an already-selected point, all arguments are null, indicating the selection was cleared.

ui.Chart.setChartType

Sets the chartType of this chart.

Returns this chart.

UsageReturns
Chart.setChartType(chartType)ui.Chart
ArgumentTypeDetails
this: ui.chartui.ChartThe ui.Chart instance.
chartTypeStringThe chart type; e.g 'ScatterChart', 'LineChart', and 'ColumnChart'. For the complete list of charts, see: https://developers.google.com/chart/interactive/docs/gallery

ui.Chart.setDataTable

Sets the DataTable containing data for this chart.

Returns this chart.

UsageReturns
Chart.setDataTable(dataTable)ui.Chart
ArgumentTypeDetails
this: ui.chartui.ChartThe ui.Chart instance.
dataTableListA 2-D array of data to chart or a Google Visualization DataTable literal. See: http://developers.google.com/chart/interactive/docs/reference#DataTable

ui.Chart.setDownloadable

Sets a view for this chart.

Returns this chart.

UsageReturns
Chart.setDownloadable(Whether)ui.Chart
ArgumentTypeDetails
this: ui.chartui.ChartThe ui.Chart instance.
WhetherBooleanthe chart can be downloaded as CSV, SVG, and PNG.

ui.Chart.setOptions

Sets options used to style this chart.

Returns this chart.

UsageReturns
Chart.setOptions(options)ui.Chart
ArgumentTypeDetails
this: ui.chartui.ChartThe ui.Chart instance.
optionsObjectAn object defining chart style options such as:
title (string) The title of the chart.
colors (Array) An array of colors used to draw the chart.
Its format should follow the Google Visualization API's options: https://developers.google.com/chart/interactive/docs/customizing_charts

ui.Chart.setSeriesNames

Returns a copy of this chart with updated series names.

UsageReturns
Chart.setSeriesNames(seriesNames, seriesIndex)ui.Chart
ArgumentTypeDetails
this: ui.chartui.ChartThe ui.Chart instance.
seriesNamesDictionary|DictionaryNew series names. If it's a string, the name of the series at seriesIndex is set to seriesNames. If it's a list, the value at index i in the list is used as a label for series number i. If it's a dictionary or an object, it's treated as a map from existing series names to new series names. In the last two cases, seriesIndex is ignored.
seriesIndexNumber, optionalThe index of the series to rename. Ignored if seriesNames is a list or dictionary. Series are 0-indexed.

ui.Chart.setView

Sets a view for this chart.

Returns this chart.

UsageReturns
Chart.setView(view)ui.Chart
ArgumentTypeDetails
this: ui.chartui.ChartThe ui.Chart instance.
viewObjectA DataView initializer object, which acts as a filter over the underlying data in the chart. See: https://developers.google.com/chart/interactive/docs/reference#DataView

ui.Chart.style

Returns the widget's style ActiveDictionary, which can be modified to update the widget's styles.

Properties which behave like their CSS counterparts:

  - height, maxHeight, minHeight (e.g. '100px')

  - width, maxWidth, minWidth (e.g. '100px')

  - padding, margin (e.g. '4px 4px 4px 4px' or simply '4px')

  - color, backgroundColor (e.g. 'red' or '#FF0000')

  - border (e.g. '1px solid black')

  - fontSize (e.g. '24px')

  - fontStyle (e.g. 'italic')

  - fontWeight (e.g. 'bold' or '100')

  - fontFamily (e.g. 'monospace' or 'serif')

  - textAlign (e.g. 'left' or 'center')

  - textDecoration (e.g. 'underline' or 'line-through')

  - whiteSpace (e.g. 'nowrap' or 'pre')

  - shown (true or false)

Supported custom layout properties (see ui.Panel.Layout documentation):

  - stretch ('horizontal', 'vertical', 'both')

  - position ('top-right', 'top-center', 'top-left', 'bottom-right', ...)

UsageReturns
Chart.style()ui.data.ActiveDictionary
ArgumentTypeDetails
this: ui.widgetui.WidgetThe ui.Widget instance.

ui.Chart.unlisten

Deletes callbacks.

UsageReturns
Chart.unlisten(idOrType)
ArgumentTypeDetails
this: ui.widgetui.WidgetThe ui.Widget instance.
idOrTypeString, optionalEither an ID returned by an onEventType() function during callback registration, an event type, or nothing. If an ID is passed, the corresponding callback is deleted. If an event type is passed, all callbacks for that type are deleted. If nothing is passed, all callbacks are deleted.

ui.Checkbox

A checkbox with a label.

UsageReturns
ui.Checkbox(label, value, onChange, disabled, style)ui.Checkbox
ArgumentTypeDetails
labelString, optionalThe checkbox's label. Defaults to an empty string.
valueBoolean, optionalWhether the checkbox is checked. A null value indicates that the checkbox is in an indeterminate state. Defaults to false.
onChangeFunction, optionalA callback to fire when the value of the checkbox changes. The callback is passed a boolean indicating whether the checkbox is now checked and the checkbox widget.
disabledBoolean, optionalWhether the checkbox is disabled. Defaults to false.
styleObject, optionalAn object of allowed CSS styles with their values to be set for this widget. See style() documentation.

ui.Checkbox.getDisabled

Returns whether the checkbox is disabled.

UsageReturns
Checkbox.getDisabled()Boolean
ArgumentTypeDetails
this: ui.checkboxui.CheckboxThe ui.Checkbox instance.

ui.Checkbox.getLabel

Returns the checkbox's label.

UsageReturns
Checkbox.getLabel()String
ArgumentTypeDetails
this: ui.checkboxui.CheckboxThe ui.Checkbox instance.

ui.Checkbox.getValue

Returns whether the checkbox is checked. A null value indicates the checkbox is in an indeterminate state.

UsageReturns
Checkbox.getValue()Boolean
ArgumentTypeDetails
this: ui.checkboxui.CheckboxThe ui.Checkbox instance.

ui.Checkbox.onChange

Registers a callback that's fired when the value of the checkbox changes.

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
Checkbox.onChange(callback)String
ArgumentTypeDetails
this: ui.checkboxui.CheckboxThe ui.Checkbox instance.
callbackFunctionThe callback to fire when the value of the checkbox changes. The callback is passed a boolean indicating whether the checkbox is now checked and the checkbox widget.

ui.Checkbox.setDisabled

Sets whether the checkbox is disabled.

Returns this checkbox.

UsageReturns
Checkbox.setDisabled(disabled)ui.Checkbox
ArgumentTypeDetails
this: ui.checkboxui.CheckboxThe ui.Checkbox instance.
disabledBooleanWhether the checkbox is disabled.

ui.Checkbox.setLabel

Sets the checkbox's label.

Returns this checkbox.

UsageReturns
Checkbox.setLabel(value)ui.Checkbox
ArgumentTypeDetails
this: ui.checkboxui.CheckboxThe ui.Checkbox instance.
valueStringThe new label for the checkbox.

ui.Checkbox.setValue

Sets whether the checkbox is checked.

Returns this checkbox.

UsageReturns
Checkbox.setValue(value, trigger)ui.Checkbox
ArgumentTypeDetails
this: ui.checkboxui.CheckboxThe ui.Checkbox instance.
valueBooleanWhether the checkbox is checked. A null value indicates the checkbox is in an indeterminate state.
triggerBoolean, optionalWhether to trigger onChange callbacks when the checked property changes. Defaults to true.

ui.Checkbox.style

Returns the widget's style ActiveDictionary, which can be modified to update the widget's styles.

Properties which behave like their CSS counterparts:

  - height, maxHeight, minHeight (e.g. '100px')

  - width, maxWidth, minWidth (e.g. '100px')

  - padding, margin (e.g. '4px 4px 4px 4px' or simply '4px')

  - color, backgroundColor (e.g. 'red' or '#FF0000')

  - border (e.g. '1px solid black')

  - fontSize (e.g. '24px')

  - fontStyle (e.g. 'italic')

  - fontWeight (e.g. 'bold' or '100')

  - fontFamily (e.g. 'monospace' or 'serif')

  - textAlign (e.g. 'left' or 'center')

  - textDecoration (e.g. 'underline' or 'line-through')

  - whiteSpace (e.g. 'nowrap' or 'pre')

  - shown (true or false)

Supported custom layout properties (see ui.Panel.Layout documentation):

  - stretch ('horizontal', 'vertical', 'both')

  - position ('top-right', 'top-center', 'top-left', 'bottom-right', ...)

UsageReturns
Checkbox.style()ui.data.ActiveDictionary
ArgumentTypeDetails
this: ui.widgetui.WidgetThe ui.Widget instance.

ui.Checkbox.unlisten

Deletes callbacks.

UsageReturns
Checkbox.unlisten(idOrType)
ArgumentTypeDetails
this: ui.widgetui.WidgetThe ui.Widget instance.
idOrTypeString, optionalEither an ID returned by an onEventType() function during callback registration, an event type, or nothing. If an ID is passed, the corresponding callback is deleted. If an event type is passed, all callbacks for that type are deleted. If nothing is passed, all callbacks are deleted.

ui.DateSlider

A draggable target that ranges linearly between two dates. The date slider can be configured to display dates of various interval sizes, including day, 8-day, and year. The value of the slider is displayed as a label alongside it.

UsageReturns
ui.DateSlider(start, end, value, period, onChange, disabled, style)ui.DateSlider
ArgumentTypeDetails
startDate|Number|String, optionalThe start date, as a UTC timestamp, date string, or ee.Date. Defaults to one week ago.
endDate|Number|String, optionalThe end date, as a UTC timestamp, date string, or ee.Date. Defaults to today.
valueDate|Number|String, optionalThe initial value. The value is an array consisting of the start and end date for the selected date range, but for convenience, it can be set by specifying the start date alone. Defaults to yesterday.
periodNumber, optionalThe interval size for values on the slider in days. Defaults to one.
onChangeFunction, optionalA callback to fire when the slider's state changes. The callback is passed an ee.DateRange representing the slider's current value and the slider widget.
disabledBoolean, optionalWhether the slider is disabled. Defaults to false.
styleObject, optionalAn object of allowed CSS styles with their values to be set for this widget. Defaults to an empty object.

ui.DateSlider.getDisabled

Returns whether the slider is disabled.

UsageReturns
DateSlider.getDisabled()Boolean
ArgumentTypeDetails
this: ui.datesliderui.DateSliderThe ui.DateSlider instance.

ui.DateSlider.getEnd

Returns the slider's end date as a UTC timestamp.

UsageReturns
DateSlider.getEnd()Number
ArgumentTypeDetails
this: ui.datesliderui.DateSliderThe ui.DateSlider instance.

ui.DateSlider.getPeriod

Returns the slider's period interval.

UsageReturns
DateSlider.getPeriod()Number
ArgumentTypeDetails
this: ui.datesliderui.DateSliderThe ui.DateSlider instance.

ui.DateSlider.getStart

Returns the slider's start date as a UTC timestamp.

UsageReturns
DateSlider.getStart()Number
ArgumentTypeDetails
this: ui.datesliderui.DateSliderThe ui.DateSlider instance.

ui.DateSlider.getValue

Returns the slider's current value, and array with the start and end datetimes as epoch UTC timestamps.

UsageReturns
DateSlider.getValue()List
ArgumentTypeDetails
this: ui.datesliderui.DateSliderThe ui.DateSlider instance.

ui.DateSlider.onChange

Registers a callback that's fired when the slider's value changes.

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
DateSlider.onChange(callback)String
ArgumentTypeDetails
this: ui.datesliderui.DateSliderThe ui.DateSlider instance.
callbackFunctionThe callback to fire when the slider's state changes. The callback is passed an ee.DateRange representing the slider's current value and the slider widget.

ui.DateSlider.setDisabled

Sets whether the slider is disabled.

Returns this slider.

UsageReturns
DateSlider.setDisabled(disabled)ui.DateSlider
ArgumentTypeDetails
this: ui.datesliderui.DateSliderThe ui.DateSlider instance.
disabledBooleanWhether the slider is disabled.

ui.DateSlider.setEnd

Sets the end date of the slider.

Returns this slider.

UsageReturns
DateSlider.setEnd(value)ui.DateSlider
ArgumentTypeDetails
this: ui.datesliderui.DateSliderThe ui.DateSlider instance.
valueNumber|StringThe slider's end date.

ui.DateSlider.setPeriod

Sets the period interval of the slider.

Returns this slider.

UsageReturns
DateSlider.setPeriod(value)ui.DateSlider
ArgumentTypeDetails
this: ui.datesliderui.DateSliderThe ui.DateSlider instance.
valueNumberThe slider's period interval.

ui.DateSlider.setStart

Sets the start date of the slider.

Returns this slider.

UsageReturns
DateSlider.setStart(start)ui.DateSlider
ArgumentTypeDetails
this: ui.datesliderui.DateSliderThe ui.DateSlider instance.
startNumber|StringThe start date. Defaults to one week ago.

ui.DateSlider.setValue

Set the value of the slider.

Returns this slider.

UsageReturns
DateSlider.setValue(value, trigger)ui.DateSlider
ArgumentTypeDetails
this: ui.datesliderui.DateSliderThe ui.DateSlider instance.
valueNumber|StringThe value to set on the slider.
triggerBoolean, optionalWhether to trigger onChange callbacks when the value property changes. Defaults to true.

ui.DateSlider.style

Returns the widget's style ActiveDictionary, which can be modified to update the widget's styles.

Properties which behave like their CSS counterparts:

  - height, maxHeight, minHeight (e.g. '100px')

  - width, maxWidth, minWidth (e.g. '100px')

  - padding, margin (e.g. '4px 4px 4px 4px' or simply '4px')

  - color, backgroundColor (e.g. 'red' or '#FF0000')

  - border (e.g. '1px solid black')

  - fontSize (e.g. '24px')

  - fontStyle (e.g. 'italic')

  - fontWeight (e.g. 'bold' or '100')

  - fontFamily (e.g. 'monospace' or 'serif')

  - textAlign (e.g. 'left' or 'center')

  - textDecoration (e.g. 'underline' or 'line-through')

  - whiteSpace (e.g. 'nowrap' or 'pre')

  - shown (true or false)

Supported custom layout properties (see ui.Panel.Layout documentation):

  - stretch ('horizontal', 'vertical', 'both')

  - position ('top-right', 'top-center', 'top-left', 'bottom-right', ...)

UsageReturns
DateSlider.style()ui.data.ActiveDictionary
ArgumentTypeDetails
this: ui.widgetui.WidgetThe ui.Widget instance.

ui.DateSlider.unlisten

Deletes callbacks.

UsageReturns
DateSlider.unlisten(idOrType)
ArgumentTypeDetails
this: ui.widgetui.WidgetThe ui.Widget instance.
idOrTypeString, optionalEither an ID returned by an onEventType() function during callback registration, an event type, or nothing. If an ID is passed, the corresponding callback is deleted. If an event type is passed, all callbacks for that type are deleted. If nothing is passed, all callbacks are deleted.

ui.Label

A text label.

UsageReturns
ui.Label(value, style, targetUrl, imageUrl)ui.Label
ArgumentTypeDetails
valueString, optionalThe text to display. Defaults to an empty string.
styleObject, optionalAn object of allowed CSS styles with their values to be set for this widget. See style() documentation.
targetUrlString, optionalThe url to link to. Defaults to an empty string.
imageUrlString, optionalOptional image url. If provided, the label will be rendered as an image and the value text will be shown on mouse hover. Only data: urls and icons loaded from gstatic.com are allowed.

ui.Label.getImageUrl

Returns the url of the image if it exists.

UsageReturns
Label.getImageUrl()String
ArgumentTypeDetails
this: ui.labelui.LabelThe ui.Label instance.

ui.Label.getUrl

Returns the url of the label if it exists.

UsageReturns
Label.getUrl()String
ArgumentTypeDetails
this: ui.labelui.LabelThe ui.Label instance.

ui.Label.getValue

Returns the value of the label.

UsageReturns
Label.getValue()String
ArgumentTypeDetails
this: ui.labelui.LabelThe ui.Label instance.

ui.Label.setImageUrl

Sets the label to an image, which will render instead of the value text.

Returns this label.

UsageReturns
Label.setImageUrl(imageUrl)ui.Label
ArgumentTypeDetails
this: ui.labelui.LabelThe ui.Label instance.
imageUrlStringThe url of the image.

ui.Label.setUrl

Sets the url of the label, which will cause it to render as a link.

Returns this label.

UsageReturns
Label.setUrl(targetUrl)ui.Label
ArgumentTypeDetails
this: ui.labelui.LabelThe ui.Label instance.
targetUrlStringThe url of the hyperlink.

ui.Label.setValue

Sets the value of the label.

Returns this label.

UsageReturns
Label.setValue(value)ui.Label
ArgumentTypeDetails
this: ui.labelui.LabelThe ui.Label instance.
valueStringThe value of the label.

ui.Label.style

Returns the widget's style ActiveDictionary, which can be modified to update the widget's styles.

Properties which behave like their CSS counterparts:

  - height, maxHeight, minHeight (e.g. '100px')

  - width, maxWidth, minWidth (e.g. '100px')

  - padding, margin (e.g. '4px 4px 4px 4px' or simply '4px')

  - color, backgroundColor (e.g. 'red' or '#FF0000')

  - border (e.g. '1px solid black')

  - fontSize (e.g. '24px')

  - fontStyle (e.g. 'italic')

  - fontWeight (e.g. 'bold' or '100')

  - fontFamily (e.g. 'monospace' or 'serif')

  - textAlign (e.g. 'left' or 'center')

  - textDecoration (e.g. 'underline' or 'line-through')

  - whiteSpace (e.g. 'nowrap' or 'pre')

  - shown (true or false)

Supported custom layout properties (see ui.Panel.Layout documentation):

  - stretch ('horizontal', 'vertical', 'both')

  - position ('top-right', 'top-center', 'top-left', 'bottom-right', ...)

UsageReturns
Label.style()ui.data.ActiveDictionary
ArgumentTypeDetails
this: ui.widgetui.WidgetThe ui.Widget instance.

ui.Map

A Google map.

UsageReturns
ui.Map(center, onClick, style)ui.Map
ArgumentTypeDetails
centerObject, optionalAn object containing the latitude ('lat'), longitude ('lon') and optionally the zoom level ('zoom') for the map.
onClickFunction, optionalA callback fired when the map is clicked. The callback is passed an object containing the coordinates of the clicked point on the map (with keys lon and lat) and the map widget itself.
styleObject, optionalAn object of allowed CSS styles with their values to be set for this map. See style() documentation.

ui.Map.CloudStorageLayer

A layer generated from Cloud Storage tiles for display on a ui.Map.

UsageReturns
ui.Map.CloudStorageLayer(bucket, path, maxZoom, suffix, name, shown, opacity)ui.Map.CloudStorageLayer
ArgumentTypeDetails
bucketStringThe bucket that contains the tiles.
pathStringThe path to this layer's tiles, relative to the bucket. A trailing "/" is optional.
maxZoomNumberThe maximum zoom level for which there are tiles.
suffixString, optionalThe tile source file suffix, if any.
nameString, optionalThe name of the layer.
shownBoolean, optionalWhether the layer is initially shown. Defaults to true.
opacityNumber, optionalThe layer's opacity represented as a number between 0 and 1. Defaults to 1.

ui.Map.CloudStorageLayer.getBucket

Returns the name of this layer's bucket.

UsageReturns
CloudStorageLayer.getBucket()String
ArgumentTypeDetails
this: ui.map.cloudstoragelayerui.Map.CloudStorageLayerThe ui.Map.CloudStorageLayer instance.

ui.Map.CloudStorageLayer.getMaxZoom

Returns the maximum zoom level of this layer's tileset.

UsageReturns
CloudStorageLayer.getMaxZoom()Number
ArgumentTypeDetails
this: ui.map.cloudstoragelayerui.Map.CloudStorageLayerThe ui.Map.CloudStorageLayer instance.

ui.Map.CloudStorageLayer.getName

Returns the name of the layer.

UsageReturns
CloudStorageLayer.getName()String
ArgumentTypeDetails
this: ui.map.abstractlayerui.Map.AbstractLayerThe ui.Map.AbstractLayer instance.

ui.Map.CloudStorageLayer.getOpacity

Returns the layer's opacity represented as a number between 0 and 1.

UsageReturns
CloudStorageLayer.getOpacity()Number
ArgumentTypeDetails
this: ui.map.abstractlayerui.Map.AbstractLayerThe ui.Map.AbstractLayer instance.

ui.Map.CloudStorageLayer.getPath

Returns the path within the bucket to the tiles.

UsageReturns
CloudStorageLayer.getPath()String
ArgumentTypeDetails
this: ui.map.cloudstoragelayerui.Map.CloudStorageLayerThe ui.Map.CloudStorageLayer instance.

ui.Map.CloudStorageLayer.getShown

Returns whether the layer is shown.

UsageReturns
CloudStorageLayer.getShown()Boolean
ArgumentTypeDetails
this: ui.map.abstractlayerui.Map.AbstractLayerThe ui.Map.AbstractLayer instance.

ui.Map.CloudStorageLayer.getSuffix

Returns the suffix for this layer's tile files.

UsageReturns
CloudStorageLayer.getSuffix()String
ArgumentTypeDetails
this: ui.map.cloudstoragelayerui.Map.CloudStorageLayerThe ui.Map.CloudStorageLayer instance.

ui.Map.CloudStorageLayer.setBucket

Sets the bucket for this layer.

Returns this map layer.

UsageReturns
CloudStorageLayer.setBucket(bucket)ui.Map.CloudStorageLayer
ArgumentTypeDetails
this: ui.map.cloudstoragelayerui.Map.CloudStorageLayerThe ui.Map.CloudStorageLayer instance.
bucketStringThe name of the Cloud Storage bucket with this layer's tiles.

ui.Map.CloudStorageLayer.setMaxZoom

Sets the maximum zoom level for tiles. When the user zooms in beyond this level, the parent tile at this level will be fetched and zoomed on the client.

Returns this map layer.

UsageReturns
CloudStorageLayer.setMaxZoom(maxZoom)ui.Map.CloudStorageLayer
ArgumentTypeDetails
this: ui.map.cloudstoragelayerui.Map.CloudStorageLayerThe ui.Map.CloudStorageLayer instance.
maxZoomNumberThe maximum zoom level with tiles.

ui.Map.CloudStorageLayer.setName

Sets the name of the layer.

Returns this map layer.

UsageReturns
CloudStorageLayer.setName(name)ui.Map.AbstractLayer
ArgumentTypeDetails
this: ui.map.abstractlayerui.Map.AbstractLayerThe ui.Map.AbstractLayer instance.
nameString, optionalThe name of the layer.

ui.Map.CloudStorageLayer.setOpacity

Sets the opacity of the layer.

Returns this map layer.

UsageReturns
CloudStorageLayer.setOpacity(opacity)ui.Map.AbstractLayer
ArgumentTypeDetails
this: ui.map.abstractlayerui.Map.AbstractLayerThe ui.Map.AbstractLayer instance.
opacityNumber, optionalThe layer's opacity represented as a number between 0 and 1.

ui.Map.CloudStorageLayer.setPath

Sets the location of the folder from which the layer will retrieve its tiles.

Returns this map layer.

UsageReturns
CloudStorageLayer.setPath(path)ui.Map.CloudStorageLayer
ArgumentTypeDetails
this: ui.map.cloudstoragelayerui.Map.CloudStorageLayerThe ui.Map.CloudStorageLayer instance.
pathStringThe path to this layer's tiles, relative to the bucket.

ui.Map.CloudStorageLayer.setShown

Sets the visibility of the layer.

Returns this map layer.

UsageReturns
CloudStorageLayer.setShown(shown)ui.Map.AbstractLayer
ArgumentTypeDetails
this: ui.map.abstractlayerui.Map.AbstractLayerThe ui.Map.AbstractLayer instance.
shownBoolean, optionalWhether the layer is shown.

ui.Map.CloudStorageLayer.setSuffix

Sets the CloudStorageLayer's file suffix.

Returns this map layer.

UsageReturns
CloudStorageLayer.setSuffix(suffix)ui.Map.CloudStorageLayer
ArgumentTypeDetails
this: ui.map.cloudstoragelayerui.Map.CloudStorageLayerThe ui.Map.CloudStorageLayer instance.
suffixStringThe suffix for the tile files, for example ".png".

ui.Map.DrawingTools

A set of tools for drawing on a map.

UsageReturns
ui.Map.DrawingTools(layers, shape, selected, shown, linked)ui.Map.DrawingTools
ArgumentTypeDetails
layersList, optionalAn array of geometry layers with which to initialize the drawing tools.
shapeString, optionalThe shape to draw. One of the following: point, line, polygon, or rectangle. Defaults to polygon.
selectedui.Map.GeometryLayer, optionalThe selected geometry layer. Defaults to null.
shownBoolean, optionalWhen false, hides the drawing tools or, when true, shows the shape selecter and allows the list panel's visibility to be determined by the presence of geometry layers in the list. Defaults to true.
linkedBoolean, optionalWhether the drawing tools are linked to the geometries in the imports pane. When false, the tools do not display imported geometries. Defaults to false.

ui.Map.DrawingTools.addLayer

Adds a given list of ee.Geometry objects to the drawing tools as a geometry layer.

Returns the new geometry layer.

UsageReturns
DrawingTools.addLayer(geometries, name, color, shown, locked)ui.Map.GeometryLayer
ArgumentTypeDetails
this: ui.map.drawingtoolsui.Map.DrawingToolsThe ui.Map.DrawingTools instance.
geometriesListThe geometries with which to initialize the layer.
nameString, optionalThe name of the layer.
colorString, optionalThe CSS color of shapes in the layer, for instance "white" or "#FFFFFF".
shownBoolean, optionalWhether to show the shapes in the layer. Defaults to true.
lockedBoolean, optionalWhether to lock shape editing in the layer. Defaults to false.

ui.Map.DrawingTools.clear

Clears the drawing tools.

Returns this set of drawing tools.

UsageReturns
DrawingTools.clear()ui.Map.DrawingTools
ArgumentTypeDetails
this: ui.map.drawingtoolsui.Map.DrawingToolsThe ui.Map.DrawingTools instance.

ui.Map.DrawingTools.draw

Enters drawing mode, in which a click on the map will begin drawing the selected shape.

Returns this set of drawing tools.

UsageReturns
DrawingTools.draw()ui.Map.DrawingTools
ArgumentTypeDetails
this: ui.map.drawingtoolsui.Map.DrawingToolsThe ui.Map.DrawingTools instance.

ui.Map.DrawingTools.edit

Starts editing the selected layer.

Returns this set of drawing tools.

UsageReturns
DrawingTools.edit()ui.Map.DrawingTools
ArgumentTypeDetails
this: ui.map.drawingtoolsui.Map.DrawingToolsThe ui.Map.DrawingTools instance.

ui.Map.DrawingTools.get

Returns either a clone of this object or, if a key is provided, the value of the property with the passed-in key. Look at the constructor's parameters to see which properties are available.

UsageReturns
DrawingTools.get(key)Object
ArgumentTypeDetails
this: ui.data.activedictionaryui.data.ActiveDictionaryThe ui.data.ActiveDictionary instance.
keyString, optionalThe key of the property to retrieve.

ui.Map.DrawingTools.getDrawModes

Gets the available draw modes on the drawing tool. The available draw mode shapes are: point, line, polygon, and rectangle.

Returns the list of enabled draw modes.

UsageReturns
DrawingTools.getDrawModes()List
ArgumentTypeDetails
this: ui.map.drawingtoolsui.Map.DrawingToolsThe ui.Map.DrawingTools instance.

ui.Map.DrawingTools.getLinked

Returns whether the drawing tools' geometries are linked to those in the imports panel.

UsageReturns
DrawingTools.getLinked()Boolean
ArgumentTypeDetails
this: ui.map.drawingtoolsui.Map.DrawingToolsThe ui.Map.DrawingTools instance.

ui.Map.DrawingTools.getMap

Returns the map for these drawing tools or null if the drawing tools have not been added to a map.

UsageReturns
DrawingTools.getMap()ui.Map
ArgumentTypeDetails
this: ui.map.drawingtoolsui.Map.DrawingToolsThe ui.Map.DrawingTools instance.

ui.Map.DrawingTools.getSelected

Returns the selected layer.

UsageReturns
DrawingTools.getSelected()ui.Map.GeometryLayer
ArgumentTypeDetails
this: ui.map.drawingtoolsui.Map.DrawingToolsThe ui.Map.DrawingTools instance.

ui.Map.DrawingTools.getShape

Returns the shape drawn when in drawing mode.

UsageReturns
DrawingTools.getShape()String
ArgumentTypeDetails
this: ui.map.drawingtoolsui.Map.DrawingToolsThe ui.Map.DrawingTools instance.

ui.Map.DrawingTools.getShown

Returns whether the drawing tools are shown.

UsageReturns
DrawingTools.getShown()Boolean
ArgumentTypeDetails
this: ui.map.drawingtoolsui.Map.DrawingToolsThe ui.Map.DrawingTools instance.

ui.Map.DrawingTools.layers

Returns the list of geometry layers in the drawing tools.

UsageReturns
DrawingTools.layers()ui.data.ActiveList
ArgumentTypeDetails
this: ui.map.drawingtoolsui.Map.DrawingToolsThe ui.Map.DrawingTools instance.

ui.Map.DrawingTools.onDraw

Registers a callback that's fired when a shape is drawn.

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
DrawingTools.onDraw(callback)String
ArgumentTypeDetails
this: ui.map.drawingtoolsui.Map.DrawingToolsThe ui.Map.DrawingTools instance.
callbackFunctionThe callback to fire when a shape is drawn. The callback is passed three parameters: the added ee.Geometry, the GeometryLayer to which the geometry was added, and the ui.Map.DrawingTools widget that the event listener is bound to.

ui.Map.DrawingTools.onEdit

Registers a callback that's fired when a shape is edited.

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
DrawingTools.onEdit(callback)String
ArgumentTypeDetails
this: ui.map.drawingtoolsui.Map.DrawingToolsThe ui.Map.DrawingTools instance.
callbackFunctionThe callback to fire when a shape is edited. The callback is passed three parameters: the edited ee.Geometry, the GeometryLayer to which the edited geometry belongs, and the ui.Map.DrawingTools widget that the event listener is bound to.

ui.Map.DrawingTools.onErase

Registers a callback that's fired when a shape is erased.

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
DrawingTools.onErase(callback)String
ArgumentTypeDetails
this: ui.map.drawingtoolsui.Map.DrawingToolsThe ui.Map.DrawingTools instance.
callbackFunctionThe callback to fire when a shape is erased. The callback is passed three parameters: the removed ee.Geometry, the GeometryLayer from which the geometry was removed, and the ui.Map.DrawingTools widget that the event listener is bound to.

ui.Map.DrawingTools.onLayerAdd

Registers a callback that's fired when a layer is added.

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
DrawingTools.onLayerAdd(callback)String
ArgumentTypeDetails
this: ui.map.drawingtoolsui.Map.DrawingToolsThe ui.Map.DrawingTools instance.
callbackFunctionThe callback to fire when a layer is added. The callback is passed two parameters: the added GeometryLayer and the ui.Map.DrawingTools widget that the event listener is bound to.

ui.Map.DrawingTools.onLayerConfig

Registers a callback that's fired after a layer's name or color is changed.

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
DrawingTools.onLayerConfig(callback)String
ArgumentTypeDetails
this: ui.map.drawingtoolsui.Map.DrawingToolsThe ui.Map.DrawingTools instance.
callbackFunctionThe callback to fire after a layer is configured. The callback is passed two parameters: the configured GeometryLayer and the ui.Map.DrawingTools widget that the event listener is bound to.

ui.Map.DrawingTools.onLayerRemove

Registers a callback that's fired when a layer is removed.

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
DrawingTools.onLayerRemove(callback)String
ArgumentTypeDetails
this: ui.map.drawingtoolsui.Map.DrawingToolsThe ui.Map.DrawingTools instance.
callbackFunctionThe callback to fire when a layer is removed. The callback is passed two parameters: the removed GeometryLayer and the ui.Map.DrawingTools widget that the event listener is bound to.

ui.Map.DrawingTools.onLayerSelect

Registers a callback that's fired when a layer is selected.

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
DrawingTools.onLayerSelect(callback)String
ArgumentTypeDetails
this: ui.map.drawingtoolsui.Map.DrawingToolsThe ui.Map.DrawingTools instance.
callbackFunctionThe callback to fire when a shape is selected. The callback is passed two parameters: the selected GeometryLayer (or null for deselect) and the ui.Map.DrawingTools widget that the event listener is bound to.

ui.Map.DrawingTools.onSelect

Registers a callback that's fired when a shape is selected.

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
DrawingTools.onSelect(callback)String
ArgumentTypeDetails
this: ui.map.drawingtoolsui.Map.DrawingToolsThe ui.Map.DrawingTools instance.
callbackFunctionThe callback to fire when a shape is selected. The callback is passed three parameters: the selected ee.Geometry, the GeometryLayer to which the selected geometry belongs, and the ui.Map.DrawingTools widget that the event listener is bound to.

ui.Map.DrawingTools.onShapeChange

Registers a callback that's fired when a drawing mode shape is changed.

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
DrawingTools.onShapeChange(callback)String
ArgumentTypeDetails
this: ui.map.drawingtoolsui.Map.DrawingToolsThe ui.Map.DrawingTools instance.
callbackFunctionThe callback to fire when the shape is changed. The callback is passed two parameters: the drawing mode shape as a string (or null for cancel) and the ui.Map.DrawingTools widget that the event listener is bound to. The shape values are:
  • point
  • line
  • polygon
  • rectangle
  • null

ui.Map.DrawingTools.set

Sets the value of a given property. Throws an error if the key provided is not supported by the object. Look at the constructor's parameters to see which properties can be set.

Returns this ui.data.ActiveDictionary.

UsageReturns
DrawingTools.set(keyOrDict, value)ui.data.ActiveDictionary
ArgumentTypeDetails
this: ui.data.activedictionaryui.data.ActiveDictionaryThe ui.data.ActiveDictionary instance.
keyOrDictObject|StringEither the key of the property to set or a dictionary of key/value pairs to set on the object.
valueObject, optionalThe property's new value. This is required when the first argument is a key string.

ui.Map.DrawingTools.setDrawModes

Sets the available draw mode shapes on the drawing tool. The available draw mode shapes are: point, line, polygon, and rectangle.

UsageReturns
DrawingTools.setDrawModes(drawModes)
ArgumentTypeDetails
this: ui.map.drawingtoolsui.Map.DrawingToolsThe ui.Map.DrawingTools instance.
drawModesList, optionalThe list of draw modes to enable. Defaults to all supported ones.

ui.Map.DrawingTools.setLinked

Sets whether the drawing tools' geometries are linked to the imports panel or isolated to the map.

Returns these ui.Map.DrawingTools.

UsageReturns
DrawingTools.setLinked(linked)ui.Map.DrawingTools
ArgumentTypeDetails
this: ui.map.drawingtoolsui.Map.DrawingToolsThe ui.Map.DrawingTools instance.
linkedBooleanWhether the geometries should be linked to the imports panel. When false, all geometries are local to the map instance.

ui.Map.DrawingTools.setSelected

Sets the selected layer.

Returns this set of drawing tools.

UsageReturns
DrawingTools.setSelected(layer)ui.Map.DrawingTools
ArgumentTypeDetails
this: ui.map.drawingtoolsui.Map.DrawingToolsThe ui.Map.DrawingTools instance.
layerui.Map.GeometryLayer, optionalThe layer to select or null to deselect all layers.

ui.Map.DrawingTools.setShape

Sets the draw mode shape and starts draw mode. The available draw mode shapes are: point, line, polygon, and rectangle.

Returns this set of drawing tools.

UsageReturns
DrawingTools.setShape(shape)ui.Map.DrawingTools
ArgumentTypeDetails
this: ui.map.drawingtoolsui.Map.DrawingToolsThe ui.Map.DrawingTools instance.
shapeStringThe shape to draw.

ui.Map.DrawingTools.setShown

Sets the visibility of the shape selector and geometry layer list.

Returns this set of drawing tools.

UsageReturns
DrawingTools.setShown(shown)ui.Map.DrawingTools
ArgumentTypeDetails
this: ui.map.drawingtoolsui.Map.DrawingToolsThe ui.Map.DrawingTools instance.
shownBooleanWhether to show the drawing tools.

ui.Map.DrawingTools.stop

Closes the drawing tools, exiting interactive drawing or editing.

Returns this set of drawing tools.

UsageReturns
DrawingTools.stop()ui.Map.DrawingTools
ArgumentTypeDetails
this: ui.map.drawingtoolsui.Map.DrawingToolsThe ui.Map.DrawingTools instance.

ui.Map.DrawingTools.toFeatureCollection

Returns a feature collection in which each geometry in the drawing tools is a feature.

UsageReturns
DrawingTools.toFeatureCollection(indexProperty)FeatureCollection
ArgumentTypeDetails
this: ui.map.drawingtoolsui.Map.DrawingToolsThe ui.Map.DrawingTools instance.
indexPropertyStringA property with this name will be assigned to every feature in the returned collection. The value of the property will be a number that corresponds to the index of the geometry layer to which the geometry belongs.

ui.Map.DrawingTools.unlisten

Deletes callbacks.

UsageReturns
DrawingTools.unlisten(idOrType)
ArgumentTypeDetails
this: ui.map.drawingtoolsui.Map.DrawingToolsThe ui.Map.DrawingTools instance.
idOrTypeString, optionalEither an ID returned by an onEventType() function during callback registration, an event type, or nothing. If an ID is passed, the corresponding callback is deleted. If an event type is passed, all callbacks for that type are deleted. If nothing is passed, all callbacks are deleted.

ui.Map.FeatureViewLayer

A layer generated from a FeatureView asset for display on a ui.Map.

UsageReturns
ui.Map.FeatureViewLayer(assetId, visParams, name, shown, opacity)ui.Map.FeatureViewLayer
ArgumentTypeDetails
assetIdStringThe asset ID for the FeatureView.
visParamsObject, optionalThe visualization parameters for this layer.
nameString, optionalThe name of the layer, which appears in the list of layers and when inspecting this layer. Defaults to the asset ID.
shownBoolean, optionalWhether the layer is initially shown on the map. Defaults to true.
opacityNumber, optionalThe layer's opacity represented as a number between 0 and 1. Defaults to 1.

ui.Map.FeatureViewLayer.getAssetId

Returns the asset ID for the FeatureView asset backing this layer.

UsageReturns
FeatureViewLayer.getAssetId()String
ArgumentTypeDetails
this: ui.map.featureviewlayerui.Map.FeatureViewLayerThe ui.Map.FeatureViewLayer instance.

ui.Map.FeatureViewLayer.getName

Returns the name of the layer.

UsageReturns
FeatureViewLayer.getName()String
ArgumentTypeDetails
this: ui.map.abstractlayerui.Map.AbstractLayerThe ui.Map.AbstractLayer instance.

ui.Map.FeatureViewLayer.getOpacity

Returns the layer's opacity represented as a number between 0 and 1.

UsageReturns
FeatureViewLayer.getOpacity()Number
ArgumentTypeDetails
this: ui.map.abstractlayerui.Map.AbstractLayerThe ui.Map.AbstractLayer instance.

ui.Map.FeatureViewLayer.getShown

Returns whether the layer is shown.

UsageReturns
FeatureViewLayer.getShown()Boolean
ArgumentTypeDetails
this: ui.map.abstractlayerui.Map.AbstractLayerThe ui.Map.AbstractLayer instance.

ui.Map.FeatureViewLayer.getVisParams

Returns the visualization parameters for this layer.

UsageReturns
FeatureViewLayer.getVisParams()Object
ArgumentTypeDetails
this: ui.map.featureviewlayerui.Map.FeatureViewLayerThe ui.Map.FeatureViewLayer instance.

ui.Map.FeatureViewLayer.setAssetId

Changes the asset being displayed on this layer.

Returns this map layer.

UsageReturns
FeatureViewLayer.setAssetId(assetId)ui.Map.FeatureViewLayer
ArgumentTypeDetails
this: ui.map.featureviewlayerui.Map.FeatureViewLayerThe ui.Map.FeatureViewLayer instance.
assetIdStringThe asset ID for the FeatureView backing this layer.

ui.Map.FeatureViewLayer.setName

Sets the name of the layer.

Returns this map layer.

UsageReturns
FeatureViewLayer.setName(name)ui.Map.AbstractLayer
ArgumentTypeDetails
this: ui.map.abstractlayerui.Map.AbstractLayerThe ui.Map.AbstractLayer instance.
nameString, optionalThe name of the layer.

ui.Map.FeatureViewLayer.setOpacity

Sets the opacity of the layer.

Returns this map layer.

UsageReturns
FeatureViewLayer.setOpacity(opacity)ui.Map.AbstractLayer
ArgumentTypeDetails
this: ui.map.abstractlayerui.Map.AbstractLayerThe ui.Map.AbstractLayer instance.
opacityNumber, optionalThe layer's opacity represented as a number between 0 and 1.

ui.Map.FeatureViewLayer.setShown

Sets the visibility of the layer.

Returns this map layer.

UsageReturns
FeatureViewLayer.setShown(shown)ui.Map.AbstractLayer
ArgumentTypeDetails
this: ui.map.abstractlayerui.Map.AbstractLayerThe ui.Map.AbstractLayer instance.
shownBoolean, optionalWhether the layer is shown.

ui.Map.FeatureViewLayer.setVisParams

Sets the visualization parameters for this layer.

Returns this map layer.

UsageReturns
FeatureViewLayer.setVisParams(visParams)ui.Map.FeatureViewLayer
ArgumentTypeDetails
this: ui.map.featureviewlayerui.Map.FeatureViewLayerThe ui.Map.FeatureViewLayer instance.
visParamsObject, optionalThe visualization parameters for this layer.

ui.Map.GeometryLayer

A layer of ee.Geometries for display as shapes on a ui.Map.

UsageReturns
ui.Map.GeometryLayer(geometries, name, color, shown, locked)ui.Map.GeometryLayer
ArgumentTypeDetails
geometriesList, optionalThe geometries with which to initialize the layer.
nameString, optionalThe name of the layer.
colorString, optionalThe CSS color of shapes in the layer, for instance "white" or "#FFFFFF". Defaults to "#000000" (black).
shownBoolean, optionalWhether to show the shapes in the layer. Defaults to true.
lockedBoolean, optionalWhether to lock shape editing in the layer. Defaults to false.

ui.Map.GeometryLayer.fromGeometry

Resets the layer's geometries by parsing individual geometries from an ee.Geometry.

Returns this geometry layer.

UsageReturns
GeometryLayer.fromGeometry(geometry)ui.Map.GeometryLayer
ArgumentTypeDetails
this: ui.map.geometrylayerui.Map.GeometryLayerThe ui.Map.GeometryLayer instance.
geometryGeometryA geometry with which to reset the layer's geometries.

ui.Map.GeometryLayer.geometries

Returns the active list of geometries associated with the layer.

UsageReturns
GeometryLayer.geometries()ui.data.ActiveList
ArgumentTypeDetails
this: ui.map.geometrylayerui.Map.GeometryLayerThe ui.Map.GeometryLayer instance.

ui.Map.GeometryLayer.get

Returns either a clone of this object or, if a key is provided, the value of the property with the passed-in key. Look at the constructor's parameters to see which properties are available.

UsageReturns
GeometryLayer.get(key)Object
ArgumentTypeDetails
this: ui.data.activedictionaryui.data.ActiveDictionaryThe ui.data.ActiveDictionary instance.
keyString, optionalThe key of the property to retrieve.

ui.Map.GeometryLayer.getColor

Returns the color of the layer.

UsageReturns
GeometryLayer.getColor()String
ArgumentTypeDetails
this: ui.map.geometrylayerui.Map.GeometryLayerThe ui.Map.GeometryLayer instance.

ui.Map.GeometryLayer.getEeObject

Returns the EE object associated with the layer.

UsageReturns
GeometryLayer.getEeObject()Feature|FeatureCollection|Geometry
ArgumentTypeDetails
this: ui.map.geometrylayerui.Map.GeometryLayerThe ui.Map.GeometryLayer instance.

ui.Map.GeometryLayer.getLocked

Returns whether the shapes in the layer are shown.

UsageReturns
GeometryLayer.getLocked()Boolean
ArgumentTypeDetails
this: ui.map.geometrylayerui.Map.GeometryLayerThe ui.Map.GeometryLayer instance.

ui.Map.GeometryLayer.getName

Returns the name of the layer.

UsageReturns
GeometryLayer.getName()String
ArgumentTypeDetails
this: ui.map.geometrylayerui.Map.GeometryLayerThe ui.Map.GeometryLayer instance.

ui.Map.GeometryLayer.getShown

Returns whether the shapes in the layer are shown.

UsageReturns
GeometryLayer.getShown()Boolean
ArgumentTypeDetails
this: ui.map.geometrylayerui.Map.GeometryLayerThe ui.Map.GeometryLayer instance.

ui.Map.GeometryLayer.openConfigurationDialog

Opens a configuration dialog for the layer. Use onLayerConfig to register a callback for when the user makes changes using the dialog.

Returns the geometry layer to be updated by the dialog.

UsageReturns
GeometryLayer.openConfigurationDialog()ui.Map.GeometryLayer
ArgumentTypeDetails
this: ui.map.geometrylayerui.Map.GeometryLayerThe ui.Map.GeometryLayer instance.

ui.Map.GeometryLayer.set

Sets the value of a given property. Throws an error if the key provided is not supported by the object. Look at the constructor's parameters to see which properties can be set.

Returns this ui.data.ActiveDictionary.

UsageReturns
GeometryLayer.set(keyOrDict, value)ui.data.ActiveDictionary
ArgumentTypeDetails
this: ui.data.activedictionaryui.data.ActiveDictionaryThe ui.data.ActiveDictionary instance.
keyOrDictObject|StringEither the key of the property to set or a dictionary of key/value pairs to set on the object.
valueObject, optionalThe property's new value. This is required when the first argument is a key string.

ui.Map.GeometryLayer.setColor

Sets the CSS color of shapes in the layer.

Returns this map layer.

UsageReturns
GeometryLayer.setColor(color)ui.Map.GeometryLayer
ArgumentTypeDetails
this: ui.map.geometrylayerui.Map.GeometryLayerThe ui.Map.GeometryLayer instance.
colorStringThe color of the layer.

ui.Map.GeometryLayer.setLocked

Sets the locked state of the layer. A locked layer disallows adding, removing, or editing the geometries on the layer from the user interface.

Returns this map layer.

UsageReturns
GeometryLayer.setLocked(locked)ui.Map.GeometryLayer
ArgumentTypeDetails
this: ui.map.geometrylayerui.Map.GeometryLayerThe ui.Map.GeometryLayer instance.
lockedBooleanWhether the layer is locked.

ui.Map.GeometryLayer.setName

Sets the name of the layer.

Returns this map layer.

UsageReturns
GeometryLayer.setName(name)ui.Map.GeometryLayer
ArgumentTypeDetails
this: ui.map.geometrylayerui.Map.GeometryLayerThe ui.Map.GeometryLayer instance.
nameStringThe name of the layer.

ui.Map.GeometryLayer.setShown

Sets the visibility of shapes in the layer.

Returns this map layer.

UsageReturns
GeometryLayer.setShown(shown)ui.Map.GeometryLayer
ArgumentTypeDetails
this: ui.map.geometrylayerui.Map.GeometryLayerThe ui.Map.GeometryLayer instance.
shownBooleanWhether the layer is shown.

ui.Map.GeometryLayer.toGeometry

Returns the layer's geometries as a single ee.Geometry.

UsageReturns
GeometryLayer.toGeometry()Geometry
ArgumentTypeDetails
this: ui.map.geometrylayerui.Map.GeometryLayerThe ui.Map.GeometryLayer instance.

ui.Map.Layer

A layer generated from an Earth Engine object for display on a ui.Map.

UsageReturns
ui.Map.Layer(eeObject, visParams, name, shown, opacity)ui.Map.Layer
ArgumentTypeDetails
eeObjectCollection|Feature|Image, optionalThe object to add to the map. Defaults to an empty ee.Image.
visParamsFeatureVisualizationParameters|ImageVisualizationParameters, optionalThe visualization parameters. See ee.data.getMapId() docs.
nameString, optionalThe name of the layer.
shownBoolean, optionalWhether the layer is initially shown. Defaults to true.
opacityNumber, optionalThe layer's opacity represented as a number between 0 and 1. Defaults to 1.

ui.Map.Layer.getEeObject

Returns the layer's ee.Object.

UsageReturns
Layer.getEeObject()Collection|Feature|Image
ArgumentTypeDetails
this: ui.map.layerui.Map.LayerThe ui.Map.Layer instance.

ui.Map.Layer.getName

Returns the name of the layer.

UsageReturns
Layer.getName()String
ArgumentTypeDetails
this: ui.map.abstractlayerui.Map.AbstractLayerThe ui.Map.AbstractLayer instance.

ui.Map.Layer.getOpacity

Returns the layer's opacity represented as a number between 0 and 1.

UsageReturns
Layer.getOpacity()Number
ArgumentTypeDetails
this: ui.map.abstractlayerui.Map.AbstractLayerThe ui.Map.AbstractLayer instance.

ui.Map.Layer.getShown

Returns whether the layer is shown.

UsageReturns
Layer.getShown()Boolean
ArgumentTypeDetails
this: ui.map.abstractlayerui.Map.AbstractLayerThe ui.Map.AbstractLayer instance.

ui.Map.Layer.getVisParams

Returns the layer's visualization parameters.

UsageReturns
Layer.getVisParams()FeatureVisualizationParameters|ImageVisualizationParameters
ArgumentTypeDetails
this: ui.map.layerui.Map.LayerThe ui.Map.Layer instance.

ui.Map.Layer.setEeObject

Sets the layer's ee.Object.

Returns this map layer.

UsageReturns
Layer.setEeObject(eeObject)ui.Map.Layer
ArgumentTypeDetails
this: ui.map.layerui.Map.LayerThe ui.Map.Layer instance.
eeObjectCollection|Feature|Image, optionalThe object to add to the map. Defaults to an empty ee.Image.

ui.Map.Layer.setName

Sets the name of the layer.

Returns this map layer.

UsageReturns
Layer.setName(name)ui.Map.AbstractLayer
ArgumentTypeDetails
this: ui.map.abstractlayerui.Map.AbstractLayerThe ui.Map.AbstractLayer instance.
nameString, optionalThe name of the layer.

ui.Map.Layer.setOpacity

Sets the opacity of the layer.

Returns this map layer.

UsageReturns
Layer.setOpacity(opacity)ui.Map.AbstractLayer
ArgumentTypeDetails
this: ui.map.abstractlayerui.Map.AbstractLayerThe ui.Map.AbstractLayer instance.
opacityNumber, optionalThe layer's opacity represented as a number between 0 and 1.

ui.Map.Layer.setShown

Sets the visibility of the layer.

Returns this map layer.

UsageReturns
Layer.setShown(shown)ui.Map.AbstractLayer
ArgumentTypeDetails
this: ui.map.abstractlayerui.Map.AbstractLayerThe ui.Map.AbstractLayer instance.
shownBoolean, optionalWhether the layer is shown.

ui.Map.Layer.setVisParams

Sets the layer's visualization parameters.

Returns this map layer.

UsageReturns
Layer.setVisParams(visParams)ui.Map.Layer
ArgumentTypeDetails
this: ui.map.layerui.Map.LayerThe ui.Map.Layer instance.
visParamsFeatureVisualizationParameters|ImageVisualizationParameters, optionalThe visualization parameters. See ee.data.getMapId() docs.

ui.Map.Linker

A utility for creating linked maps.

UsageReturns
ui.Map.Linker(maps, event)ui.Map.Linker
ArgumentTypeDetails
mapsList, optionalA list of maps to link.
eventString, optionalThe event to link across the maps. Defaults to "change-bounds". Possible events comprise:
  • change-bounds
  • change-center
  • change-zoom

ui.Map.Linker.add

Appends an element to the list.

Returns this ui.data.ActiveList.

UsageReturns
Linker.add(el)ui.data.ActiveList
ArgumentTypeDetails
this: ui.data.activelistui.data.ActiveListThe ui.data.ActiveList instance.
elObjectThe element to add.

ui.Map.Linker.forEach

Iterates over each element, calling the provided callback. The callback is called for each element like: callback(element, index).

UsageReturns
Linker.forEach(callback)
ArgumentTypeDetails
this: ui.data.activelistui.data.ActiveListThe ui.data.ActiveList instance.
callbackFunction

ui.Map.Linker.get

Returns the element at the specified index.

UsageReturns
Linker.get(index)Object
ArgumentTypeDetails
this: ui.data.activelistui.data.ActiveListThe ui.data.ActiveList instance.
indexNumberThe index of the element to return.

ui.Map.Linker.getJsArray

Returns the list as a JS array.

UsageReturns
Linker.getJsArray()List
ArgumentTypeDetails
this: ui.data.activelistui.data.ActiveListThe ui.data.ActiveList instance.

ui.Map.Linker.insert

Inserts an element at the specified index and shifts the rest of the list. If the specified index is greater than the length of the list, the element will be appended to the list.

Returns this ui.data.ActiveList.

UsageReturns
Linker.insert(index, el)ui.data.ActiveList
ArgumentTypeDetails
this: ui.data.activelistui.data.ActiveListThe ui.data.ActiveList instance.
indexNumberThe index at which to insert the element.
elObjectThe element to insert.

ui.Map.Linker.length

Returns the number of elements in the list.

UsageReturns
Linker.length()Number
ArgumentTypeDetails
this: ui.data.activelistui.data.ActiveListThe ui.data.ActiveList instance.

ui.Map.Linker.remove

Removes the specified element from the list.

Returns the removed element or null if the element was not present in the list.

UsageReturns
Linker.remove(el)Object
ArgumentTypeDetails
this: ui.data.activelistui.data.ActiveListThe ui.data.ActiveList instance.
elObjectThe element to remove.

ui.Map.Linker.reset

Replaces all elements in list with a new list or, if no list is provided, removes all elements from list.

Returns the elements in the list after the reset is applied.

UsageReturns
Linker.reset(list)List
ArgumentTypeDetails
this: ui.data.activelistui.data.ActiveListThe ui.data.ActiveList instance.
listList, optionalA list of elements.

ui.Map.Linker.set

Sets an element at the specified index. If the index exceeds that of the list's last element, the element will be added to the end of the list.

Returns this ui.data.ActiveList.

UsageReturns
Linker.set(index, el)ui.data.ActiveList
ArgumentTypeDetails
this: ui.data.activelistui.data.ActiveListThe ui.data.ActiveList instance.
indexNumberThe index to overwrite.
elObjectThe element to set.

ui.Map.add

Adds an item to the map. Can also be used to add widgets like ui.Label as well as some non-widget objects like ui.Map.Layer.

Returns the map.

UsageReturns
Map.add(item)ui.Map
ArgumentTypeDetails
this: ui.mapui.MapThe ui.Map instance.
itemObjectThe item to add.

ui.Map.addLayer

Adds a given EE object to the map as a layer.

Returns the new map layer.

UsageReturns
Map.addLayer(eeObject, visParams, name, shown, opacity)ui.Map.Layer
ArgumentTypeDetails
this: ui.mapui.MapThe ui.Map instance.
eeObjectCollection|Feature|Image|MapIdThe object to add to the map.
visParamsFeatureVisualizationParameters|ImageVisualizationParameters, optionalThe visualization parameters. For Images and ImageCollection, see ee.data.getMapId for valid parameters. For Features and FeatureCollections, the only supported key is "color", as a 6-character hex string in the RRGGBB format.
nameString, optionalThe name of the layer. Defaults to "Layer N".
shownBoolean, optionalA flag indicating whether the layer should be on by default.
opacityNumber, optionalThe layer's opacity represented as a number between 0 and 1. Defaults to 1.

ui.Map.centerObject

Centers the map view on a given object.

Returns this ui.Map.

UsageReturns
Map.centerObject(object, zoom, onComplete)ui.Map
ArgumentTypeDetails
this: ui.mapui.MapThe ui.Map instance.
objectElement|GeometryAn object to center on - a geometry, image or feature.
zoomNumber, optionalThe zoom level, from 0 to 24. If unspecified, computed based on the object's bounding box.
onCompleteFunction, optionalA callback which is triggered after the recentering completes successfully. Passing this parameter causes the `centerObject` operation to run asynchronously.

ui.Map.clear

Clears the map by removing all layers, listeners, and widgets and restoring the options to their defaults.

Returns the map.

UsageReturns
Map.clear()ui.Map
ArgumentTypeDetails
this: ui.mapui.MapThe ui.Map instance.

ui.Map.drawingTools

Returns the map's drawing tools, which can be used to create and edit shapes on the map. Adds the drawing tools to the map if none exist.

UsageReturns
Map.drawingTools()ui.Map.DrawingTools
ArgumentTypeDetails
this: ui.mapui.MapThe ui.Map instance.

ui.Map.getBounds

Returns the bounds of the current map view, as a list in the format [west, south, east, north] in degrees.

UsageReturns
Map.getBounds(asGeoJSON)GeoJSONGeometry|List|String
ArgumentTypeDetails
this: ui.mapui.MapThe ui.Map instance.
asGeoJSONBoolean, optionalIf true, returns map bounds as GeoJSON.

ui.Map.getCenter

Returns the coordinates at the center of the map.

UsageReturns
Map.getCenter()Geometry.Point
ArgumentTypeDetails
this: ui.mapui.MapThe ui.Map instance.

ui.Map.getScale

Returns the approximate pixel scale of the current map view, in meters.

UsageReturns
Map.getScale()Number|String
ArgumentTypeDetails
this: ui.mapui.MapThe ui.Map instance.

ui.Map.getZoom

Returns the current zoom level of the map.

UsageReturns
Map.getZoom()Number
ArgumentTypeDetails
this: ui.mapui.MapThe ui.Map instance.

ui.Map.insert

Inserts a widget into to the panel at the specified index.

Returns this panel.

UsageReturns
Map.insert(index, widget)ui.Panel
ArgumentTypeDetails
this: ui.panelui.PanelThe ui.Panel instance.
indexNumberThe index at which to insert the widget.
widgetui.WidgetThe widget to insert.

ui.Map.layers

Returns the list of layers associated with the map.

UsageReturns
Map.layers()ui.data.ActiveList
ArgumentTypeDetails
this: ui.mapui.MapThe ui.Map instance.

ui.Map.onChangeBounds

Registers a callback that's fired when the map bounds change. This is fired during pan, zoom, and when the map's bounds are changed programmatically.

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
Map.onChangeBounds(callback)String
ArgumentTypeDetails
this: ui.mapui.MapThe ui.Map instance.
callbackFunctionThe callback to fire when the map bounds change. The callback is passed two parameters: an object containing the coordinates of the new map center (with keys lon, lat, and zoom) and the map widget itself.

ui.Map.onChangeCenter

Registers a callback that's fired when the map center changes. This is fired during pan or when the map's center is changed programmatically.

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
Map.onChangeCenter(callback)String
ArgumentTypeDetails
this: ui.mapui.MapThe ui.Map instance.
callbackFunctionThe callback to fire when the map center changes. The callback is passed two parameters: an object containing the coordinates of the new center (with keys lon and lat) and the map widget itself.

ui.Map.onChangeZoom

Registers a callback that's fired when the map zoom level changes.

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
Map.onChangeZoom(callback)String
ArgumentTypeDetails
this: ui.mapui.MapThe ui.Map instance.
callbackFunctionThe callback to fire when the map zoom change. The callback is passed two parameters: the new zoom level and the map widget itself.

ui.Map.onClick

Registers a callback that's fired when the map is clicked.

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
Map.onClick(callback)String
ArgumentTypeDetails
this: ui.mapui.MapThe ui.Map instance.
callbackFunctionThe callback to fire when the map is clicked. The callback is passed an object containing the coordinates of the clicked point on the map (with keys lon and lat) and the map widget itself.

ui.Map.onIdle

Registers a callback that's fired when the map stops moving.

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
Map.onIdle(callback)String
ArgumentTypeDetails
this: ui.mapui.MapThe ui.Map instance.
callbackFunctionThe callback to fire when the map becomes idle. The callback is passed two parameters: an object containing the coordinates of the map center (with keys lon, lat, and zoom) and the map widget itself.

ui.Map.onTileLoaded

Registers a callback that's fired when a map tile has been loaded.

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
Map.onTileLoaded(callback)String
ArgumentTypeDetails
this: ui.mapui.MapThe ui.Map instance.
callbackFunctionCalled with an array of per layer values. Each value is the fraction of tiles still pending: a value of 0 means there are no more tiles to load for the layer.

ui.Map.remove

Removes the given item from the map, if it exists.

Returns the removed item or null if it hadn't been added to the map.

UsageReturns
Map.remove(item)Object
ArgumentTypeDetails
this: ui.mapui.MapThe ui.Map instance.
itemObjectThe item to remove.

ui.Map.setCenter

Centers the map view at the given coordinates with the given zoom level. If no zoom level is provided, it uses the most recent zoom level on the map.

Returns this ui.Map.

UsageReturns
Map.setCenter(lon, lat, zoom)ui.Map
ArgumentTypeDetails
this: ui.mapui.MapThe ui.Map instance.
lonNumberThe longitude of the center, in degrees.
latNumberThe latitude of the center, in degrees.
zoomNumber, optionalThe zoom level, from 0 to 24.

ui.Map.setControlVisibility

Sets the visibility of the controls on the map.

Returns this ui.Map.

UsageReturns
Map.setControlVisibility(all, layerList, zoomControl, scaleControl, mapTypeControl, fullscreenControl, drawingToolsControl)ui.Map
ArgumentTypeDetails
this: ui.mapui.MapThe ui.Map instance.
allBoolean, optionalWhether to show all controls. False hides all controls; true shows all controls. Overridden by individually set parameters. Note that setting this explicitly will affect any additional controls added in the future.
layerListBoolean, optionalWhen false, hides the layer list panel or, when true, allows the layer list panel's visibility to be determined by the presence of layers in the list. The default is to show the list.
zoomControlBoolean, optionalWhether the zoom control is visible. Defaults to true.
scaleControlBoolean, optionalWhether to show the control which indicates the scale at the map's current zoom level. Defaults to true.
mapTypeControlBoolean, optionalWhether to show the control that allows the user to change the base map. Defaults to true.
fullscreenControlBoolean, optionalWhether to show the control that allows the user to make the map full-screen. Defaults to true.
drawingToolsControlBoolean, optionalWhether to show the control that allows the user to add or edit the geometry drawing tools. Defaults to true if the drawing tools were previously added to the map. Ignored if the drawing tools were not previously added to the map.

ui.Map.setGestureHandling

Controls how gestures are handled on the map.

See https://developers.google.com/maps/documentation/javascript/reference/map#MapOptions.gestureHandling.

UsageReturns
Map.setGestureHandling(option)
ArgumentTypeDetails
this: ui.mapui.MapThe ui.Map instance.
optionStringThe option that controls how gestures are handled on the map. Allowed values:
  • "cooperative": Scroll events and one-finger touch gestures scroll the page, and do not zoom or pan the map. Two-finger touch gestures pan and zoom the map. Scroll events with a ctrl key or ⌘ key pressed zoom the map. In this mode the map cooperates with the page.
  • "greedy": All touch gestures and scroll events pan or zoom the map.
  • "none": The map cannot be panned or zoomed by user gestures.
  • "auto": (default) Gesture handling is either cooperative or greedy, depending on whether the page is scrollable or in an iframe.

ui.Map.setLocked

Limits panning and zooming on the map.

  - To lock both panning and zooming, set locked to true and nothing else.

  - To allow panning and limit the min and max zoom, set locked to false and supply the minZoom and maxZoom parameters.

  - To disallow panning and limit min and max zoom, set locked to true and supply the minZoom and maxZoom parameters.

  - To reset the map to default, set locked to false and nothing else.

UsageReturns
Map.setLocked(locked, minZoom, maxZoom)
ArgumentTypeDetails
this: ui.mapui.MapThe ui.Map instance.
lockedBooleanWhether the map should be locked or not.
minZoomNumber, optional(optional) The minimum zoom for the map, between 0 and 24, inclusive.
maxZoomNumber, optional(optional) The maximum zoom for the map, between 0 and 24, inclusive.

ui.Map.setOptions

Modifies the Google Maps basemap. Allows for: 1) Setting the current MapType. 2) Providing custom styles for the basemap (MapTypeStyles). 3) Setting the list of available mapTypesIds for the basemap.

If called with no parameters, resets the map type to the Google Maps default.

Returns this ui.Map.

UsageReturns
Map.setOptions(mapTypeId, styles, types)ui.Map
ArgumentTypeDetails
this: ui.mapui.MapThe ui.Map instance.
mapTypeIdString, optionalA mapTypeId to set the basemap to. Can be one of "ROADMAP", "SATELLITE", "HYBRID", or "TERRAIN" to select one of the standard Google Maps API map types, or one of the keys specified in the opt_styles dictionary. If left as null and only 1 style is specified in opt_styles, that style will be used.
stylesObject, optionalA dictionary of custom MapTypeStyle objects keyed with a name that will appear in the map's Map Type Controls. See: https://developers.google.com/maps/documentation/javascript/reference#MapTypeStyle
typesList, optionalA list of mapTypeIds to make available. If omitted, but opt_styles is specified, appends all of the style keys to the standard Google Maps API map types.

ui.Map.setZoom

Sets the zoom level of the map.

Returns this ui.Map.

UsageReturns
Map.setZoom(zoom)ui.Map
ArgumentTypeDetails
this: ui.mapui.MapThe ui.Map instance.
zoomNumberThe zoom level, from 0 to 24, to set for the map.

ui.Map.style

Returns the map's style ActiveDictionary, which can be modified to update the map's styles.

In addition to the standard UI API styles listed in the ui.Panel.style() documentation, ui.Map supports the following custom style option:

  - cursor, which can be 'crosshair' or 'hand' (default)

UsageReturns
Map.style()ui.data.ActiveDictionary
ArgumentTypeDetails
this: ui.mapui.MapThe ui.Map instance.

ui.Map.unlisten

Deletes callbacks.

UsageReturns
Map.unlisten(idOrType)
ArgumentTypeDetails
this: ui.mapui.MapThe ui.Map instance.
idOrTypeString, optionalEither an ID returned by listen() when a callback was registered, an event type, or nothing. If an ID is passed, the corresponding callback is deleted. If an event type is passed, all callbacks registered with that event type are deleted. If nothing is passed, all callbacks are deleted.

ui.Map.widgets

Returns the list of widgets currently in the panel.

UsageReturns
Map.widgets()ui.data.ActiveList
ArgumentTypeDetails
this: ui.panelui.PanelThe ui.Panel instance.

ui.Panel

A widget that can hold other widgets. Use panels to construct complex combinations of nested widgets.

Panels can be added to ui.root but not printed to the console with print().

UsageReturns
ui.Panel(widgets, layout, style)ui.Panel
ArgumentTypeDetails
widgetsList, optionalThe list of widgets or a single widget to add to the panel. Defaults to an empty array.
layoutString|ui.Panel.Layout, optionalThe layout to use for this panel. If a string is passed in, it's taken as a shortcut to the layout constructor with that name. Defaults to 'flow'.
styleObject, optionalAn object of allowed CSS styles with their values to be set for this widget. See style() documentation.

ui.Panel.Layout.absolute

Returns a layout that places its widgets absolutely relative to the panel.

An added widget's "position" style property determines how it is placed. The following positions are supported:

  - top-left, top-center, top-right

  - middle-left, middle-right

  - bottom-left, bottom-center, bottom-right

If no position is specified, the widget will be placed behind (that is, with a lower z-index than) the positioned widgets.

UsageReturns
ui.Panel.Layout.absolute()ui.Panel.Layout

No arguments.

ui.Panel.Layout.flow

Returns a layout that places its widgets in a flow, either horizontal or vertical. By default, widgets take up their natural space within a flow layout panel. Set the "stretch" style property on an added widget to stretch it to fill available space in the relevant direction:   - horizontal, vertical, both When multiple widgets are stretched, the available space is split equally among them. Panels are widgets themselves and can be stretched by specifying a "stretch" style property.
UsageReturns
ui.Panel.Layout.flow(direction, wrap)ui.Panel.Layout
ArgumentTypeDetails
directionString, optionalThe direction of the flow. One of 'horizontal' or 'vertical'. Defaults to 'vertical'.
wrapBoolean, optionalWhether to wrap children in the layout if there are too many to show in one line. Defaults to false.

ui.Panel.add

Adds a widget to the panel.

Returns this panel.

UsageReturns
Panel.add(widget)ui.Panel
ArgumentTypeDetails
this: ui.panelui.PanelThe ui.Panel instance.
widgetui.WidgetThe widget to be added.

ui.Panel.clear

Removes all widgets from the panel.

Returns this panel.

UsageReturns
Panel.clear()ui.Panel
ArgumentTypeDetails
this: ui.panelui.PanelThe ui.Panel instance.

ui.Panel.getLayout

Gets the panel's layout.

UsageReturns
Panel.getLayout()ui.Panel.Layout
ArgumentTypeDetails
this: ui.panelui.PanelThe ui.Panel instance.

ui.Panel.insert

Inserts a widget into to the panel at the specified index.

Returns this panel.

UsageReturns
Panel.insert(index, widget)ui.Panel
ArgumentTypeDetails
this: ui.panelui.PanelThe ui.Panel instance.
indexNumberThe index at which to insert the widget.
widgetui.WidgetThe widget to insert.

ui.Panel.remove

Removes the given widget from the panel, if it exists.

Returns whether the widget was successfully removed.

UsageReturns
Panel.remove(widget)Boolean
ArgumentTypeDetails
this: ui.panelui.PanelThe ui.Panel instance.
widgetui.WidgetThe widget to remove.

ui.Panel.setLayout

Sets the panel's layout.

Returns this panel.

UsageReturns
Panel.setLayout(layout)ui.Panel
ArgumentTypeDetails
this: ui.panelui.PanelThe ui.Panel instance.
layoutui.Panel.LayoutThe new layout.

ui.Panel.style

Returns the widget's style ActiveDictionary, which can be modified to update the widget's styles.

Properties which behave like their CSS counterparts:

  - height, maxHeight, minHeight (e.g. '100px')

  - width, maxWidth, minWidth (e.g. '100px')

  - padding, margin (e.g. '4px 4px 4px 4px' or simply '4px')

  - color, backgroundColor (e.g. 'red' or '#FF0000')

  - border (e.g. '1px solid black')

  - fontSize (e.g. '24px')

  - fontStyle (e.g. 'italic')

  - fontWeight (e.g. 'bold' or '100')

  - fontFamily (e.g. 'monospace' or 'serif')

  - textAlign (e.g. 'left' or 'center')

  - textDecoration (e.g. 'underline' or 'line-through')

  - whiteSpace (e.g. 'nowrap' or 'pre')

  - shown (true or false)

Supported custom layout properties (see ui.Panel.Layout documentation):

  - stretch ('horizontal', 'vertical', 'both')

  - position ('top-right', 'top-center', 'top-left', 'bottom-right', ...)

UsageReturns
Panel.style()ui.data.ActiveDictionary
ArgumentTypeDetails
this: ui.widgetui.WidgetThe ui.Widget instance.

ui.Panel.widgets

Returns the list of widgets currently in the panel.

UsageReturns
Panel.widgets()ui.data.ActiveList
ArgumentTypeDetails
this: ui.panelui.PanelThe ui.Panel instance.

ui.Select

A printable select menu with a callback.

UsageReturns
ui.Select(items, placeholder, value, onChange, disabled, style)ui.Select
ArgumentTypeDetails
itemsList, optionalThe list of options to add to the select. Defaults to an empty array.
placeholderString, optionalThe placeholder shown when no value is selected. Defaults to "Select a value...".
valueString, optionalThe select's value. Defaults to null.
onChangeFunction, optionalThe callback to fire when an item is selected. The callback is passed the currently selected value and the select widget.
disabledBoolean, optionalWhether the select is disabled. Defaults to false.
styleObject, optionalAn object of allowed CSS styles with their values to be set for this widget. See style() documentation.

ui.Select.getDisabled

Returns whether the select is disabled.

UsageReturns
Select.getDisabled()Boolean
ArgumentTypeDetails
this: ui.selectui.SelectThe ui.Select instance.

ui.Select.getPlaceholder

Returns the select's placeholder text.

UsageReturns
Select.getPlaceholder()String
ArgumentTypeDetails
this: ui.selectui.SelectThe ui.Select instance.

ui.Select.getValue

Returns the currently selected value.

UsageReturns
Select.getValue()String
ArgumentTypeDetails
this: ui.selectui.SelectThe ui.Select instance.

ui.Select.items

See ui.data.ActiveList.

Returns the list of items in the selection menu.

UsageReturns
Select.items()ui.data.ActiveList
ArgumentTypeDetails
this: ui.selectui.SelectThe ui.Select instance.

ui.Select.onChange

Registers a callback that's fired when an item is selected.

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
Select.onChange(callback)String
ArgumentTypeDetails
this: ui.selectui.SelectThe ui.Select instance.
callbackFunctionThe callback to fire when an item is selected. The callback is passed the currently selected value and the select widget.

ui.Select.setDisabled

Sets whether the select is disabled.

Returns this select.

UsageReturns
Select.setDisabled(disabled)ui.Select
ArgumentTypeDetails
this: ui.selectui.SelectThe ui.Select instance.
disabledBooleanWhether the select is disabled.

ui.Select.setPlaceholder

Sets the select's placeholder text, which is shown when no value is selected.

Returns this select.

UsageReturns
Select.setPlaceholder(placeholder)ui.Select
ArgumentTypeDetails
this: ui.selectui.SelectThe ui.Select instance.
placeholderStringThe select's placeholder text.

ui.Select.setValue

Sets the selected value.

Returns this select.

UsageReturns
Select.setValue(value, trigger)ui.Select
ArgumentTypeDetails
this: ui.selectui.SelectThe ui.Select instance.
valueStringThe value to select.
triggerBoolean, optionalWhether to trigger onChange callbacks when the value property changes. Defaults to true.

ui.Select.style

Returns the widget's style ActiveDictionary, which can be modified to update the widget's styles.

Properties which behave like their CSS counterparts:

  - height, maxHeight, minHeight (e.g. '100px')

  - width, maxWidth, minWidth (e.g. '100px')

  - padding, margin (e.g. '4px 4px 4px 4px' or simply '4px')

  - color, backgroundColor (e.g. 'red' or '#FF0000')

  - border (e.g. '1px solid black')

  - fontSize (e.g. '24px')

  - fontStyle (e.g. 'italic')

  - fontWeight (e.g. 'bold' or '100')

  - fontFamily (e.g. 'monospace' or 'serif')

  - textAlign (e.g. 'left' or 'center')

  - textDecoration (e.g. 'underline' or 'line-through')

  - whiteSpace (e.g. 'nowrap' or 'pre')

  - shown (true or false)

Supported custom layout properties (see ui.Panel.Layout documentation):

  - stretch ('horizontal', 'vertical', 'both')

  - position ('top-right', 'top-center', 'top-left', 'bottom-right', ...)

UsageReturns
Select.style()ui.data.ActiveDictionary
ArgumentTypeDetails
this: ui.widgetui.WidgetThe ui.Widget instance.

ui.Select.unlisten

Deletes callbacks.

UsageReturns
Select.unlisten(idOrType)
ArgumentTypeDetails
this: ui.widgetui.WidgetThe ui.Widget instance.
idOrTypeString, optionalEither an ID returned by an onEventType() function during callback registration, an event type, or nothing. If an ID is passed, the corresponding callback is deleted. If an event type is passed, all callbacks for that type are deleted. If nothing is passed, all callbacks are deleted.

ui.Slider

A draggable target that ranges linearly between two numeric values. The value of the slider is displayed as a label alongside it.

UsageReturns
ui.Slider(min, max, value, step, onChange, direction, disabled, style)ui.Slider
ArgumentTypeDetails
minNumber, optionalThe minimum value. Defaults to 0.
maxNumber, optionalThe maximum value. Defaults to 1.
valueNumber, optionalThe initial value. Defaults to 0.
stepNumber, optionalThe step size for the slider. Defaults to 0.01.
onChangeFunction, optionalA callback to fire when the slider's state changes. The callback is passed the slider's current value and the slider widget.
directionString, optionalThe direction of the slider. One of 'horizontal' or 'vertical'. Defaults to 'horizontal'.
disabledBoolean, optionalWhether the slider is disabled. Defaults to false.
styleObject, optionalAn object of allowed CSS styles with their values to be set for this widget. See style() documentation.

ui.Slider.getDisabled

Returns whether the slider is disabled.

UsageReturns
Slider.getDisabled()Boolean
ArgumentTypeDetails
this: ui.sliderui.SliderThe ui.Slider instance.

ui.Slider.getMax

Returns the slider's maximum value.

UsageReturns
Slider.getMax()Number
ArgumentTypeDetails
this: ui.sliderui.SliderThe ui.Slider instance.

ui.Slider.getMin

Returns the slider's minimum value.

UsageReturns
Slider.getMin()Number
ArgumentTypeDetails
this: ui.sliderui.SliderThe ui.Slider instance.

ui.Slider.getStep

Returns the slider's step value.

UsageReturns
Slider.getStep()Number
ArgumentTypeDetails
this: ui.sliderui.SliderThe ui.Slider instance.

ui.Slider.getValue

Returns the current slider value.

UsageReturns
Slider.getValue()Number
ArgumentTypeDetails
this: ui.sliderui.SliderThe ui.Slider instance.

ui.Slider.onChange

Registers a callback that's fired when the slider's state changes. If the change is due to the user dragging the slider, the event will not fire until the drag completes.

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
Slider.onChange(callback)String
ArgumentTypeDetails
this: ui.sliderui.SliderThe ui.Slider instance.
callbackFunctionThe callback to fire when the slider's state changes. The callback is passed the slider's current value and the slider widget.

ui.Slider.onSlide

Registers a callback that's fired when the slider's state changes. The callback will be invoked repeatedly while the user is dragging the slider.

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
Slider.onSlide(callback)String
ArgumentTypeDetails
this: ui.sliderui.SliderThe ui.Slider instance.
callbackFunctionThe callback to fire when the slider's state changes. The callback is passed the slider's current value.

ui.Slider.setDisabled

Sets whether the slider is disabled.

Returns this slider.

UsageReturns
Slider.setDisabled(disabled)ui.Slider
ArgumentTypeDetails
this: ui.sliderui.SliderThe ui.Slider instance.
disabledBooleanWhether the slider is disabled.

ui.Slider.setMax

Sets the maximum value of the slider.

Returns this slider.

UsageReturns
Slider.setMax(value)ui.Slider
ArgumentTypeDetails
this: ui.sliderui.SliderThe ui.Slider instance.
valueNumberThe slider's maximum value.

ui.Slider.setMin

Sets the minimum value of the slider.

Returns this slider.

UsageReturns
Slider.setMin(value)ui.Slider
ArgumentTypeDetails
this: ui.sliderui.SliderThe ui.Slider instance.
valueNumberThe slider's minimum value.

ui.Slider.setStep

Sets the step value of the slider.

Returns this slider.

UsageReturns
Slider.setStep(value)ui.Slider
ArgumentTypeDetails
this: ui.sliderui.SliderThe ui.Slider instance.
valueNumberThe slider's step value.

ui.Slider.setValue

Set the value of the slider.

Returns this slider.

UsageReturns
Slider.setValue(value, trigger)ui.Slider
ArgumentTypeDetails
this: ui.sliderui.SliderThe ui.Slider instance.
valueNumberThe value to slider.
triggerBoolean, optionalWhether to trigger onChange callbacks when the value property changes. Defaults to true.

ui.Slider.style

Returns the widget's style ActiveDictionary, which can be modified to update the widget's styles.

Properties which behave like their CSS counterparts:

  - height, maxHeight, minHeight (e.g. '100px')

  - width, maxWidth, minWidth (e.g. '100px')

  - padding, margin (e.g. '4px 4px 4px 4px' or simply '4px')

  - color, backgroundColor (e.g. 'red' or '#FF0000')

  - border (e.g. '1px solid black')

  - fontSize (e.g. '24px')

  - fontStyle (e.g. 'italic')

  - fontWeight (e.g. 'bold' or '100')

  - fontFamily (e.g. 'monospace' or 'serif')

  - textAlign (e.g. 'left' or 'center')

  - textDecoration (e.g. 'underline' or 'line-through')

  - whiteSpace (e.g. 'nowrap' or 'pre')

  - shown (true or false)

Supported custom layout properties (see ui.Panel.Layout documentation):

  - stretch ('horizontal', 'vertical', 'both')

  - position ('top-right', 'top-center', 'top-left', 'bottom-right', ...)

UsageReturns
Slider.style()ui.data.ActiveDictionary
ArgumentTypeDetails
this: ui.widgetui.WidgetThe ui.Widget instance.

ui.Slider.unlisten

Deletes callbacks.

UsageReturns
Slider.unlisten(idOrType)
ArgumentTypeDetails
this: ui.widgetui.WidgetThe ui.Widget instance.
idOrTypeString, optionalEither an ID returned by an onEventType() function during callback registration, an event type, or nothing. If an ID is passed, the corresponding callback is deleted. If an event type is passed, all callbacks for that type are deleted. If nothing is passed, all callbacks are deleted.

ui.SplitPanel

A widget containing two panels with a divider between them. The divider can be dragged, allowing the panels to be resized. One or both panels may be ui.Map objects.

By default the layout initializes with a 50/50 split. The width and max/minWidth styles on the panels control the split sizing for horizontal orientations. Similarly, use height and max/minHeight for vertical. These can be given in pixels as '{n}px' or as a percentage of the containing SplitPanel as '{n}%'.

Note that the given size for the second panel will be ignored if the first panel size is specified, since the overall width of the split panel is controlled independently. Max/min sizes may be set for both panels.

UsageReturns
ui.SplitPanel(firstPanel, secondPanel, orientation, wipe, style)ui.SplitPanel
ArgumentTypeDetails
firstPanelui.Panel, optionalThe left or top panel. Defaults to a new instance of ui.Panel.
secondPanelui.Panel, optionalThe bottom or right panel. Defaults to a new instance of ui.Panel.
orientationString, optionalOne of "horizontal" or "vertical". Defaults to "horizontal".
wipeBoolean, optionalWhether to enable the wiping effect. When this mode is enabled, both panels take up all available space, and dragging the divider doesn't set the size of the panels but rather determines how much of each panel is shown. This effect is analogous to a "wipe transition". This mode is useful for comparing two maps. Defaults to false.
styleObject, optionalAn object of allowed CSS styles with their values to be set for this panel. Defaults to an empty object.

ui.SplitPanel.getFirstPanel

Returns the first panel in the split panel.

UsageReturns
SplitPanel.getFirstPanel()ui.Panel
ArgumentTypeDetails
this: ui.splitpanelui.SplitPanelThe ui.SplitPanel instance.

ui.SplitPanel.getOrientation

Returns the panel's orientation.

UsageReturns
SplitPanel.getOrientation()String
ArgumentTypeDetails
this: ui.splitpanelui.SplitPanelThe ui.SplitPanel instance.

ui.SplitPanel.getPanel

Returns the requested panel in the split panel.

UsageReturns
SplitPanel.getPanel(index)ui.Panel
ArgumentTypeDetails
this: ui.splitpanelui.SplitPanelThe ui.SplitPanel instance.
indexNumber0 for top or left panel, 1 for bottom or right panel.

ui.SplitPanel.getSecondPanel

Returns the second panel in the split panel.

UsageReturns
SplitPanel.getSecondPanel()ui.Panel
ArgumentTypeDetails
this: ui.splitpanelui.SplitPanelThe ui.SplitPanel instance.

ui.SplitPanel.getWipe

Returns whether the wiping effect is enabled.

UsageReturns
SplitPanel.getWipe()Boolean
ArgumentTypeDetails
this: ui.splitpanelui.SplitPanelThe ui.SplitPanel instance.

ui.SplitPanel.setFirstPanel

Returns this split panel.

UsageReturns
SplitPanel.setFirstPanel(panel)ui.SplitPanel
ArgumentTypeDetails
this: ui.splitpanelui.SplitPanelThe ui.SplitPanel instance.
panelui.PanelThe panel to display left or on top of the split.

ui.SplitPanel.setOrientation

Sets the panel's orientation; one of "horizontal" or "vertical".

Returns this split panel.

UsageReturns
SplitPanel.setOrientation(orientation)ui.SplitPanel
ArgumentTypeDetails
this: ui.splitpanelui.SplitPanelThe ui.SplitPanel instance.
orientationStringThe new orientation.

ui.SplitPanel.setPanel

Returns the requested panel in the split panel.

UsageReturns
SplitPanel.setPanel(index, panel)ui.Panel
ArgumentTypeDetails
this: ui.splitpanelui.SplitPanelThe ui.SplitPanel instance.
indexNumber0 for top or left panel, 1 for bottom or right panel.
panelui.PanelThe panel to add to the split panel.

ui.SplitPanel.setSecondPanel

Returns this split panel.

UsageReturns
SplitPanel.setSecondPanel(panel)ui.SplitPanel
ArgumentTypeDetails
this: ui.splitpanelui.SplitPanelThe ui.SplitPanel instance.
panelui.PanelThe panel to display right of or below the split.

ui.SplitPanel.setWipe

Enables or disables the wiping effect.

Returns this split panel.

UsageReturns
SplitPanel.setWipe(wipe)ui.SplitPanel
ArgumentTypeDetails
this: ui.splitpanelui.SplitPanelThe ui.SplitPanel instance.
wipeBooleanWhether to enable the wiping effect.

ui.SplitPanel.style

Returns the widget's style ActiveDictionary, which can be modified to update the widget's styles.

Properties which behave like their CSS counterparts:

  - height, maxHeight, minHeight (e.g. '100px')

  - width, maxWidth, minWidth (e.g. '100px')

  - padding, margin (e.g. '4px 4px 4px 4px' or simply '4px')

  - color, backgroundColor (e.g. 'red' or '#FF0000')

  - border (e.g. '1px solid black')

  - fontSize (e.g. '24px')

  - fontStyle (e.g. 'italic')

  - fontWeight (e.g. 'bold' or '100')

  - fontFamily (e.g. 'monospace' or 'serif')

  - textAlign (e.g. 'left' or 'center')

  - textDecoration (e.g. 'underline' or 'line-through')

  - whiteSpace (e.g. 'nowrap' or 'pre')

  - shown (true or false)

Supported custom layout properties (see ui.Panel.Layout documentation):

  - stretch ('horizontal', 'vertical', 'both')

  - position ('top-right', 'top-center', 'top-left', 'bottom-right', ...)

UsageReturns
SplitPanel.style()ui.data.ActiveDictionary
ArgumentTypeDetails
this: ui.widgetui.WidgetThe ui.Widget instance.

ui.SplitPanel.unlisten

Deletes callbacks.

UsageReturns
SplitPanel.unlisten(idOrType)
ArgumentTypeDetails
this: ui.widgetui.WidgetThe ui.Widget instance.
idOrTypeString, optionalEither an ID returned by an onEventType() function during callback registration, an event type, or nothing. If an ID is passed, the corresponding callback is deleted. If an event type is passed, all callbacks for that type are deleted. If nothing is passed, all callbacks are deleted.

ui.Textbox

A textbox that enables the user to input text information.

UsageReturns
ui.Textbox(placeholder, value, onChange, disabled, style)ui.Textbox
ArgumentTypeDetails
placeholderString, optionalThe placeholder text to display when the textbox is empty. Defaults to none.
valueString, optionalThe textbox's value. Defaults to none.
onChangeFunction, optionalThe callback to fire when the text changes. The callback is passed the text currently in the textbox and the textbox widget.
disabledBoolean, optionalWhether the textbox is disabled. Defaults to false.
styleObject, optionalAn object of allowed CSS styles with their values to be set for this widget. See style() documentation.

ui.Textbox.getDisabled

Returns whether the textbox is disabled.

UsageReturns
Textbox.getDisabled()Boolean
ArgumentTypeDetails
this: ui.textboxui.TextboxThe ui.Textbox instance.

ui.Textbox.getPlaceholder

Returns the textbox's placeholder text.

UsageReturns
Textbox.getPlaceholder()String
ArgumentTypeDetails
this: ui.textboxui.TextboxThe ui.Textbox instance.

ui.Textbox.getValue

Returns the value of the textbox.

UsageReturns
Textbox.getValue()String
ArgumentTypeDetails
this: ui.textboxui.TextboxThe ui.Textbox instance.

ui.Textbox.onChange

Registers a callback that's called when text in the textbox changes.

In particular, the callback is called when:

  - The user types a new value and then either the textbox loses focus or the user presses enter.

  - A new value is set programmatically with set('value', newValue).

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
Textbox.onChange(callback)String
ArgumentTypeDetails
this: ui.textboxui.TextboxThe ui.Textbox instance.
callbackFunctionThe callback to fire when the text changes. The callback is passed the text currently in the textbox and the textbox widget.

ui.Textbox.setDisabled

Sets whether the textbox is disabled.

Returns this textbox.

UsageReturns
Textbox.setDisabled(disabled)ui.Textbox
ArgumentTypeDetails
this: ui.textboxui.TextboxThe ui.Textbox instance.
disabledBooleanWhether the textbox is disabled.

ui.Textbox.setPlaceholder

Sets the textbox's placeholder text, which is shown when no text is entered.

Returns this select.

UsageReturns
Textbox.setPlaceholder(placeholder)ui.Textbox
ArgumentTypeDetails
this: ui.textboxui.TextboxThe ui.Textbox instance.
placeholderStringThe select's placeholder text.

ui.Textbox.setValue

Sets the value of the textbox.

Returns this textbox.

UsageReturns
Textbox.setValue(value, trigger)ui.Textbox
ArgumentTypeDetails
this: ui.textboxui.TextboxThe ui.Textbox instance.
valueStringThe value of the textbox.
triggerBoolean, optionalWhether to trigger onChange callbacks when the value property changes. Defaults to true.

ui.Textbox.style

Returns the widget's style ActiveDictionary, which can be modified to update the widget's styles.

Properties which behave like their CSS counterparts:

  - height, maxHeight, minHeight (e.g. '100px')

  - width, maxWidth, minWidth (e.g. '100px')

  - padding, margin (e.g. '4px 4px 4px 4px' or simply '4px')

  - color, backgroundColor (e.g. 'red' or '#FF0000')

  - border (e.g. '1px solid black')

  - fontSize (e.g. '24px')

  - fontStyle (e.g. 'italic')

  - fontWeight (e.g. 'bold' or '100')

  - fontFamily (e.g. 'monospace' or 'serif')

  - textAlign (e.g. 'left' or 'center')

  - textDecoration (e.g. 'underline' or 'line-through')

  - whiteSpace (e.g. 'nowrap' or 'pre')

  - shown (true or false)

Supported custom layout properties (see ui.Panel.Layout documentation):

  - stretch ('horizontal', 'vertical', 'both')

  - position ('top-right', 'top-center', 'top-left', 'bottom-right', ...)

UsageReturns
Textbox.style()ui.data.ActiveDictionary
ArgumentTypeDetails
this: ui.widgetui.WidgetThe ui.Widget instance.

ui.Textbox.unlisten

Deletes callbacks.

UsageReturns
Textbox.unlisten(idOrType)
ArgumentTypeDetails
this: ui.widgetui.WidgetThe ui.Widget instance.
idOrTypeString, optionalEither an ID returned by an onEventType() function during callback registration, an event type, or nothing. If an ID is passed, the corresponding callback is deleted. If an event type is passed, all callbacks for that type are deleted. If nothing is passed, all callbacks are deleted.

ui.Thumbnail

A fixed-size thumbnail image generated asynchronously from an ee.Image.

UsageReturns
ui.Thumbnail(image, params, onClick, style)ui.Thumbnail
ArgumentTypeDetails
imageImage, optionalThe ee.Image from which to generate the thumbnail. Defaults to an empty ee.Image.
paramsObject, optionalFor an explanation of the possible parameters, see ui.Thumbnail.setParams(). Defaults to an empty object.
onClickFunction, optionalA callback fired when the thumbnail is clicked.
styleObject, optionalAn object of allowed CSS styles with their values to be set for this label. Defaults to an empty object.

ui.Thumbnail.getImage

Returns the ee.Image for the thumbnail.

UsageReturns
Thumbnail.getImage()Image|ImageCollection
ArgumentTypeDetails
this: ui.thumbnailui.ThumbnailThe ui.Thumbnail instance.

ui.Thumbnail.getParams

See ee.Image.prototype.getThumbnailURL.

Returns the parameters used in generating the thumbnail.

UsageReturns
Thumbnail.getParams()Object
ArgumentTypeDetails
this: ui.thumbnailui.ThumbnailThe ui.Thumbnail instance.

ui.Thumbnail.onClick

Registers a callback that's fired when the thumbnail is clicked.

Returns an ID which can be passed to unlisten() to unregister the callback.

UsageReturns
Thumbnail.onClick(callback)String
ArgumentTypeDetails
this: ui.thumbnailui.ThumbnailThe ui.Thumbnail instance.
callbackFunctionThe callback to fire when the thumbnail is clicked. The callback is passed the thumbnail widget.

ui.Thumbnail.setImage

Sets the ee.Image used to generate the thumbnail.

Returns this thumbnail.

UsageReturns
Thumbnail.setImage(image)ui.Thumbnail
ArgumentTypeDetails
this: ui.thumbnailui.ThumbnailThe ui.Thumbnail instance.
imageImageThe image from which to generate the thumbnail.

ui.Thumbnail.setParams

Sets the parameters used to generate the thumbnail.

Returns this thumbnail.

UsageReturns
Thumbnail.setParams(params)ui.Thumbnail
ArgumentTypeDetails
this: ui.thumbnailui.ThumbnailThe ui.Thumbnail instance.
paramsObjectThe parameters used in generating the thumbnail.
dimensions (a number or pair of numbers in format WIDTHxHEIGHT) Maximum dimensions of the thumbnail to render, in pixels. If only one number is passed, it is used as the maximum, and the other dimension is computed by proportional scaling.
region (E,S,W,N or GeoJSON) Geospatial region of the image to render. By default, the whole image.
format (string) Either 'png' or 'jpg'.
bands (comma-separated strings) Comma-delimited list of band names to be mapped to RGB.
min (comma-separated numbers) Value (or one per band) to map onto 00.
max (comma-separated numbers) Value (or one per band) to map onto FF.
gain (comma-separated numbers) Gain (or one per band) to map onto 00-FF.
bias (comma-separated numbers) Offset (or one per band) to map onto 00-FF.
gamma (comma-separated numbers) Gamma correction factor (or one per band)
palette (comma-separated strings) List of CSS-style color strings (single-band previews only).
opacity (number) a number between 0 and 1 for opacity.
version (number) Version number of image (or latest).

ui.Thumbnail.style

Returns the widget's style ActiveDictionary, which can be modified to update the widget's styles.

Properties which behave like their CSS counterparts:

  - height, maxHeight, minHeight (e.g. '100px')

  - width, maxWidth, minWidth (e.g. '100px')

  - padding, margin (e.g. '4px 4px 4px 4px' or simply '4px')

  - color, backgroundColor (e.g. 'red' or '#FF0000')

  - border (e.g. '1px solid black')

  - fontSize (e.g. '24px')

  - fontStyle (e.g. 'italic')

  - fontWeight (e.g. 'bold' or '100')

  - fontFamily (e.g. 'monospace' or 'serif')

  - textAlign (e.g. 'left' or 'center')

  - textDecoration (e.g. 'underline' or 'line-through')

  - whiteSpace (e.g. 'nowrap' or 'pre')

  - shown (true or false)

Supported custom layout properties (see ui.Panel.Layout documentation):

  - stretch ('horizontal', 'vertical', 'both')

  - position ('top-right', 'top-center', 'top-left', 'bottom-right', ...)

UsageReturns
Thumbnail.style()ui.data.ActiveDictionary
ArgumentTypeDetails
this: ui.widgetui.WidgetThe ui.Widget instance.

ui.Thumbnail.unlisten

Deletes callbacks.

UsageReturns
Thumbnail.unlisten(idOrType)
ArgumentTypeDetails
this: ui.widgetui.WidgetThe ui.Widget instance.
idOrTypeString, optionalEither an ID returned by an onEventType() function during callback registration, an event type, or nothing. If an ID is passed, the corresponding callback is deleted. If an event type is passed, all callbacks for that type are deleted. If nothing is passed, all callbacks are deleted.

ui.data.ActiveDictionary

A dictionary-like container for data for use in UI components.

When a property of a ui.data.ActiveDictionary (e.g. myButton.style()) is updated, the component it belongs to is automatically updated. For example, myButton.style().set('color', 'red') would change the color of button's text to red.

UsageReturns
ui.data.ActiveDictionary(object, allowedProperties)ui.data.ActiveDictionary
ArgumentTypeDetails
objectObject, optionalA JavaScript object with properties and values to initialize this object with.
allowedPropertiesList, optionalAn array of allowed properties for this object. If undefined, then any property is allowed.

ui.data.ActiveDictionary.get

Returns either a clone of this object or, if a key is provided, the value of the property with the passed-in key. Look at the constructor's parameters to see which properties are available.

UsageReturns
ActiveDictionary.get(key)Object
ArgumentTypeDetails
this: ui.data.activedictionaryui.data.ActiveDictionaryThe ui.data.ActiveDictionary instance.
keyString, optionalThe key of the property to retrieve.

ui.data.ActiveDictionary.set

Sets the value of a given property. Throws an error if the key provided is not supported by the object. Look at the constructor's parameters to see which properties can be set.

Returns this ui.data.ActiveDictionary.

UsageReturns
ActiveDictionary.set(keyOrDict, value)ui.data.ActiveDictionary
ArgumentTypeDetails
this: ui.data.activedictionaryui.data.ActiveDictionaryThe ui.data.ActiveDictionary instance.
keyOrDictObject|StringEither the key of the property to set or a dictionary of key/value pairs to set on the object.
valueObject, optionalThe property's new value. This is required when the first argument is a key string.

ui.data.ActiveList

An array-like container for data for use in UI components.

When a ui.data.ActiveList (e.g. Map.layers()) is updated, the component it belongs to is updated as well. For example, Map.layers().add(myLayer) will add myLayer as a layer on the map.

UsageReturns
ui.data.ActiveList(list)ui.data.ActiveList
ArgumentTypeDetails
listList, optionalAn optional list to initialize with.

ui.data.ActiveList.add

Appends an element to the list.

Returns this ui.data.ActiveList.

UsageReturns
ActiveList.add(el)ui.data.ActiveList
ArgumentTypeDetails
this: ui.data.activelistui.data.ActiveListThe ui.data.ActiveList instance.
elObjectThe element to add.

ui.data.ActiveList.forEach

Iterates over each element, calling the provided callback. The callback is called for each element like: callback(element, index).

UsageReturns
ActiveList.forEach(callback)
ArgumentTypeDetails
this: ui.data.activelistui.data.ActiveListThe ui.data.ActiveList instance.
callbackFunction

ui.data.ActiveList.get

Returns the element at the specified index.

UsageReturns
ActiveList.get(index)Object
ArgumentTypeDetails
this: ui.data.activelistui.data.ActiveListThe ui.data.ActiveList instance.
indexNumberThe index of the element to return.

ui.data.ActiveList.getJsArray

Returns the list as a JS array.

UsageReturns
ActiveList.getJsArray()List
ArgumentTypeDetails
this: ui.data.activelistui.data.ActiveListThe ui.data.ActiveList instance.

ui.data.ActiveList.insert

Inserts an element at the specified index and shifts the rest of the list. If the specified index is greater than the length of the list, the element will be appended to the list.

Returns this ui.data.ActiveList.

UsageReturns
ActiveList.insert(index, el)ui.data.ActiveList
ArgumentTypeDetails
this: ui.data.activelistui.data.ActiveListThe ui.data.ActiveList instance.
indexNumberThe index at which to insert the element.
elObjectThe element to insert.

ui.data.ActiveList.length

Returns the number of elements in the list.

UsageReturns
ActiveList.length()Number
ArgumentTypeDetails
this: ui.data.activelistui.data.ActiveListThe ui.data.ActiveList instance.

ui.data.ActiveList.remove

Removes the specified element from the list.

Returns the removed element or null if the element was not present in the list.

UsageReturns
ActiveList.remove(el)Object
ArgumentTypeDetails
this: ui.data.activelistui.data.ActiveListThe ui.data.ActiveList instance.
elObjectThe element to remove.

ui.data.ActiveList.reset

Replaces all elements in list with a new list or, if no list is provided, removes all elements from list.

Returns the elements in the list after the reset is applied.

UsageReturns
ActiveList.reset(list)List
ArgumentTypeDetails
this: ui.data.activelistui.data.ActiveListThe ui.data.ActiveList instance.
listList, optionalA list of elements.

ui.data.ActiveList.set

Sets an element at the specified index. If the index exceeds that of the list's last element, the element will be added to the end of the list.

Returns this ui.data.ActiveList.

UsageReturns
ActiveList.set(index, el)ui.data.ActiveList
ArgumentTypeDetails
this: ui.data.activelistui.data.ActiveListThe ui.data.ActiveList instance.
indexNumberThe index to overwrite.
elObjectThe element to set.

ui.root.add

Adds a widget to the root panel.

Returns the root panel.

UsageReturns
ui.root.add(widget)ui.Panel
ArgumentTypeDetails
widgetui.WidgetThe widget to be added.

ui.root.clear

Clears the root panel.

UsageReturns
ui.root.clear()

No arguments.

ui.root.getLayout

Returns the root panel's layout.
UsageReturns
ui.root.getLayout()ui.Panel.Layout

No arguments.

ui.root.insert

Inserts a widget into to the root panel at the specified index. Returns the root panel.
UsageReturns
ui.root.insert(index, widget)ui.Panel
ArgumentTypeDetails
indexNumberThe index at which to insert the widget.
widgetui.WidgetThe widget to insert.

ui.root.onResize

Registers a callback that's fired when the script starts and whenever the browser window size changes. It will be passed an object with boolean fields "is_mobile", "is_tablet", "is_desktop", "is_portrait" and "is_landscape", and numeric fields "width" and "height".

These fields indicate whether a user's device is mobile, tablet or desktop, the device orientation (portrait or landscape), and the width and height of the window in pixels. See the Width and Height (dp) section of device metrics at https://material.io/resources/devices/.

UsageReturns
ui.root.onResize(callback)
ArgumentTypeDetails
callbackFunctionThe callback to fire after the window has been resized. The callback is passed an object with the information of the device.

ui.root.remove

Removes the given widget from the root panel, if it exists.

Returns the removed widget or null if the widget was not present in the root panel.

UsageReturns
ui.root.remove(widget)Object
ArgumentTypeDetails
widgetui.WidgetThe widget to remove.

ui.root.setKeyHandler

Sets a keydown event handler to the root panel with a non-predefined key. The handler is fired only once when a user presses the bound key command. The same key will be bound to the latest handler set to it.

UsageReturns
ui.root.setKeyHandler(keyCode, handler, description)
ArgumentTypeDetails
keyCodeListA key code or an array of key codes. For example, ui.Key.A or [ui.Key.SHIFT, ui.Key.A].
handlerFunctionThe handler for the key command.
descriptionString, optionalA short description that explains this key command. The description will be visible in the Shortcuts Menu.

ui.root.setLayout

Sets the ui.root panel's layout.

Returns the root panel.

UsageReturns
ui.root.setLayout(layout)ui.Panel
ArgumentTypeDetails
layoutString|ui.Panel.LayoutThe root panel's new layout.

ui.root.widgets

Returns the list of widgets currently in the root panel.

UsageReturns
ui.root.widgets()ui.data.ActiveList

No arguments.

ui.url.get

Returns the value of the given key from the URL fragment.
UsageReturns
ui.url.get(key, default)Boolean|Number|Object|String
ArgumentTypeDetails
keyStringThe name of the parameter to read.
defaultBoolean|Number|String, optionaloptional default value to return if no value is present.

ui.url.set

Sets the value of the page's URL fragment. The fragment encodes a dictionary of keys and values. If a dictionary is supplied as the first argument, the key/value pairs in that dictionary will be encoded and replace the current URL fragment. If a key string is provided, then only that key (and its value, the second argument) are updated, and the rest of the URL fragment is unchanged.

UsageReturns
ui.url.set(keyOrDict, value)
ArgumentTypeDetails
keyOrDictDictionaryEither a key to update a single value in the URL fragment, or a dictionary of key/value pairs which will replace the existing URL fragment. Dictionary values must be of type string, number, or boolean.
valueBoolean|Number|String, optionalThe new value to associate with a single key. This is required when the first argument is a string and is otherwise ignored.

ui.util.clear

Clears all state related to utility functions, including cancelling any active timeouts, intervals, debounces, etc.

UsageReturns
ui.util.clear()

No arguments.

ui.util.clearTimeout

Clears a timeout set via ui.util.setTimeout or ui.util.setInterval.
UsageReturns
ui.util.clearTimeout(timeoutKey)
ArgumentTypeDetails
timeoutKeyNumberThe key to the timeout or interval to clear.

ui.util.debounce

Wraps a function to allow it to be called, at most, once for each sequence of calls fired repeatedly so long as they are fired less than a specified interval apart (in milliseconds). This can be used to reduce the number of invocations of an expensive function while ensuring it eventually runs.

Example use: For the callback to a change event on a ui.Checkbox. If the user clicks the checkbox repeatedly, only the last click of the checkbox will run the callback.

Returns the debounced function.

UsageReturns
ui.util.debounce(func, delay, scope)Function
ArgumentTypeDetails
funcFunctionThe function to debounce.
delayNumberAfter the function is called once, the number of milliseconds to delay for an additional invocation of the function before allowing it to run.
scopeObject, optionalObject in whose scope to call the function.

ui.util.getCurrentPosition

Gets the user's current geographic position from the browser's geolocation service.

UsageReturns
ui.util.getCurrentPosition(success, error)
ArgumentTypeDetails
successFunctionA callback function that takes a ee.Geometry.Point object as its input parameter.
errorFunction, optionalAn optional callback function that takes an error message as its input parameter.

ui.util.rateLimit

Wraps a function to allow it to be called, at most, once per interval. If the wrapper function is called more than once, only the first call will go through, and no subsequent invocations will have an effect until the interval has elapsed. This can be used to ensure a function that is expensive to run executes immediately but doesn't execute repeatedly.

Example use: For the callback to a click on a ui.Button, in order to prevent the button from being accidentally double-clicked and the callback running twice.

Returns the rate-limited function.

UsageReturns
ui.util.rateLimit(func, delay, scope)Function
ArgumentTypeDetails
funcFunctionFunction to call.
delayNumberAfter the function is called and executed, the number of milliseconds to delay before allowing an additional invocation of the function.
scopeObject, optionalObject in whose scope to call the function.

ui.util.setInterval

Repeatedly calls a function with a fixed time delay between each call.

Returns a key that can be passed to ui.util.clearTimeout to remove the timeout.

UsageReturns
ui.util.setInterval(func, delay)Number
ArgumentTypeDetails
funcFunctionThe function to run after the specified delay.
delayNumberThe time, in milliseconds (thousandths of a second), the timer should delay in between executions of the specified function.

ui.util.setTimeout

Calls a function after a fixed time delay.

Returns a key that can be passed to ui.util.clearTimeout to remove the timeout.

UsageReturns
ui.util.setTimeout(func, delay)Number
ArgumentTypeDetails
funcFunctionThe function to run at the specified interval.
delayNumberThe time, in milliseconds (thousandths of a second), the timer should delay before execution of the specified function.

ui.util.throttle

Wraps a function to allow it to be called, at most, twice per interval. If the wrapper function is called multiple times before the delay elapses, only the first and the last calls will go through.

Example use: For the callback to a slide event on a ui.Slider. The callback will run immediately, making the slide action feel responsive. The callback is also guaranteed to run after the user has finished interacting with the slider, ensuring that the final callback invocation has access to the slider's final value.

Returns the wrapped function.

UsageReturns
ui.util.throttle(func, delay, scope)Function
ArgumentTypeDetails
funcFunctionThe function to call.
delayNumberThe delay, in milliseconds, for the throttle. The function can only be called once after the initial invocation until after the delay has elapsed.
scopeObject, optionalThe object in whose scope to call the function.