v0.1.370

PiperOrigin-RevId: 565718645

javascript/package.json

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

javascript/src/apiclient.js

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

javascript/src/apifunction.js

@@ -9,8 +9,6 @@
  *
  * This class manages the algorithm dictionary and creates JavaScript functions
  * to apply each EE algorithm.
- *
- * @author [email protected] (Max Shawabkeh)
  */
 
 goog.provide('ee.ApiFunction');

javascript/src/batch.js

@@ -325,6 +325,7 @@ Export.table.toFeatureView = function(
  * @param {string|!Array<string>=} opt_selectors
  * @param {number=} opt_maxVertices
  * @return {!ExportTask}
+ * @export
  */
 Export.table.toBigQuery = function(
     collection, opt_description, opt_table, opt_overwrite, opt_append,

javascript/src/collection.js

@@ -1,7 +1,6 @@
 /**
  * @fileoverview Base class for ImageCollection and FeatureCollection.
  * This class is never intended to be instantiated by the user.
- * @author [email protected] (Noel Gorelick)
  */
 
 goog.provide('ee.Collection');

javascript/src/computedobject.js

@@ -1,7 +1,5 @@
 /**
  * @fileoverview A representation of a computed earthengine object.
- *
- * @author [email protected] (Noel Gorelick)
  */
 
 goog.provide('ee.ComputedObject');

javascript/src/customfunction.js

@@ -1,6 +1,5 @@
 /**
  * @fileoverview An object representing a custom EE Function.
- * @author [email protected] (Max Shawabkeh)
  */
 
 goog.provide('ee.CustomFunction');

javascript/src/data.js

@@ -1,7 +1,6 @@
 /**
  * @fileoverview Singleton for all of the library's communication
  * with the Earth Engine API.
- * @author [email protected] (Noel Gorelick)
  * @suppress {missingRequire} TODO(user): this shouldn't be needed
  * @suppress {useOfGoogProvide} TODO(user): Convert to goog.module.
  */

javascript/src/date.js

@@ -3,8 +3,6 @@
  *
  * We don't autogenerate this class because we want the constructor
  * to promote by pushing things through the server-side Date() function.
- *
- * @author [email protected] (Noel Gorelick)
  */
 
 goog.provide('ee.Date');

javascript/src/deserializer.js

@@ -1,7 +1,5 @@
 /**
  * @fileoverview A deserializer that decodes EE object trees from JSON DAGs.
- *
- * @author [email protected] (Max Shawabkeh)
  */
 
 goog.provide('ee.Deserializer');

javascript/src/dictionary.js

@@ -1,6 +1,5 @@
 /**
  * @fileoverview A wrapper for dicts.
- * @author [email protected] (Noel Gorelick)
  */
 
 goog.provide('ee.Dictionary');

javascript/src/ee.js

@@ -1,6 +1,5 @@
 /**
  * @fileoverview Initialization and convenience functions for the EE library.
- * @author [email protected] (Noel Gorelick)
  */
 
 goog.provide('ee');

javascript/src/element.js

@@ -1,7 +1,6 @@
 /**
  * @fileoverview Base class for Image, Feature and Collection.
  * This class is never intended to be instantiated by the user.
- * @author [email protected] (Noel Gorelick)
  */
 
 goog.provide('ee.Element');

javascript/src/encodable.js

@@ -1,6 +1,5 @@
 /**
  * @fileoverview An interface implemented by serializable objects.
- * @author [email protected] (Max Shawabkeh)
  */
 
 goog.provide('ee.Encodable');

javascript/src/feature.js

@@ -1,6 +1,5 @@
 /**
  * @fileoverview An object representing EE Features.
- * @author [email protected] (Noel Gorelick)
  */
 
 goog.provide('ee.Feature');

javascript/src/featurecollection.js

@@ -1,6 +1,5 @@
 /**
  * @fileoverview Representation of an Earth Engine FeatureCollection.
- * @author [email protected] (Noel Gorelick)
  */
 
 goog.provide('ee.FeatureCollection');
@@ -70,8 +69,8 @@ ee.FeatureCollection = function(args, opt_column) {
       actualArgs['geometryColumn'] = opt_column;
     }
     ee.FeatureCollection.base(
-        this, 
-        'constructor', 
+        this,
+        'constructor',
         new ee.ApiFunction('Collection.loadTable'), actualArgs);
   } else if (Array.isArray(args)) {
     // A list of features.

javascript/src/filter.js

@@ -1,6 +1,5 @@
 /**
  * @fileoverview Collection filters.
- * @author [email protected] (Noel Gorelick)
  *
  * new Filter('time', low, high)
  *    .bounds(ring)

javascript/src/function.js

@@ -1,6 +1,5 @@
 /**
  * @fileoverview A base class for EE Functions.
- * @author [email protected] (Max Shawabkeh)
  */
 
 goog.provide('ee.Function');

javascript/src/geometry.js

@@ -1,6 +1,5 @@
 /**
  * @fileoverview An object representing EE Geometries.
- * @author [email protected] (Max Shawabkeh)
  */
 
 goog.provide('ee.Geometry');

javascript/src/image.js

@@ -1,7 +1,7 @@
 /**
  * @fileoverview A representation of an earth engine image.
- * See: https://sites.google.com/site/earthengineapidocs for more details.
- * @author [email protected] (Noel Gorelick)
+ * See: https://developers.google.com/earth-engine/apidocs/ee-image for more
+ * details.
  */
 
 goog.provide('ee.Image');

javascript/src/imagecollection.js

@@ -1,6 +1,5 @@
 /**
  * @fileoverview Javascript representation for an Earth Engine ImageCollection.
- * @author [email protected] (Noel Gorelick)
  */
 
 goog.provide('ee.ImageCollection');

javascript/src/list.js

@@ -1,6 +1,5 @@
 /**
  * @fileoverview A wrapper for Lists.
- * @author [email protected] (Noel Gorelick)
  */
 
 goog.provide('ee.List');

javascript/src/number.js

@@ -1,6 +1,5 @@
 /**
  * @fileoverview A wrapper for numbers.
- * @author [email protected] (Noel Gorelick)
  */
 
 goog.provide('ee.Number');

javascript/src/serializer.js

@@ -1,7 +1,5 @@
 /**
  * @fileoverview A serializer that encodes EE object trees as JSON DAGs.
- *
- * @author [email protected] (Noel Gorelick)
  */
 
 goog.provide('ee.Serializer');

javascript/src/string.js

@@ -1,6 +1,5 @@
 /**
  * @fileoverview A wrapper for strings.
- * @author [email protected] (Noel Gorelick)
  */
 
 goog.provide('ee.String');

javascript/src/terrain.js

@@ -1,7 +1,6 @@
 /**
  * @fileoverview A class to generate the ee.Terrain namespace.
  *
- * @author [email protected] (Noel Gorelick)
  * @suppress {useOfGoogProvide}
  */
 

javascript/src/types.js

@@ -1,6 +1,5 @@
 /**
  * @fileoverview A set of utilities to work with EE types.
- * @author [email protected] (Max Shawabkeh)
  */
 
 goog.provide('ee.Types');

python/ee/__init__.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 """The EE Python library."""
 
-__version__ = '0.1.369'
+__version__ = '0.1.370'
 
 # Using lowercase function naming to match the JavaScript names.
 # pylint: disable=g-bad-name
@@ -128,6 +128,7 @@ def Initialize(
   """
   if credentials == 'persistent':
     credentials = data.get_persistent_credentials()
+
   data.initialize(
       credentials=credentials,
       api_base_url=(opt_url + '/api' if opt_url else None),
@@ -136,44 +137,50 @@ def Initialize(
       cloud_api_key=cloud_api_key,
       project=project,
       http_transport=http_transport)
+
   # Initialize the dynamically loaded functions on the objects that want them.
   ApiFunction.initialize()
+  Collection.initialize()
+  Date.initialize()
+  Dictionary.initialize()
   Element.initialize()
-  Image.initialize()
   Feature.initialize()
-  Collection.initialize()
-  ImageCollection.initialize()
   FeatureCollection.initialize()
   Filter.initialize()
   Geometry.initialize()
+  Image.initialize()
+  ImageCollection.initialize()
   List.initialize()
   Number.initialize()
   String.initialize()
-  Date.initialize()
-  Dictionary.initialize()
   Terrain.initialize()
+
+  # These must happen last.
   _InitializeGeneratedClasses()
   _InitializeUnboundMethods()
 
 
 def Reset():
   """Reset the library. Useful for re-initializing to a different server."""
   data.reset()
+
+  # Must call reset on the base class before any of its derived classes.
   ApiFunction.reset()
-  Element.reset()
-  Image.reset()
+  Element.reset()  # Must be before Collection.
+  Collection.reset()  # Must be before FeatureCollection and ImageCollection.
+  Date.reset()
+  Dictionary.reset()
   Feature.reset()
-  Collection.reset()
-  ImageCollection.reset()
   FeatureCollection.reset()
   Filter.reset()
   Geometry.reset()
+  Image.reset()
+  ImageCollection.reset()
   List.reset()
   Number.reset()
   String.reset()
-  Date.reset()
-  Dictionary.reset()
   Terrain.reset()
+
   _ResetGeneratedClasses()
   global Algorithms
   Algorithms = _AlgorithmsContainer()

python/ee/apifunction.py

@@ -14,10 +14,12 @@
 # Using lowercase function naming to match the JavaScript names.
 # pylint: disable=g-bad-name
 
+from __future__ import annotations
+
 import copy
 import keyword
 import re
-from typing import Any, Dict, Optional, Type
+from typing import Any, Dict, Optional, Set, Type
 
 from ee import computedobject
 from ee import data
@@ -32,11 +34,11 @@ class ApiFunction(function.Function):
   _signature: Dict[str, Any]
 
   # A dictionary of functions defined by the API server.
-  _api = {}
+  _api: Dict[str, ApiFunction] = {}
 
   # A set of algorithm names containing all algorithms that have been bound to
   # a function so far using importApi().
-  _bound_signatures = set()
+  _bound_signatures: Set[str] = set()
 
   def __init__(self, name: str, opt_signature: Optional[Dict[str, Any]] = None):
     """Creates a function defined by the EE API.
@@ -53,7 +55,7 @@ def __init__(self, name: str, opt_signature: Optional[Dict[str, Any]] = None):
     self._signature = copy.deepcopy(opt_signature)
     self._signature['name'] = name
 
-  def __eq__(self, other):
+  def __eq__(self, other: Any) -> bool:
     return (isinstance(other, ApiFunction) and
             self.getSignature() == other.getSignature())
 
@@ -94,11 +96,11 @@ def apply_(cls, name: str, named_args: Dict[str, Any]) -> Any:
     """
     return cls.lookup(name).apply(named_args)
 
-  def encode_invocation(self, encoder):
+  def encode_invocation(self, encoder: Any) -> Any:
     del encoder  # Unused.
     return self._signature['name']
 
-  def encode_cloud_invocation(self, encoder):
+  def encode_cloud_invocation(self, encoder: Any) -> Dict[str, Any]:
     del encoder  # Unused.
     return {'functionName': self._signature['name']}
 
@@ -120,7 +122,7 @@ def unboundFunctions(cls) -> Dict[str, Any]:
     return dict([(name, func) for name, func in cls._api.items()
                  if name not in cls._bound_signatures])
 
-  # TODO(user): Any -> 'ApiFunction' for the return type.
+  # TODO(user): Any -> ApiFunction for the return type.
   @classmethod
   def lookup(cls, name: str) -> Any:
     """Looks up an API function by name.
@@ -139,7 +141,7 @@ def lookup(cls, name: str) -> Any:
     return result
 
   @classmethod
-  def lookupInternal(cls, name: str) -> Optional['ApiFunction']:
+  def lookupInternal(cls, name: str) -> Optional[ApiFunction]:
     """Looks up an API function by name.
 
     Args:
@@ -212,7 +214,8 @@ def importApi(
         # Create a new function so we can attach properties to it.
         def MakeBoundFunction(func):
           # We need the lambda to capture "func" from the enclosing scope.
-          return lambda *args, **kwargs: func.call(*args, **kwargs)  # pylint: disable=unnecessary-lambda
+          # pylint: disable-next=unnecessary-lambda
+          return lambda *args, **kwargs: func.call(*args, **kwargs)
         bound_function = MakeBoundFunction(api_func)
 
         # Add docs.