@google/earthengine 0.1.377 → 0.1.379

package/package.json

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

package/src/apiclient.js

@@ -6,7 +6,6 @@ goog.module.declareLegacyNamespace();
 
 const GoogConst = goog.require('goog.string.Const');
 const Throttle = goog.require('goog.async.Throttle');
-const TrustedResourceUrl = goog.require('goog.html.TrustedResourceUrl');
 const Uri = goog.require('goog.Uri');
 const XhrIo = goog.require('goog.net.XhrIo');
 const XhrLike = goog.requireType('goog.net.XhrLike');
@@ -21,11 +20,12 @@ const jsloader = goog.require('goog.net.jsloader');
 const {MakeRequestParams, processParams} = goog.require('eeapiclient.request_params');
 const {NULL_VALUE, Serializable, SerializableCtor, deserialize, serialize} = goog.require('eeapiclient.domain_object');
 const {PromiseRequestService} = goog.require('eeapiclient.promise_request_service');
+const {trustedResourceUrl} = goog.require('safevalues');
 
 /** @namespace */
 const apiclient = {};
 
-const API_CLIENT_VERSION = '0.1.377';
+const API_CLIENT_VERSION = '0.1.379';
 
 exports.VERSION = apiVersion.VERSION;
 exports.API_CLIENT_VERSION = API_CLIENT_VERSION;
@@ -1147,8 +1147,9 @@ apiclient.ensureAuthLibLoaded_ = function(callback) {
       delete goog.global[callbackName];
       done();
     };
-    jsloader.safeLoad(TrustedResourceUrl.format(
-        apiclient.AUTH_LIBRARY_URL_, {'onload': callbackName}));
+    jsloader.safeLoad(
+        trustedResourceUrl`https://apis.google.com/js/client.js?onload=${
+            callbackName}`);
   }
 };
 

package/src/ee.js

