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

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

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

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

सीमाएं

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

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

प्रॉपर्टी

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

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

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

vehicleInfo

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

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

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

उदाहरण

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

कोड सैंपल

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

"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
      }
    ]
  }
}