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"

  • जगह के आईडी

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

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

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

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

  • ईटीए को ज़्यादा सटीक बनाने के लिए, वेपॉइंट के लिए वाहन के शीर्षक (यात्रा की दिशा) और सड़क के किनारे की जानकारी सेट करें. ज़्यादा जानकारी के लिए, वाहन का शीर्षक और सड़क के किनारे की जानकारी बताएं देखें.

  • पास-थ्रू बनाम टर्मिनल की जगहें और सुरक्षित स्टॉप वाली जगह की जानकारी दें. ज़्यादा जानकारी के लिए, किसी रास्ते पर एक स्टॉप सेट करना और किसी रास्ते से होकर गुज़रने के लिए एक पॉइंट सेट करना देखें.

  • रास्ते की दूरी और ETA के साथ-साथ टोल की जानकारी मांगें. ज़्यादा जानकारी के लिए, किसी रास्ते के लिए टोल शुल्क कैलकुलेट करना देखें.

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

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

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 अनुरोध के मुख्य हिस्से के साथ एचटीटीपी पोस्ट अनुरोध को स्वीकार करता है, जिसमें अनुरोध की जानकारी होती है. किन फ़ील्ड पर वापस जाना है, यह बताने के लिए कम से कम एक ऑरिजिन, दो या उससे ज़्यादा डेस्टिनेशन, trafficMode, और एक फ़ील्ड मास्क की ज़रूरत होती है.

उदाहरण

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 के लिए उपलब्ध क्लाइंट लाइब्रेरी की सूची देखने के लिए, क्लाइंट लाइब्रेरी देखें.

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

• उपलब्ध रास्ते के विकल्प
• चुनें कि आपको कौनसी जानकारी दिखानी है
• निर्देशों एपीआई या दूरी मैट्रिक्स एपीआई से माइग्रेट करना
• रूट एपीआई की झलक से GA पर माइग्रेट करना