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

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 के काम करने का तरीका

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 किसी ऑरिजिन वॉयपॉइंट से डेस्टिनेशन वॉयपॉइंट तक के रास्तों का ऐरे दिखाता है.

रूट एपीआई को इस्तेमाल करने का तरीका

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

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

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

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