@google/earthengine 0.1.310 → 0.1.315

package/package.json

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

package/src/apiclient.js

@@ -25,7 +25,7 @@ const {PromiseRequestService} = goog.require('eeapiclient.promise_request_servic
 /** @namespace */
 const apiclient = {};
 
-const API_CLIENT_VERSION = '0.1.310';
+const API_CLIENT_VERSION = '0.1.315';
 
 exports.VERSION = apiVersion.VERSION;
 exports.API_CLIENT_VERSION = API_CLIENT_VERSION;

package/src/computedobject.js

@@ -195,6 +195,7 @@ ee.ComputedObject.prototype.serialize = function(legacy = false) {
 
 /**
  * @return {string} A human-readable representation of the object.
+ * @override
  */
 ee.ComputedObject.prototype.toString = function() {
   return 'ee.' + this.name() + '(' + ee.Serializer.toReadableJSON(this) + ')';

package/src/data.js

@@ -70,6 +70,7 @@ goog.require('ee.rpc_convert_batch');
 goog.require('goog.array');
 goog.require('goog.functions');
 goog.require('goog.object');
+goog.require('goog.singleton');
 goog.requireType('ee.Collection');
 goog.requireType('ee.ComputedObject');
 goog.requireType('ee.Element');
@@ -551,11 +552,11 @@ ee.data.listFeatures = function(asset, params, opt_callback) {
 ee.data.computeValue = function(obj, opt_callback) {
   const expression =
       ee.data.expressionAugmenter_(ee.Serializer.encodeCloudApiExpression(obj));
+  const request = {expression};
   const call = new ee.apiclient.Call(opt_callback);
   return call.handle(
       call.value()
-          .compute(
-              call.projectsPath(), new ee.api.ComputeValueRequest({expression}))
+          .compute(call.projectsPath(), new ee.api.ComputeValueRequest(request))
           .then(x => x['result']));
 };
 
@@ -1881,7 +1882,6 @@ ee.data.getAssetRootQuota = function(rootId, opt_callback) {
   return call.handle(getAssetRequest.then(getResponse));
 };
 
-
 ////////////////////////////////////////////////////////////////////////////////
 //                               Types and enums.                             //
 ////////////////////////////////////////////////////////////////////////////////
@@ -2965,7 +2965,8 @@ ee.data.MapZoomRange = {
  *   type: string,
  *   description: (undefined|string),
  *   sourceUrl: (undefined|string),
- *   element: (undefined|!ee.Element|!ee.ComputedObject)
+ *   element: (undefined|!ee.Element|!ee.ComputedObject),
+ *   workloadTag: (undefined|string),
  * }}
  */
 ee.data.AbstractTaskConfig;
@@ -2996,7 +2997,8 @@ ee.data.AbstractTaskConfig;
  *   outputBucket: (undefined|string),
  *   outputPrefix: (undefined|string),
  *   assetId: (undefined|string),
- *   pyramidingPolicy: (undefined|string)
+ *   pyramidingPolicy: (undefined|string),
+ *   workloadTag: (undefined|string),
  * }}
  */
 ee.data.ImageTaskConfigUnformatted;
@@ -3039,7 +3041,8 @@ ee.data.ImageTaskConfigUnformatted;
  *   outputBucket: (undefined|string),
  *   outputPrefix: (undefined|string),
  *   assetId: (undefined|string),
- *   pyramidingPolicy: (undefined|string)
+ *   pyramidingPolicy: (undefined|string),
+ *   workloadTag: (undefined|string),
  * }}
  */
 ee.data.ImageTaskConfig;
@@ -3060,7 +3063,8 @@ ee.data.ImageTaskConfig;
  *   sequenceData: (undefined|boolean),
  *   collapseBands: (undefined|boolean),
  *   maskedThreshold: (undefined|number),
- *   shardSize: (undefined|number)
+ *   shardSize: (undefined|number),
+ *   workloadTag: (undefined|string),
  * }}
  */
 ee.data.ImageExportFormatConfig;
