feat: make the Place ID format consistent

Google APIs · copybara-github · commit 77c78e90aeeb · 2026-03-26T16:20:32.000-07:00
docs: update the navigation point usage enum documentation

PiperOrigin-RevId: 890102125
diff --git a/google/maps/geocode/v4/destination_service.proto b/google/maps/geocode/v4/destination_service.proto
@@ -238,9 +238,13 @@ message PlaceView {
     GROUNDS = 4;
   }
 
-  // This place's resource name, in `places/{placeId}` format.
+  // This Place's resource name, in `places/{placeId}` format.  Can be used to
+  // look up the Place.
   string place = 1;
 
+  // The unique identifier of a place.
+  string place_id = 2;
+
   // Human readable place description. For example, "Gate B", "McDonalds"
   google.type.LocalizedText display_name = 3;
 
@@ -342,9 +346,7 @@ message NavigationPoint {
     // Not used.
     USAGE_UNSPECIFIED = 0;
 
-    // Unknown usage type. Most navigation points will be `UNKNOWN` and it does
-    // not necessarily mean their usage is restricted in any way. This
-    // navigation might still be suitable for pickup and/or dropoff.
+    // Indicates that the usage type is unknown.
     UNKNOWN = 1;
 
     // Suitable for dropping off a passenger. For example, a rideshare drop off
@@ -374,7 +376,9 @@ message NavigationPoint {
   // Travel modes that are appropriate for this navigation point.
   repeated TravelMode travel_modes = 4;
 
-  // Usages supported by this navigation point.
+  // Lists `usages` supported by this navigation point. If empty, it does not
+  // necessarily mean its usage is restricted in any way. All navigation
+  // points can be used for general navigation.
   repeated Usage usages = 5;
 }
 
diff --git a/google/maps/geocode/v4/geocode_service.proto b/google/maps/geocode/v4/geocode_service.proto
@@ -217,13 +217,11 @@ message GeocodeResult {
     APPROXIMATE = 4;
   }
 
-  // The fully qualified place identifier for this result.
-  // In the format of "//places.googleapis.com/places/{placeID}". See
-  // https://developers.google.com/maps/documentation/places/web-service/place-id.
-  // for more details.
+  // This Place's resource name, in `places/{placeId}` format.  Can be used to
+  // look up the Place.
   string place = 1;
 
-  // The place ID for this result.
+  // The unique identifier of a place.
   string place_id = 2;
 
   // The latlng of this address.
