OptimizeToursRequest 消息可用于发出 OptimizeTours 请求。
示例：发出 OptimizeTours 请求
可以使用 REST 或 gRPC 发出 OptimizeTours 请求。此外，客户端库也支持多种常用编程语言。此示例组合使用命令行工具和客户端库发出请求。
在发出请求之前，请将以下参数替换为适合您的环境的值：
Go
使用 Go 客户端库发出请求：
import (
"context"
"fmt"
routeoptimization "cloud.google.com/go/maps/routeoptimization/apiv1"
"google.golang.org/genproto/googleapis/type/latlng"
rpb "cloud.google.com/go/maps/routeoptimization/apiv1/routeoptimizationpb"
)
func optimizeTours(projectID string) (*rpb.OptimizeToursResponse, error) {
ctx := context.Background()
c, err := routeoptimization.NewClient(ctx)
if err != nil {
return nil, fmt.Errorf("routeoptimization client: %w", err)
}
defer c.Close()
// See https://pkg.go.dev/cloud.google.com/go/maps/routeoptimization/apiv1/routeoptimizationpb#OptimizeToursRequest.
req := &rpb.OptimizeToursRequest{
Parent: "projects/" + projectID,
Model: &rpb.ShipmentModel{
Shipments: []*rpb.Shipment{
&rpb.Shipment{
Deliveries: []*rpb.Shipment_VisitRequest{
{ArrivalLocation: &latlng.LatLng{Latitude: 48.880942, Longitude: 2.323866}},
},
},
},
Vehicles: []*rpb.Vehicle{
{
StartLocation: &latlng.LatLng{Latitude: 48.863102, Longitude: 2.341204},
EndLocation: &latlng.LatLng{Latitude: 48.86311, Longitude: 2.341205},
},
},
},
}
return c.OptimizeTours(ctx, req)
}
Java
如果您使用的是 Maven，请将以下代码添加到 pom.xml 文件中。
<dependencyManagement>
<dependencies>
<dependency>
<artifactId>google-maps-routeoptimization-bom</artifactId>
<groupId>com.google.maps</groupId>
<scope>import</scope>
<type>pom</type>
<version>0.1.0</version>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<dependency>
<groupId>com.google.maps</groupId>
<artifactId>google-maps-routeoptimization</artifactId>
<scope>compile</scope>
</dependency>
</dependencies>
使用 Java 客户端库发出请求：
import com.google.maps.routeoptimization.v1.OptimizeToursRequest; import com.google.maps.routeoptimization.v1.OptimizeToursResponse; import com.google.maps.routeoptimization.v1.RouteOptimizationClient; import com.google.maps.routeoptimization.v1.Shipment; import com.google.maps.routeoptimization.v1.Shipment.VisitRequest; import com.google.maps.routeoptimization.v1.ShipmentModel; import com.google.maps.routeoptimization.v1.Vehicle; import com.google.type.LatLng;public class OptimizeTours { public static void main(String[] args) throws Exception { System.out.println(optimizeTours()); }
public static OptimizeToursResponse optimizeTours() throws Exception { try (RouteOptimizationClient routeOptimizationClient = RouteOptimizationClient.create()) { OptimizeToursRequest request = OptimizeToursRequest.newBuilder() .setParent("projects/PROJECT_NUMBER_OR_ID") .setModel( ShipmentModel.newBuilder() .addShipments( Shipment.newBuilder() .addPickups( VisitRequest.newBuilder() .setArrivalLocation( LatLng.newBuilder().setLatitude(48.8).setLongitude(2.4)))) .addVehicles( Vehicle.newBuilder() .setStartLocation( LatLng.newBuilder().setLatitude(48.9).setLongitude(2.5)))) .build(); return routeOptimizationClient.optimizeTours(request); } } }
Python
Python 客户端可通过 PyPI 获取。
pip install google-maps-routeoptimization
使用 Python 客户端库发出请求：
from google.maps import routeoptimization_v1 as ro
client = ro.RouteOptimizationClient()
request = ro.OptimizeToursRequest(
parent="projects/PROJECT_NUMBER_OR_ID",
model={
"shipments": [
{
"pickups": [
{
"arrival_location": {
"latitude": 37.738818,
"longitude": -122.4161
}
}
],
"deliveries": [
{
"arrival_location": {
"latitude": 37.79581,
"longitude": -122.4218856
}
}
]
}
],
"vehicles": [
{
"start_location": {
"latitude": 37.738818,
"longitude": -122.4161
},
"end_location": {
"latitude": 37.738818,
"longitude": -122.4161
},
"cost_per_kilometer": 1.0
}
],
"global_start_time": "2024-02-13T00:00:00.000Z",
"global_end_time": "2024-02-14T06:00:00.000Z"
}
)
response = client.optimize_tours(request=request)
print(response)
Node.js
首先，向您的 Google Maps Platform 代表索取 Node.js 客户端归档文件的副本。
使用以下 JSON 代码段配置 package.json 文件：
{
"name": "route-optimization-example",
"version": "1.0.0",
"description": "A RouteOptimization example.",
"main": "main.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1"
},
"author": "",
"dependencies": {
"@googlemaps/routeoptimization": "^0.1.0"
}
}
使用 Node.js 客户端库发出请求：
'use strict';
const {RouteOptimizationClient} = require('@googlemaps/routeoptimization').v1;
const routeoptimizationClient = new RouteOptimizationClient();
async function callOptimizeTours() {
const response = await routeoptimizationClient.optimizeTours({
"parent": "projects/PROJECT_NUMBER_OR_ID",
"model": {
"shipments": [
{
"pickups": [
{
"arrivalLocation": {
"latitude": 37.73881799999999,
"longitude": -122.4161
}
}
],
"deliveries": [
{
"arrivalLocation": {
"latitude": 37.79581,
"longitude": -122.4218856
}
}
]
}
],
"vehicles": [
{
"startLocation": {
"latitude": 37.73881799999999,
"longitude": -122.4161
},
"endLocation": {
"latitude": 37.73881799999999,
"longitude": -122.4161
},
"costPerKilometer": 1.0
}
],
"globalStartTime": "2024-02-13T00:00:00.000Z",
"globalEndTime": "2024-02-14T06:00:00.000Z"
}
});
console.log(JSON.stringify(response));
}
callOptimizeTours();
REST
以下命令会向 Route Optimization API 发送 OptimizeTours 请求，并同步接收响应。
curl -X POST 'https://routeoptimization.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID:optimizeTours' \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
--data @- << EOM
{
"model": {
"shipments": [
{
"pickups": [
{
"arrivalLocation": {
"latitude": 37.73881799999999,
"longitude": -122.4161
}
}
],
"deliveries": [
{
"arrivalLocation": {
"latitude": 37.79581,
"longitude": -122.4218856
}
}
]
}
],
"vehicles": [
{
"startLocation": {
"latitude": 37.73881799999999,
"longitude": -122.4161
},
"endLocation": {
"latitude": 37.73881799999999,
"longitude": -122.4161
},
"costPerKilometer": 1.0
}
],
"globalStartTime": "2024-02-13T00:00:00.000Z",
"globalEndTime": "2024-02-14T06:00:00.000Z"
}
}
EOM
请求完成后，您会收到一条响应消息。