बड़े वाहनों के लिए रूटिंग

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

बड़े वाहन की रूटिंग, प्रॉपर्टी का एक सेट है. इसकी मदद से, बड़े वाहनों के लिए फ़्लीट रूटिंग को ऑप्टिमाइज़ किया जा सकता है. इसके लिए, वाहन के डाइमेंशन, वज़न, और ट्रेलर की संख्या की जानकारी देनी होती है. एपीआई इन एट्रिब्यूट का इस्तेमाल करके, ऐसे रास्ते का पता लगाता है जिन पर पाबंदी नहीं है. जैसे, कम ऊंचाई वाले पुल या ऐसे रास्ते जिन पर भारी वाहन नहीं चल सकते.

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

• सड़क पर मौजूद खतरों से बचें: ऐसे रूट प्लान जनरेट करें जो वाहनों को कम ऊंचाई वाले पुलों, वज़न की पाबंदी वाली सड़कों, और अन्य खतरों से दूर रखें.
• वाहन की पूरी जानकारी दें: पूरे फ़्लीट के लिए रूट प्लान में, सटीक डाइमेंशन, कुल वज़न, ऐक्सल की संख्या, और ट्रेलर कॉन्फ़िगरेशन शामिल करें.
• फ़्लीट के लिए बेहतर प्लानिंग करें: अपनी पूरी ट्रक फ़्लीट के लिए बेहतर रूट प्लान बनाएं. साथ ही, यह पक्का करें कि सभी असाइनमेंट, सड़क से जुड़ी पाबंदियों का पालन करते हों.
• रास्ते के दिशा-निर्देश की सुविधा चालू करें: फ़्लीट रूटिंग के लिए रूट टोकन जनरेट करें और उन्हें Navigation SDK को पास करें, ताकि ड्राइवर को बड़े वाहन के हिसाब से नेविगेशन की जानकारी दी जा सके.

सीमाएं

शुरू करने से पहले, आपको इन सीमाओं और ज़रूरी शर्तों के बारे में पता होना चाहिए.

• देश या इलाके के हिसाब से उपलब्धता: बड़े वाहनों के लिए रास्तों की जानकारी देने की सुविधा, सिर्फ़ अमेरिका के 48 राज्यों में उपलब्ध है.
• ड्राइवर के लिए सलाह और सुरक्षा: ड्राइवर को सुरक्षित या कानूनी तौर पर सही होने के लिए, सिर्फ़ इस एपीआई से मिले रास्तों पर भरोसा नहीं करना चाहिए. इस बात की कोई गारंटी नहीं है कि रास्ते वाहन के हिसाब से सही होंगे. इन रास्तों पर चलने से, ड्राइवर को कम ऊंचाई वाले पुल या ऐसी सड़कों जैसी खतरनाक स्थितियों का सामना करना पड़ सकता है जहां बड़े वाहनों को चलाने की अनुमति नहीं है.
• बेस्ट-एफ़र्ट रूट: कुछ मामलों में, एपीआई ऐसा रूट नहीं ढूंढ पाता जो यात्रा से जुड़ी पाबंदियों का पूरी तरह से पालन करता हो. इसके बजाय, यह "सबसे सही" रास्ता दिखाता है, जो अब भी प्रतिबंधित इलाकों से होकर गुज़र सकता है.
• इस्तेमाल नहीं की जा सकने वाली सुविधाएं: बड़े वाहन के लिए रास्ता दिखाने की सुविधा, इन सुविधाओं के साथ काम नहीं करती:
  • ट्रक के टोल की कीमतें
  • गति की सीमाएं
  • रेडियोऐक्टिव खतरनाक सामान के लिए रूटिंग
• बिलिंग: Google सभी optimizeTours अनुरोधों के लिए एक समान बिल जनरेट करता है. इससे कोई फ़र्क़ नहीं पड़ता कि अनुरोधों में बड़े वाहन के लिए रूटिंग प्रॉपर्टी कॉन्फ़िगर की गई हैं या नहीं.
• लंबी दूरी वाले रास्ते: 500 या इससे ज़्यादा किलोमीटर की दूरी वाले ट्रक के रास्तों के लिए, छोटे रास्तों की तुलना में ज़्यादा समय लगता है. साथ ही, हो सकता है कि इनसे रास्ते का कम क्वालिटी वाला डेटा मिले. रास्ते की क्वालिटी बनाए रखने के लिए, शिपमेंट, वाहन के शुरू होने की जगहों, और वाहन के खत्म होने की जगहों के बीच की दूरी को सीमित करें. अगर आपको लंबे रूट की ज़रूरत है, तो अनुरोध की समयसीमा बढ़ाएं. इससे DEADLINE_EXCEEDED गड़बड़ियों की संभावना कम हो जाएगी.

प्रॉपर्टी

बड़े वाहनों के लिए रूटिंग प्रॉपर्टी का इस्तेमाल करने के लिए, आपको वाहन के डाइमेंशन कॉन्फ़िगर करने होंगे. साथ ही, रूटिंग मोड को ट्रक पर सेट करना होगा.

यहां दी गई टेबल में, बड़े वाहनों के रूटिंग को कॉन्फ़िगर करने के लिए टॉप-लेवल की प्रॉपर्टी दी गई हैं:

