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

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

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

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

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

उदाहरण

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

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

कोड सैंपल

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

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

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

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