@google/earthengine 0.1.400 → 0.1.402

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@google/earthengine",
-  "version": "0.1.400",
+  "version": "0.1.402",
   "description": "JavaScript client for Google Earth Engine API.",
   "author": "Google LLC",
   "license": "Apache-2.0",

package/src/apiclient.js

@@ -24,7 +24,7 @@ const {trustedResourceUrl} = goog.require('safevalues');
 /** @namespace */
 const apiclient = {};
 
-const API_CLIENT_VERSION = '0.1.400';
+const API_CLIENT_VERSION = '0.1.402';
 
 exports.VERSION = apiVersion.VERSION;
 exports.API_CLIENT_VERSION = API_CLIENT_VERSION;

package/src/examples/UserInterface/LandsatExplorer.js

@@ -6,6 +6,9 @@ var app = {};
 
 /** Creates the UI panels. */
 app.createPanels = function() {
+  /* The map to use for this app. */
+  app.map = new ui.Map();
+
   /* The introduction section. */
   app.intro = {
     panel: ui.Panel([
@@ -54,7 +57,7 @@ app.createPanels = function() {
     }),
     // Create a button that centers the map on a given object.
     centerButton: ui.Button('Center on map', function() {
-      Map.centerObject(Map.layers().get(0).get('eeObject'));
+      app.map.centerObject(app.map.layers().get(0).get('eeObject'));
     })
   };
 
@@ -161,7 +164,7 @@ app.createHelpers = function() {
 
     // Filter bounds to the map if the checkbox is marked.
     if (app.filters.mapCenter.getValue()) {
-      filtered = filtered.filterBounds(Map.getCenter());
+      filtered = filtered.filterBounds(app.map.getCenter());
     }
 
     // Set filter variables.
@@ -188,14 +191,14 @@ app.createHelpers = function() {
 
   /** Refreshes the current map layer based on the UI widget states. */
   app.refreshMapLayer = function() {
-    Map.clear();
+    app.map.clear();
     var imageId = app.picker.select.getValue();
     if (imageId) {
       // If an image id is found, create an image.
       var image = ee.Image(app.COLLECTION_ID + '/' + imageId);
       // Add the image to the map with the corresponding visualization options.
       var visOption = app.VIS_OPTIONS[app.vis.select.getValue()];
-      Map.addLayer(image, visOption.visParams, imageId);
+      app.map.addLayer(image, visOption.visParams, imageId);
     }
   };
 };
@@ -244,8 +247,9 @@ app.boot = function() {
     ],
     style: {width: '320px', padding: '8px'}
   });
-  Map.setCenter(-97, 26, 9);
-  ui.root.insert(0, main);
+  app.map.setCenter(-97, 26, 9);
+  ui.root.clear();
+  ui.root.widgets().add(ui.SplitPanel(main, app.map));
   app.applyFilters();
 };
 

package/src/geometry.js

