रास्ते की खास जानकारी और रास्ते में पड़ने वाली जगहों को खोजने की सुविधा को एक साथ इस्तेमाल करना

रास्ते की खास जानकारी के हिसाब-किताब को रास्ते में पड़ने वाली जगहों को खोजने की सुविधा के साथ जोड़ा जा सकता है. इस मामले में, टेक्स्ट से खोजें (नया), जवाब में हर जगह की यात्रा में लगने वाले समय और दूरी की जानकारी दिखाता है. इसके बाद, हर जगह से रास्ते के आखिरी डेस्टिनेशन तक की जानकारी दिखाता है.

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

1. Routes API का इस्तेमाल करके, ऐसा रास्ता कैलकुलेट करें जो जवाब में रास्ते की पॉलीलाइन दिखाता हो.

2. searchAlongRouteParameters.polyline.encodedPolyline पैरामीटर का इस्तेमाल करके, टेक्स्ट से खोजें (नया वर्शन) सुविधा को रूट की पॉलीलाइन पास करें. इससे खोज के नतीजों को रूट के हिसाब से बायस किया जा सकता है. इसके बाद, रिस्पॉन्स में ऐसी जगहें शामिल होती हैं जो खोज के लिए तय की गई शर्तों से मेल खाती हैं. साथ ही, वे तय किए गए रास्ते के आस-पास मौजूद होती हैं.

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

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

डिफ़ॉल्ट रूप से, टेक्स्ट से खोजें (नई सुविधा) पूरे रास्ते पर खोज करती है:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food",
  "searchAlongRouteParameters": {
    "polyline": {
      "encodedPolyline": "ROUTE_POLYLINE"
    }
  }
}' \
-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'

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

{
  "places": [
    {
      "formattedAddress": "1199 El Camino Real, San Bruno, CA 94066, USA",
      "priceLevel": "PRICE_LEVEL_INEXPENSIVE",
      "displayName": {
        "text": "Vegan Mob - Vegan BBQ and Soul Food",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "839 Kearny St, San Francisco, CA 94108, USA",
      "priceLevel": "PRICE_LEVEL_MODERATE",
      "displayName": {
        "text": "Enjoy Vegetarian",
        "languageCode": "en"
      }
    },
   …
],
  "routingSummaries": [
    {
      "legs": [
        {
          "duration": "285s",
          "distanceMeters": 1616
        },
        {
          "duration": "2466s",
          "distanceMeters": 58147
        }
      ],
      "directionsUri": "https://www.google.com/maps/dir/37.42268,-122.08473/''/37.77877,-122.38781/data=!4m7!4m6!1m0!1m2!1m1!1s0x808f87f9ede375f5:0xa37171fea1a16b28!1m0!3e0"
    },
    {
      "legs": [
        {
          "duration": "696s",
          "distanceMeters": 4704
        },
        {
          "duration": "2787s",
          "distanceMeters": 58901
        }
      ],
      "directionsUri": "https://www.google.com/maps/dir/37.42268,-122.08473/''/37.77877,-122.38781/data=!4m7!4m6!1m0!1m2!1m1!1s0x808580f4cebdb06f:0xd3af09e5742234f2!1m0!3e0"
    },
   …
  ]
}

legs कलेक्शन में मौजूद हर एंट्री के लिए, टेक्स्ट से खोजें (नया) सुविधा, यात्रा के समय को दो हिस्सों में बांटकर दिखाती है:

• पहले चरण में, यात्रा शुरू करने की जगह से मंज़िल तक पहुंचने में लगने वाला समय और दूरी की जानकारी होती है. इस उदाहरण में, शुरुआती जगह से नतीजों में मौजूद पहली जगह तक पहुंचने में लगने वाला समय और दूरी, 285 सेकंड और 1,616 मीटर है.

• दूसरे चरण में, जगह से रास्ते की मंज़िल तक की यात्रा की अवधि और दूरी शामिल होती है. इस उदाहरण में, अवधि और दूरी 2,466 सेकंड और 58,147 मीटर है.

रास्ते की शुरुआत की जगह, यात्रा का मोड, और रास्ते में बदलाव करने वाले पैरामीटर तय करना

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

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

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

  curl -X POST -d '{
    "textQuery" : "Spicy Vegetarian Food",
    "maxResultCount": 5,
    "searchAlongRouteParameters": {
      "polyline": {
        "encodedPolyline": "ROUTE_POLYLINE"
      }
    },
    "routingParameters": {
      "origin": {
        "latitude": 37.56617,
        "longitude": -122.30870
      },
      "travelMode":"DRIVE",
      "routeModifiers": {
        "avoidTolls": 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. Execute बटन को चुनें. डायलॉग बॉक्स में, वह खाता चुनें जिसका इस्तेमाल करके आपको अनुरोध करना है.

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