// Copyright 2024 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

//

// https://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.

// Code generated by protoc-gen-go_gapic. DO NOT EDIT.

package routing

import (

"bytes"

"context"

"errors"

"fmt"

"io"

"math"

"net/http"

"net/url"

routingpb "cloud.google.com/go/maps/routing/apiv2/routingpb"

gax "github.com/googleapis/gax-go/v2"

"google.golang.org/api/googleapi"

"google.golang.org/api/option"

"google.golang.org/api/option/internaloption"

gtransport "google.golang.org/api/transport/grpc"

httptransport "google.golang.org/api/transport/http"

"google.golang.org/grpc"

"google.golang.org/grpc/metadata"

"google.golang.org/protobuf/encoding/protojson"

)

var newRoutesClientHook clientHook

// RoutesCallOptions contains the retry settings for each method of RoutesClient.

type RoutesCallOptions struct {

ComputeRoutes []gax.CallOption

ComputeRouteMatrix []gax.CallOption

}

func defaultRoutesGRPCClientOptions() []option.ClientOption {

}

func defaultRoutesCallOptions() *RoutesCallOptions {

}

func defaultRoutesRESTCallOptions() *RoutesCallOptions {

}

// internalRoutesClient is an interface that defines the methods available from Routes API.

type internalRoutesClient interface {

}

// RoutesClient is a client for interacting with Routes API.

// Methods, except Close, may be called concurrently. However, fields must not be modified concurrently with method calls.

//

// The Routes API.

type RoutesClient struct {

}

// Wrapper methods routed to the internal client.

// Close closes the connection to the API service. The user should invoke this when

// the client is no longer required.

func (c *RoutesClient) Close() error {

return c.internalClient.Close()

}

// setGoogleClientInfo sets the name and version of the application in

// the `x-goog-api-client` header passed on each request. Intended for

// use by Google-written clients.

func (c *RoutesClient) setGoogleClientInfo(keyval ...string) {

c.internalClient.setGoogleClientInfo(keyval...)

}

// Connection returns a connection to the API service.

//

// Deprecated: Connections are now pooled so this method does not always

// return the same resource.

func (c *RoutesClient) Connection() *grpc.ClientConn {

return c.internalClient.Connection()

}

// ComputeRoutes returns the primary route along with optional alternate routes, given a set

// of terminal and intermediate waypoints.

//

// NOTE: This method requires that you specify a response field mask in

// the input. You can provide the response field mask by using URL parameter

// $fields or fields, or by using an HTTP/gRPC header X-Goog-FieldMask

// (see the available URL parameters and

// headers (at https://cloud.google.com/apis/docs/system-parameters)). The value

// is a comma separated list of field paths. See detailed documentation about

// how to construct the field

// paths (at https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/field_mask.proto).

//

// For example, in this method:

//

// Field mask of all available fields (for manual inspection):

// X-Goog-FieldMask: *

//

// Field mask of Route-level duration, distance, and polyline (an example

// production setup):

// X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

//

// Google discourage the use of the wildcard (*) response field mask, or

// specifying the field mask at the top level (routes), because:

//

// Selecting only the fields that you need helps our server save computation

// cycles, allowing us to return the result to you with a lower latency.

//

// Selecting only the fields that you need

// in your production job ensures stable latency performance. We might add

// more response fields in the future, and those new fields might require

// extra computation time. If you select all fields, or if you select all

// fields at the top level, then you might experience performance degradation

// because any new field we add will be automatically included in the

// response.

//

// Selecting only the fields that you need results in a smaller response

// size, and thus higher network throughput.

func (c *RoutesClient) ComputeRoutes(ctx context.Context, req *routingpb.ComputeRoutesRequest, opts ...gax.CallOption) (*routingpb.ComputeRoutesResponse, error) {

return c.internalClient.ComputeRoutes(ctx, req, opts...)

}

// ComputeRouteMatrix takes in a list of origins and destinations and returns a stream containing

// route information for each combination of origin and destination.

//

// NOTE: This method requires that you specify a response field mask in

// the input. You can provide the response field mask by using the URL

// parameter $fields or fields, or by using the HTTP/gRPC header

