रास्ते के ऑप्टिमाइज़ेशन के लिए अपना पहला अनुरोध करें

इस दस्तावेज़ में, Route Optimization API के लिए पहला अनुरोध करने का तरीका बताया गया है. इसमें, असल दुनिया में इस्तेमाल होने वाले किसी उदाहरण का इस्तेमाल किया गया है.

आसानी से समझने के लिए, इस उदाहरण में REST API को दिखाने के लिए एचटीटीपी और JSON का इस्तेमाल किया गया है. हालांकि, आपके प्रोडक्शन एनवायरमेंट के लिए, gRPC का इस्तेमाल करने का सुझाव दिया जाता है, ताकि आपको इसकी परफ़ॉर्मेंस से जुड़े फ़ायदे मिल सकें. हालांकि, gRPC को इंस्टॉल करना ज़रूरी है. ज़्यादा जानकारी के लिए, Route Optimization API की क्लाइंट लाइब्रेरी देखें.

स्थिति

आपने सैन फ़्रांसिस्को में पालतू कुत्तों के लिए डेकेयर की सेवा शुरू की है. यह सेवा सुबह 7:00 बजे से शाम 7:00 बजे तक उपलब्ध है. आज सुबह, आपको शहर की अलग-अलग जगहों से दो कुत्तों को पिक अप करना है. कुत्ते के दोनों मालिकों ने आपको सुबह 7:30 बजे से सुबह 9:30 बजे के बीच पिकअप करने का समय दिया है.

आपके पास काम के लिए एक वैन है और ड्राइवर को हर घंटे के हिसाब से 27 डॉलर दिए जाते हैं. ड्राइवर और वैन, सुबह 7:00 बजे आपके डेकेयर सेंटर से दिन की शुरुआत करते हैं. उन्हें दोपहर 12:00 बजे तक, सुबह बच्चों को पिकअप करने के बाद वापस आना होता है, ताकि वे दोपहर के खाने के लिए ब्रेक ले सकें.

आज 13 फ़रवरी, 2024 है और ड्राइवर को ये टास्क पूरे करने हैं:

• कोइट टावर के पास बर्नीज़ माउंटेन डॉग को उठाओ.
• चिहुआहुआ को साउथ सनसेट प्लेग्राउंड पार्क से ले आओ.
• दोनों कुत्तों को मिशन डोलोरेस पार्क में मौजूद डॉगी डेकेयर सेंटर पर छोड़ दो.

आपको ऐसा रास्ता चाहिए जिससे कुत्तों को वैन में कम से कम समय बिताना पड़े. साथ ही, पिकअप और ड्रॉपऑफ़ की ज़रूरी शर्तें भी पूरी हों.

शुरू करने से पहले

उदाहरण के तौर पर दिए गए इस कोड को चलाने के लिए, आपको सबसे पहले Route Optimization API सेट अप करें में दिए गए निर्देशों को पूरा करना होगा.

1. रास्ते को ऑप्टिमाइज़ करने का तरीका चुनना

Route Optimization API में कई तरीके उपलब्ध हैं. इनमें से किसी एक को चुना जा सकता है. यह इस बात पर निर्भर करता है कि ऑप्टिमाइज़ेशन से जुड़ी आपकी समस्या कितनी जटिल है.

डॉग डेकेयर के इस छोटे और आसान अनुरोध के लिए, optimizeTours जैसी ब्लॉकिंग विधि का इस्तेमाल करें. इससे छोटे अनुरोधों के नतीजे तुरंत मिलते हैं. Route Optimization API के तरीकों के बारे में ज़्यादा जानने के लिए, सिंक्रोनस और एसिंक्रोनस एंडपॉइंट देखें.

optimizeTours तरीके के लिए, एचटीटीपी पोस्ट अनुरोध करने के लिए, इस यूआरएल का इस्तेमाल करें:

https://routeoptimization.googleapis.com/v1/projects/PROJECT_OR_ID:optimizeTours

आपको टाइमआउट और समयसीमा की सेटिंग को भी कम पर सेट करना होगा, ताकि किसी भी तरह के गैर-ज़रूरी इंतज़ार के समय को कम किया जा सके. डॉग डेकेयर के इस उदाहरण में, ऑप्टिमाइज़र को आपके अनुरोध का जवाब देने के लिए ज़्यादा समय की ज़रूरत नहीं है. इसलिए, इन सेटिंग का इस्तेमाल करें:

• timeout पैरामीटर को 2 सेकंड पर सेट करें.
• समयसीमा की सेटिंग को डिफ़ॉल्ट पर छोड़ दें. REST अनुरोधों के लिए, यह 60 सेकंड होती है.

