다음 리소스에 HTTP POST 요청을 전송하여 Routes Preferred API에서 경로 집합을 검색할 수 있습니다.
https://routespreferred.googleapis.com/v1:computeRoutes
메시지 본문에 JSON 형식으로 요청 옵션을 포함합니다. 전체 옵션 세트에 대한 자세한 내용은 computeRoutes 요청 본문을 참조하세요.
요청 본문 예시
다음 JSON 코드는 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"
}
응답 본문 예시
다음 JSON 코드는 위 computeRoutes 호출에서 반환된 응답 본문의 예입니다.
{
"routes": [
{
"distanceMeters": 772,
"duration": "165s",
"polyline": {
"encodedPolyline": "ipkcFfichVnP@j@BLoFVwM{E?"
}
}
]
}
gRPC 요청 예시
다음은 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)
}
통행료 계산 예시
다음 예시에서는 톨 패스가 사용될 때
computeRoutes 메서드를 사용하여 예상 요금과 함께 통행료 정보를 반환합니다.
이 기능은 요청에 지정된 routes.travelAdvisory.tollInfo 필드 마스크를 사용하여 사용 설정됩니다. 톨 패스는 route_modifiers 필드에 지정됩니다. 반환되는 통행료는 지정된 패스에 사용되는 가격을 기준으로 합니다. 패스를 두 개 이상 지정하면 가장 저렴한 가격이 반환됩니다.
요청:
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'
대답:
{
"routes": [
{
"legs": [
{
"travelAdvisory": {
"tollInfo": {
"estimatedPrice": [
{
"currencyCode": "USD",
"units": "3",
"nanos": 400000000
}
]
}
}
}
],
"distanceMeters": 22496,
"duration": "1400s",
"travelAdvisory": {
"tollInfo": {
"estimatedPrice": [
{
"currencyCode": "USD",
"units": "3",
"nanos": 400000000
}
]
}
}
}
]
}