@@ -3088,7 +3092,8 @@ ee.data.ImageExportFormatConfig;
  *   outputPrefix: (undefined|string),
  *   bucketCorsUris: (undefined|!Array<string>),
  *   mapsApiKey: (undefined|string),
- *   generateEarthHtml: (undefined|boolean)
+ *   generateEarthHtml: (undefined|boolean),
+ *   workloadTag: (undefined|string),
  * }}
  */
 ee.data.MapTaskConfig;
@@ -3108,6 +3113,7 @@ ee.data.MapTaskConfig;
  *   thinningStrategy: (undefined|!ee.data.ThinningStrategy),
  *   thinningRanking: (undefined|string|!Array<string>),
  *   zOrderRanking: (undefined|string|!Array<string>),
+ *   workloadTag: (undefined|string),
  * }}
  */
 ee.data.FeatureViewTaskConfig;
@@ -3130,7 +3136,8 @@ ee.data.FeatureViewTaskConfig;
  *   outputPrefix: (undefined|string),
  *   assetId: (undefined|string),
  *   maxWorkers: (undefined|number),
- *   maxVertices: (undefined|number)
+ *   maxVertices: (undefined|number),
+ *   workloadTag: (undefined|string),
  * }}
  */
 ee.data.TableTaskConfig;
@@ -3157,7 +3164,8 @@ ee.data.TableTaskConfig;
  *   driveFolder: (undefined|string),
  *   driveFileNamePrefix: (undefined|string),
  *   outputBucket: (undefined|string),
- *   outputPrefix: (undefined|string)
+ *   outputPrefix: (undefined|string),
+ *   workloadTag: (undefined|string),
  * }}
  */
 ee.data.VideoTaskConfig;

package/src/ee.js

@@ -51,10 +51,12 @@ goog.require('goog.object');
  * In most cases, an authorization token should be set before the library
  * is initialized, either with ee.data.authorize() or ee.data.setAuthToken().
  *
- * 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.
+ * 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.
  *
  * @param {string?=} opt_baseurl The Earth Engine REST API endpoint.
  *     (Python argument name: opt_url)
@@ -67,8 +69,8 @@ goog.require('goog.object');
  *     invoked with an error if the initialization fails. (JavaScript only)
  * @param {string?=} opt_xsrfToken A string to pass in the "xsrfToken"
  *     parameter of EE API XHRs. (JavaScript only)
- * @param {string?=} opt_project Optional project ID or number to use when
-       making API calls. (Python argument name: project)
+ * @param {string?=} opt_project Optional client project ID or number to use
+ *     when making API calls. (Python argument name: project)
  * @export
  */
 ee.initialize = function(
@@ -669,6 +671,10 @@ ee.makeClass_ = function(name) {
     }
   };
   goog.inherits(target, ee.ComputedObject);
+  /**
+   * @return {string}
+   * @override
+   */
   target.prototype.name = function() { return name; };
   ee.ApiFunction.importApi(target, name, name);
   return target;

package/src/eeapiclient/domain_object.ts

@@ -24,12 +24,12 @@ type Primitive = string|number|boolean|null|undefined;
  * i.e., {a: {b: {c: boolean}}} gets transformed into {a?: {b?: {c?: boolean}}}
  */
 export type DeepPartialISerializable<T> =
-    T extends Primitive ? Partial<T>: T extends object ?
+    T extends Primitive ? Partial<T>: T extends ISerializable ?
     Omit<
         {[K in keyof T]?: DeepPartialISerializable<T[K]>},