2. अनुरोध के मैसेज का मुख्य हिस्सा बनाना

ब्लॉक करने की optimizeTours विधि चुनने के बाद, टाइम आउट और समयसीमा की सेटिंग तय करें. इसके बाद, अनुरोध के मैसेज का मुख्य हिस्सा बनाएं.

इस उदाहरण में, अनुरोध एक OptimizeToursRequest मैसेज है, जिसे REST API में JSON के तौर पर कोड में बदला गया है.

अनुरोध का मैसेज बनाने के लिए, यह तरीका अपनाएं:

1. अनुरोध के बुनियादी स्ट्रक्चर से शुरुआत करें. यह स्ट्रक्चर इस तरह से होता है:

   {
     "timeout": ...,
     "model": {
       "shipments": [...],
       "vehicles": [...],
       "globalStartTime": "...",
       "globalEndTime": "..."
     }
   }
   

   स्ट्रक्चर के बारे में ज़्यादा जानने के लिए, बुनियादी स्ट्रक्चर (ShipmentModel, Shipment, और Vehicle) के बारे में मुख्य कॉन्सेप्ट गाइड देखें.

2. शिपमेंट तय करें. shipments फ़ील्ड में, हर उस कुत्ते के लिए Shipment मैसेज जोड़ें जिसे सुबह पिक अप और ड्रॉप ऑफ़ करना है. यहां आपको कुत्ते के मालिक की पसंद के हिसाब से, कुत्ते को पिकअप करने की जगह और समय के साथ-साथ डेकेयर सेंटर की जगह और कुत्ते को छोड़ने का समय तय करना होता है.

   1. हर कुत्ते के लिए, पिकअप के लिए VisitRequest और डिलीवरी के लिए दूसरा VisitRequest बनाएं. इस उदाहरण में, डिलीवरी को डेकेयर ड्रॉपऑफ़ कहा गया है.

      • पिकअप में, arrivalWaypoint को कुत्ते के पिकअप की जगह (बर्नीज़ माउंटेन डॉग के लिए कॉइट टॉवर या चिहुआहुआ के लिए साउथ सनसेट प्लेग्राउंड पार्क) और timeWindows को मालिक के अनुरोध किए गए पिकअप के समय (सुबह 7:30 बजे से 9:30 बजे) पर सेट करें.

      • डिलीवरी के लिए, डेकेयर सेंटर के लिए arrivalWaypoint और ड्रॉपऑफ़ के लिए timeWindows को सुबह 9:30 बजे से 11:30 बजे के बीच सेट करें.

      टाइम विंडो के बारे में ज़्यादा जानने के लिए, टाइम विंडो लेख पढ़ें.

   2. label फ़ील्ड का इस्तेमाल करके, हर शिपमेंट के लिए आइडेंटिफ़ायर जोड़ा जा सकता है. जैसे, "बर्नीज़ माउंटेन डॉग" और "चिहुआहुआ". इससे आपको जवाब में मौजूद शिपमेंट की पहचान करने में मदद मिल सकती है.

   शिपमेंट तय करने के बारे में ज़्यादा जानकारी के लिए, शिपमेंट देखें.

3. वाहनों के बारे में जानकारी दें. vehicles फ़ील्ड में, अपनी एक वैन के लिए Vehicle मैसेज जोड़ें. इसमें डेकेयर सेंटर को शुरुआती और आखिरी पॉइंट के तौर पर शामिल करें. साथ ही, ड्राइवर के वेतन और वैन के चलने के समय की जानकारी दें.

   1. वैन के लिए, दिन की शुरुआत और खत्म होने की जगह के तौर पर startWaypoint और endWaypoint सेट करें. यह जगह, मिशन डोलोरेस पार्क के पास मौजूद डेकेयर सेंटर है.

   2. ऑपरेशन की लागत को कम करने के लिए, आपको अपने कारोबार की लागत की सीमाएं तय करनी होंगी. लागत पैरामीटर costPerHour को 27 पर सेट करें. यह वह रकम है जो आपने कुत्ते को डेकेयर ले जाने वाले ड्राइवर को दी है. लागत के पैरामीटर के बारे में ज़्यादा जानने के लिए, लागत मॉडल देखें.

   3. यह पक्का करने के लिए कि ऑप्टिमाइज़र, वैन के कामकाजी घंटों के दौरान रूट बनाए, startTimeWindows को उस मान्य सीमा के तौर पर तय करें जिसमें ड्राइवर वैन चलाना शुरू कर सकता है. साथ ही, endTimeWindows को उस मान्य सीमा के तौर पर तय करें जिसमें ड्राइवर को डेकेयर सेंटर वापस लौटना होगा. टाइम विंडो के बारे में ज़्यादा जानने के लिए, टाइम विंडो लेख पढ़ें.

   वाहनों को तय करने के बारे में ज़्यादा जानकारी के लिए, वाहन देखें.

