docs: [places] Fix designation of Text Search (#5220)

* docs: Fix designation of Text Search
docs: Update field mask guidance

PiperOrigin-RevId: 622956031

Source-Link: googleapis/googleapis@5db2bbe

Source-Link: googleapis/googleapis-gen@d6536e4
Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLW1hcHMtcGxhY2VzLy5Pd2xCb3QueWFtbCIsImgiOiJkNjUzNmU0MDEyM2JhZmNiNjRiOGM3ZTkyYjI4ZDk2YWU3YzA3OWEzIn0=

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

packages/google-maps-places/protos/google/maps/places/v1/place.proto

@@ -295,8 +295,8 @@ message Place {
   google.type.LocalizedText display_name = 31;
 
   // A set of type tags for this result. For example, "political" and
-  // "locality".  For the complete list of possible values, see Table A and
-  // Table B at
+  // "locality". For the complete list of possible values, see Table A and Table
+  // B at
   // https://developers.google.com/maps/documentation/places/web-service/place-types
   repeated string types = 5;
 
@@ -308,8 +308,8 @@ message Place {
   string primary_type = 50;
 
   // The display name of the primary type, localized to the request language if
-  // applicable.  For the complete list of possible values, see Table A and
-  // Table B at
+  // applicable. For the complete list of possible values, see Table A and Table
+  // B at
   // https://developers.google.com/maps/documentation/places/web-service/place-types
   google.type.LocalizedText primary_type_display_name = 32;
 

packages/google-maps-places/protos/google/maps/places/v1/places_service.proto

@@ -36,11 +36,10 @@ option objc_class_prefix = "GMPSV1";
 option php_namespace = "Google\\Maps\\Places\\V1";
 
 // Service definition for the Places API.
-// Note: every request actually requires a field mask set outside of
-// the request proto (all/'*', is not assumed).  That can be set via either a
-// side channel (SystemParameterContext) over RPC, or a header
-// (X-Goog-FieldMask) over HTTP. See:
-// https://cloud.google.com/apis/docs/system-parameters
+// Note: every request (except for Autocomplete requests) requires a field mask
+// set outside of the request proto (`all/*`, is not assumed). The field mask
+// can be set via the HTTP header `X-Goog-FieldMask`. See:
+// https://developers.google.com/maps/documentation/places/web-service/choose-fields
 service Places {
   option (google.api.default_host) = "places.googleapis.com";
 
@@ -718,7 +717,7 @@ message AutocompletePlacesResponse {
     message QueryPrediction {
       // The predicted text. This text does not represent a Place, but rather a
       // text query that could be used in a search endpoint (for example,
-      // TextSearch).
+      // Text Search).
       //
       // `text` is recommended for developers who wish to show a single UI
       // element. Developers who wish to show two separate, but related, UI

packages/google-maps-places/src/v1/places_client.ts

@@ -38,11 +38,10 @@ const version = require('../../../package.json').version;
 
 /**
  *  Service definition for the Places API.
- *  Note: every request actually requires a field mask set outside of
- *  the request proto (all/'*', is not assumed).  That can be set via either a
- *  side channel (SystemParameterContext) over RPC, or a header
- *  (X-Goog-FieldMask) over HTTP. See:
- *  https://cloud.google.com/apis/docs/system-parameters
+ *  Note: every request (except for Autocomplete requests) requires a field mask
+ *  set outside of the request proto (`all/*`, is not assumed). The field mask
+ *  can be set via the HTTP header `X-Goog-FieldMask`. See:
+ *  https://developers.google.com/maps/documentation/places/web-service/choose-fields
  * @class
  * @memberof v1
  */