@googlemaps/routing 2.0.1 → 2.1.1

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"/>
 
-# [Google Maps Routing: Node.js Client](https://github.com/googleapis/google-cloud-node/tree/main/packages/google-maps-routing)
-
-[![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/routing.svg)](https://www.npmjs.org/package/@googlemaps/routing)
-
+# [Routes API: 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/routing.svg)](https://www.npmjs.org/package/@googlemaps/routing)
 
- client for Node.js
+Routes API 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-routing/CHANGELOG.md).
+[the CHANGELOG][homepage_changelog].
 
-* [Google Maps Routing Node.js Client API Reference][client-docs]
+* [Routes API Nodejs Client API Reference](https://cloud.google.com/nodejs/docs/reference/routing/latest)
 
-* [github.com/googleapis/google-cloud-node/packages/google-maps-routing](https://github.com/googleapis/google-cloud-node/tree/main/packages/google-maps-routing)
 
 Read more about the client libraries for Cloud APIs, including the older
 Google APIs Client Libraries, in [Client Libraries Explained][explained].
@@ -27,149 +27,60 @@ 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].
 1.  [Enable billing for your project][billing].
-1.  [Enable the Google Maps Routing API][enable_api].
-1.  [Set up authentication with a service account][auth] so you can access the
+1.  [Enable the Routes API 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/routing
 ```
 
+## Terms of Service
 
-### Using the client library
-
-```javascript
-/**
- * This snippet has been automatically generated and should be regarded as a code template only.
- * It will require modifications to work.
- * It may require correct/in-range values for request initialization.
- * TODO(developer): Uncomment these variables before running the sample.
- */
-/**
- *  Required. Origin waypoint.
- */
-// const origin = {}
-/**
- *  Required. Destination waypoint.
- */
-// const destination = {}
-/**
- *  Optional. A set of waypoints along the route (excluding terminal points),
- *  for either stopping at or passing by. Up to 25 intermediate waypoints are
- *  supported.
- */
-// const intermediates = 1234
-/**
- *  Optional. Specifies the mode of transportation.
- */
-// const travelMode = {}
-/**
- *  Optional. Specifies how to compute the route. The server
- *  attempts to use the selected routing preference to compute the route. If
- *   the routing preference results in an error or an extra long latency, then
- *  an error is returned. In the future, we might implement a fallback
- *  mechanism to use a different option when the preferred option does not give
- *  a valid result. You can specify this option only when the `travel_mode` is
- *  `DRIVE` or `TWO_WHEELER`, otherwise the request fails.
- */
-// const routingPreference = {}
-/**
- *  Optional. Specifies your preference for the quality of the polyline.
- */
-// const polylineQuality = {}
-/**
- *  Optional. Specifies the preferred encoding for the polyline.
- */
-// const polylineEncoding = {}
-/**
- *  Optional. The departure time. If you don't set this value, then this value
- *  defaults to the time that you made the request. If you set this value to a
- *  time that has already occurred, then the request fails.
- */
-// const departureTime = {}
-/**
- *  Optional. Specifies whether to calculate alternate routes in addition to the route.
- */
-// const computeAlternativeRoutes = true
-/**
- *  Optional. A set of conditions to satisfy that affect the way routes are
- *  calculated.
- */
-// const routeModifiers = {}
-/**
- *  Optional. The BCP-47 language code, such as "en-US" or "sr-Latn". For more
- *  information, see
- *  http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. See
- *  Language Support (https://developers.google.com/maps/faq#languagesupport)
- *  for the list of supported languages. When you don't provide this value, the
- *  display language is inferred from the location of the route request.
- */
-// const languageCode = 'abc123'
-/**
- *  Optional. Specifies the units of measure for the display fields. This
- *  includes the `instruction` field in `NavigationInstruction`. The units of
- *  measure used for the route, leg, step distance, and duration are not
- *  affected by this value. If you don't provide this value, then the display
- *  units are inferred from the location of the request.
- */
-// const units = {}
-
-// Imports the Routing library
-const {RoutesClient} = require('@googlemaps/routing').v2;
-
-// Instantiates a client
-const routingClient = new RoutesClient();
-
-async function callComputeRoutes() {
-  // Construct request
-  const request = {
-    origin,
-    destination,
-  };
-
-  // Run request
-  const response = await routingClient.computeRoutes(request);
-  console.log(response);
-}
-
-callComputeRoutes();
-
-```
+`@googlemaps/routing` 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].
 
+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.
 
+### European Economic Area (EEA) developers
 
-## Samples
+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].
 
-Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-node/tree/main/packages/google-maps-routing/samples) directory. Each sample's `README.md` has instructions for running its sample.
+[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
 
-| Sample                      | Source Code                       | Try it |
-| --------------------------- | --------------------------------- | ------ |
-| Routes.compute_route_matrix | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing/samples/generated/v2/routes.compute_route_matrix.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-routing/samples/generated/v2/routes.compute_route_matrix.js,packages/google-maps-routing/samples/README.md) |
-| Routes.compute_routes | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing/samples/generated/v2/routes.compute_routes.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-routing/samples/generated/v2/routes.compute_routes.js,packages/google-maps-routing/samples/README.md) |
-| Quickstart | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing/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-routing/samples/quickstart.js,packages/google-maps-routing/samples/README.md) |
+## Samples
 
+Samples are in the [`samples/`][homepage_samples] directory. Each sample's `README.md` has instructions for running its sample.
 
+| Sample                      | Source Code                       |
+| --------------------------- | --------------------------------- |
+| compute route matrix | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing/samples/generated/v2/routes.compute_route_matrix.js) |
+| compute routes | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing/samples/generated/v2/routes.compute_routes.js) |
+| maps | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing/samples/generated/v2/snippet_metadata_google.maps.routing.v2.json) |
 
-The [Google Maps Routing Node.js Client API Reference][client-docs] documentation
-also contains samples.
 
 ## Supported Node.js Versions
 
@@ -196,41 +107,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-routing/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)
-
-[client-docs]: https://cloud.google.com/nodejs/docs/reference/routing/latest
+See [LICENSE](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing/LICENSE)
 
 [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=routes.googleapis.com
-[auth]: https://cloud.google.com/docs/authentication/getting-started
+[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-routing/samples
+[homepage_changelog]: https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing/CHANGELOG.md
+[homepage]: https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing

package/build/protos/protos.d.ts

@@ -27,7 +27,7 @@ export namespace google {
             type_url?: (string|null);
 
             /** Any value */
-            value?: (Uint8Array|string|null);
+            value?: (Uint8Array|Buffer|string|null);
         }
 
         /** Represents an Any. */
@@ -43,7 +43,7 @@ export namespace google {
             public type_url: string;
 
             /** Any value. */
-            public value: (Uint8Array|string);
+            public value: (Uint8Array|Buffer|string);
 
             /**
              * Creates a new Any instance using the specified properties.
@@ -903,7 +903,7 @@ export namespace google {
         interface IBytesValue {
 
             /** BytesValue value */
-            value?: (Uint8Array|string|null);
+            value?: (Uint8Array|Buffer|string|null);
         }
 
         /** Represents a BytesValue. */
@@ -916,7 +916,7 @@ export namespace google {
             constructor(properties?: google.protobuf.IBytesValue);
 
             /** BytesValue value. */
-            public value: (Uint8Array|string);
+            public value: (Uint8Array|Buffer|string);
 
             /**
              * Creates a new BytesValue instance using the specified properties.
@@ -4110,6 +4110,9 @@ export namespace google {
 
             /** ServiceOptions .google.api.oauthScopes */
             ".google.api.oauthScopes"?: (string|null);
+
+            /** ServiceOptions .google.api.apiVersion */
+            ".google.api.apiVersion"?: (string|null);
         }
 
         /** Represents a ServiceOptions. */
@@ -4358,7 +4361,7 @@ export namespace google {
             doubleValue?: (number|null);
 
             /** UninterpretedOption stringValue */
-            stringValue?: (Uint8Array|string|null);
+            stringValue?: (Uint8Array|Buffer|string|null);
 
             /** UninterpretedOption aggregateValue */
             aggregateValue?: (string|null);
@@ -4389,7 +4392,7 @@ export namespace google {
             public doubleValue: number;
 
             /** UninterpretedOption stringValue. */
-            public stringValue: (Uint8Array|string);
+            public stringValue: (Uint8Array|Buffer|string);
 
             /** UninterpretedOption aggregateValue. */
             public aggregateValue: string;
@@ -6333,9 +6336,6 @@ export namespace google {
                     /** GeocodedWaypoint placeId. */
                     public placeId: string;
 
-                    /** GeocodedWaypoint _intermediateWaypointRequestIndex. */
-                    public _intermediateWaypointRequestIndex?: "intermediateWaypointRequestIndex";
-
                     /**
                      * Creates a new GeocodedWaypoint instance using the specified properties.
                      * @param [properties] Properties to set
@@ -6998,12 +6998,6 @@ export namespace google {
                         /** PolylinePointIndex endIndex. */
                         public endIndex?: (number|null);
 
-                        /** PolylinePointIndex _startIndex. */
-                        public _startIndex?: "startIndex";
-
-                        /** PolylinePointIndex _endIndex. */
-                        public _endIndex?: "endIndex";
-
                         /**
                          * Creates a new PolylinePointIndex instance using the specified properties.
                          * @param [properties] Properties to set
@@ -8308,12 +8302,6 @@ export namespace google {
                             /** MultiModalSegment travelMode. */
                             public travelMode: (google.maps.routing.v2.RouteTravelMode|keyof typeof google.maps.routing.v2.RouteTravelMode);
 
-                            /** MultiModalSegment _stepStartIndex. */
-                            public _stepStartIndex?: "stepStartIndex";
-
-                            /** MultiModalSegment _stepEndIndex. */
-                            public _stepEndIndex?: "stepEndIndex";
-
                             /**
                              * Creates a new MultiModalSegment instance using the specified properties.
                              * @param [properties] Properties to set
@@ -9055,12 +9043,6 @@ export namespace google {
                     /** SpeedReadingInterval speed. */
                     public speed?: (google.maps.routing.v2.SpeedReadingInterval.Speed|keyof typeof google.maps.routing.v2.SpeedReadingInterval.Speed|null);
 
-                    /** SpeedReadingInterval _startPolylinePointIndex. */
-                    public _startPolylinePointIndex?: "startPolylinePointIndex";
-
-                    /** SpeedReadingInterval _endPolylinePointIndex. */
-                    public _endPolylinePointIndex?: "endPolylinePointIndex";
-
                     /** SpeedReadingInterval speedType. */
                     public speedType?: "speed";
 
@@ -10924,12 +10906,6 @@ export namespace google {
                     /** RouteMatrixElement localizedValues. */
                     public localizedValues?: (google.maps.routing.v2.RouteMatrixElement.ILocalizedValues|null);
 
-                    /** RouteMatrixElement _originIndex. */
-                    public _originIndex?: "originIndex";
-
-                    /** RouteMatrixElement _destinationIndex. */
-                    public _destinationIndex?: "destinationIndex";
-
                     /**
                      * Creates a new RouteMatrixElement instance using the specified properties.
                      * @param [properties] Properties to set
@@ -12193,6 +12169,9 @@ export namespace google {
 
             /** Publishing protoReferenceDocumentationUri */
             protoReferenceDocumentationUri?: (string|null);
+
+            /** Publishing restReferenceDocumentationUri */
+            restReferenceDocumentationUri?: (string|null);
         }
 
         /** Represents a Publishing. */
@@ -12234,6 +12213,9 @@ export namespace google {
             /** Publishing protoReferenceDocumentationUri. */
             public protoReferenceDocumentationUri: string;
 
+            /** Publishing restReferenceDocumentationUri. */
+            public restReferenceDocumentationUri: string;
+
             /**
              * Creates a new Publishing instance using the specified properties.
              * @param [properties] Properties to set