На этой странице показано, как начать работу с клиентскими библиотеками для Routes API.
Подробнее о клиентских библиотеках читайте в разделе «Описание клиентских библиотек» .
Установка клиентской библиотеки
Ява
Дополнительную информацию см. в разделе Настройка среды разработки Java .
Инструкции по установке см. в разделе «Клиент Google Routes API для Java» .
Идти
go get cloud.google.com/go/mapsДополнительную информацию см. в разделе Настройка среды разработки Go .
Инструкции по установке см. в разделе «Клиент Google Routes API для Go» .
Node.js
npm install @googlemaps/routingДополнительные сведения см. в разделе Настройка среды разработки Node.js.
Полные инструкции по установке см. в разделе Клиент Google Routes API для Node.js.
Питон
Дополнительную информацию см. в разделе Настройка среды разработки Python .
Полные инструкции по установке см. в разделе Клиент Google Routes API для Python.
.Сеть
Дополнительную информацию см. в разделе Настройка среды разработки .Net .
Полные инструкции по установке см. в разделе Клиент Google Routes API для .Net.
Настройка аутентификации
При использовании клиентских библиотек для аутентификации вы используете учетные данные приложения по умолчанию (ADC) . Дополнительные сведения о настройке ADC см. в разделе Предоставление учетных данных для учетных данных приложения по умолчанию . Сведения об использовании ADC с клиентскими библиотеками см. в разделе Аутентификация с использованием клиентских библиотек .
Использование клиентской библиотеки
Ява
Пример вычисления маршрутов:
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());
}
}
Пример матрицы маршрутов:
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());
}
}
}
Идти
Пример вычисления маршрутов:
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)
}
Пример матрицы маршрутов:
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
Пример вычисления маршрутов:
// 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();
Пример расчета матрицы маршрутов:
// 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();