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

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

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

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 विंडो को बड़ा किया जा सके.