4. ग्लोबल टाइम विंडो सेट करें. ग्लोबल टाइम विंडो से पता चलता है कि वैन, पूरे दिन में किस समयावधि के दौरान आपके डेकेयर से बच्चों को पिकअप और ड्रॉप ऑफ़ कर सकती है. इस उदाहरण के लिए, 13 फ़रवरी, 2024 के लिए globalStartTime को सुबह 7:00 बजे और globalEndTime को शाम 7:00 बजे पर सेट करें. यह आपके डॉगी डेकेयर के खुलने और बंद होने का समय है.

3. अनुरोध भेजें

यहां कुत्ते की देखभाल करने वाले डेकेयर के उदाहरण के आधार पर, curl का एक सामान्य अनुरोध दिया गया है. इसमें, optimizeTours को ब्लॉक करने के तरीके का इस्तेमाल किया गया है.

अनुरोध भेजने से पहले, सैंपल कोड में मौजूद PROJECT_NUMBER_OR_ID की जगह अपना Google Cloud प्रोजेक्ट आईडी डालें.

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
{
  "timeout": "2s",
  "model": {
    "shipments": [
      {
        "pickups": [
          {
            "arrivalWaypoint": {
              "location": {
                "latLng": {
                  "latitude": 37.802395,
                  "longitude": -122.405822
                }
              }
            },
            "timeWindows": [
              {
                "startTime": "2024-02-13T07:30:00Z",
                "endTime": "2024-02-13T09:30:00Z"
              }
            ]
          }
        ],
        "deliveries": [
          {
            "arrivalWaypoint": {
              "location": {
                "latLng": {
                  "latitude": 37.760202,
                  "longitude": -122.426796
                }
              }
            },
            "timeWindows": [
              {
                "startTime": "2024-02-13T09:30:00Z",
                "endTime": "2024-02-13T11:30:00Z"
              }
            ]
          }
        ],
        "label": "Bernese mountain dog"
      },
      {
        "pickups": [
          {
            "arrivalWaypoint": {
              "location": {
                "latLng": {
                  "latitude": 37.738067,
                  "longitude": -122.498593
                }
              }
            },
            "timeWindows": [
              {
                "startTime": "2024-02-13T07:30:00Z",
                "endTime": "2024-02-13T09:30:00Z"
              }
            ]
          }
        ],
        "deliveries": [
          {
            "arrivalWaypoint": {
              "location": {
                "latLng": {
                  "latitude": 37.760202,
                  "longitude": -122.426796
                }
              }
            },
            "timeWindows": [
              {
                "startTime": "2024-02-13T09:30:00Z",
                "endTime": "2024-02-13T11:30:00Z"
              }
            ]
          }
        ],
        "label": "Chihuahua"
      }
    ],
    "vehicles": [
      {
        "startWaypoint": {
          "location": {
            "latLng": {
              "latitude": 37.760202,
              "longitude": -122.426796
            }
          }
        },
        "endWaypoint": {
          "location": {
            "latLng": {
              "latitude": 37.760202,
              "longitude": -122.426796
            }
          }
        },
        "costPerHour": 27,
        "startTimeWindows": [
          {
            "startTime": "2024-02-13T07:00:00Z",
            "endTime": "2024-02-13T07:15:00Z"
          }
        ],
        "endTimeWindows": [
          {
            "startTime": "2024-02-13T11:45:00Z",
            "endTime": "2024-02-13T12:00:00Z"
          }
        ]
      }
    ],
    "globalStartTime": "2024-02-13T07:00:00Z",
    "globalEndTime": "2024-02-13T19:00:00Z"
  }
}
EOM

अनुरोध में इस्तेमाल किए गए अनुरोध पैरामीटर

यहां दी गई टेबल में, अनुरोध के मुख्य हिस्से में इस्तेमाल किए गए अनुरोध पैरामीटर के बारे में बताया गया है. ये पैरामीटर, उदाहरण के तौर पर दिए गए परिदृश्य में इस्तेमाल किए गए हैं. कॉन्टेंट को पैरंट के हिसाब से या टेक्स्ट खोजकर फ़िल्टर किया जा सकता है.

अगला

जवाब को समझनाarrow_forward