@googlemaps/routing 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.4.0](https://github.com/googleapis/google-cloud-node/compare/routing-v0.3.1...routing-v0.4.0) (2023-03-13)
+
+
+### Features
+
+* [routing] added support for specifying waypoints as addresses ([#4065](https://github.com/googleapis/google-cloud-node/issues/4065)) ([e325ac5](https://github.com/googleapis/google-cloud-node/commit/e325ac51cf2550cc9d9dba6a8145d4affe766930))
+
+## [0.3.1](https://github.com/googleapis/google-cloud-node/compare/routing-v0.3.0...routing-v0.3.1) (2023-02-15)
+
+
+### Bug Fixes
+
+* [Many APIs] changing format of the jsdoc links ([#3991](https://github.com/googleapis/google-cloud-node/issues/3991)) ([c6326d9](https://github.com/googleapis/google-cloud-node/commit/c6326d90abb9b649b25052e4afe7b3eb0f65bcb4))
+
 ## [0.3.0](https://github.com/googleapis/google-cloud-node/compare/routing-v0.2.1...routing-v0.3.0) (2023-01-28)
 
 

package/README.md

@@ -4,7 +4,7 @@
 
 # [Google Maps Routing: Node.js Client](https://github.com/googleapis/google-cloud-node)
 
-[![release level](https://img.shields.io/badge/release%20level-beta-yellow.svg?style=flat)](https://cloud.google.com/terms/launch-stages)
+[![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)
 
 
@@ -200,13 +200,12 @@ This library follows [Semantic Versioning](http://semver.org/).
 
 
 
-This library is considered to be in **beta**. This means it is expected to be
-mostly stable while we work toward a general availability release; however,
-complete stability is not guaranteed. We will address issues and requests
-against beta libraries with a high priority.
 
 
 
+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]

package/build/protos/google/maps/routing/v2/geocoding_results.proto

@@ -0,0 +1,71 @@
+// Copyright 2023 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.maps.routing.v2;
+
+import "google/rpc/status.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Maps.Routing.V2";
+option go_package = "google.golang.org/genproto/googleapis/maps/routing/v2;routing";
+option java_multiple_files = true;
+option java_outer_classname = "GeocodingResultsProto";
+option java_package = "com.google.maps.routing.v2";
+option objc_class_prefix = "GMRV2";
+option php_namespace = "Google\\Maps\\Routing\\V2";
+option ruby_package = "Google::Maps::Routing::V2";
+
+// Contains GeocodedWaypoints for origin, destination and intermediate
+// waypoints. Only populated for address waypoints.
+message GeocodingResults {
+  // Origin geocoded waypoint.
+  GeocodedWaypoint origin = 1;
+
+  // Destination geocoded waypoint.
+  GeocodedWaypoint destination = 2;
+
+  // A list of intermediate geocoded waypoints each containing an index field
+  // that corresponds to the zero-based position of the waypoint in the order
+  // they were specified in the request.
+  repeated GeocodedWaypoint intermediates = 3;
+}
+
+// Details about the locations used as waypoints. Only populated for address
+// waypoints. Includes details about the geocoding results for the purposes of
+// determining what the address was geocoded to.
+message GeocodedWaypoint {
+  // Indicates the status code resulting from the geocoding operation.
+  google.rpc.Status geocoder_status = 1;
+
+  // The index of the corresponding intermediate waypoint in the request.
+  // Only populated if the corresponding waypoint is an intermediate
+  // waypoint.
+  optional int32 intermediate_waypoint_request_index = 2;
+
+  // The type(s) of the result, in the form of zero or more type tags.
+  // Supported types:
+  // https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types
+  repeated string type = 3;
+
+  // Indicates that the geocoder did not return an exact match for the original
+  // request, though it was able to match part of the requested address. You may
+  // wish to examine the original request for misspellings and/or an incomplete
+  // address.
+  bool partial_match = 4;
+
+  // The place ID for this result.
+  string place_id = 5;
+}

package/build/protos/google/maps/routing/v2/route.proto

@@ -145,16 +145,7 @@ message RouteLegTravelAdvisory {
 // Encapsulates the additional information that the user should be informed
 // about, such as possible traffic zone restriction on a leg step.
 message RouteLegStepTravelAdvisory {
-  // Speed reading intervals detailing traffic density. Applicable in case of
-  // `TRAFFIC_AWARE` and `TRAFFIC_AWARE_OPTIMAL` routing preferences.
-  // The intervals cover the entire polyline of the RouteLegStep without
-  // overlap. The start point of a specified interval is the same as the end
-  // point of the preceding interval.
-  //
-  // Example:
-  //
-  //     polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
-  //     speed_reading_intervals: [A,C), [C,D), [D,G).
+  // NOTE: This field is not currently populated.
   repeated SpeedReadingInterval speed_reading_intervals = 1;
 }
 

package/build/protos/google/maps/routing/v2/routes_service.proto

@@ -20,6 +20,7 @@ import "google/api/annotations.proto";
 import "google/api/client.proto";
 import "google/api/field_behavior.proto";
 import "google/maps/routing/v2/fallback_info.proto";
+import "google/maps/routing/v2/geocoding_results.proto";
 import "google/maps/routing/v2/polyline.proto";
 import "google/maps/routing/v2/route.proto";
 import "google/maps/routing/v2/route_modifiers.proto";
@@ -194,7 +195,8 @@ message ComputeRoutesRequest {
       [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Specifies whether to calculate alternate routes in addition to
-  // the route.
+  // the route. No alternative routes are returned for requests that have
+  // intermediate waypoints.
   bool compute_alternative_routes = 8 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. A set of conditions to satisfy that affect the way routes are
@@ -246,6 +248,9 @@ message ComputeRoutesResponse {
   // computation. When fallback mode is used, this field contains detailed info
   // about the fallback response. Otherwise this field is unset.
   FallbackInfo fallback_info = 2;
+
+  // Contains geocoding response info for waypoints specified as addresses.
+  GeocodingResults geocoding_results = 3;
 }
 
 // ComputeRouteMatrix request message
@@ -258,7 +263,7 @@ message ComputeRouteMatrixRequest {
     // Toll information for the matrix element(s).
     TOLLS = 1;
   }
-  
+
   // Required. Array of origins, which determines the rows of the response
   // matrix. Several size restrictions apply to the cardinality of origins and
   // destinations:

package/build/protos/google/maps/routing/v2/waypoint.proto

@@ -39,6 +39,10 @@ message Waypoint {
 
     // The POI Place ID associated with the waypoint.
     string place_id = 2;
+
+    // Human readable address or a plus code.
+    // See https://plus.codes for details.
+    string address = 7;
   }
 
   // Marks this waypoint as a milestone rather a stopping point. For