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

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

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 सेकंड लगते हैं और इसकी दूरी 2, 607 मीटर है.

आस-पास की जगहों की जानकारी पाने की सुविधा का इस्तेमाल करना

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

  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 विंडो बड़ी हो जाएगी.