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

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

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

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

• पहले चरण में, यात्रा शुरू करने की जगह से मंज़िल तक पहुंचने में लगने वाला समय और दूरी शामिल होती है. इस उदाहरण में, नतीजे में पहली जगह पर मौजूद जगह तक पहुंचने में लगने वाला समय और दूरी 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 की विंडो बड़ी हो जाएगी.