रास्ते की जानकारी का हिसाब लगाना

जवाब में मौजूद हर जगह तक पहुंचने में लगने वाला समय और दूरी का हिसाब लगाने के लिए, टेक्स्ट सर्च (नई) या आस-पास की जगहें ढूंढने की सुविधा (नई) का इस्तेमाल करें:

  1. अनुरोध में routingParameters.origin पैरामीटर पास करें, ताकि रूटिंग की शुरुआत की जगह के अक्षांश और देशांतर के निर्देशांक तय किए जा सकें. इस पैरामीटर की मदद से, जवाब में मौजूद हर जगह की दूरी और वहां पहुंचने में लगने वाले समय का हिसाब लगाया जाता है.

  2. फ़ील्ड मास्क में routingSummaries शामिल करें, ताकि रिस्पॉन्स में routingSummaries अरे शामिल हो. इस ऐरे में, रूटिंग के शुरुआती पॉइंट से लेकर जवाब में मौजूद हर जगह तक की अवधि और दूरी की जानकारी होती है.

एपीआई एक्सप्लोरर की मदद से, लाइव अनुरोध किए जा सकते हैं. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिलती है:

टेक्स्ट से खोजने की सुविधा (नई) का इस्तेमाल करना

नीचे दिए गए अनुरोध में, टेक्स्ट सर्च (नया) के जवाब में मौजूद हर जगह तक पहुंचने में लगने वाले समय और दूरी का हिसाब लगाया गया है:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia",
  "routingParameters": {
    "origin": {
      "latitude": -33.8688,
      "longitude": 151.1957362
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,routingSummaries' \
'https://places.googleapis.com/v1/places:searchText'

रिस्पॉन्स में दो JSON कलेक्शन शामिल हैं: places कलेक्शन में, मैच करने वाली जगहें शामिल हैं. वहीं, routingSummaries कलेक्शन में, हर जगह तक पहुंचने में लगने वाला समय और दूरी शामिल है:

{
  "places": [
    {
      object (Place)
    }
  ]
  "routingSummaries": [
    {
      object (RoutingSummary)
    }
}

routingSummaries कलेक्शन में मौजूद हर एलिमेंट, places कलेक्शन में मौजूद एलिमेंट की जगह पर होता है. इसका मतलब है कि routingSummaries[0] पर मौजूद एलिमेंट, places[0] पर मौजूद जगह से मेल खाता है.

routingSummaries की ऐरे की लंबाई, places की ऐरे की लंबाई के बराबर है. अगर किसी जगह के लिए routingSummary उपलब्ध नहीं है, तो ऐरे की एंट्री खाली होती है.

इस उदाहरण में, रूटिंग के शुरुआती पॉइंट से हर जगह की दूरी और वहां पहुंचने में लगने वाले समय का हिसाब लगाया जाता है. इसलिए, जवाब में मौजूद routingSummaries.legs फ़ील्ड में एक Leg ऑब्जेक्ट होता है. इसमें रूटिंग के शुरुआती पॉइंट से जगह की duration और distanceMeters की जानकारी होती है.

{
  "places": [
    {
      "formattedAddress": "1, Westfield Sydney Central Plaza, 450 George St, Sydney NSW 2000, Australia",
      "displayName": {
        "text": "Gözleme King Sydney",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia",
      "priceLevel": "PRICE_LEVEL_MODERATE",
      "displayName": {
        "text": "Mother Chu's Vegetarian Kitchen",
        "languageCode": "en"
      }
    },
    …
  ]
  "routingSummaries": [
    {
      "legs": [
        {
          "duration": "597s",
          "distanceMeters": 2607
        }
      ],
      "directionsUri": "https://www.google.com/maps/dir/-33.8688,151.1957362/''/data=!4m6!4m5!1m0!1m2!1m1!1s0x6b12ae3fa97cd745:0x6aecf365bf497c08!3e0"
    },
    {
      "legs": [
        {
          "duration": "562s",
          "distanceMeters": 2345
        }
      ],
      "directionsUri": "https://www.google.com/maps/dir/-33.8688,151.1957362/''/data=!4m6!4m5!1m0!1m2!1m1!1s0x6b12ae3da97f60c1:0x845f3273bd764f6c!3e0"
    },
   …
  ]
}

इस उदाहरण में, आपको दिखेगा कि रूटिंग के शुरुआती पॉइंट से नतीजों में मौजूद पहली जगह तक पहुंचने में 597 सेकंड और 2607 मीटर लगते हैं.

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

  curl -X POST -d '{
    "includedTypes": ["restaurant"],
    "maxResultCount": 10,
    "locationRestriction": {
      "circle": {
        "center": {
          "latitude": -33.8688,
          "longitude": 151.1957362},
        "radius": 500.0
      }
    },
    "routingParameters": {
      "origin": {
        "latitude": -33.8688,
        "longitude": 151.1957362
      }
    }
  }' \
  -H 'Content-Type: application/json' -H "X-Goog-Api-Key:API_KEY" \
  -H "X-Goog-FieldMask: places.displayName,routingSummaries" \
  https://places.googleapis.com/v1/places:searchNearby

आपको locationRestriction और रूटिंग के मूल स्थान के लिए एक ही कोऑर्डिनेट का इस्तेमाल करने की ज़रूरत नहीं है. उदाहरण के लिए, आपने खोज के नतीजों को उस सर्कल के हिसाब से दिखाने के लिए, locationRestriction को सिडनी के सेंटर पॉइंट पर सेट किया. हालांकि, बाद में आपने रूटिंग के लिए शुरुआती जगह के तौर पर अपने घर के निर्देशांक सेट किए. इसका मतलब है कि आपने खोज के दायरे में मौजूद किसी दूसरी जगह को चुना. इसके बाद, अनुरोध के आधार पर खोज के नतीजों में सर्कल को प्राथमिकता दी जाती है. साथ ही, आपके घर की जगह की जानकारी के आधार पर रास्ते की खास जानकारी का हिसाब लगाया जाता है.

यात्रा के विकल्प तय करना

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

  • routingParameters.travelMode पैरामीटर का इस्तेमाल करके, परिवहन के मोड को DRIVE, BICYCLE, WALK या TWO_WHEELER पर सेट करें. इन विकल्पों के बारे में ज़्यादा जानने के लिए, रास्तों के लिए उपलब्ध वाहन के टाइप लेख पढ़ें.

  • routingParameters.routingPreference प्रॉपर्टी का इस्तेमाल करके, राउटिंग की प्राथमिकता के विकल्प को TRAFFIC_UNAWARE (डिफ़ॉल्ट), TRAFFIC_AWARE या TRAFFIC_AWARE_OPTIMAL पर सेट करें. हर विकल्प में, डेटा क्वालिटी और डेटा मिलने में लगने वाले समय का लेवल अलग-अलग होता है. ज़्यादा जानकारी के लिए, यह तय करना कि ट्रैफ़िक डेटा को कैसे और शामिल करना है या नहीं लेख पढ़ें.

    routingParameters.routingPreference प्रॉपर्टी का असर, झलक (प्री-जीए) directionsUri फ़ील्ड में मौजूद निर्देशों पर पड़ता है. इसकी वजह यह है कि Google Maps, लिंक खोलने पर ट्रैफ़िक के विकल्प दिखाता है.

  • avoidTolls, avoidHighways, avoidFerries, और avoidIndoor को यह बताने के लिए, routingParameters.routeModifiers प्रॉपर्टी का इस्तेमाल करें. इन विकल्पों के बारे में ज़्यादा जानकारी के लिए, रास्ते की उन सुविधाओं के बारे में बताना जिन्हें आपको शामिल नहीं करना है लेख पढ़ें.

यहां दिए गए उदाहरण में, यात्रा के मोड को DRIVE के तौर पर सेट किया गया है. साथ ही, हाइवे से बचने के लिए:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia",
  "routingParameters": {
    "origin": {
      "latitude": -33.8688,
      "longitude": 151.1957362
    },
    "travelMode":"DRIVE",
    "routeModifiers": {
      "avoidHighways": true
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,routingSummaries' \
'https://places.googleapis.com/v1/places:searchText'

इसे आज़माएं!

APIs Explorer की मदद से, सैंपल अनुरोध किए जा सकते हैं. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिलती है.

  1. पेज की दाईं ओर मौजूद, एपीआई आइकॉन api चुनें.

  2. अनुरोध के पैरामीटर में बदलाव करें. यह ज़रूरी नहीं है.

  3. लागू करें बटन को चुनें. डायलॉग बॉक्स में, वह खाता चुनें जिसका इस्तेमाल करके आपको अनुरोध करना है.

  4. APIs Explorer पैनल में, फ़ुलस्क्रीन आइकॉन fullscreen को चुनें, ताकि APIs Explorer विंडो को बड़ा किया जा सके.

पीछे जाएं
रास्ते के आस-पास खोजें
आगे बढ़ें
रास्ते की खास जानकारी को रास्ते के हिसाब से खोजने की सुविधा के साथ जोड़ें