docs: Change comments in some fields in Places API

Google APIs · copybara-github · commit b3d8e7d376b8 · 2025-03-10T11:08:24.000-07:00
feat: Add postal_address and time_zone to Place

PiperOrigin-RevId: 735444062
diff --git a/google/maps/places/v1/BUILD.bazel b/google/maps/places/v1/BUILD.bazel
@@ -80,9 +80,11 @@ proto_library(
         "//google/api:resource_proto",
         "//google/geo/type:viewport_proto",
         "//google/type:date_proto",
+        "//google/type:datetime_proto",
         "//google/type:latlng_proto",
         "//google/type:localized_text_proto",
         "//google/type:money_proto",
+        "//google/type:postal_address_proto",
         "@com_google_protobuf//:duration_proto",
         "@com_google_protobuf//:timestamp_proto",
     ],
@@ -186,9 +188,11 @@ go_proto_library(
         "//google/api:annotations_go_proto",
         "//google/geo/type:viewport_go_proto",
         "//google/type:date_go_proto",
+        "//google/type:datetime_go_proto",
         "//google/type:latlng_go_proto",
         "//google/type:localized_text_go_proto",
         "//google/type:money_go_proto",
+        "//google/type:postaladdress_go_proto",
     ],
 )
 
diff --git a/google/maps/places/v1/place.proto b/google/maps/places/v1/place.proto
@@ -27,8 +27,10 @@ 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/datetime.proto";
 import "google/type/latlng.proto";
 import "google/type/localized_text.proto";
+import "google/type/postal_address.proto";
 
 option csharp_namespace = "Google.Maps.Places.V1";
 option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
@@ -91,10 +93,10 @@ message Place {
         // Monday, etc.
         optional int32 day = 1;
 
-        // The hour in 2 digits. Ranges from 00 to 23.
+        // The hour in 24 hour format. Ranges from 0 to 23.
         optional int32 hour = 2;
 
-        // The minute in 2 digits. Ranges from 00 to 59.
+        // The minute. Ranges from 0 to 59.
         optional int32 minute = 3;
 
         // Date in the local timezone for the place.
@@ -378,6 +380,9 @@ message Place {
   // A short, human-readable address for this place.
   string short_formatted_address = 51;
 
+  // The address in postal address format.
+  google.type.PostalAddress postal_address = 90;
+
   // Repeated components for each locality level.
   // Note the following facts about the address_components[] array:
   // - The array of address components may contain more components than the
@@ -421,21 +426,30 @@ message Place {
   // reviews can be returned.
   repeated Review reviews = 53;
 
-  // The regular hours of operation.
+  // The regular hours of operation. Note that if a place is always open (24
+  // hours), the `close` field will not be set. Clients can rely on always open
+  // (24 hours) being represented as an
+  // [open][google.maps.places.v1.Place.OpeningHours.Period.open] period
+  // containing [day][Point.day] with value `0`, [hour][Point.hour] with
+  // value `0`, and [minute][Point.minute] with value `0`.
   OpeningHours regular_opening_hours = 21;
 
   // Number of minutes this place's timezone is currently offset from UTC.
   // This is expressed in minutes to support timezones that are offset by
   // fractions of an hour, e.g. X hours and 15 minutes.
   optional int32 utc_offset_minutes = 22;
 
+  // IANA Time Zone Database time zone. For example "America/New_York".
+  google.type.TimeZone time_zone = 88;
+
   // Information (including references) about photos of this place. A maximum of
   // 10 photos can be returned.
   repeated Photo photos = 54;
 
   // 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.
