एपीआई अनुरोध करें

OptimizeTours का अनुरोध करने के लिए, OptimizeToursRequest मैसेज का इस्तेमाल किया जा सकता है.

उदाहरण: OptimizeTours के लिए अनुरोध करें

OptimizeTours अनुरोध, REST या gRPC का इस्तेमाल करके किया जा सकता है. क्लाइंट लाइब्रेरी, कई लोकप्रिय प्रोग्रामिंग भाषाओं के लिए भी उपलब्ध हैं. इस उदाहरण में अनुरोध करने के लिए, कमांड लाइन टूल और क्लाइंट लाइब्रेरी के कॉम्बिनेशन का इस्तेमाल किया जाता है.

अनुरोध करने से पहले, इन पैरामीटर को अपने एनवायरमेंट के हिसाब से सही वैल्यू से बदलें:

• पक्का करें कि आपने ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल कॉन्फ़िगर किए हैं, जैसा कि OAuth का इस्तेमाल करें में बताया गया है.

• PROJECT_NUMBER_OR_ID को अपने क्लाउड प्रोजेक्ट नंबर या आईडी पर सेट करें.

शुरू करें

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

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

आराम

नीचे दिया गया निर्देश, रूट ऑप्टिमाइज़ेशन एपीआई को 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

ध्यान दें: इस उदाहरण में, स्टैंडर्ड इनपुट से मिले अनुरोध को पढ़ने के लिए --data @- का इस्तेमाल किया गया है. किसी फ़ाइल से पढ़ने के लिए, --data @Filename का इस्तेमाल करें.

अनुरोध पूरा होने पर, आपको जवाब वाला मैसेज मिलेगा.

अगला: जवाब को समझना