@googlemaps/solar 0.5.2 → 0.7.0

package/README.md

@@ -77,7 +77,6 @@ Samples are in the [`samples/`][homepage_samples] directory. Each sample's `READ
 
 | Sample                      | Source Code                       |
 | --------------------------- | --------------------------------- |
-| maps | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-solar/samples/generated/v1/snippet_metadata_google.maps.solar.v1.json) |
 | find closest building insights | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-solar/samples/generated/v1/solar.find_closest_building_insights.js) |
 | get data layers | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-solar/samples/generated/v1/solar.get_data_layers.js) |
 | get geo tiff | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-solar/samples/generated/v1/solar.get_geo_tiff.js) |
@@ -114,7 +113,7 @@ More Information: [Google Cloud Platform Launch Stages][launch_stages]
 
 ## Contributing
 
-Contributions welcome! See the [Contributing Guide](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-solar/CONTRIBUTING.md).
+Contributions welcome! See the [Contributing Guide](https://github.com/googleapis/google-cloud-node/blob/main/CONTRIBUTING.md).
 
 Please note that this `README.md`
 and a variety of configuration files in this repository (including `.nycrc` and `tsconfig.json`)
@@ -124,7 +123,7 @@ are generated from a central template.
 
 Apache Version 2.0
 
-See [LICENSE](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-solar/LICENSE)
+See [LICENSE](https://github.com/googleapis/google-cloud-node/blob/main/LICENSE)
 
 [shell_img]: https://gstatic.com/cloudssh/images/open-btn.png
 [projects]: https://console.cloud.google.com/project

package/build/protos/google/maps/solar/v1/solar_service.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -85,8 +85,20 @@ message FindClosestBuildingInsightsRequest {
   // 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.
+  // Optional. Specifies the pre-GA experiments to enable. Requests using this
+  // field are classified as a pre-GA offering under the [Google Maps Platform
+  // Service Specific
+  // Terms](https://cloud.google.com/maps-platform/terms/maps-service-terms).
+  // See [launch stage
+  // descriptions](https://cloud.google.com/maps-platform/terms/launch-stages)
+  // for more details.
   repeated Experiment experiments = 5 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. A list of
+  // [additional_insights][google.maps.solar.v1.FindClosestBuildingInsightsRequest.additional_insights]
+  // to be included in the response.
+  repeated AdditionalInsights additional_insights = 6
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // A bounding box in lat/lng coordinates.
@@ -102,6 +114,30 @@ message LatLngBox {
 // Information about the location, dimensions, and solar potential of a
 // building.
 message BuildingInsights {
+  // Information about solar arrays detected on the building.
+  message DetectedArrays {
+    // Indicates the detection status of solar arrays for this building.
+    enum DetectionStatus {
+      // Unspecified status.
+      DETECTION_STATUS_UNSPECIFIED = 0;
+
+      // Detected solar array data is unavailable for this building.
+      DETECTION_STATUS_DATA_UNAVAILABLE = 1;
+
+      // At least one solar array has been detected for this building.
+      DETECTION_STATUS_ARRAYS_DETECTED = 2;
+
+      // No solar arrays detected for this building.
+      DETECTION_STATUS_NO_ARRAYS_DETECTED = 3;
+    }
+
+    // Indicates the detection status of solar arrays for this building.
+    DetectionStatus detection_status = 1;
+
+    // The date indicating when the latest solar array data was captured.
+    google.type.Date latest_capture_date = 3;
+  }
+
   // The resource name for the building, of the format `buildings/{place_id}`.
   string name = 1;
 
@@ -135,6 +171,11 @@ message BuildingInsights {
 
   // The quality of the imagery used to compute the data for this building.
   ImageryQuality imagery_quality = 10;
+
+  // Solar arrays detected on the building. This field is only populated if
+  // DETECTED_ARRAYS is included in the request's
+  // [FindClosestBuildingInsightsRequest.additional_insights][google.maps.solar.v1.FindClosestBuildingInsightsRequest.additional_insights].
+  DetectedArrays detected_arrays = 12;
 }
 
 // Information about the solar potential of a building. A number of
@@ -202,7 +243,7 @@ message SolarPotential {
   // Size and sunlight quantiles for each roof segment.
   repeated RoofSegmentSizeAndSunshineStats roof_segment_stats = 6;
 
-  // Each [SolarPanel] [google.maps.solar.v1.SolarPanel]
+  // Each [SolarPanel][google.maps.solar.v1.SolarPanel]
   // describes a single solar panel. They are listed in the order that
   // the panel layout algorithm placed this. This is usually, though
   // not always, in decreasing order of annual energy production.
@@ -566,7 +607,13 @@ message GetDataLayersRequest {
   // 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.
+  // Optional. Specifies the pre-GA experiments to enable. Requests using this
+  // field are classified as a pre-GA offering under the [Google Maps Platform
+  // Service Specific
+  // Terms](https://cloud.google.com/maps-platform/terms/maps-service-terms).
+  // See [launch stage descriptions](
+  // https://cloud.google.com/maps-platform/terms/launch-stages) for more
+  // details.
   repeated Experiment experiments = 8 [(google.api.field_behavior) = OPTIONAL];
 }
 
@@ -658,6 +705,21 @@ message GetGeoTiffRequest {
   string id = 1 [(google.api.field_behavior) = REQUIRED];
 }
 
+// Additional building information such as roof geometry and
+// solar panel arrays that can be returned in BuildingInsights.
+//
+// New values may be added to this enum in the future.
+enum AdditionalInsights {
+  // The default value. The default BuildingInsights will be returned.
+  ADDITIONAL_INSIGHTS_UNSPECIFIED = 0;
+
+  // Determines whether the response will include the detected arrays.
+  //
+  // If specified, the `detected_arrays` field will be populated in the
+  // response.
+  DETECTED_ARRAYS = 2;
+}
+
 // What subset of the solar information to return.
 enum DataLayerView {
   // Equivalent to FULL.