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

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

रूट एपीआई का इस्तेमाल क्यों करना चाहिए

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

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

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

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

  • ट्रैफ़िक का हाल और बंद सड़कें

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

  • रूटिंग की सभी ज़रूरतों के लिए, इंतज़ार के समय, क्वालिटी, और कीमत के बीच संतुलन बनाएं. हालांकि, ऐसा करना ज़रूरी नहीं है टोल और यात्रा का मेटाडेटा जैसी सुविधाएँ, जैसे कि समय और दूरी, और ईंधन दक्षता

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

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

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

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

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

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

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

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

रूट एपीआई Compute Routes तरीके का इस्तेमाल करके, जगहों के बीच हिसाब लगाया जा सकता है:

  • यात्रा के अलग-अलग तरीकों के लिए निर्देश पाना. साथ ही, एक या एक से ज़्यादा गतिविधियों के लिए निर्देश पाना:

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

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

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

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

    • जगह के आईडी

    • अक्षांश और देशांतर निर्देशांक. इसके साथ, वाहन की दिशा की जानकारी भी दी जा सकती है

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

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

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

Routes API 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

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'

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

संसाधन

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

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

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

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

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

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

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