@@ -378,8 +378,7 @@ ee.promote_ = function(arg, klass) {
       return new ee.Image(/** @type {Object} */ (arg));
     case 'Feature':
       if (arg instanceof ee.Collection) {
-        // TODO(user): Decide whether we want to leave this in. It can be
-        //              quite dangerous on large collections.
+        // This can be quite dangerous on large collections.
         return ee.ApiFunction._call(
             'Feature', ee.ApiFunction._call('Collection.geometry', arg));
       } else {

package/src/eeapiclient/api_client.ts

@@ -1,3 +1,4 @@
+// g3-format-clang
 import {Serializable, serialize} from './domain_object';
 import {GeneratedRequestParams} from './generated_types';
 import {MultipartRequest} from './multipart_request';

package/src/eeapiclient/api_request_hook.ts

@@ -1,3 +1,4 @@
+// g3-format-clang
 import {GeneratedRequestParams} from './generated_types';
 
 export interface ApiClientRequestHook {

package/src/eeapiclient/domain_object.ts

@@ -1,4 +1,5 @@
 /**
+ * g3-format-clang
  * Utility map for ClassMetadata to describe how to create instances of child
  * properties.
  */

package/src/eeapiclient/generated_types.ts

@@ -1,3 +1,4 @@
+// g3-format-clang
 import {Serializable, SerializableCtor} from './domain_object';
 import {MultipartRequest} from './multipart_request';
 

package/src/eeapiclient/multipart_request.ts

@@ -1,3 +1,4 @@
+// g3-format-clang
 import {Serializable, serialize} from './domain_object';
 
 export class MultipartRequest {

package/src/eeapiclient/promise_api_client.ts

@@ -1,3 +1,4 @@
+// g3-format-clang
 import {ApiClient, toMakeRequestParams, toMultipartMakeRequestParams} from './api_client';
 import {ApiClientHookFactory, getRequestHook} from './api_request_hook';
 import {Serializable} from './domain_object';

package/src/eeapiclient/promise_request_service.ts

@@ -1,3 +1,4 @@
+// g3-format-clang
 import {deserialize, Serializable, SerializableCtor} from './domain_object';
 import {MakeRequestParams, processParams} from './request_params';
 

package/src/eeapiclient/request_params.ts

@@ -1,3 +1,4 @@
+// g3-format-clang
 import * as httpCors from 'goog:goog.net.rpc.HttpCors';
 
 import {GeneratedQueryParams} from './generated_types';

package/src/eeapiclient/request_params_test.ts

@@ -1,3 +1,4 @@
+// g3-format-clang
 import 'jasmine';
 
 import {buildQueryParams, bypassCorsPreflight, MakeRequestParams} from './request_params';

package/src/examples/CloudMasking/Sentinel2CloudScorePlus.js

@@ -0,0 +1,35 @@
+// This example demonstrates how to use Cloud Score+ QA bands to generate a
+// clear median composite for a specified date range.
+
+// Harmonized Sentinel-2 Level 2A collection.
+var s2 = ee.ImageCollection('COPERNICUS/S2_SR_HARMONIZED');
+
+// Cloud Score+ image collection. Note Cloud Score+ is produced from Sentinel-2
+// Level 1C data and can be applied to either L1C or L2A collections.
+var csPlus = ee.ImageCollection('GOOGLE/CLOUD_SCORE_PLUS/V1/S2_HARMONIZED');
+
+// Region of interest.
+var ROI = ee.Geometry.Point(-119.9087, 37.4159);
+
+// Use 'cs' or 'cs_cdf', depending on your use-case; see docs for guidance.
+var QA_BAND = 'cs_cdf';
+
+// The threshold for masking; values between 0.50 and 0.65 generally work well.
+// Higher values will remove thin clouds, haze & cirrus shadows.
+var CLEAR_THRESHOLD = 0.60;
+
+// Make composite.
+var composite = s2
+    .filterBounds(ROI)
+    .filterDate('2023-01-01', '2023-02-01')
+    .linkCollection(csPlus, [QA_BAND])
+    .map(function(img) {
+      return img.updateMask(img.select(QA_BAND).gte(CLEAR_THRESHOLD));
+    })
+    .median();
+
+// Sentinel-2 visualization parameters.
+var s2Viz = {bands: ['B4', 'B3', 'B2'], min: 0, max: 2500};
+
+Map.addLayer(composite, s2Viz, 'median composite');
+Map.centerObject(ROI, 11);

package/src/examples/CloudMasking/Sentinel2ClearComposite.js

@@ -1,57 +0,0 @@
-// This example demonstrates how to use Cloud Score+ QA bands to
-// create a clear Sentinel-2 median composite.
-//
-
-
-// Region of interest.
-var roi = ee.Geometry.Rectangle([-124.8697, 35.5806, -119.9917, 39.9554]);
-
-// Harmonized Sentinel-2 Level 2A collection.
-var s2 = ee.ImageCollection('COPERNICUS/S2_SR_HARMONIZED');
-
-// Cloud Score+ image collection. Note Cloud Score+ is produced
-// from Sentinel-2 Level 1C data and can be applied to either L1C
-// or L2A collections.
-var csPlus = ee.ImageCollection('GOOGLE/CLOUD_SCORE_PLUS/V1/S2_HARMONIZED');
-
-// Get list of Sentinel-2 bands.
-var csPlusBands = csPlus.first().bandNames();
-
-// Link S2 and CS+ results.
-var linkedCollection = s2.linkCollection(csPlus, csPlusBands);
-// Date range for median composite.
-var dateStart = '2023-03-01';
-var dateEnd = '2023-09-01';
-
-/**
- * Masks pixels with low CS+ QA scores.
- * @param {ee.Image} image Sentinel-2 image
- * @return {ee.Image} masked Sentinel-2 image
- */
-function maskLowQA(image) {
-  // CS+ QA band to use for masking. Options are 'cs' and 'cs_cdf'.
-  var qaBand = 'cs';
-
-  // Adjustable threshold for converting CS+ QA to a binary mask.
-  // Higher thresholds will mask out partial occlusions like thin clouds, haze &
-  // cirrus shadows. Lower thresholds will be more permissive of these
-  // occlusions.
-  var clearThreshold = 0.60;
-  var mask = image.select(qaBand).gte(clearThreshold);
-
-  return image.updateMask(mask);
-}
-
-
-// Filter collection, mask pixels with low QA scores, and
-// generate median composite.
-var composite = linkedCollection.filterBounds(roi)
-                    .filterDate(dateStart, dateEnd)
-                    .map(maskLowQA)
-                    .median();
-
-// Sentinel-2 visualization parameters.
-var s2Viz = {bands: ['B4', 'B3', 'B2'], min: 0, max: 3000};
-
-Map.addLayer(composite, s2Viz, 'median composite');
-Map.centerObject(roi, 11);