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

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

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 लिंक खोलने पर ट्रैफ़िक के विकल्प दिखाता है.

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

यहां दिए गए उदाहरण में, यात्रा के मोड को 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 विंडो बड़ी हो जाएगी.