कैलकुलेट किए गए रास्तों की खास जानकारी

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

परिचय

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

क्या आपको रूट मैट्रिक्स की ज़रूरत है? अगर आपको रूट मैट्रिक्स में दिलचस्पी है, तो Compute Route Matrix की खास जानकारी देखें.

क्या आपको माइग्रेट करना है? अगर आपको Distance Matrix API (लेगसी) से माइग्रेट करना है, तो माइग्रेशन के निर्देश देखें. इसकी शुरुआत Routes API पर माइग्रेट क्यों करें से करें.

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

Compute Routes की मदद से, रास्ते की ज़्यादा जानकारी मिलती है. इससे, लागत और क्वालिटी को ऑप्टिमाइज़ करते हुए, अपनी पसंद के मुताबिक वाहनों या पैकेज को रूट किया जा सकता है.

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

Routes API के Compute Routes तरीके का इस्तेमाल करके, ये काम किए जा सकते हैं:

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

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

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

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

    • टेक्स्ट स्ट्रिंग. उदाहरण के लिए: "Chicago, IL", "Darwin, NT, Australia", "1800 Amphitheatre Parkway, Mountain View, CA 94043" या "CWF6+FWX Mountain View, California"

    • जगह के आईडी

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

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

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

Compute Routes कैसे काम करता है

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'

इसके बाद, सेवा अनुरोध किए गए रास्ते का हिसाब लगाती है और आपके अनुरोध किए गए फ़ील्ड दिखाती है.

संसाधन

नीचे दी गई टेबल में, Routes API के Compute Routes तरीके से उपलब्ध संसाधनों की खास जानकारी दी गई है. साथ ही, इससे मिलने वाले डेटा की जानकारी भी दी गई है.

डेटा रिसॉर्स डेटा के आधार पर मिली जानकारी जवाब का फ़ॉर्मैट
ComputeRoutes यह किसी रास्ते के लिए रूट, लेग, और स्टेप दिखाता है. साथ ही, अनुरोध किए जाने पर, वैकल्पिक रास्ते भी दिखाता है. JSON

Compute Routes का इस्तेमाल कैसे करें

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

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

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

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