रास्ते की खास जानकारी को, रास्ते में पड़ने वाली जगहें खोजने की सुविधा के साथ जोड़ना
रास्ते की खास जानकारी के कैलकुलेशन को रास्ते में पड़ने वाली जगहें खोजने की सुविधा के साथ जोड़ा जा सकता है. इस मामले में, टेक्स्ट सर्च (नया), जवाब में हर जगह के लिए यात्रा की अवधि और दूरी दिखाता है. इसके बाद, हर जगह से रास्ते के आखिरी डेस्टिनेशन तक की दूरी दिखाता है.
किसी रास्ते पर खोज के साथ-साथ, रास्ते की खास जानकारी का हिसाब लगाने के लिए, टेक्स्ट खोज (नया) का इस्तेमाल करने के लिए:
-
Routes API का इस्तेमाल करके, ऐसे रास्ते का हिसाब लगाएं जो रिस्पॉन्स में रास्ते की पॉलीलाइन दिखाता हो.
-
searchAlongRouteParameters.setPolyline()का इस्तेमाल करके, रास्ते की पॉलीलाइन को टेक्स्ट खोज (नया) में पास करें, ताकि खोज के नतीजों में रास्ते के हिसाब से बदलाव किया जा सके. इसके बाद, रिस्पॉन्स में ऐसी जगहें शामिल होती हैं जो खोज के लिए तय की गई शर्तों से मेल खाती हैं और तय किए गए रास्ते के आस-पास हैं. -
अनुरोध ऑब्जेक्ट बनाते समय,
.setRoutingSummariesIncluded(true)जोड़ें.
डिफ़ॉल्ट रूप से, टेक्स्ट सर्च (नया) पूरे रास्ते पर खोज करता है:
// Define the route polyline object using the route string. EncodedPolyline encodedPolyline = EncodedPolyline.newInstance("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 "); // Specify the list of fields to return. final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME); // Define the search along route parameters object and pass the polyline object. SearchAlongRouteParameters searchAlongRouteParameters = SearchAlongRouteParameters.builder() .setPolyline(encodedPolyline) .build(); // Use the builder to create a SearchByTextRequest object and pass the search along route parameters. final SearchByTextRequest searchByTextRequest = SearchByTextRequest.builder("Spicy Vegetarian Food", placeFields) .setMaxResultCount(10) .setSearchAlongRouteParameters(searchAlongRouteParameters) .setRoutingSummariesIncluded(true) .build(); // Call PlacesClient.searchByText() to perform the search. // Define a response handler to process the returned List of Place objects. placesClient.searchByText(searchByTextRequest) .addOnSuccessListener(response -> { List<Place> places = response.getPlaces(); List<RoutingSummary> routingSummaries = response.getRoutingSummaries(); List<Leg> legs = routingSummaries.get(0).getLegs(); Duration duration = legs.get(0).getDuration(); });
जवाब में ऐसे ऑब्जेक्ट होते हैं जिनमें अनुरोध की गई जगहों के फ़ील्ड की सूचियां और हर जगह की यात्रा में लगने वाले समय और दूरी की जानकारी देने वाली रूटिंग की खास जानकारी शामिल होती है.
रूटिंग की खास जानकारी वाली सूची देखने के लिए, SearchByTextResponse.getRoutingSummaries() को कॉल किया जा सकता है.
legs कलेक्शन में मौजूद हर एंट्री के लिए, टेक्स्ट सर्च (नया) दो हिस्सों में यात्रा का समय दिखाता है:
-
पहले चरण में, यात्रा की अवधि और ऑरिजिन से जगह तक की दूरी शामिल होती है.
-
दूसरे चरण में, यात्रा की अवधि और जगह से राइड के डेस्टिनेशन तक की दूरी शामिल होती है.
रूटिंग के ऑरिजिन, यात्रा के मोड, और रूट में बदलाव करने वाले निर्देशों की जानकारी देना
खोज और रास्ते की जानकारी की गिनती में बदलाव किया जा सकता है. इसके लिए, आपको रास्ते की शुरुआत, यात्रा का मोड, रास्ते में बदलाव करने वाले फ़ंक्शन, और रास्ते की प्राथमिकताएं तय करनी होंगी. यात्रा के विकल्पों की जानकारी दें विषय में दिखाए गए तरीके के मुताबिक, यात्रा का मोड और रास्ता बदलने वाले टूल, रास्ता तय किए बिना रास्ते की खास जानकारी का हिसाब लगाने के लिए भी उसी तरह काम करते हैं.
डिफ़ॉल्ट रूप से, हर नतीजे के पहले चरण में, ऑरिजिन से हर जगह की दूरी होती है. यह दूरी, पॉलीलाइन से तय की जाती है. हालांकि, अनुरोध में रूटिंग ऑरिजिन के बारे में साफ़ तौर पर बताकर, उस डिफ़ॉल्ट वैल्यू को बदला जा सकता है. अगर यह जानकारी दी गई है, तो सभी रिस्पॉन्स के पहले चरण में, तय किए गए रूटिंग ऑरिजिन से दूरी और समय की जानकारी दी जाती है. इससे पॉलीलाइन से ऑरिजिन की जानकारी बदल जाती है.
अगले उदाहरण में, सैन मैटेओ, कैलिफ़ोर्निया के निर्देशांक के तौर पर, रूटिंग के ऑरिजिन की जानकारी दी गई है. साथ ही, टोल से बचने के लिए कहा गया है और नतीजों की संख्या को पांच पर सेट किया गया है:
// Define the route polyline object using the route string. EncodedPolyline encodedPolyline = EncodedPolyline.newInstance("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 "); // Specify the list of fields to return. final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME); // Define the routing modifiers object. RouteModifiers routeModifiers = RouteModifiers.builder() .setAvoidTolls(true) .build(); // Define the routing parameters object and pass the routing origin. // Set the travel mode to DRIVE. // Pass the routeModifiers object. RoutingParameters routingParameters = RoutingParameters.builder() .setOrigin(toLatLng("37.56617, -122.30870")) .setTravelMode(DRIVE) .setRouteModifiers(routeModifiers) .build(); // Define the search along route parameters object and pass the polyline object. SearchAlongRouteParameters searchAlongRouteParameters = SearchAlongRouteParameters.builder() .setPolyline(encodedPolyline) .build(); // Use the builder to create a SearchByTextRequest object and pass the search along route parameters. final SearchByTextRequest searchByTextRequest = SearchByTextRequest.builder("Spicy Vegetarian Food", placeFields) .setMaxResultCount(5) .setRoutingParameters(routingParameters) .setSearchAlongRouteParameters(searchAlongRouteParameters) .setRoutingSummariesIncluded(true) .build(); // Call PlacesClient.searchByText() to perform the search. // Define a response handler to process the returned List of Place objects. placesClient.searchByText(searchByTextRequest) .addOnSuccessListener(response -> { List<Place> places = response.getPlaces(); List<RoutingSummary> routingSummaries = result.getRoutingSummaries(); List<Leg> legs = routingSummaries.get(0).getLegs(); Duration duration = legs.get(0).getDuration(); });
यहां दी गई इमेज में एक मैप दिखाया गया है. इसमें रास्ते की पॉलीलाइन, ऑरिजिन की नई जगह (हल्का नीला पिन), और खोज के नतीजों में दिखने वाली जगहें (हरे पिन) शामिल हैं. ध्यान दें कि सभी नतीजे, रास्ते पर मौजूद हैं, लेकिन सैन मेटो के बाद के हैं:
