feat: Add experiments param to endpoints for access to pre-GA features

Google APIs · copybara-github · commit 74853d72427c · 2025-08-15T13:26:37.000-07:00
feat: Add new `ImageryQuality` tier for allowing satellite-based Solar API results
docs: Add more detailed descriptions for each `ImageryQuality` tier

PiperOrigin-RevId: 795589896
diff --git a/google/maps/solar/v1/solar_service.proto b/google/maps/solar/v1/solar_service.proto
@@ -39,9 +39,9 @@ service Solar {
   option (google.api.oauth_scopes) =
       "https://www.googleapis.com/auth/cloud-platform";
 
-  // Locates the closest building to a query point. Returns an error with
-  // code `NOT_FOUND` if there are no buildings within approximately 50m of the
-  // query point.
+  // Locates the building whose centroid is closest to a query point. Returns an
+  // error with code `NOT_FOUND` if there are no buildings within approximately
+  // 50m of the query point.
   rpc FindClosestBuildingInsights(FindClosestBuildingInsightsRequest)
       returns (BuildingInsights) {
     option (google.api.http) = {
@@ -84,6 +84,9 @@ message FindClosestBuildingInsightsRequest {
   // is interpreted as the exact required quality and only `MEDIUM` quality
   // imagery is returned if `required_quality` is set to `MEDIUM`.
   bool exact_quality_required = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Specifies the pre-GA features to enable.
+  repeated Experiment experiments = 5 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // A bounding box in lat/lng coordinates.
@@ -99,7 +102,7 @@ message LatLngBox {
 // Information about the location, dimensions, and solar potential of a
 // building.
 message BuildingInsights {
-  // The resource name for the building, of the format `building/<place ID>`.
+  // The resource name for the building, of the format `buildings/{place_id}`.
   string name = 1;
 
   // A point near the center of the building.
@@ -562,6 +565,9 @@ message GetDataLayersRequest {
   // is interpreted as the exact required quality and only `MEDIUM` quality
   // imagery is returned if `required_quality` is set to `MEDIUM`.
   bool exact_quality_required = 7 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Specifies the pre-GA experiments to enable.
+  repeated Experiment experiments = 8 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Information about the solar potential of a region. The actual data
@@ -682,14 +688,21 @@ enum ImageryQuality {
   // No quality is known.
   IMAGERY_QUALITY_UNSPECIFIED = 0;
 
-  // The underlying imagery and DSM data were processed at 0.1 m/pixel.
+  // Solar data is derived from aerial imagery captured at low-altitude and
+  // processed at 0.1 m/pixel.
   HIGH = 1;
 
-  // The underlying imagery and DSM data were processed at 0.25 m/pixel.
+  // Solar data is derived from enhanced aerial imagery captured at
+  // high-altitude and processed at 0.25 m/pixel.
   MEDIUM = 2;
 
-  // The underlying imagery and DSM data were processed at 0.5 m/pixel.
+  // Solar data is derived from enhanced satellite imagery processed at 0.25
+  // m/pixel.
   LOW = 3;
+
+  // Solar data is derived from enhanced satellite imagery processed at 0.25
+  // m/pixel.
+  BASE = 4;
 }
 
 // The orientation of a solar panel. This must be interpreted relative to the
@@ -706,3 +719,14 @@ enum SolarPanelOrientation {
   // direction of the roof segment that it is placed on.
   PORTRAIT = 2;
 }
+
+// Specifies pre-GA experiments that can be enabled in the API.
+enum Experiment {
+  // No experiments are specified.
+  EXPERIMENT_UNSPECIFIED = 0;
+
+  // Expands the geographic region available for querying solar data. For more
+  // information, see [Expanded
+  // Coverage](https://developers.google.com/maps/documentation/solar/expanded-coverage).
+  EXPANDED_COVERAGE = 1;
+}
