Routes API की खास जानकारी

Routes API एक ऐसी सेवा है जो एचटीटीपीएस अनुरोध स्वीकार करती है और दो जगहों के बीच का सबसे सही रास्ता दिखाती है. इसके अलावा, यह ऑरिजिन और डेस्टिनेशन की अलग-अलग जगहों के बीच के रास्तों के मैट्रिक के लिए, दूरी और यात्रा में लगने वाला समय भी दिखाती है.

Routes API का इस्तेमाल क्यों करना चाहिए

Routes API की मदद से, आपको सटीक रास्ते और यात्रा की जानकारी मिल सकती है. इसके लिए, परिवहन की जानकारी, ट्रैफ़िक और सड़क की अप-टू-डेट स्थिति, और रास्ते की प्राथमिकताओं का इस्तेमाल किया जाता है:

  • यात्रा के अलग-अलग साधनों के टाइप और सुविधाएं

  • वाहन किस दिशा में जा रहा है

  • पिक अप या ड्रॉप ऑफ़ के लिए सड़क का किनारा

  • ट्रैफ़िक की स्थिति और बंद सड़कों के बारे में जानकारी

  • सुरक्षा से जुड़ी समस्याएं, जैसे कि खतरनाक इलाकों से बचना या पिकअप के लिए सुरक्षित इलाकों की जानकारी देना

  • अपनी रास्ते की ज़रूरतों के हिसाब से, विकल्प के तौर पर उपलब्ध सुविधाओं की मदद से, विलंब, क्वालिटी, और कीमत को संतुलित करें. जैसे, टोल और यात्रा के मेटाडेटा, जैसे कि समय और दूरी, और ईंधन की बचत

डिस्पैच शेड्यूल करने के लिए, सबसे सही रास्ते भी तय किए जा सकते हैं. जैसे:

  • एक से ज़्यादा पैकेज लेने के लिए, कर्मचारियों को असाइन करने का सबसे सही तरीका

  • यह तय करना कि पैकेज को उनके आखिरी डिस्टिनेशन पर शिप करने के लिए, सबसे अच्छा वेयरहाउस कौनसा है

Routes API की मदद से क्या-क्या किया जा सकता है?

Routes API की मदद से, आपको रूटिंग की जानकारी की दो मुख्य कैटगरी मिल सकती हैं:

  • किसी जगह से एक या उससे ज़्यादा डेस्टिनेशन तक के रास्ते

  • कई शुरुआती और आखिरी जगहों के बीच संभावित रास्तों का मैट्रिक.

एक या एक से ज़्यादा डेस्टिनेशन के लिए रास्ते पाना

Routes API Compute Routes के तरीके की मदद से, जगहों के बीच की दूरी का हिसाब लगाया जा सकता है:

  • यात्रा के अलग-अलग तरीकों के लिए निर्देश पाना. साथ ही, एक या एक से ज़्यादा गतिविधियों के लिए निर्देश पाना:

    • यात्रा के तरीके, जैसे कि सार्वजनिक परिवहन, ड्राइविंग, दोपहिया वाहन, पैदल चलना या साइकल चलाना.

    • वे रास्ते जिन पर यात्रा करने के लिए, सबसे सही क्रम में उन्हें ऑप्टिमाइज़ किया जा सकता है.

  • ऑरिजिन, डेस्टिनेशन, और रास्ते में रुकने के लिए जगहों की जानकारी देने के कई तरीके:

    • टेक्स्ट स्ट्रिंग. उदाहरण के लिए: "मुंबई, भारत", "दिल्ली, भारत", "1800 Amphitheatre Parkway, Mountain View, CA 94043" या "CWF6+FWX Mountain View, California"

    • जगह के आईडी

    • अक्षांश और देशांतर निर्देशांक. इसके साथ, वाहन की दिशा की जानकारी भी दी जा सकती है

  • अपनी ज़रूरतों और लक्ष्यों के आधार पर, रास्ते के विकल्पों को बेहतर बनाएं:

  • फ़ील्ड मास्क का इस्तेमाल करके, सिर्फ़ उस डेटा का अनुरोध करें जिसकी आपको ज़रूरत है. इससे, डेटा लोड होने में लगने वाले समय और डेटा क्वालिटी को कंट्रोल किया जा सकता है. साथ ही, अनुरोध की बिलिंग दरों में होने वाली बढ़ोतरी से भी बचा जा सकता है. ज़्यादा जानकारी के लिए, चुनें कि कौनसी जानकारी दिखानी है लेख पढ़ें.

संभावित रास्तों का मैट्रिक्स पाना