प्रॉपर्टी	टाइप	आवश्यकता	ब्यौरा
travelMode	स्ट्रिंग	ज़रूरी है	इससे वाहन की यात्रा का मोड पता चलता है. बड़े वाहनों के लिए रूटिंग की प्रॉपर्टी चालू करने के लिए, इस वैल्यू को TRUCK पर सेट करें.
routeModifiers	ऑब्जेक्ट	ज़रूरी है	इसमें रूट के हिसाब से कॉन्फ़िगरेशन शामिल होते हैं. जैसे, vehicleInfo.

vehicleInfo

vehicleInfo ऑब्जेक्ट में, वाहन की फ़िज़िकल स्पेसिफ़िकेशन की जानकारी होती है. इस ऑब्जेक्ट को routeModifiers प्रॉपर्टी में तय करें. अगर आपने travelMode को TRUCK पर सेट किया है, तो vehicleInfo ऑब्जेक्ट को शामिल करना ज़रूरी है.

नीचे दी गई टेबल में, vehicleInfo ऑब्जेक्ट में उपलब्ध प्रॉपर्टी की सूची दी गई है:

प्रॉपर्टी	टाइप	आवश्यकता	ब्यौरा
totalHeightMm	पूर्णांक	ज़रूरी है	इससे वाहन की कुल ऊंचाई मिलीमीटर में पता चलती है. यह वैल्यू एक पॉज़िटिव पूर्णांक होनी चाहिए.
totalWidthMm	पूर्णांक	ज़रूरी है	इससे वाहन की कुल चौड़ाई के बारे में पता चलता है. यह जानकारी मिलीमीटर में होती है. यह वैल्यू एक पॉज़िटिव पूर्णांक होनी चाहिए.
totalWeightKg	पूर्णांक	ज़रूरी है	इससे वाहन का कुल वज़न किलोग्राम में पता चलता है. यह वैल्यू एक पॉज़िटिव पूर्णांक होनी चाहिए.
totalLengthMm	पूर्णांक	ज़रूरी है	इससे वाहन की कुल लंबाई मिलीमीटर में पता चलती है. यह वैल्यू एक पॉज़िटिव पूर्णांक होनी चाहिए.
trailerInfo	ऐरे	वैकल्पिक	इसमें ट्रेलर की खास बातों का एक ऐरे होता है. इसमें lengthMm प्रॉपर्टी शामिल होती है, ताकि हर ट्रेलर की लंबाई मिलीमीटर में बताई जा सके.
totalAxleCount	पूर्णांक	ज़रूरी है	इससे वाहन में मौजूद ऐक्सल की कुल संख्या के बारे में पता चलता है. यह वैल्यू, 2 या इससे ज़्यादा का पूर्णांक होना चाहिए.

उदाहरण

इस सेक्शन में, दो तरह के उदाहरण दिए गए हैं:

• कोड सैंपल, जिसमें बड़े वाहनों के लिए रूटिंग का स्ट्रक्चर दिखाया गया है.
• अनुरोध का उदाहरण, जिसमें सुविधा शामिल है.

कोड सैंपल

नीचे दिए गए उदाहरण में, बड़े वाहन के लिए रूटिंग के लिए इस्तेमाल की जाने वाली प्रॉपर्टी का स्ट्रक्चर दिखाया गया है:

"vehicles": [
  {
    "travelMode": "TRUCK",
    "routeModifiers": {
      "vehicleInfo": {
        "totalHeightMm": TOTAL_HEIGHT_MM,
        "totalWidthMm": TOTAL_WIDTH_MM,
        "totalWeightKg": TOTAL_WEIGHT_KG,
        "totalLengthMm": TOTAL_LENGTH_MM,
        "trailerInfo": [
          {
            "lengthMm": TRAILER_LENGTH_MM
          }
        ],
        "totalAxleCount": TOTAL_AXLE_COUNT
      }
    }
  }
]

अनुरोध का उदाहरण

यहां optimizeTours के बुनियादी अनुरोध का स्ट्रक्चर दिखाया गया है. इसमें बड़े वाहनों के लिए राउटिंग की सुविधा शामिल है:

{
  "model": {
    "shipments": [
      {
        "pickups": [
          {
            "arrivalLocation": {
              "latitude": 40.953523,
              "longitude": -72.2277846
            }
          }
        ],
        "deliveries": [
          {
            "arrivalLocation": {
              "latitude": 40.9546673,
              "longitude": -72.2580151
            }
          }
        ]
      }
    ],
    "vehicles": [
      {
        "travelMode": "TRUCK",
        "routeModifiers": {
          "vehicleInfo": {
            "totalHeightMm": 4000,
            "totalWidthMm": 2500,
            "totalWeightKg": 9000,
            "totalLengthMm": 20000,
            "trailerInfo": [
              {
                "lengthMm": 15000
              }
            ],
            "totalAxleCount": 5
          }
        },
        "costPerKilometer": 1.0
      }
    ]
  }
}

आगे क्या करना है

• टर्न-बाय-टर्न नेविगेशन की सुविधा उपलब्ध कराना: जानें कि हर ट्रांज़िशन के लिए मिले routeToken को Android या iOS के लिए Navigation SDK टूल को कैसे पास करें.
• ट्रांज़िशन पॉलीलाइन और रूट टोकन जनरेट करना: ट्रांज़िशन पॉलीलाइन और रूट टोकन में populateTransitionPolylines का इस्तेमाल करके, रूट टोकन का अनुरोध करने का तरीका जानें.
• एपीआई के बारे में जानकारी: optimizeTours के बारे में जानकारी में फ़ील्ड की पूरी सूची देखें.