@@ -67,8 +67,8 @@ ee.Geometry = function(geoJson, opt_proj, opt_geodesic, opt_evenOdd) {
   // argument, we know the arguments were passed in sequence. If not, we
   // assume the user intended to pass a named argument dictionary and use
   // ee.arguments.extractFromFunction() to validate and extract the keys.
-  if (!('type' in geoJson)) {
-    var args = ee.arguments.extractFromFunction(ee.Geometry, arguments);
+  if (typeof geoJson !== 'object' || !('type' in geoJson)) {
+    const args = ee.arguments.extractFromFunction(ee.Geometry, arguments);
     geoJson = args['geoJson'];
     opt_proj = args['proj'];
     opt_geodesic = args['geodesic'];
@@ -77,9 +77,9 @@ ee.Geometry = function(geoJson, opt_proj, opt_geodesic, opt_evenOdd) {
 
   ee.Geometry.initialize();
 
-  var computed = geoJson instanceof ee.ComputedObject &&
+  const computed = geoJson instanceof ee.ComputedObject &&
                  !(geoJson instanceof ee.Geometry && geoJson.type_);
-  var options =
+  const options =
       (opt_proj != null || opt_geodesic != null || opt_evenOdd != null);
   if (computed) {
     if (options) {
@@ -94,7 +94,7 @@ ee.Geometry = function(geoJson, opt_proj, opt_geodesic, opt_evenOdd) {
 
   // Below here, we're working with a GeoJSON literal.
   if (geoJson instanceof ee.Geometry) {
-    geoJson = /** @type {Object} */(geoJson.encode());
+    geoJson = /** @type {!Object} */(geoJson.encode());
   }
 
   if (!ee.Geometry.isValidGeometry_(geoJson)) {
@@ -105,16 +105,14 @@ ee.Geometry = function(geoJson, opt_proj, opt_geodesic, opt_evenOdd) {
 
   /**
    * The type of the geometry.
-   * @type {string}
-   * @private
+   * @private @const {string}
    */
   this.type_ = geoJson['type'];
 
   /**
    * The coordinates of the geometry, up to 4 nested levels with numbers at
    * the last level. Null if and only if type is GeometryCollection.
-   * @type {Array?}
-   * @private
+   * @private @const {?Array}
    */
   this.coordinates_ = (geoJson['coordinates'] != null) ?
       goog.object.unsafeClone(geoJson['coordinates']) :
@@ -122,15 +120,13 @@ ee.Geometry = function(geoJson, opt_proj, opt_geodesic, opt_evenOdd) {
 
   /**
    * The subgeometries, non-null if and only if type is GeometryCollection.
-   * @type {Array?}
-   * @private
+   * @private @const {Array?}
    */
   this.geometries_ = geoJson['geometries'] || null;
 
   /**
    * The projection of the geometry.
-   * @type {String|undefined}
-   * @private
+   * @private {string|undefined}
    */
   this.proj_;
   if (opt_proj != null) {
@@ -148,8 +144,7 @@ ee.Geometry = function(geoJson, opt_proj, opt_geodesic, opt_evenOdd) {
 
   /**
    * Whether the geometry has spherical geodesic edges.
-   * @type {boolean|undefined}
-   * @private
+   * @private {boolean|undefined}
    */
   this.geodesic_ = opt_geodesic;
   if (this.geodesic_ === undefined && 'geodesic' in geoJson) {
@@ -159,8 +154,7 @@ ee.Geometry = function(geoJson, opt_proj, opt_geodesic, opt_evenOdd) {
   /**
    * Whether polygon interiors are based on the even/odd rule. If false,
    * the left-inside rule is used. If unspecified, defaults to true.
-   * @type {boolean|undefined}
-   * @private
+   * @private {boolean|undefined}
    */
   this.evenOdd_ = opt_evenOdd;
   if (this.evenOdd_ === undefined && 'evenOdd' in geoJson) {

package/src/layers/abstractoverlay.js

@@ -148,7 +148,13 @@ ee.layers.AbstractOverlay = class extends goog.events.EventTarget {
     return this.stats;
   }
 
-  /** @override */
+  /**
+   * Implements getTile() for the google.maps.MapType interface.
+   * @param {?google.maps.Point} coord Position of tile.
+   * @param {number} zoom Zoom level.
+   * @param {?Document} ownerDocument Parent document.
+   * @return {?Element} Element to be displayed as a map tile.
+   */
   getTile(coord, zoom, ownerDocument) {
     var maxCoord = 1 << zoom;
 
@@ -193,7 +199,9 @@ ee.layers.AbstractOverlay = class extends goog.events.EventTarget {
     return tile.div;
   }
 
-  /** @override */
+  /**
+   * Implements releaseTile() for the google.maps.MapType interface.
+   */
   releaseTile(tileDiv) {
     var tile = this.tilesById.get(tileDiv.id);
     this.tilesById.remove(tileDiv.id);

package/src/layers/earthenginetilesource.js

@@ -20,8 +20,10 @@ const EarthEngineTileSource = class extends AbstractTileSource {
    *     tiles.
    * @param {data.Profiler=} opt_profiler The profiler to send map tile
    *     calculation cost to, if any.
+   * @param {number=} opt_parallelism The number of map tiles to fetch
+   *     concurrently.
    */
-  constructor(mapId, opt_profiler) {
+  constructor(mapId, opt_profiler, opt_parallelism) {
     super();
 
     /** @const @private {!data.RawMapId} The EE map ID for fetching tiles. */
@@ -31,8 +33,12 @@ const EarthEngineTileSource = class extends AbstractTileSource {
      * Map tile calculation cost will be sent to this profiler, if its enabled
      * flag is set.
      * @private {?data.Profiler}
+     * @const
      */
     this.profiler_ = opt_profiler || null;
+
+    this.token_count_ =
+        opt_parallelism || EarthEngineTileSource.DEFAULT_TOKEN_COUNT_;
   }
 
   /** @override */
@@ -65,9 +71,10 @@ const EarthEngineTileSource = class extends AbstractTileSource {
     tile.sourceUrl = this.getTileUrl_(tile.coord, tile.zoom);
 
     // When a request token is available, load the tile.
-    var handleAvailableToken =
-        goog.bind(this.handleAvailableToken_, this, tile);
-    var tokenPool = EarthEngineTileSource.getGlobalTokenPool_();
+    const handleAvailableToken = (token) => {
+      this.handleAvailableToken_(tile, token);
+    };
+    const tokenPool = this.getGlobalTokenPool_();
     tokenPool.getObject(handleAvailableToken, opt_priority);
   }
 
@@ -83,7 +90,7 @@ const EarthEngineTileSource = class extends AbstractTileSource {
    * @private
    */
   handleAvailableToken_(tile, token) {
-    var tokenPool = EarthEngineTileSource.getGlobalTokenPool_();
+    const tokenPool = this.getGlobalTokenPool_();
 
     // Exit early if the tile was aborted (e.g. because the layer was hidden or
     // this tile was panned out of view).
@@ -122,10 +129,10 @@ const EarthEngineTileSource = class extends AbstractTileSource {
    * @return {!PriorityPool} The global EE tile request token pool.
    * @private
    */
-  static getGlobalTokenPool_() {
+  getGlobalTokenPool_() {
     if (!EarthEngineTileSource.TOKEN_POOL_) {
       EarthEngineTileSource.TOKEN_POOL_ =
-          new PriorityPool(0, EarthEngineTileSource.TOKEN_COUNT_);
+          new PriorityPool(0, this.token_count_);
     }
     return EarthEngineTileSource.TOKEN_POOL_;
   }
@@ -135,7 +142,11 @@ goog.exportSymbol('ee.layers.EarthEngineTileSource', EarthEngineTileSource);
 /** @private {?PriorityPool} The global EE tile token pool. */
 EarthEngineTileSource.TOKEN_POOL_ = null;
 
-/** @private {number} The global max count of outstanding EE tile requests. */
-EarthEngineTileSource.TOKEN_COUNT_ = 4;
+/**
+ * @private {number}
+ * @const
+ * The default global count of outstanding EE tile requests.
+ */
+EarthEngineTileSource.DEFAULT_TOKEN_COUNT_ = 4;
 
 exports = EarthEngineTileSource;