// X-Goog-FieldMask (see the available URL parameters and

// headers (at https://cloud.google.com/apis/docs/system-parameters)).

// The value is a comma separated list of field paths. See this detailed

// documentation about how to construct the field

// paths (at https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/field_mask.proto).

//

// For example, in this method:

//

// Field mask of all available fields (for manual inspection):

// X-Goog-FieldMask: *

//

// Field mask of route durations, distances, element status, condition, and

// element indices (an example production setup):

// X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

//

// It is critical that you include status in your field mask as otherwise

// all messages will appear to be OK. Google discourages the use of the

// wildcard (*) response field mask, because:

//

// Selecting only the fields that you need helps our server save computation

// cycles, allowing us to return the result to you with a lower latency.

//

// Selecting only the fields that you need in your production job ensures

// stable latency performance. We might add more response fields in the

// future, and those new fields might require extra computation time. If you

// select all fields, or if you select all fields at the top level, then you

// might experience performance degradation because any new field we add will

// be automatically included in the response.

//

// Selecting only the fields that you need results in a smaller response

// size, and thus higher network throughput.

func (c *RoutesClient) ComputeRouteMatrix(ctx context.Context, req *routingpb.ComputeRouteMatrixRequest, opts ...gax.CallOption) (routingpb.Routes_ComputeRouteMatrixClient, error) {

return c.internalClient.ComputeRouteMatrix(ctx, req, opts...)

}

// routesGRPCClient is a client for interacting with Routes API over gRPC transport.

//

// Methods, except Close, may be called concurrently. However, fields must not be modified concurrently with method calls.

type routesGRPCClient struct {

}

// NewRoutesClient creates a new routes client based on gRPC.

// The returned client must be Closed when it is done being used to clean up its underlying connections.

//

// The Routes API.

func NewRoutesClient(ctx context.Context, opts ...option.ClientOption) (*RoutesClient, error) {

}

// Connection returns a connection to the API service.

//

// Deprecated: Connections are now pooled so this method does not always

// return the same resource.

func (c *routesGRPCClient) Connection() *grpc.ClientConn {

return c.connPool.Conn()

}

// setGoogleClientInfo sets the name and version of the application in

// the `x-goog-api-client` header passed on each request. Intended for

// use by Google-written clients.

func (c *routesGRPCClient) setGoogleClientInfo(keyval ...string) {

}

// Close closes the connection to the API service. The user should invoke this when

// the client is no longer required.

func (c *routesGRPCClient) Close() error {

return c.connPool.Close()

}

// Methods, except Close, may be called concurrently. However, fields must not be modified concurrently with method calls.

type routesRESTClient struct {

}

// NewRoutesRESTClient creates a new routes rest client.

//

// The Routes API.

func NewRoutesRESTClient(ctx context.Context, opts ...option.ClientOption) (*RoutesClient, error) {

}

func defaultRoutesRESTClientOptions() []option.ClientOption {

}

// setGoogleClientInfo sets the name and version of the application in

// the `x-goog-api-client` header passed on each request. Intended for

// use by Google-written clients.

func (c *routesRESTClient) setGoogleClientInfo(keyval ...string) {

}

// Close closes the connection to the API service. The user should invoke this when

// the client is no longer required.

func (c *routesRESTClient) Close() error {

}

// Connection returns a connection to the API service.

//

// Deprecated: This method always returns nil.

func (c *routesRESTClient) Connection() *grpc.ClientConn {

return nil

}

func (c *routesGRPCClient) ComputeRoutes(ctx context.Context, req *routingpb.ComputeRoutesRequest, opts ...gax.CallOption) (*routingpb.ComputeRoutesResponse, error) {

}

func (c *routesGRPCClient) ComputeRouteMatrix(ctx context.Context, req *routingpb.ComputeRouteMatrixRequest, opts ...gax.CallOption) (routingpb.Routes_ComputeRouteMatrixClient, error) {

}

// ComputeRoutes returns the primary route along with optional alternate routes, given a set

// of terminal and intermediate waypoints.

//

// NOTE: This method requires that you specify a response field mask in

// the input. You can provide the response field mask by using URL parameter

