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 तक डेस्टिनेशन की संख्या से गुणा किया जाता है.

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

रूट एपीआई में दो तरीके हैं: 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 एपीआई के ज़रिए उपलब्ध संसाधनों की खास जानकारी दी गई है. साथ ही, इससे मिलने वाला डेटा भी शामिल किया गया है.

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

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

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

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

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

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