feat: add a new business status FUTURE_OPENING for places,

along with an `opening_date` field to indicate when the establishment
will open in the future
feat: add a new `include_future_opening_businesses` flag to Nearby Search, Text Search, and AutocompletPlaces. When true, businesses opening in the future are included in the results.

PiperOrigin-RevId: 885675815

Author: Google APIs

google/maps/places/v1/place.proto

@@ -238,6 +238,9 @@ message Place {
 
     // The establishment is permanently closed.
     CLOSED_PERMANENTLY = 3;
+
+    // The establishment will open in the future.
+    FUTURE_OPENING = 4;
   }
 
   // Information about data providers of this place.
@@ -595,6 +598,10 @@ message Place {
   // The business status for the place.
   BusinessStatus business_status = 25;
 
+  // The date this place will open in the future. This field is only
+  // populated if the business status is FUTURE_OPENING.
+  google.type.Date opening_date = 95;
+
   // Price level of the place.
   PriceLevel price_level = 26;
 

google/maps/places/v1/places_service.proto

@@ -255,6 +255,11 @@ message SearchNearbyRequest {
   // Optional. Parameters that affect the routing to the search results.
   RoutingParameters routing_parameters = 10
       [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. If true, include businesses that are not yet open but will open
+  // in the future.
+  bool include_future_opening_businesses = 15
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Response proto for Search Nearby.
@@ -442,6 +447,11 @@ message SearchTextRequest {
   // location related fields for these businesses.
   bool include_pure_service_area_businesses = 20
       [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. If true, include businesses that are not yet open but will open
+  // in the future.
+  bool include_future_opening_businesses = 21
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Response proto for SearchText.
@@ -720,6 +730,11 @@ message AutocompletePlacesRequest {
   // location related fields for these businesses.
   bool include_pure_service_area_businesses = 12
       [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. If true, include businesses that are not yet open but will open
+  // in the future.
+  bool include_future_opening_businesses = 13
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Response proto for AutocompletePlaces.