// $fields or fields, or by using an HTTP/gRPC header X-Goog-FieldMask

// (see the available URL parameters and

// headers (at https://cloud.google.com/apis/docs/system-parameters)). The value

// is a comma separated list of field paths. See detailed documentation about

// how to construct the field

// paths (at https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/field_mask.proto).

//

// For example, in this method:

//

// Field mask of all available fields (for manual inspection):

// X-Goog-FieldMask: *

//

// Field mask of Route-level duration, distance, and polyline (an example

// production setup):

// X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

//

// Google discourage the use of the wildcard (*) response field mask, or

// specifying the field mask at the top level (routes), because:

//

// Selecting only the fields that you need helps our server save computation

// cycles, allowing us to return the result to you with a lower latency.

//

// Selecting only the fields that you need

// in your production job ensures stable latency performance. We might add

// more response fields in the future, and those new fields might require

// extra computation time. If you select all fields, or if you select all

// fields at the top level, then you might experience performance degradation

// because any new field we add will be automatically included in the

// response.

//

// Selecting only the fields that you need results in a smaller response

// size, and thus higher network throughput.

func (c *routesRESTClient) ComputeRoutes(ctx context.Context, req *routingpb.ComputeRoutesRequest, opts ...gax.CallOption) (*routingpb.ComputeRoutesResponse, error) {

}

// ComputeRouteMatrix takes in a list of origins and destinations and returns a stream containing

// route information for each combination of origin and destination.

//

// NOTE: This method requires that you specify a response field mask in

// the input. You can provide the response field mask by using the URL

// parameter $fields or fields, or by using the HTTP/gRPC header

// X-Goog-FieldMask (see the available URL parameters and

// headers (at https://cloud.google.com/apis/docs/system-parameters)).

// The value is a comma separated list of field paths. See this detailed

// documentation about how to construct the field

// paths (at https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/field_mask.proto).

//

// For example, in this method:

//

// Field mask of all available fields (for manual inspection):

// X-Goog-FieldMask: *

//

// Field mask of route durations, distances, element status, condition, and

// element indices (an example production setup):

// X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

//

// It is critical that you include status in your field mask as otherwise

// all messages will appear to be OK. Google discourages the use of the

// wildcard (*) response field mask, because:

//

// Selecting only the fields that you need helps our server save computation

// cycles, allowing us to return the result to you with a lower latency.

//

// Selecting only the fields that you need in your production job ensures

// stable latency performance. We might add more response fields in the

// future, and those new fields might require extra computation time. If you

// select all fields, or if you select all fields at the top level, then you

// might experience performance degradation because any new field we add will

// be automatically included in the response.

//

// Selecting only the fields that you need results in a smaller response

// size, and thus higher network throughput.

func (c *routesRESTClient) ComputeRouteMatrix(ctx context.Context, req *routingpb.ComputeRouteMatrixRequest, opts ...gax.CallOption) (routingpb.Routes_ComputeRouteMatrixClient, error) {

}

// computeRouteMatrixRESTClient is the stream client used to consume the server stream created by

// the REST implementation of ComputeRouteMatrix.

type computeRouteMatrixRESTClient struct {

}

func (c *computeRouteMatrixRESTClient) Recv() (*routingpb.RouteMatrixElement, error) {

}

func (c *computeRouteMatrixRESTClient) Header() (metadata.MD, error) {

return c.md, nil

}

func (c *computeRouteMatrixRESTClient) Trailer() metadata.MD {

return c.md

}

func (c *computeRouteMatrixRESTClient) CloseSend() error {

// This is a no-op to fulfill the interface.

return errors.New("this method is not implemented for a server-stream")

}

func (c *computeRouteMatrixRESTClient) Context() context.Context {

return c.ctx

}

func (c *computeRouteMatrixRESTClient) SendMsg(m interface{}) error {

// This is a no-op to fulfill the interface.

return errors.New("this method is not implemented for a server-stream")

}

func (c *computeRouteMatrixRESTClient) RecvMsg(m interface{}) error {

// This is a no-op to fulfill the interface.

return errors.New("this method is not implemented, use Recv")

}