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

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

रास्ते के साथ-साथ खोज करने के साथ-साथ रूटिंग की खास जानकारी का हिसाब लगाने के लिए, टेक्स्ट खोज (नई) का इस्तेमाल करने के लिए:

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

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

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

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

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

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 कलेक्शन में मौजूद हर एंट्री के लिए, Text Search (New) दो लेग वाली यात्रा का समय दिखाता है:

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

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

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

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

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

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

  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. लागू करें बटन को चुनें. डायलॉग बॉक्स में, वह खाता चुनें जिसका इस्तेमाल करके आपको अनुरोध करना है.

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