Para recuperar un conjunto de rutas de la API de Routes Preferred, envía una solicitud HTTP POST al siguiente recurso:
https://routespreferred.googleapis.com/v1:computeRoutes
Incluye las opciones de tu solicitud, con formato JSON, en el cuerpo del mensaje. Para obtener información sobre el conjunto completo de opciones, consulta el Cuerpo de la solicitud de computeRoutes.
Ejemplo de cuerpo de la solicitud
En el siguiente código JSON, se muestra cómo construir un cuerpo de solicitud típico para una solicitud computeRoutes.
POST /v1:computeRoutes
Host: routespreferred.googleapis.com
Content-Type: application/json
X-Goog-Api-Key: YOUR_API_KEY
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
{
"origin":{
"location":{
"latLng":{
"latitude": 37.419734,
"longitude": -122.0827784
}
}
},
"destination":{
"location":{
"latLng":{
"latitude": 37.417670,
"longitude": -122.079595
}
}
},
"travelMode": "DRIVE",
"routingPreference": "TRAFFIC_AWARE",
"polylineQuality": "OVERVIEW",
"departureTime": "2019-10-15T15:01:23.045123456Z",
"computeAlternativeRoutes": false,
"routeModifiers": {
"avoidTolls": false,
"avoidHighways": false,
"avoidFerries": false
},
"languageCode": "en-US",
"units": "IMPERIAL"
}
Ejemplo de cuerpo de la respuesta
El siguiente código JSON es un ejemplo del cuerpo de la respuesta que se muestra desde la llamada anterior a computeRoutes.
{
"routes": [
{
"distanceMeters": 772,
"duration": "165s",
"polyline": {
"encodedPolyline": "ipkcFfichVnP@j@BLoFVwM{E?"
}
}
]
}
Ejemplo de solicitud de gRPC
A continuación, se muestra un ejemplo de solicitud gRPC.
Go
package main
import (
"context"
"fmt"
"log"
"time"
routespreferred "developers.google.com/maps/go/routespreferred/v1"
"google.golang.org/api/option"
routespb "google.golang.org/genproto/googleapis/maps/routes/v1"
"google.golang.org/genproto/googleapis/type/latlng"
"google.golang.org/grpc/metadata"
)
const (
// https://cloud.google.com/iam/docs/creating-managing-service-account-keys#creating_service_account_keys
credentialsFile = "service-account.json"
// Note that setting the field mask to * is OK for testing, but discouraged in
// production.
// For example, for ComputeRoutes, set the field mask to
// "routes.distanceMeters,routes.duration,routes.polyline.encodedPolyline"
// in order to get the route distances, durations, and encoded polylines.
fieldMask = "*"
)
func main() {
ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
defer cancel()
// instantiate a client
c, err := routespreferred.NewRoutesPreferredClient(ctx,
option.WithCredentialsFile(credentialsFile))
defer c.Close()
if err != nil {
log.Fatal(err)
}
// create the origin using a latitude and longitude
origin := &routespb.Waypoint{
LocationType: &routespb.Waypoint_Location{
Location: &routespb.Location{
LatLng: &latlng.LatLng{
Latitude: 37.417670,
Longitude: -122.0827784,
},
},
},
}
// create the destination using a latitude and longitude
destination := &routespb.Waypoint{
LocationType: &routespb.Waypoint_Location{
Location: &routespb.Location{
LatLng: &latlng.LatLng{
Latitude: 37.417670,
Longitude: -122.079595,
},
},
},
}
// create the request with additional options
req := &routespb.ComputeRoutesRequest{
Origin: origin,
Destination: destination,
TravelMode: routespb.RouteTravelMode_DRIVE,
RoutingPreference: routespb.RoutingPreference_TRAFFIC_AWARE,
ComputeAlternativeRoutes: true,
Units: routespb.Units_METRIC,
LanguageCode: "en-us",
RouteModifiers: &routespb.RouteModifiers{
AvoidTolls: false,
AvoidHighways: true,
AvoidFerries: true,
},
PolylineQuality: routespb.PolylineQuality_OVERVIEW,
}
// set the field mask
ctx = metadata.AppendToOutgoingContext(ctx, "X-Goog-Fieldmask", fieldMask)
// execute rpc
resp, err := c.ComputeRoutes(ctx, req)
if err != nil {
// "rpc error: code = InvalidArgument desc = Request contains an invalid
// argument" may indicate that your project lacks access to Routes Preferred
log.Fatal(err)
}
fmt.Printf("Duration of route %d", resp.Routes[0].Duration.Seconds)
}
Ejemplo de cálculo de peajes
En el siguiente ejemplo, se usa el método
computeRoutes para mostrar información sobre peajes con un precio estimado cuando se usa un pase de peaje.
Esta función se habilita con la máscara de campo routes.travelAdvisory.tollInfo especificada en la solicitud. El pase de peaje se especifica en el campo route_modifiers. El precio del peaje que se muestra se basa en los precios que usa el pase especificado. Si se especifica más de un pase, se muestra el precio menos costoso.
Solicitud:
curl -X POST -d '{
"origin":{
"location":{
"lat_lng":{
"latitude":47.7020056,
"longitude":-122.3479236
}
}
},
"destination":{
"location":{
"lat_lng":{
"latitude":47.6192234,
"longitude": -122.1676792
}
}
},
"travel_mode":"DRIVE",
"route_modifiers":{
"vehicle_info":{
"emission_type": "GASOLINE"
},
"toll_passes": [
"US_MA_EZPASSMA",
"US_WA_GOOD_TO_GO"
]
}
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: <YOUR_API_KEY>' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.travelAdvisory.tollInfo,routes.legs.travelAdvisory.tollInfo' \
'https://routespreferred.googleapis.com/v1alpha:computeRoutes'
Respuesta:
{
"routes": [
{
"legs": [
{
"travelAdvisory": {
"tollInfo": {
"estimatedPrice": [
{
"currencyCode": "USD",
"units": "3",
"nanos": 400000000
}
]
}
}
}
],
"distanceMeters": 22496,
"duration": "1400s",
"travelAdvisory": {
"tollInfo": {
"estimatedPrice": [
{
"currencyCode": "USD",
"units": "3",
"nanos": 400000000
}
]
}
}
}
]
}