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

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

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

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

  • यात्रा के अलग-अलग साधनों का टाइप और क्षमता

  • कोई वाहन किस दिशा में है

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

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

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

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

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

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

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

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

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

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

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

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

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

  • यात्रा करने के अलग-अलग तरीकों के लिए और एक या एक से ज़्यादा मंज़िलों के लिए दिशा-निर्देश पाएं:

    • परिवहन के साधन, जैसे कि बस, मेट्रो वगैरह, ड्राइविंग, दोपहिया वाहन, पैदल या साइकल से.

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

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

    • टेक्स्ट स्ट्रिंग. उदाहरण के लिए: "शिकागो, IL", "Darwin, NT, Australia" "1800 Amphitheatre Parkway, Mountain View, CA 94043" या "CWF6+FWX Mountain View, California"

    • जगह के आईडी

    • अक्षांश और देशांतर निर्देशांक, वाहन की हेडिंग के साथ विकल्प

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

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

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

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

  • यात्रा के चुने गए साधन के लिए दूरी

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

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

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

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

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

रूट एपीआई कैसे काम करता है

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

रूट एपीआई 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 रास्तों के मैट्रिक का हिसाब लगाना और जवाब की समीक्षा करना ज़्यादा जानकारी के लिए, रास्ते का मैट्रिक्स पाना और रास्ते के मैट्रिक्स के रिस्पॉन्स की समीक्षा करना लेख पढ़ें.

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

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

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