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

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

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

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

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

  • कोई वाहन किस दिशा में है

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

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

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

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

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

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

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

रूट एपीआई की मदद से क्या-क्या किया जा सकता है?

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

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

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

एक या एक से ज़्यादा गंतव्यों के लिए रास्ते पाएं

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

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

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

    • वेपॉइंट की एक सीरीज़, जिसे आप सबसे बेहतर ढंग से काम करने के लिए ऑप्टिमाइज़ कर सकते हैं सफ़र करना आसान हो जाता है.

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

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

    • जगह के आईडी

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

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

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

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

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

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

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

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

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

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

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

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

रूट एपीआई में दो तरीके हैं: ComputeRoutes और ComputeRouteMatrix.

ComputeRoutes

रूट एपीआई 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'

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

संसाधन

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

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

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

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

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

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

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