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

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

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

  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 सेकंड और 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'

यहां दी गई इमेज में एक मैप दिखाया गया है. इसमें रास्ते की पॉलीलाइन, नई जगह (हल्का नीला पिन), और खोज के नतीजों में दिखने वाली जगहें (हरे पिन) शामिल हैं. ध्यान दें कि सभी नतीजे, रास्ते पर हैं, लेकिन सैन मेटो के बाद के:

अपडेट के सोर्स से मिले खोज के नतीजे.
पीछे जाएं
रूटिंग सारांश की गणना करें