रास्ते के आस-पास खोजें

किसी रास्ते पर खोज करने के लिए, टेक्स्ट से खोजने की सुविधा (नई) का इस्तेमाल करने के लिए, अनुरोध में Routes API से पहले से तय किया गया रास्ता, पॉलीलाइन के तौर पर पास करें. जवाब में, खोज के लिए इस्तेमाल की गई शर्तों से मैच करने वाली ऐसी जगहें शामिल होती हैं जो तय किए गए रास्ते के आस-पास होती हैं.

रास्ते के आस-पास मौजूद जगहें खोजने के लिए:

1. Routes API का इस्तेमाल करके, ऐसे रास्ते का हिसाब लगाएं जो रिस्पॉन्स में रास्ते की कोड की गई पॉलीलाइन दिखाता हो.

   ध्यान दें: एन्कोड की गई पॉलीलाइन के एल्गोरिदम के फ़ॉर्मैट में बताए गए तरीके से, अपनी पॉलीलाइन को भी एन्कोड किया जा सकता है.

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

डिफ़ॉल्ट रूप से, टेक्स्ट सर्च (नया) की सुविधा, ऑरिजिन से डेस्टिनेशन तक पूरे रास्ते पर खोज करती है. यह रास्ता, पॉलीलाइन के हिसाब से तय होता है. यहां दिए गए उदाहरण में, पॉलीलाइन से रास्ते की जानकारी मिलती है:

• ऑरिजिन: 1600 Amphitheatre Parkway, Mountain View, CA
• डेस्टिनेशन: 24 विली मेज़ प्लाज़ा, सैन फ़्रांसिस्को, सीए

इस रूट के लिए, यात्रा की कोड की गई पॉलीलाइन को स्ट्रिंग से दिखाया गया है:

wblcFptchVIFOd@G@EVw@Ms@dHKR}ApNA`AF~@Hf@TjAb@bBb@~@n@p@^Rd@~@Vz@HVz@nDLt@?d@Kr@c@~@mD`G?`@aEfGkCnDuChDm`@bb@[`@{GhHeEdEciBnnBkC`DkC~DaClEuKjT_Z|l@Qb@iR~_@}EzJ_AdB_Und@kAfCaOjZkg@vcAqBzD_]rr@iBlEaBxEgArD}AlG}AhHsA`IeAnH{@dIq@dJgL~iBq@rHu@vGgAtHwArHaBhHkBzG_DpJ}Nbc@iBhGkA|EgC|LcIjb@oAhG_AvDgAdDkApC_BzCiBpCsFvGii@vn@scAxlAmLjNgSzUeRjT{TzWqExEmG|FuNlMmMhLaRvPqOlNmbAl}@mFlF{PlOmJfIoElE}LtMiSbU_H`I}}@jcAwl@vp@oAbBqA~BeAhCm@tBg@fCWrBQ~BI|DaB~rBO~D[bEa@`Dm@pDaAdE{@vC_BbEkB~Def@|z@sEzHKJeS~]}K`S{\\~l@cXpe@sBpDm@bAuCxDkBrBiC~BwCtByBnAcBx@}Bt@{Bn@gh@|LaOpDeFhAoDj@aE^kVrA_E^iEr@yD~@uBr@gMjF_EnAcCh@eFr@_DRsAD}@Jsu@xCWDqIV}BCeCOyDm@cBa@_DmA}JeE_CwAsBcBiBoBuAqBmOoX{CuEkB_CoDqDkVoUoD{CeE_DkEkC_FeCqB}@sDuAoDgAeCe@cCW}CK}BDaDTeOlBcuBrYaNlBq@Dyd@rGyFt@yBb@eBf@oCnAoBlAkIpGkAp@wBbAaCt@oFdAwKjBoGxA{FbByIjC_HfB_@KmNdDuC|@uFzBcH|C{@\\[?sBv@}@VaBVoA@y@EmAQcA[w@]aBkAeAkA}BuDUKs@uAqBsCwBcCgAiAiN_MyKsJsG{GkBaBiBuA{BwAwDkBcOaHiC_AiCg@}BQcCAcBHqBVkB`@qEjAu@LgCVgAHwG@sG?mABsH^eNr@mBXy@NqBt@uAt@aBlAkAlA}BtCyApBiAdB_BxB{A`B}@j@oAf@s@PeCVcIf@gAAkAQy@YiAo@_A{@_DgEgJqM_DeEaM}PoBiCzAsBw@kAdAGVk@f@q@z@C

ध्यान दें: रास्ते के साथ खोजने की सुविधा, सिर्फ़ एन्कोड की गई पॉलीलाइन के साथ काम करती है. इसे स्ट्रिंग के तौर पर पास किया जा सकता है. साथ ही, इसमें कम से कम डेटा खोने के साथ कंप्रेसन शामिल होता है. यह Routes API का डिफ़ॉल्ट आउटपुट है. ज़्यादा जानकारी के लिए, रास्ते के लिए पॉलीलाइन का अनुरोध करें देखें.

नीचे दिए गए उदाहरण में, खोज के नतीजों को अपने हिसाब से दिखाने के लिए, रास्ते की कोड में बदली गई पॉलीलाइन का इस्तेमाल किया गया है:

  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' \
  'https://places.googleapis.com/v1/places:searchText'

जवाब में, खोज के लिए इस्तेमाल की गई शर्तों से मैच करने वाली जगहें शामिल होती हैं. ये जगहें, रास्ते के हिसाब से चुनी जाती हैं:

  {
    "places": [
      {
        "formattedAddress": "60 Morris St, San Francisco, CA 94107, USA",
        "priceLevel": "PRICE_LEVEL_MODERATE",
        "displayName": {
          "text": "Umami Express",
          "languageCode": "en"
        }
      },
      {
        "formattedAddress": "1130 4th St, San Francisco, CA 94158, USA",
        "priceLevel": "PRICE_LEVEL_MODERATE",
        "displayName": {
          "text": "House of Tadu Ethiopian Kitchen",
          "languageCode": "en"
        }
      },
      {
        "formattedAddress": "1602 El Camino Real Ste A, Belmont, CA 94002, USA",
        "priceLevel": "PRICE_LEVEL_MODERATE",
        "displayName": {
          "text": "Eats Meets West Bowls",
          "languageCode": "en"
        }
      },
      /.../
    ]
  }

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

  curl -X POST -d '{
    "textQuery" : "Spicy Vegetarian Food",
    "searchAlongRouteParameters": {
      "polyline": {
        "encodedPolyline": "ROUTE_POLYLINE"
      }
    },
    "routingParameters": {
      "origin": {
        "latitude": 37.56617,
        "longitude": -122.30870
      }
    }
  }' \
  -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
  -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \
  'https://places.googleapis.com/v1/places:searchText'

ध्यान दें: रास्ते में खोजने की सुविधा, ऐसी जगहों की जानकारी दिखाती है जहां से शुरुआती पॉइंट से मंज़िल तक पहुंचने में कम से कम समय लगता है. इसलिए, अगर शुरुआती पॉइंट और मंज़िल एक ही जगह या एक-दूसरे के आस-पास हैं, तो हो सकता है कि रास्ते में खोजने की सुविधा कोई नतीजा न दिखाए.