-        'Serializable$get'|'Serializable$has'|'Serializable$set'|
-        'getClassMetadata'|'getConstructor'|'getPartialClassMetadata'>:
-    unknown;
+        keyof ISerializable|'getPartialClassMetadata'>:
+    T extends object ? {[K in keyof T]?: DeepPartialISerializable<T[K]>} :
+                       unknown;
 
 /**
  * Description of the properties in a Serializable class.

package/src/encodable_batch.js

@@ -113,6 +113,7 @@ ee.rpc_convert_batch.taskToExportTableRequest = function(params) {
     default:
       throw new Error(`Export destination "${destination}" unknown`);
   }
+
   return result;
 };
 
@@ -763,10 +764,10 @@ ee.rpc_convert_batch.buildRankByOneThingRule_ = function(ruleString) {
 
   // Parse rule string. Input is expected in the string format: `attr_name ASC,
   // .minZoomLevel DESC, .geometryType ASC` or as a list of strings: ["attr_name
-  // ASC", ".pixelSize DESC", ".geometryType ASC"]. .minZoomLevel and .geometryType
-  // correspond to minVisibleLOD and geometryType ranking rules in DMS. Rules
-  // that do not start with the keywords ".minZoomLevel" or ".geometryType" are
-  // assumed to be attribute rules.
+  // ASC", ".pixelSize DESC", ".geometryType ASC"]. .minZoomLevel and
+  // .geometryType correspond to minVisibleLOD and geometryType ranking rules in
+  // DMS. Rules that do not start with the keywords ".minZoomLevel" or
+  // ".geometryType" are assumed to be attribute rules.
   ruleString = ruleString.trim();
   const matches = ruleString.match(/^([\S]+.*)\s+(ASC|DESC)$/);
   if (matches == null) {

package/src/feature.js

@@ -122,6 +122,7 @@ ee.Feature.reset = function() {
  *     the second if unsuccessful.
  * @return {ee.data.GeoJSONFeature} A description of the feature.
  * @export
+ * @override
  */
 ee.Feature.prototype.getInfo = function(opt_callback) {
   return /** @type {ee.data.GeoJSONFeature} */(

package/src/featurecollection.js

@@ -179,6 +179,7 @@ ee.FeatureCollection.prototype.getMap = function(opt_visParams, opt_callback) {
  *     - properties: an optional dictionary containing the collection's
  *           metadata properties.
  * @export
+ * @override
  */
 ee.FeatureCollection.prototype.getInfo = function(opt_callback) {
   return /** @type {ee.data.FeatureCollectionDescription} */(

package/src/geometry.js

@@ -660,6 +660,7 @@ goog.inherits(ee.Geometry.MultiPolygon, ee.Geometry);
  * @param {function(*): *=} opt_encoder A function that can be called to encode
  *    the components of an object.
  * @return {*} An encoded representation of the geometry.
+ * @override
  */
 ee.Geometry.prototype.encode = function(opt_encoder) {
   if (!this.type_) {

package/src/image.js

@@ -143,6 +143,7 @@ ee.Image.reset = function() {
  *     - bands - a list containing metadata about the bands in the collection.
  *     - properties - a dictionary containing the image's metadata properties.
  * @export
+ * @override
  */
 ee.Image.prototype.getInfo = function(opt_callback) {
   return /** @type {ee.data.ImageDescription} */(

package/src/imagecollection.js

@@ -298,6 +298,7 @@ ee.ImageCollection.prototype.getMap = function(opt_visParams, opt_callback) {
  *     - properties: an optional dictionary containing the collection's
  *           metadata properties.
  * @export
+ * @override
  */
 ee.ImageCollection.prototype.getInfo = function(opt_callback) {
   return /** @type {!ee.data.ImageCollectionDescription} */(

package/src/maplayeroverlay.js

@@ -101,6 +101,7 @@ ee.MapLayerOverlay = class extends ee.AbstractOverlay {
    * @param {number} zoom Zoom level.
    * @param {Node} ownerDocument Parent document.
    * @return {Node} Element to be displayed as a map tile.
+   * @override
    */
   getTile(coord, zoom, ownerDocument) {
     var maxCoord = 1 << zoom;
@@ -153,7 +154,10 @@ ee.MapLayerOverlay = class extends ee.AbstractOverlay {
     return this.tiles_.getCount();
   }
 
-  /** @return {number} The number of tiles currently loading. */
+  /**
+   * @return {number} The number of tiles currently loading.
+   * @override
+   */
   getLoadingTilesCount() {
     return this.tilesLoading.length;
   }