Stay organized with collections Save and categorize content based on your preferences.
This page shows how to get started with the client libraries for Routes API.
Read more about the client libraries in Client Libraries Explained.
Installing the client library Setting up authenticationWhen you use client libraries, you use Application Default Credentials (ADC) to authenticate. For information about setting up ADC, see Provide credentials for Application Default Credentials. For information about using ADC with client libraries, see Authenticate using client libraries.
Using the client library JavaCompute Routes example:
import com.google.maps.routing.v2.*;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;
public class Main {
public static void main(String[] arguments) throws IOException {
RoutesSettings routesSettings = RoutesSettings.newBuilder()
.setHeaderProvider(() -> {
Map<String, String> headers = new HashMap<>();
headers.put("X-Goog-FieldMask", "*");
return headers;
}).build();
RoutesClient routesClient = RoutesClient.create(routesSettings);
ComputeRoutesResponse response = routesClient.computeRoutes(ComputeRoutesRequest.newBuilder()
.setOrigin(Waypoint.newBuilder().setPlaceId("ChIJeRpOeF67j4AR9ydy_PIzPuM").build())
.setDestination(Waypoint.newBuilder().setPlaceId("ChIJG3kh4hq6j4AR_XuFQnV0_t8").build())
.setRoutingPreference(RoutingPreference.TRAFFIC_AWARE)
.setTravelMode(RouteTravelMode.DRIVE).build());
System.out.println("Response: " + response.toString());
}
}
Route Matrix example:
import com.google.api.gax.rpc.ServerStream;
import com.google.api.gax.rpc.ServerStreamingCallable;
import com.google.maps.routing.v2.*;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;
public class Main {
public static void main(String[] arguments) throws IOException {
RoutesSettings routesSettings = RoutesSettings.newBuilder()
.setHeaderProvider(() -> {
Map<String, String> headers = new HashMap<>();
headers.put("X-Goog-FieldMask", "*");
return headers;
}).build();
RoutesClient routesClient = RoutesClient.create(routesSettings);
ServerStreamingCallable<ComputeRouteMatrixRequest, RouteMatrixElement> computeRouteMatrix = routesClient.computeRouteMatrixCallable();
ServerStream<RouteMatrixElement> stream = computeRouteMatrix.call(ComputeRouteMatrixRequest.newBuilder()
.addOrigins(RouteMatrixOrigin.newBuilder()
.setWaypoint(Waypoint.newBuilder().
setPlaceId("ChIJeRpOeF67j4AR9ydy_PIzPuM").build()))
.addDestinations(RouteMatrixDestination.newBuilder()
.setWaypoint(Waypoint.newBuilder().setPlaceId("ChIJG3kh4hq6j4AR_XuFQnV0_t8").build())
.build()).setTravelMode(RouteTravelMode.DRIVE)
.build());
for (RouteMatrixElement element : stream) {
System.out.println("Response : " + element.toString());
}
}
} Go
Compute Routes example:
import (
"context"
"fmt"
"io"
"os"
routing "cloud.google.com/go/maps/routing/apiv2"
"cloud.google.com/go/maps/routing/apiv2/routingpb"
"google.golang.org/grpc/metadata"
)
func main() {
ctx := context.Background()
client, err := routing.NewRoutesClient(ctx)
if err != nil {
fmt.Fprintf(os.Stderr, "error: %v\n", err)
os.Exit(1)
}
computeRoutesReq := routingpb.ComputeRoutesRequest{
Origin: &routingpb.Waypoint{
LocationType: &routingpb.Waypoint_PlaceId{
PlaceId: "ChIJeRpOeF67j4AR9ydy_PIzPuM",
},
},
Destination: &routingpb.Waypoint{
LocationType: &routingpb.Waypoint_PlaceId{
PlaceId: "ChIJG3kh4hq6j4AR_XuFQnV0_t8",
},
},
RoutingPreference: routingpb.RoutingPreference_TRAFFIC_AWARE,
TravelMode: routingpb.RouteTravelMode_DRIVE,
}
ctx = metadata.AppendToOutgoingContext(ctx, "X-Goog-FieldMask", "*")
computeRoutesResponse, err := client.ComputeRoutes(ctx, &computeRoutesReq)
if err != nil {
fmt.Fprintf(os.Stderr, "error: %v\n", err)
os.Exit(1)
}
fmt.Fprintf(os.Stdout, "response: %v\n", computeRoutesResponse)
}
Route Matrix example:
import (
"context"
"fmt"
"io"
"os"
routing "cloud.google.com/go/maps/routing/apiv2"
"cloud.google.com/go/maps/routing/apiv2/routingpb"
"google.golang.org/grpc/metadata"
)
func main() {
ctx := context.Background()
client, err := routing.NewRoutesClient(ctx)
if err != nil {
fmt.Printf("error: %v\n", err)
os.Exit(1)
}
computeRouteMatrixReq := routingpb.ComputeRouteMatrixRequest{
Origins: []*routingpb.RouteMatrixOrigin{
{
Waypoint: &routingpb.Waypoint{
LocationType: &routingpb.Waypoint_PlaceId{
PlaceId: "ChIJeRpOeF67j4AR9ydy_PIzPuM",
},
},
},
},
Destinations: []*routingpb.RouteMatrixDestination{
{
Waypoint: &routingpb.Waypoint{
LocationType: &routingpb.Waypoint_PlaceId{
PlaceId: "ChIJG3kh4hq6j4AR_XuFQnV0_t8",
},
},
},
},
TravelMode: routingpb.RouteTravelMode_DRIVE,
}
ctx = metadata.AppendToOutgoingContext(ctx, "X-Goog-FieldMask", "*")
stream, err := client.ComputeRouteMatrix(ctx, &computeRouteMatrixReq)
if err != nil {
fmt.Fprintf(os.Stderr, "error: %v\n", err)
os.Exit(1)
}
for {
element, err := stream.Recv()
if err == io.EOF {
break
}
if err != nil {
fmt.Fprintf(os.Stderr, "error: %v\n", err)
os.Exit(1)
}
fmt.Fprintf(os.Stdout, "element: %v\n", element)
}
} Node.js
Compute Routes example:
// Imports the Routing library
const { RoutesClient } = require("@googlemaps/routing").v2;
const origin = {
location: {
latLng: {
latitude: 37.419734,
longitude: -122.0827784,
},
},
};
const destination = {
location: {
latLng: {
latitude: 37.41767,
longitude: -122.079595,
},
},
};
// Instantiates a client
const routingClient = new RoutesClient();
async function callComputeRoutes() {
const request = {
origin,
destination,
};
// Run request
const response = await routingClient.computeRoutes(request, {
otherArgs: {
headers: {
"Content-Type": "application/json",
"X-Goog-Api-Key": "YOUR_API_KEY",
"X-Goog-FieldMask":
"routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline",
},
},
});
console.log(response);
}
callComputeRoutes();
Compute Route Matrix example:
// Imports the Routing library
const { RoutesClient } = require("@googlemaps/routing").v2;
const origins = [
{
waypoint: {
location: {
latLng: {
latitude: 37.420761,
longitude: -122.081356,
},
},
},
},
{
waypoint: {
location: {
latLng: {
latitude: 37.403184,
longitude: -122.097371,
},
},
},
},
];
const destinations = [
{
waypoint: {
location: {
latLng: {
latitude: 37.420999,
longitude: -122.086894,
},
},
},
},
{
waypoint: {
location: {
latLng: {
latitude: 37.383047,
longitude: -122.044651,
},
},
},
},
];
// Instantiates a client
const routingClient = new RoutesClient();
async function callComputeRouteMatrix() {
// Construct request
const request = {
origins,
destinations,
};
// Run request
const stream = await routingClient.computeRouteMatrix(request, {
otherArgs: {
headers: {
"Content-Type": "application/json",
"X-Goog-Api-Key": "YOUR_API_KEY",
"X-Goog-FieldMask": "*",
},
},
});
stream.on("data", (response) => {
console.log(response);
});
stream.on("error", (err) => {
throw err;
});
stream.on("end", () => {
/* API call completed */
});
}
callComputeRouteMatrix();
Python .Net Additional resources
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-14 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-14 UTC."],[[["This page provides instructions for getting started with the Routes API client libraries, covering installation and basic usage."],["Client libraries are available for Java, Go, Node.js, Python, and .Net, simplifying interaction with the Routes API."],["You'll need to set up authentication using Application Default Credentials (ADC) before using the client libraries."],["Code examples demonstrate how to make Compute Routes and Route Matrix requests using the client libraries in each supported language."],["Additional resources such as source code, issue trackers, and community forums are provided for further assistance."]]],["The content provides instructions for using client libraries with the Routes API across multiple languages. Key actions include: installing the respective language's client library (Java, Go, Node.js, Python, .Net), setting up Application Default Credentials (ADC) for authentication, and using code examples for \"Compute Routes\" and \"Route Matrix\" functionalities, demonstrating route calculation between specified locations using the API, in addition to links for documentation.\n"]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4