feat: update attributes in Places API

Google APIs · copybara-github · commit e7084f34ebed · 2024-11-08T09:06:44.000-08:00
PiperOrigin-RevId: 694522095
diff --git a/google/maps/places/v1/BUILD.bazel b/google/maps/places/v1/BUILD.bazel
@@ -65,6 +65,7 @@ proto_library(
         "place.proto",
         "places_service.proto",
         "polyline.proto",
+        "price_range.proto",
         "reference.proto",
         "review.proto",
         "route_modifiers.proto",
@@ -197,13 +198,13 @@ go_gapic_library(
     grpc_service_config = "places_grpc_service_config.json",
     importpath = "cloud.google.com/go/maps/places/apiv1;places",
     metadata = True,
-    # Labeling beta so we get unstable notice in client.
     release_level = "beta",
     rest_numeric_enums = True,
     service_yaml = "places_v1.yaml",
     transport = "grpc+rest",
     deps = [
         ":places_go_proto",
+        "@io_bazel_rules_go//proto/wkt:duration_go_proto",
     ],
 )
 
@@ -392,7 +393,6 @@ load(
 
 csharp_proto_library(
     name = "places_csharp_proto",
-    extra_opts = [],
     deps = [":places_proto"],
 )
 
diff --git a/google/maps/places/v1/attribution.proto b/google/maps/places/v1/attribution.proto
@@ -16,7 +16,6 @@ syntax = "proto3";
 
 package google.maps.places.v1;
 
-option cc_enable_arenas = true;
 option csharp_namespace = "Google.Maps.Places.V1";
 option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
 option java_multiple_files = true;
diff --git a/google/maps/places/v1/content_block.proto b/google/maps/places/v1/content_block.proto
@@ -19,7 +19,6 @@ package google.maps.places.v1;
 import "google/maps/places/v1/reference.proto";
 import "google/type/localized_text.proto";
 
-option cc_enable_arenas = true;
 option csharp_namespace = "Google.Maps.Places.V1";
 option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
 option java_multiple_files = true;
diff --git a/google/maps/places/v1/contextual_content.proto b/google/maps/places/v1/contextual_content.proto
@@ -19,7 +19,6 @@ package google.maps.places.v1;
 import "google/maps/places/v1/photo.proto";
 import "google/maps/places/v1/review.proto";
 
-option cc_enable_arenas = true;
 option csharp_namespace = "Google.Maps.Places.V1";
 option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
 option java_multiple_files = true;
diff --git a/google/maps/places/v1/ev_charging.proto b/google/maps/places/v1/ev_charging.proto
@@ -18,7 +18,6 @@ package google.maps.places.v1;
 
 import "google/protobuf/timestamp.proto";
 
-option cc_enable_arenas = true;
 option csharp_namespace = "Google.Maps.Places.V1";
 option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
 option java_multiple_files = true;
diff --git a/google/maps/places/v1/fuel_options.proto b/google/maps/places/v1/fuel_options.proto
@@ -19,7 +19,6 @@ package google.maps.places.v1;
 import "google/protobuf/timestamp.proto";
 import "google/type/money.proto";
 
-option cc_enable_arenas = true;
 option csharp_namespace = "Google.Maps.Places.V1";
 option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
 option java_multiple_files = true;
diff --git a/google/maps/places/v1/geometry.proto b/google/maps/places/v1/geometry.proto
@@ -19,7 +19,6 @@ package google.maps.places.v1;
 import "google/api/field_behavior.proto";
 import "google/type/latlng.proto";
 
-option cc_enable_arenas = true;
 option csharp_namespace = "Google.Maps.Places.V1";
 option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
 option java_multiple_files = true;
diff --git a/google/maps/places/v1/photo.proto b/google/maps/places/v1/photo.proto
@@ -20,7 +20,6 @@ import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/maps/places/v1/attribution.proto";
 
-option cc_enable_arenas = true;
 option csharp_namespace = "Google.Maps.Places.V1";
 option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
 option java_multiple_files = true;
diff --git a/google/maps/places/v1/place.proto b/google/maps/places/v1/place.proto
@@ -22,13 +22,14 @@ import "google/maps/places/v1/content_block.proto";
 import "google/maps/places/v1/ev_charging.proto";
 import "google/maps/places/v1/fuel_options.proto";
 import "google/maps/places/v1/photo.proto";
+import "google/maps/places/v1/price_range.proto";
 import "google/maps/places/v1/reference.proto";
 import "google/maps/places/v1/review.proto";
+import "google/protobuf/timestamp.proto";
 import "google/type/date.proto";
 import "google/type/latlng.proto";
 import "google/type/localized_text.proto";
 
-option cc_enable_arenas = true;
 option csharp_namespace = "Google.Maps.Places.V1";
 option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
 option java_multiple_files = true;
@@ -193,6 +194,16 @@ message Place {
     // current_opening_hours and current_secondary_opening_hours if there are
     // exceptional hours.
     repeated SpecialDay special_days = 5;
+
+    // The next time the current opening hours period starts up to 7 days in the
+    // future. This field is only populated if the opening hours period is not
+    // active at the time of serving the request.
+    google.protobuf.Timestamp next_open_time = 6;
+
+    // The next time the current opening hours period ends up to 7 days in the
+    // future. This field is only populated if the opening hours period is
+    // active at the time of serving the request.
+    google.protobuf.Timestamp next_close_time = 7;
   }
 
   // Business status for the place.
@@ -314,6 +325,17 @@ message Place {
     repeated ContentBlock content_blocks = 4;
   }
 
+  // Info about the place in which this place is located.
+  message ContainingPlace {
+    // The resource name of the place in which this place is located.
+    string name = 1 [
+      (google.api.resource_reference) = { type: "places.googleapis.com/Place" }
+    ];
+
+    // The place id of the place in which this place is located.
+    string id = 2;
+  }
+
   // This Place's resource name, in `places/{place_id}` format.  Can be used to
   // look up the Place.
   string name = 1;
@@ -378,7 +400,9 @@ message Place {
   // The position of this place.
   google.type.LatLng location = 12;
 
-  // A viewport suitable for displaying the place on an average-sized map.
+  // A viewport suitable for displaying the place on an average-sized map. This
+  // viewport should not be used as the physical boundary or the service area of
+  // the business.
   google.geo.type.Viewport viewport = 13;
 
   // A rating between 1.0 and 5.0, based on user reviews of this place.
@@ -412,7 +436,6 @@ message Place {
   // The place's address in adr microformat: http://microformats.org/wiki/adr.
   string adr_format_address = 24;
 
-  // The business status for the place.
   BusinessStatus business_status = 25;
 
   // Price level of the place.
@@ -562,6 +585,19 @@ message Place {
   //
   // AI-generated summary of the area that the place is in.
   AreaSummary area_summary = 81;
+
+  // List of places in which the current place is located.
+  repeated ContainingPlace containing_places = 82;
+
+  // Indicates whether the place is a pure service area business. Pure service
+  // area business is a business that visits or delivers to customers directly
+  // but does not serve customers at their business address. For example,
+  // businesses like cleaning services or plumbers. Those businesses may not
+  // have a physical address or location on Google Maps.
+  optional bool pure_service_area_business = 83;
+
+  // The price range associated with a Place.
+  PriceRange price_range = 86;
 }
 
 // Price level of the place.
diff --git a/google/maps/places/v1/places_service.proto b/google/maps/places/v1/places_service.proto
@@ -32,7 +32,6 @@ import "google/maps/places/v1/routing_summary.proto";
 import "google/maps/places/v1/travel_mode.proto";
 import "google/type/latlng.proto";
 
-option cc_enable_arenas = true;
 option csharp_namespace = "Google.Maps.Places.V1";
 option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
 option java_multiple_files = true;
@@ -263,7 +262,7 @@ message SearchNearbyResponse {
   repeated Place places = 1;
 
   // A list of routing summaries where each entry associates to the
-  // corresponding place in the same index in the places field. If the routing
+  // corresponding place in the same index in the `places` field. If the routing
   // summary is not available for one of the places, it will contain an empty
   // entry. This list should have as many entries as the list of places if
   // requested.
@@ -430,6 +429,16 @@ message SearchTextRequest {
   // Optional. Additional parameters proto for searching along a route.
   SearchAlongRouteParameters search_along_route_parameters = 17
       [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Include pure service area businesses if the field is set to true.
+  // Pure service area business is a business that visits or delivers to
+  // customers directly but does not serve customers at their business address.
+  // For example, businesses like cleaning services or plumbers. Those
+  // businesses do not have a physical address or location on Google Maps.
+  // Places will not return fields including `location`, `plus_code`, and other
+  // location related fields for these businesses.
+  bool include_pure_service_area_businesses = 20
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Response proto for SearchText.
@@ -439,7 +448,7 @@ message SearchTextResponse {
   repeated Place places = 1;
 
   // A list of routing summaries where each entry associates to the
-  // corresponding place in the same index in the places field. If the routing
+  // corresponding place in the same index in the `places` field. If the routing
   // summary is not available for one of the places, it will contain an empty
   // entry. This list will have as many entries as the list of places if
   // requested.
@@ -698,6 +707,16 @@ message AutocompletePlacesRequest {
   //   same token for more than one session will result in each request being
   //   billed individually.
   string session_token = 11 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Include pure service area businesses if the field is set to true.
+  // Pure service area business is a business that visits or delivers to
+  // customers directly but does not serve customers at their business address.
+  // For example, businesses like cleaning services or plumbers. Those
+  // businesses do not have a physical address or location on Google Maps.
+  // Places will not return fields including `location`, `plus_code`, and other
+  // location related fields for these businesses.
+  bool include_pure_service_area_businesses = 12
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Response proto for AutocompletePlaces.
diff --git a/google/maps/places/v1/places_v1.yaml b/google/maps/places/v1/places_v1.yaml
@@ -26,6 +26,10 @@ publishing:
       common:
         destinations:
         - PACKAGE_MANAGER
+    cpp_settings:
+      common: {}
+    php_settings:
+      common: {}
     python_settings:
       common:
         destinations:
@@ -38,6 +42,8 @@ publishing:
       common:
         destinations:
         - PACKAGE_MANAGER
+    ruby_settings:
+      common: {}
     go_settings:
       common:
         destinations:
diff --git a/google/maps/places/v1/polyline.proto b/google/maps/places/v1/polyline.proto
@@ -16,7 +16,6 @@ syntax = "proto3";
 
 package google.maps.places.v1;
 
-option cc_enable_arenas = true;
 option csharp_namespace = "Google.Maps.Places.V1";
 option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
 option java_multiple_files = true;
diff --git a/google/maps/places/v1/price_range.proto b/google/maps/places/v1/price_range.proto
@@ -0,0 +1,39 @@
+// Copyright 2024 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.maps.places.v1;
+
+import "google/type/money.proto";
+
+option csharp_namespace = "Google.Maps.Places.V1";
+option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
+option java_multiple_files = true;
+option java_outer_classname = "PriceRangeProto";
+option java_package = "com.google.maps.places.v1";
+option objc_class_prefix = "GMPSV1";
+option php_namespace = "Google\\Maps\\Places\\V1";
+
+// The price range associated with a Place. `end_price` could be unset, which
+// indicates a range without upper bound (e.g. "More than $100").
+message PriceRange {
+  // The low end of the price range (inclusive). Price should be at or above
+  // this amount.
+  google.type.Money start_price = 1;
+
+  // The high end of the price range (exclusive). Price should be lower than
+  // this amount.
+  google.type.Money end_price = 2;
+}
diff --git a/google/maps/places/v1/reference.proto b/google/maps/places/v1/reference.proto
@@ -19,7 +19,6 @@ package google.maps.places.v1;
 import "google/api/resource.proto";
 import "google/maps/places/v1/review.proto";
 
-option cc_enable_arenas = true;
 option csharp_namespace = "Google.Maps.Places.V1";
 option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
 option java_multiple_files = true;
diff --git a/google/maps/places/v1/review.proto b/google/maps/places/v1/review.proto
@@ -21,7 +21,6 @@ import "google/maps/places/v1/attribution.proto";
 import "google/protobuf/timestamp.proto";
 import "google/type/localized_text.proto";
 
-option cc_enable_arenas = true;
 option csharp_namespace = "Google.Maps.Places.V1";
 option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
 option java_multiple_files = true;
diff --git a/google/maps/places/v1/route_modifiers.proto b/google/maps/places/v1/route_modifiers.proto
@@ -18,7 +18,6 @@ package google.maps.places.v1;
 
 import "google/api/field_behavior.proto";
 
-option cc_enable_arenas = true;
 option csharp_namespace = "Google.Maps.Places.V1";
 option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
 option java_multiple_files = true;
diff --git a/google/maps/places/v1/routing_preference.proto b/google/maps/places/v1/routing_preference.proto
@@ -16,7 +16,6 @@ syntax = "proto3";
 
 package google.maps.places.v1;
 
-option cc_enable_arenas = true;
 option csharp_namespace = "Google.Maps.Places.V1";
 option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
 option java_multiple_files = true;
diff --git a/google/maps/places/v1/routing_summary.proto b/google/maps/places/v1/routing_summary.proto
@@ -18,7 +18,6 @@ package google.maps.places.v1;
 
 import "google/protobuf/duration.proto";
 
-option cc_enable_arenas = true;
 option csharp_namespace = "Google.Maps.Places.V1";
 option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
 option java_multiple_files = true;
@@ -29,7 +28,7 @@ option php_namespace = "Google\\Maps\\Places\\V1";
 
 // The duration and distance from the routing origin to a place in the
 // response, and a second leg from that place to the destination, if requested.
-// Note: Adding `routingSummaries` in the field mask without also including
+// **Note:** Adding `routingSummaries` in the field mask without also including
 // either the `routingParameters.origin` parameter or the
 // `searchAlongRouteParameters.polyline.encodedPolyline` parameter in the
 // request causes an error.
@@ -51,4 +50,12 @@ message RoutingSummary {
   // legs: one from the origin to place, and one from the place to the
   // destination.
   repeated Leg legs = 1;
+
+  // A link to show directions on Google Maps using the waypoints from the given
+  // routing summary. The route generated by this link is not guaranteed to be
+  // the same as the route used to generate the routing summary.
+  // The link uses information provided in the request, from fields including
+  // `routingParameters` and `searchAlongRouteParameters` when applicable, to
+  // generate the directions link.
+  string directions_uri = 2;
 }
diff --git a/google/maps/places/v1/travel_mode.proto b/google/maps/places/v1/travel_mode.proto
@@ -16,7 +16,6 @@ syntax = "proto3";
 
 package google.maps.places.v1;
 
-option cc_enable_arenas = true;
 option csharp_namespace = "Google.Maps.Places.V1";
 option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
 option java_multiple_files = true;
