@googlemaps/places 2.1.0 → 2.2.0

package/README.md

@@ -1,24 +1,24 @@
 [//]: # "This README.md file is auto-generated, all changes to this file will be lost."
-[//]: # "To regenerate it, use `python -m synthtool`."
+[//]: # "The comments you see below are used to generate those parts of the template in later states."
 <img src="https://avatars2.githubusercontent.com/u/2810941?v=3&s=96" alt="Google Cloud Platform logo" title="Google Cloud Platform" align="right" height="96" width="96"/>
 
-# [Places API (New): Node.js Client](https://github.com/googleapis/google-cloud-node/tree/main/packages/google-maps-places)
-
-[![release level](https://img.shields.io/badge/release%20level-preview-yellow.svg?style=flat)](https://cloud.google.com/terms/launch-stages)
-[![npm version](https://img.shields.io/npm/v/@googlemaps/places.svg)](https://www.npmjs.org/package/@googlemaps/places)
-
+# [Places API (New): Nodejs Client][homepage]
 
+This library is considered to be in **preview**. This means it is still a
+work-in-progress and under active development. Any release is subject to
+backwards-incompatible changes at any time.
 
+[![npm version](https://img.shields.io/npm/v/@googlemaps/places.svg)](https://www.npmjs.org/package/@googlemaps/places)
 
 Places API (New) client for Node.js
 
+[//]: # "partials.introduction"
 
 A comprehensive list of changes in each version may be found in
-[the CHANGELOG](https://github.com/googleapis/google-cloud-node/tree/main/packages/google-maps-places/CHANGELOG.md).
+[the CHANGELOG][homepage_changelog].
 
-* [Places API (New) Node.js Client API Reference][client-docs]
-* [Places API (New) Documentation][product-docs]
-* [github.com/googleapis/google-cloud-node/packages/google-maps-places](https://github.com/googleapis/google-cloud-node/tree/main/packages/google-maps-places)
+* [Places API (New) Nodejs Client API Reference](https://cloud.google.com/nodejs/docs/reference/places/latest)
+* [Places API (New) Documentation](https://developers.google.com/maps/documentation/places/web-service/)
 
 Read more about the client libraries for Cloud APIs, including the older
 Google APIs Client Libraries, in [Client Libraries Explained][explained].
@@ -27,18 +27,15 @@ Google APIs Client Libraries, in [Client Libraries Explained][explained].
 
 **Table of contents:**
 
-
 * [Quickstart](#quickstart)
   * [Before you begin](#before-you-begin)
   * [Installing the client library](#installing-the-client-library)
-  * [Using the client library](#using-the-client-library)
-* [Samples](#samples)
+
 * [Versioning](#versioning)
 * [Contributing](#contributing)
 * [License](#license)
 
 ## Quickstart
-
 ### Before you begin
 
 1.  [Select or create a Cloud Platform project][projects].
@@ -46,64 +43,47 @@ Google APIs Client Libraries, in [Client Libraries Explained][explained].
 1.  [Enable the Places API (New) API][enable_api].
 1.  [Set up authentication][auth] so you can access the
     API from your local workstation.
-
 ### Installing the client library
 
 ```bash
 npm install @googlemaps/places
 ```
 
+## Terms of Service
 
-### Using the client library
-
-```javascript
-
-// Imports the Places library
-const {PlacesClient} = require('@googlemaps/places').v1;
-
-// Instantiates a client
-const placesClient = new PlacesClient();
-
-async function callSearchText() {
-  // Construct request
-  const request = {
-    textQuery,
-  };
+`@googlemaps/places` uses Google Maps Platform services. Use of Google
+Maps Platform services through this library is subject to the
+[Google Maps Platform Terms of Service][gmp-tos].
 
-  // Run request
-  const response = await placesClient.searchText(request, {
-    otherArgs: {
-      headers: {
-        'X-Goog-FieldMask': 'places.displayName',
-      },
-    },
-  });
-  console.log(response);
-}
+This library is not a Google Maps Platform Core Service.
+Therefore, the Google Maps Platform Terms of Service (e.g., Technical
+Support Services, Service Level Agreements, and Deprecation Policy)
+do not apply to this library.
 
-callSearchText();
-
-```
+### European Economic Area (EEA) developers
 
+If your billing address is in the European Economic Area, effective on
+8 July 2025, the [Google Maps Platform EEA Terms of Service][gmp-tos-eea]
+will apply to your use of the Services. Functionality varies by region.
+[Learn more][gmp-tos-eea-faq].
 
+[gmp-tos]: https://cloud.google.com/maps-platform/terms
+[gmp-tos-eea]: https://cloud.google.com/terms/maps-platform/eea
+[gmp-tos-eea-faq]: https://developers.google.com/maps/comms/eea/faq
 
 ## Samples
 
-Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-node/tree/main/packages/google-maps-places/samples) directory. Each sample's `README.md` has instructions for running its sample.
-
-| Sample                      | Source Code                       | Try it |
-| --------------------------- | --------------------------------- | ------ |
-| Places.autocomplete_places | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-places/samples/generated/v1/places.autocomplete_places.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-places/samples/generated/v1/places.autocomplete_places.js,packages/google-maps-places/samples/README.md) |
-| Places.get_photo_media | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-places/samples/generated/v1/places.get_photo_media.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-places/samples/generated/v1/places.get_photo_media.js,packages/google-maps-places/samples/README.md) |
-| Places.get_place | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-places/samples/generated/v1/places.get_place.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-places/samples/generated/v1/places.get_place.js,packages/google-maps-places/samples/README.md) |
-| Places.search_nearby | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-places/samples/generated/v1/places.search_nearby.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-places/samples/generated/v1/places.search_nearby.js,packages/google-maps-places/samples/README.md) |
-| Places.search_text | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-places/samples/generated/v1/places.search_text.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-places/samples/generated/v1/places.search_text.js,packages/google-maps-places/samples/README.md) |
-| Quickstart | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-places/samples/quickstart.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-places/samples/quickstart.js,packages/google-maps-places/samples/README.md) |
-
+Samples are in the [`samples/`][homepage_samples] directory. Each sample's `README.md` has instructions for running its sample.
 
+| Sample                      | Source Code                       |
+| --------------------------- | --------------------------------- |
+| autocomplete places | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-places/samples/generated/v1/places.autocomplete_places.js) |
+| get photo media | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-places/samples/generated/v1/places.get_photo_media.js) |
+| get place | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-places/samples/generated/v1/places.get_place.js) |
+| search nearby | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-places/samples/generated/v1/places.search_nearby.js) |
+| search text | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-places/samples/generated/v1/places.search_text.js) |
+| maps | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-places/samples/generated/v1/snippet_metadata_google.maps.places.v1.json) |
 
-The [Places API (New) Node.js Client API Reference][client-docs] documentation
-also contains samples.
 
 ## Supported Node.js Versions
 
@@ -130,41 +110,29 @@ for versions compatible with Node.js 8.
 
 This library follows [Semantic Versioning](http://semver.org/).
 
-
-
-
-
-
-
-This library is considered to be in **preview**. This means it is still a
-work-in-progress and under active development. Any release is subject to
-backwards-incompatible changes at any time.
-
-
 More Information: [Google Cloud Platform Launch Stages][launch_stages]
 
 [launch_stages]: https://cloud.google.com/terms/launch-stages
 
 ## Contributing
 
-Contributions welcome! See the [Contributing Guide](https://github.com/googleapis/google-cloud-node/blob/main/CONTRIBUTING.md).
+Contributions welcome! See the [Contributing Guide](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-places/CONTRIBUTING.md).
 
-Please note that this `README.md`, the `samples/README.md`,
+Please note that this `README.md`
 and a variety of configuration files in this repository (including `.nycrc` and `tsconfig.json`)
-are generated from a central template. To edit one of these files, make an edit
-to its templates in
-[directory](https://github.com/googleapis/synthtool).
+are generated from a central template.
 
 ## License
 
 Apache Version 2.0
 
-See [LICENSE](https://github.com/googleapis/google-cloud-node/blob/main/LICENSE)
+See [LICENSE](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-places/LICENSE)
 
-[client-docs]: https://cloud.google.com/nodejs/docs/reference/places/latest
-[product-docs]: https://developers.google.com/maps/documentation/places/web-service/
 [shell_img]: https://gstatic.com/cloudssh/images/open-btn.png
 [projects]: https://console.cloud.google.com/project
 [billing]: https://support.google.com/cloud/answer/6293499#enable-billing
 [enable_api]: https://console.cloud.google.com/flows/enableapi?apiid=places.googleapis.com
 [auth]: https://cloud.google.com/docs/authentication/external/set-up-adc-local
+[homepage_samples]: https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-places/samples
+[homepage_changelog]: https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-places/CHANGELOG.md
+[homepage]: https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-places

package/build/protos/google/maps/places/v1/place.proto

@@ -360,6 +360,9 @@ message Place {
     // (and its localized variants). This will be in the language specified in
     // the request if available.
     google.type.LocalizedText disclosure_text = 3;
+
+    // A link to show reviews of this place on Google Maps.
+    string reviews_uri = 4;
   }
 
   // The summary of amenities near the EV charging station. This only applies to
@@ -376,7 +379,7 @@ message Place {
     // A summary of the nearby restaurants.
     ContentBlock restaurant = 3;
 
-    // A summary of the nearby gas stations.
+    // A summary of the nearby stores.
     ContentBlock store = 4;
 
     // A link where users can flag a problem with the summary.
@@ -405,6 +408,43 @@ message Place {
     google.type.LocalizedText disclosure_text = 4;
   }
 
+  // The consumer alert message for the place when we detect suspicious review
+  // activity on a business or a business violates our policies.
+  message ConsumerAlert {
+    // The details of the consumer alert message.
+    message Details {
+      // The link to show together with the description to provide more
+      // information.
+      message Link {
+        // The title to show for the link.
+        string title = 1;
+
+        // The uri of the link.
+        string uri = 2;
+      }
+
+      // The title to show together with the description.
+      string title = 1;
+
+      // The description of the consumer alert message.
+      string description = 2;
+
+      // The link to show together with the description to provide more
+      // information.
+      Link about_link = 3;
+    }
+
+    // The overview of the consumer alert message.
+    string overview = 1;
+
+    // The details of the consumer alert message.
+    Details details = 2;
+
+    // The language code of the consumer alert message. This is a BCP 47
+    // language code.
+    string language_code = 3;
+  }
+
   // This Place's resource name, in `places/{place_id}` format.  Can be used to
   // look up the Place.
   string name = 1;
@@ -693,6 +733,25 @@ message Place {
 
   // A summary of points of interest near the place.
   NeighborhoodSummary neighborhood_summary = 91;
+
+  // The consumer alert message for the place when we detect suspicious review
+  // activity on a business or a business violates our policies.
+  ConsumerAlert consumer_alert = 92;
+
+  // If this Place is permanently closed and has moved to a new Place, this
+  // field contains the new Place's resource name, in `places/{place_id}`
+  // format. If this Place moved multiple times, this field will represent the
+  // first moved place. This field will not be populated if this Place has not
+  // moved.
+  string moved_place = 93 [
+    (google.api.resource_reference) = { type: "places.googleapis.com/Place" }
+  ];
+
+  // If this Place is permanently closed and has moved to a new Place, this
+  // field contains the new Place's place ID. If this Place moved multiple
+  // times, this field will represent the first moved Place. This field will not
+  // be populated if this Place has not moved.
+  string moved_place_id = 94;
 }
 
 // Price level of the place.

package/build/protos/google/maps/places/v1/review.proto

@@ -68,4 +68,8 @@ message Review {
 
   // A link to show the review on Google Maps.
   string google_maps_uri = 16;
+
+  // The date when the author visited the place. This is truncated to the year
+  // and month of the visit.
+  google.type.Date visit_date = 17;
 }