Routes API Compute Route Matrix का तरीका, कई शुरू और आखिरी बिंदुओं के बीच सुझाए गए रास्तों के लिए, जानकारी की मैट्रिक उपलब्ध कराता है. इसमें, दूरी और पहुंचने में लगने वाले अनुमानित समय की जानकारी भी शामिल होती है. इससे आपको अपने कारोबार की ज़रूरतों के हिसाब से, सबसे अच्छे ऑरिजिन और डेस्टिनेशन चुनने में मदद मिलती है. दूरी के इस तरह के डेटा का अनुरोध किया जा सकता है:

  • यात्रा के लिए चुने गए मोड की दूरी

  • दूरी, किलोमीटर या मील में

  • ट्रैफ़िक में यात्रा में लगने वाला अनुमानित समय

दूरी के डेटा की मदद से, यात्रियों, शिपमेंट या कर्मचारियों को एक से ज़्यादा संभावित ऑरिजिन और डेस्टिनेशन के बीच भेजने का सबसे सही तरीका तय किया जा सकता है.

पूरे मैट्रिक का हिसाब लगाने से पहले, जवाब के एलिमेंट स्ट्रीम किए जा सकते हैं. इससे जवाब मिलने में लगने वाला समय कम हो जाता है.

हर सर्वर-साइड अनुरोध के लिए, कई ऑरिजिन और डेस्टिनेशन तय किए जा सकते हैं. ऑरिजिन की संख्या और डेस्टिनेशन की संख्या का गुणा 625 तक हो सकता है.

Routes API के काम करने का तरीका

Routes API के दो तरीके हैं: ComputeRoutes और ComputeRouteMatrix.

ComputeRoutes

Routes API ComputeRoutes का तरीका, एचटीटीपी पोस्ट अनुरोध को स्वीकार करता है. इसमें अनुरोध के बारे में जानकारी देने वाला JSON अनुरोध बॉडी होता है. ऑरिजिन, डेस्टिनेशन, travelMode, और फ़ील्ड मास्क की वैल्यू देना ज़रूरी है. इससे यह तय होता है कि कौनसे फ़ील्ड दिखाने हैं.

उदाहरण

curl -X POST -d '{
    "origin": {
      "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043"
    },
    "destination": {
      "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132"
    },
  "travelMode": "DRIVE"
  }' \
  -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
  -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \
  'https://routes.googleapis.com/directions/v2:computeRoutes'

इसके बाद, सेवा अनुरोध किए गए रास्ते का हिसाब लगाती है और आपके अनुरोध किए गए फ़ील्ड दिखाती है.

ComputeRouteMatrix

Routes API ComputeRouteMatrix, एचटीटीपी पोस्ट अनुरोध को स्वीकार करता है. इसमें अनुरोध के बारे में जानकारी देने वाला JSON अनुरोध बॉडी होता है. कम से कम एक ऑरिजिन, दो या उससे ज़्यादा डेस्टिनेशन, travelMode, और फ़ील्ड मास्क की वैल्यू देना ज़रूरी है. इससे यह तय किया जा सकता है कि कौनसे फ़ील्ड दिखाने हैं.

उदाहरण

curl -X POST -d '{
  "origins": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420761,
            "longitude": -122.081356
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.403184,
            "longitude": -122.097371
          }
        }
      }
    }
  ],
  "destinations": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420999,
            "longitude": -122.086894
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.383047,
            "longitude": -122.044651
          }
        }
      }
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \
'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'

जवाब में, ऑरिजिन और डेस्टिनेशन के सभी वेपॉइंट के कॉम्बिनेशन के लिए संभावित रास्ते शामिल होते हैं.

संसाधन

यहां दी गई टेबल में, Routes API के ज़रिए उपलब्ध संसाधनों के साथ-साथ, उससे मिलने वाले डेटा की खास जानकारी दी गई है.

डेटा रिसॉर्स डेटा वापस पाना रिटर्न का फ़ॉर्मैट
ComputeRoutes अनुरोध किए जाने पर, किसी रास्ते के लिए रास्ते, लेग, और चरणों के साथ-साथ, वैकल्पिक रास्तों की जानकारी देता है. JSON
ComputeRouteMatrix किसी ऑरिजिन वॉयपॉइंट से डेस्टिनेशन वॉयपॉइंट तक के रास्तों का ऐरे दिखाता है.

Routes API का इस्तेमाल करने का तरीका

1 सेट अप करना अपना Google Cloud प्रोजेक्ट सेट अप करें से शुरू करें और सेटअप के लिए दिए गए निर्देशों का पालन करें.
2 रास्ता तय करना और जवाब की समीक्षा करना ज़्यादा जानकारी के लिए, रास्ता पाना और रास्ते के जवाबों की समीक्षा करना लेख पढ़ें.
3 रास्तों के मैट्रिक का हिसाब लगाना और जवाब की समीक्षा करना ज़्यादा जानकारी के लिए, रास्ते का मैट्रिक्स पाना और रास्ते के मैट्रिक्स के रिस्पॉन्स की समीक्षा करना लेख पढ़ें.

उपलब्ध क्लाइंट लाइब्रेरी

Routes API के लिए उपलब्ध क्लाइंट लाइब्रेरी की सूची देखने के लिए, क्लाइंट लाइब्रेरी देखें.

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