@google/earthengine 0.1.379 → 0.1.381

package/package.json

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

package/src/apiclient.js

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

package/src/feature.js

@@ -135,8 +135,8 @@ ee.Feature.prototype.getInfo = function(opt_callback) {
  * generating a Map overlay.
  *
  * @param {?Object=} opt_visParams The visualization parameters. Currently only
- *     one parameter, 'color', containing an RGB color string is user.  If
- *     vis_params is null, black ("000000") is used.
+ *     one parameter, 'color', containing an RGB color string is allowed. If
+ *     visParams is not specified, black ("000000") is used.
  * @param {function(!Object, string=)=} opt_callback An async callback.
  * @return {!ee.data.MapId|undefined} An object which may be passed to
  *     ee.data.getTileUrl or ui.Map.addLayer, including an additional 'image'
@@ -144,15 +144,33 @@ ee.Feature.prototype.getInfo = function(opt_callback) {
  *     containing this feature. Undefined if a callback was specified.
  * @export
  */
-ee.Feature.prototype.getMap = function(opt_visParams, opt_callback) {
-  var args =
+ee.Feature.prototype.getMapId = function(opt_visParams, opt_callback) {
+  const args =
       ee.arguments.extractFromFunction(ee.Feature.prototype.getMap, arguments);
-  var collection = ee.ApiFunction._call('Collection', [this]);
-  return /** @type {ee.FeatureCollection} */(collection)
-      .getMap(args['visParams'], args['callback']);
+  const collection = ee.ApiFunction._call('Collection', [this]);
+  return /** @type {!ee.FeatureCollection} */(collection)
+      .getMapId(args['visParams'], args['callback']);
 };
 
 
+/**
+ * An imperative function that returns a map ID and optional token, suitable for
+ * generating a Map overlay.
+ *
+ * @deprecated Use getMapId() instead.
+ * @param {?Object=} opt_visParams The visualization parameters. Currently only
+ *     one parameter, 'color', containing an RGB color string is allowed. If
+ *     visParams is not specified, black ("000000") is used.
+ * @param {function(!Object, string=)=} opt_callback An async callback.
+ * @return {!ee.data.MapId|undefined} 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.
+ * @export
+ */
+ee.Feature.prototype.getMap = ee.Feature.prototype.getMapId;
+
+
 /** @override */
 ee.Feature.prototype.name = function() {
   return 'Feature';

package/src/featurecollection.js

@@ -132,38 +132,56 @@ ee.FeatureCollection.reset = function() {
 
 
 /**
- * An imperative function that returns a map id and token, suitable for
+ * An imperative function that returns a map ID and optional token, suitable for
  * generating a Map overlay.
  *
  * @param {?Object=} opt_visParams The visualization parameters. Currently only
- *     one parameter, 'color', containing an RGB color string is allowed.  If
- *     vis_params isn't specified, then the color #000000 is used.
+ *     one parameter, 'color', containing an RGB color string is allowed. If
+ *     visParams is not specified, black ("000000") is used.
  * @param {function(!Object, string=)=} opt_callback An async callback.
- *     If not supplied, the call is made synchronously.
  * @return {!ee.data.MapId|undefined} 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.
  * @export
  */
-ee.FeatureCollection.prototype.getMap = function(opt_visParams, opt_callback) {
-  var args = ee.arguments.extractFromFunction(
-      ee.FeatureCollection.prototype.getMap, arguments);
+ee.FeatureCollection.prototype.getMapId = function(
+    opt_visParams, opt_callback) {
+  const args = ee.arguments.extractFromFunction(
+      ee.FeatureCollection.prototype.getMapId, arguments);
 
-  var painted = /** @type {!ee.Image} */(
-      ee.ApiFunction._apply('Collection.draw', {
+  const painted =
+      /** @type {!ee.Image} */ (ee.ApiFunction._apply('Collection.draw', {
         'collection': this,
         'color': (args['visParams'] || {})['color'] || '000000'
       }));
 
   if (args['callback']) {
-    painted.getMap(undefined, args['callback']);
+    painted.getMapId(undefined, args['callback']);
   } else {
-    return painted.getMap();
+    return painted.getMapId();
   }
 };
 
 
+/**
+ * An imperative function that returns a map ID and optional token, suitable for
+ * generating a Map overlay.
+ *
+ * @deprecated Use getMapId() instead.
+ * @param {?Object=} opt_visParams The visualization parameters. Currently only
+ *     one parameter, 'color', containing an RGB color string is allowed. If
+ *     visParams is not specified, black ("000000") is used.
+ * @param {function(!Object, string=)=} opt_callback An async callback.
+ * @return {!ee.data.MapId|undefined} 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.
+ * @export
+ */
+ee.FeatureCollection.prototype.getMap = ee.FeatureCollection.prototype.getMapId;
+
+
 /**
  * An imperative function that returns all the known information about this
  * collection via an AJAX call.

package/src/image.js

@@ -153,7 +153,7 @@ ee.Image.prototype.getInfo = function(opt_callback) {
 
 
 /**
- * An imperative function that returns a map id and optional token, suitable for
+ * An imperative function that returns a map ID and optional token, suitable for
  * generating a Map overlay.
  *
  * @param {!ee.data.ImageVisualizationParameters=} opt_visParams
@@ -165,7 +165,7 @@ ee.Image.prototype.getInfo = function(opt_callback) {
  *     specified.
  * @export
  */
-ee.Image.prototype.getMap = function(opt_visParams, opt_callback) {
+ee.Image.prototype.getMapId = function(opt_visParams, opt_callback) {
   const args = ee.arguments.extractFromFunction(
       ee.Image.prototype.getMap, arguments);
 
@@ -192,6 +192,22 @@ ee.Image.prototype.getMap = function(opt_visParams, opt_callback) {
   }
 };
 
+/**
+ * An imperative function that returns a map ID and optional token, suitable for
+ * generating a Map overlay.
+ *
+ * @deprecated Use getMapId() instead.
+ * @param {!ee.data.ImageVisualizationParameters=} opt_visParams
+ *     The visualization parameters.
+ * @param {function(!ee.data.MapId, string=)=} opt_callback An async callback.
+ *     If not supplied, the call is made synchronously.
+ * @return {!ee.data.MapId|undefined} An object which may be passed to
+ *     ee.data.getTileUrl or ui.Map.addLayer. Undefined if a callback was
+ *     specified.
+ * @export
+ */
+ee.Image.prototype.getMap = ee.Image.prototype.getMapId;
+
 
 /**
  * Get a download URL for small chunks of image data in GeoTIFF or NumPy

package/src/imagecollection.js

@@ -255,31 +255,48 @@ ee.ImageCollection.prototype.getThumbURL_ = function(
 
 
 /**
- * An imperative function that returns a mapid via a synchronous AJAX call.
+ * An imperative function that returns a map ID via a synchronous AJAX call.
  *
- * This mosaics the collection to a single image and return a mapid suitable
+ * This mosaics the collection to a single image and return a map ID suitable
  * for building a Google Maps overlay.
  *
  * @param {?Object=} opt_visParams The visualization parameters.
  * @param {function(!Object, string=)=} opt_callback An async callback.
  *     If not supplied, the call is made synchronously.
- * @return {!ee.data.MapId|undefined} Returns a mapid and optional token, which
+ * @return {!ee.data.MapId|undefined} 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.
  * @export
  */
-ee.ImageCollection.prototype.getMap = function(opt_visParams, opt_callback) {
+ee.ImageCollection.prototype.getMapId = function(opt_visParams, opt_callback) {
   var args = ee.arguments.extractFromFunction(
-      ee.ImageCollection.prototype.getMap, arguments);
+      ee.ImageCollection.prototype.getMapId, arguments);
   var mosaic = /** @type {!ee.Image} */(
       ee.ApiFunction._call('ImageCollection.mosaic', this));
   if (args['callback']) {
-    mosaic.getMap(args['visParams'], args['callback']);
+    mosaic.getMapId(args['visParams'], args['callback']);
   } else {
-    return mosaic.getMap(args['visParams']);
+    return mosaic.getMapId(args['visParams']);
   }
 };
 
+/**
+ * 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.
+ *
+ * @deprecated Use getMapId() instead.
+ * @param {?Object=} opt_visParams The visualization parameters.
+ * @param {function(!Object, string=)=} opt_callback An async callback.
+ *     If not supplied, the call is made synchronously.
+ * @return {!ee.data.MapId|undefined} 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.
+ * @export
+ */
+ee.ImageCollection.prototype.getMap = ee.ImageCollection.prototype.getMapId;
+
 
 /**
  * An imperative function that returns all the known information about this

package/test/ee_test.js

@@ -14,13 +14,13 @@ describe('ee', function() {
 
   it('retrieves a map ID synchronously', function() {
     const image = new ee.Image('srtm90_v4');
-    const map = image.getMap({'min': 0, 'max': 1000});
+    const map = image.getMapId({'min': 0, 'max': 1000});
     expect(map.mapid).toMatch(/\w+/);
   });
 
   it('retrieves a map ID asynchronously', function(done) {
     const image = new ee.Image('srtm90_v4');
-    image.getMap({'min': 0, 'max': 1000}, ({mapid}) => {
+    image.getMapId({'min': 0, 'max': 1000}, ({mapid}) => {
       expect(mapid).toMatch(/\w+/);
       done();
     });