یک درخواست API ایجاد کنید

از پیام OptimizeToursRequest می توان برای درخواست OptimizeTours استفاده کرد.

مثال: درخواست OptimizeTours را ارسال کنید

درخواست های OptimizeTours را می توان با استفاده از REST یا gRPC انجام داد. کتابخانه های کلاینت برای چندین زبان برنامه نویسی محبوب نیز در دسترس هستند. این مثال از ترکیبی از ابزارهای خط فرمان و کتابخانه های مشتری برای درخواست استفاده می کند.

قبل از درخواست، پارامترهای زیر را با مقادیر مناسب برای محیط خود جایگزین کنید:

  • اطمینان حاصل کنید که اعتبارنامه پیش‌فرض برنامه را همانطور که در Use OAuth توضیح داده شده پیکربندی کرده‌اید.

  • PROJECT_NUMBER_OR_ID را روی شماره یا شناسه پروژه Cloud خود تنظیم کنید.

برو

با استفاده از کتابخانه سرویس گیرنده 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)
}

optimize_tours.go

جاوا

اگر از 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>

با استفاده از کتابخانه سرویس گیرنده جاوا درخواستی را ارسال کنید:

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);
    }
  }
}

پایتون

کلاینت پایتون در PyPI در دسترس است.

pip install google-maps-routeoptimization

با استفاده از کتابخانه کلاینت پایتون درخواست بدهید:

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

ابتدا، یک کپی از بایگانی مشتری Node.js را از نماینده پلتفرم Google Maps خود درخواست کنید.

فایل package.json خود را با استفاده از قطعه 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();

باقی مانده

دستور زیر یک درخواست OptimizeTours را به Route Optimization API ارسال می کند و پاسخی را به صورت همزمان دریافت می کند.

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

پس از تکمیل درخواست، یک پیام پاسخ دریافت خواهید کرد.

بعدی: پاسخ را تفسیر کنید