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

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

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

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

  • परिवहन के अलग-अलग साधनों के टाइप और उनकी क्षमताएं

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

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

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

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

  • टोल और यात्रा के मेटाडेटा, जैसे कि समय और दूरी, ईंधन की बचत, और

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

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

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

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

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

  • किसी जगह से सफ़र और एक या उससे ज़्यादा मंज़िलों तक के रूट

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

एक या एक से ज़्यादा मंज़िलों के लिए रास्ते देखें

Routes API Compute Routes तरीके का इस्तेमाल करके, इन जगहों के बीच कैलकुलेट किया जा सकता है:

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

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

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

  • ऑरिजिन, डेस्टिनेशन, और वेपॉइंट के बारे में जानकारी देने के कई तरीके:

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

    • जगह के आईडी

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

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

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

संभावित रास्तों का मैट्रिक्स देखें

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

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

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

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

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

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

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

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

Routes API में दो तरीके इस्तेमाल किए जा सकते हैं: ComputeRoute और ComputeRouteMatrix.

ComputeRoute

Routes API ComputeRoute वाला तरीका, 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'

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

संसाधन

नीचे दी गई टेबल में, रूट एपीआई के ज़रिए उपलब्ध संसाधनों और उनसे मिलने वाले डेटा की खास जानकारी दी गई है.

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

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

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

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

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

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