Maps के यूआरएल या Places API की मदद से, उपयोगकर्ताओं को Google Maps पर जगहों की जानकारी और रास्ते की जानकारी पर ले जाना

आज के दौर में, लोग अपनी जगह की जानकारी के हिसाब से चीज़ें ढूंढते हैं. इसलिए, वे चाहते हैं कि उन्हें किसी जगह की जानकारी, दिशा-निर्देश, और नेविगेशन की सुविधा आसानी से मिले. चाहे वह मेसेंजर ऐप्लिकेशन हो, स्थानीय कॉन्टेक्स्ट की जानकारी देने वाला ऐप्लिकेशन हो, लॉजिस्टिक्स और परिवहन प्लैटफ़ॉर्म हो, यात्रा की योजना बनाने वाला ऐप्लिकेशन हो या रियल एस्टेट लिस्टिंग प्लैटफ़ॉर्म हो, उपयोगकर्ताओं को अक्सर जगह की जानकारी तुरंत देखनी होती है या एक जगह से दूसरी जगह तक जाने का सबसे अच्छा रास्ता ढूंढना होता है. डेवलपर, ऐप्लिकेशन में अपना अनुभव बना सकते हैं. हालांकि, Google Maps के जाने-पहचाने और बेहतर इंटरफ़ेस का इस्तेमाल करने से, उपयोगकर्ताओं को बेहतर अनुभव मिलता है.

उपयोगकर्ताओं को बेहतर अनुभव देने के लिए, Google Maps का यूआरएल सही तरीके से बनाया जाना ज़रूरी है. गलत यूआरएल की वजह से, लोगों को खराब अनुभव मिलता है. इससे लोगों को गलत जगह पर रीडायरेक्ट किया जाता है, उन्हें खास जानकारी के बजाय सामान्य मैप व्यू दिखाया जाता है या लिंक भी काम नहीं करता. इससे उपयोगकर्ताओं को परेशानी होती है और वे अपना काम पूरा नहीं कर पाते. उदाहरण के लिए, Maps का मान्य यूआरएल होने के बावजूद, हो सकता है कि किसी उपयोगकर्ता को किसी खास कारोबार के बारे में जानकारी न मिले. इसके बजाय, उसे मैप का सामान्य व्यू दिखे, जिसमें काम की कोई जानकारी न हो. यहां दिया गया उदाहरण देखें: 

https://www.google.com/maps/search/?api=1&query=-33.8567%2C151.2152

इस Maps यूआरएल का इस्तेमाल, Google Maps खोलने और अक्षांश और देशांतर के आधार पर किसी जगह की जानकारी दिखाने के लिए किया जा सकता है. हालांकि, यह लोगों को किसी खास जगह के बारे में जानकारी नहीं देता.

सिर्फ़ अक्षांश और देशांतर का इस्तेमाल करके खोजना
सिर्फ़ अक्षांश और देशांतर का इस्तेमाल करके खोजना

सही यूआरएल की मदद से, अपने ऐप्लिकेशन को Google Maps से आसानी से कनेक्ट करना

Google Maps पर जगह की जानकारी वाला पेज खोलना
Maps का यूआरएल, उपयोगकर्ताओं को Google Maps पर उस जगह की ज़्यादा जानकारी वाले पेज पर ले जाता है. इस यूआरएल में जगह का यूनीक नाम होता है

Google Maps Platform (GMP), सटीक यूआरएल बनाने के लिए दो मुख्य तरीके उपलब्ध कराता है: Places API (नया) और Maps यूआरएल. Places API (नया) के लिए एपीआई पासकोड की ज़रूरत होती है. वहीं, Maps यूआरएल मुफ़्त में उपलब्ध हैं और इनके लिए पासकोड की ज़रूरत नहीं होती. यहां दिए गए समाधान, अलग-अलग स्थितियों और इस्तेमाल के उदाहरणों के लिए हैं:

GMP Places API(नया), किसी जगह के बारे में पूरी जानकारी देता है. googleMapsUri या googleMapsLinks फ़ील्ड का अनुरोध करते समय, एपीआई से मिले जवाब में जगह की जानकारी वाला ऑब्जेक्ट शामिल होता है. इसके लिए, फ़ील्ड मास्क में फ़ील्ड की जानकारी दें. इस ऑब्जेक्ट में पहले से फ़ॉर्मैट किए गए यूआरएल होते हैं. इनका इस्तेमाल, Google Maps में सीधे तौर पर जगह की जानकारी वाला व्यू खोलने के लिए किया जा सकता है.

उदाहरण:

जगह की जानकारी के लिए अनुरोध

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: YOUR_API_KEY" \
-H "X-Goog-FieldMask: googleMapsUri,googleMapsLinks" \
https://places.googleapis.com/v1/places/ChIJ3S-JXmauEmsRUcIaWtf4MzE

जगह की जानकारी के बारे में जवाब:

{
    "googleMapsUri": "https://maps.google.com/?cid=3545450935484072529",
    "googleMapsLinks": {
        "directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!3e0",
        "placeUri": "https://maps.google.com/?cid=3545450935484072529",
        "writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!12e1",
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!9m1!1b1",
        "photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!10e5"
    }
}

ऊपर दिए गए उदाहरण में ChIJ3S-JXmauEmsRUcIaWtf4MzE, सिडनी ओपेरा हाउस का प्लेस आईडी है. जगह का आईडी, टेक्स्ट वाला एक ऐसा आइडेंटिफ़ायर होता है जो Google Places के डेटाबेस और Google Maps पर मौजूद किसी जगह की खास तौर पर पहचान करता है.

बिना किसी शुल्क के जगह के आईडी पाना

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

Places API Text Search(ID Only) अनुरोध:

curl -X POST -d '{"textQuery" : "Sydney Opera House"}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: places.id' \
'https://places.googleapis.com/v1/places:searchText'

Places API Text Search(ID Only) Response:

{
  "places": [
    {
      "id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
    }
  ]
}

जब कोई उपयोगकर्ता मैप पर किसी जगह के नाम पर क्लिक या टैप करता है, तब भी जगह के आईडी वापस पाए जा सकते हैं. क्लिक किए जा सकने वाले पीओएस आइकॉन के बारे में ज़्यादा जानें(JavaScript, Android, iOS)

लागू करना

Places API का इस्तेमाल करते समय, डेवलपर रिस्पॉन्स से googleMapsUri या googleMapsLinks फ़ील्ड को आसानी से निकाल सकते हैं. इसके बाद, वे इसका इस्तेमाल Google Maps ऐप्लिकेशन में या ऐप्लिकेशन इंस्टॉल न होने पर ब्राउज़र में, उससे जुड़ा व्यू लॉन्च करने के लिए कर सकते हैं.

सुविधा ब्यौरा
directionsUri Google Maps खोलने का लिंक, ताकि उपयोगकर्ता की मौजूदा जगह से इस जगह तक के निर्देश दिखाए जा सकें
placeUri इस जगह की जानकारी वाले पेज पर जाने के लिए, Google Maps खोलने का लिंक
writeAReviewUri इस जगह के लिए, समीक्षा लिखने वाला पेज खोलने के लिए Google Maps का लिंक
reviewsUri इस जगह के लिए, समीक्षाएं पेज पर Google Maps खोलने का लिंक
photosUri इस जगह के फ़ोटो पेज पर Google Maps खोलने का लिंक

डेवलपर के लिए दिशा-निर्देश देखें और आज ही इस सुविधा को आज़माएं.

Maps के यूआरएल का इस्तेमाल करना

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

मैप पर ये कार्रवाइयां की जा सकती हैं:

  • खोज सुविधा, Google Maps ऐप्लिकेशन लॉन्च करती है. अगर ऐप्लिकेशन इंस्टॉल नहीं है, तो यह सुविधा ब्राउज़र में लॉन्च होती है. यह सुविधा, किसी खास जगह के लिए पिन दिखाती है या सामान्य खोज करती है और नतीजे दिखाने के लिए मैप लॉन्च करती है.

  • रास्ता दिखाने की सुविधा, Google Maps ऐप्लिकेशन को लॉन्च करती है. अगर ऐप्लिकेशन इंस्टॉल नहीं है, तो यह सुविधा ब्राउज़र में लॉन्च होती है. यह सुविधा, दो जगहों के बीच का रास्ता दिखाती है. साथ ही, मोबाइल डिवाइसों पर Google Maps में मोड़-दर-मोड़ नेविगेशन की सुविधा चालू करती है.

  • Street View पैनोरमा फ़ंक्शन की मदद से, व्यूअर लॉन्च किया जा सकता है. इससे Street View की इमेज को इंटरैक्टिव पैनोरमा के तौर पर दिखाया जा सकता है.

ज़्यादा फ़ंक्शन और उदाहरण देखने के लिए, GMP Maps के यूआरएल के डेवलपर दस्तावेज़ पर जाएं.

यहां हम Maps के यूआरएल की दो मुख्य सुविधाओं के बारे में जानकारी देते हैं:

  • Google Maps पर जगह की जानकारी दिखाना: इस सेक्शन में, ऐसे यूआरएल बनाने का तरीका बताया गया है जो Google Maps पर किसी जगह की जानकारी दिखाएंगे. इसमें यह भी बताया गया है कि एक जैसे नाम वाली जगहों के साथ काम करने के लिए, जगह के आईडी और सटीक क्वेरी का इस्तेमाल कैसे किया जाता है.

  • Maps के यूआरएल का इस्तेमाल करके रास्ते की जानकारी देना: इस सेक्शन में बताया गया है कि उन यूआरएल को कैसे बनाया जाए जो जगहों के बीच रास्ते की जानकारी देते हैं. इसमें कई वेपॉइंट और मोड़-दर-मोड़ रास्ते की जानकारी देने वाले यूआरएल शामिल हैं.

Google Maps पर जगह की जानकारी दिखाना

जगहों को खोजने के लिए, Search फ़ंक्शन दो पैरामीटर लेता है. ये पैरामीटर query(ज़रूरी) और query_place_id(वैकल्पिक) हैं.

खोज के सभी अनुरोधों के लिए, query पैरामीटर ज़रूरी है. इसमें किसी जगह का नाम, कॉमा लगाकर अलग किए गए अक्षांश/देशांतर निर्देशांक या खोज के लिए इस्तेमाल किया जाने वाला सामान्य शब्द डाला जा सकता है.

सर्च यूआरएल का स्ट्रक्चर: 

https://www.google.com/maps/search/?api=1&parameters

पहली स्थिति: किसी जगह के यूनीक नाम के लिए, जगह की जानकारी दिखाना 

https://www.google.com/maps/search/?api=1&query=Sydney%20Opera%20House
 इस उदाहरण में, सिर्फ़ जगह का नाम बताया गया है. इस यूआरएल से, सिडनी ओपेरा हाउस के बारे में ज़्यादा जानकारी वाला पेज खुलता है.

Google Maps पर जगह की जानकारी वाला पेज खोलना
जगह का नाम खोजो और जगह की जानकारी दिखाओ

अब ऐसी जगह के बारे में सोचें जिसका नाम यूनीक नहीं है. इस नाम से खोज करने पर क्या होता है? अगला सीनारियो देखें.

दूसरा उदाहरण: किसी ऐसी जगह के नाम से जगहें खोजना जो यूनीक नहीं है 

https://www.google.com/maps/search/?api=1&query=7-Eleven

जगह का नाम यूनीक न होने की वजह से, यह यूआरएल व्यूपोर्ट में मौजूद आस-पास की 7-Eleven की जगहों की सूची खोलता है. इसके बाद, लोग किसी स्टोर को चुनकर उसकी जानकारी देख सकते हैं.

Google Maps पर जगहों की सूची वाला पेज खोलना
एक जैसे नाम वाले प्लेस के लिए सूची वाला पेज

जगहों की सूची से बचने और सीधे किसी खास जानकारी वाले पेज को ऐक्सेस करने के लिए, ज़्यादा सटीक तरीके का इस्तेमाल किया जा सकता है. अगला उदाहरण देखें.

तीसरा उदाहरण: किसी ऐसी जगह की जानकारी दिखाना जिसका नाम यूनीक नहीं है

जगहों के सामान्य नामों के मामले में, नाम से खोज करने पर अक्सर जगहों की सूची दिखती है. किसी खास जानकारी वाले पेज से सीधे लिंक करने के लिए, इनमें से किसी एक तरीके का इस्तेमाल किया जा सकता है:

पहला तरीका: जगह के नाम और पते के साथ सटीक क्वेरी का इस्तेमाल करना 

https://www.google.com/maps/search/?api=1&query=7-Eleven%2C37%20Swanston%20St%2C%20Melbourne%20Australia

इस यूआरएल में, query पैरामीटर को जगह का नाम, पता के तौर पर फ़ॉर्मैट किया गया है. इससे खोज के नतीजों को कम करने और सीधे तौर पर उस जगह से लिंक करने में मदद मिलती है जिसके लिए खोज की गई है.

दूसरा तरीका: प्लेस आईडी का इस्तेमाल करना

जगह के आईडी, Google Places के डेटाबेस और Google Maps में किसी जगह की अलग पहचान के लिए इस्तेमाल होते हैं. 

https://www.google.com/maps/search/?api=1&query=7-Elevan&query_place_id=ChIJGcmcg7ZC1moRAOacd3HoEwM

यहां ChIJGcmcg7ZC1moRAOacd3HoEwM, किसी जगह का यूनीक प्लेस आईडी है. query पैरामीटर अब भी ज़रूरी है. हालांकि, इसका इस्तेमाल सिर्फ़ तब किया जाएगा, जब Google Maps को जगह का आईडी नहीं मिल पाता है.

चौथा उदाहरण: अक्षांश और देशांतर निर्देशांक के साथ-साथ जगह के आईडी का इस्तेमाल करके, जगह की जानकारी दिखाना

जगह का आईडी इस्तेमाल करने से, Google Maps पर जगह की पूरी जानकारी दिखती है.

https://www.google.com/maps/search/?api=1&query=-33.8567%2C151.2152&query_place_id=ChIJ3S-JXmauEmsRUcIaWtf4MzE
अक्षांश और देशांतर के साथ-साथ जगह के आईडी का इस्तेमाल करके, जगह की ज़्यादा जानकारी वाला पेज
जगह की जानकारी वाला पेज, जिसमें अक्षांश और देशांतर के साथ-साथ जगह के आईडी का इस्तेमाल किया गया है

बिना किसी शुल्क के प्लेस आईडी पाना

प्रोग्राम के हिसाब से जगह के आईडी पाने के लिए, Places API: Text Search(ID Only) फ़ंक्शन का इस्तेमाल किया जा सकता है. जगह के आईडी पाने के लिए, यह बिना किसी शुल्क वाला तरीका है. जगह के आईडी और Place API(नया) के अनुरोध के बारे में ज़्यादा जानें.

Places API Text Search(ID Only) अनुरोध: 

curl -X POST -d '{"textQuery" : "Sydney Opera House"}'
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: places.id'
'https://places.googleapis.com/v1/places:searchText'

Places API Text Search(ID Only) Response: 

{
  "places": [
    {
      "id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
    }
  ]
}

जब कोई उपयोगकर्ता मैप पर किसी जगह के नाम पर क्लिक या टैप करता है, तब भी जगह के आईडी वापस पाए जा सकते हैं. क्लिक किए जा सकने वाले पीओएस आइकॉन के बारे में ज़्यादा जानें(JavaScript, Android, iOS)

निष्कर्ष

जगह की सटीक जानकारी देना, खरीदारों को अच्छा अनुभव देने के लिए ज़रूरी है. यह पक्का करने के लिए कि लोग जगह की सही जानकारी वाले पेज पर पहुंचें, खोज के लिए यूआरएल बनाते समय सुझाए गए इन फ़ॉर्मैट में से किसी एक का इस्तेमाल करें:

  • query=PLACE_NAME, ADDRESS
  • query=PLACE_NAME&query_place_id=PLACE_ID

अगर आपका मकसद किसी जगह की जानकारी दिखाना है, तो query पैरामीटर में सिर्फ़ अक्षांश/देशांतर निर्देशांक का इस्तेमाल न करें. query=latitude,longitude, query=PLACE_NAME,latitude,longitude या query=ADDRESS,latitude,longitude जैसे फ़ॉर्मैट से, जगह की जानकारी वाले पेज पर हमेशा नहीं पहुंचा जा सकेगा. इसके बजाय, यह जगह के अक्षांश और देशांतर को दिखाएगा.

Maps के यूआरएल का इस्तेमाल करके कैटगरी के हिसाब से खोजना

कैटेगरी के हिसाब से खोज करने पर, आपको सामान्य खोज शब्द डालना होता है. इसके बाद, Google Maps आपकी बताई गई जगह के आस-पास, आपकी शर्तों से मेल खाने वाली लिस्टिंग ढूंढने की कोशिश करता है. अगर कोई जगह नहीं बताई जाती है, तो Google Maps आपकी मौजूदा जगह के आस-पास की लिस्टिंग ढूंढने की कोशिश करता है.

पहला उदाहरण: आस-पास की जगहों को खोजना

https://www.google.com/maps/search/?api=1&query=Cafe%20near%20Sydney%20Opera%20House%20that%20are%20open%20now
कैटगरी के हिसाब से खोज - आस-पास की जगहें
कैटगरी के हिसाब से खोज - आस-पास की जगहें

Maps के यूआरएल का इस्तेमाल करके दिशा-निर्देश देना

'निर्देश' फ़ंक्शन, मैप पर दो या उससे ज़्यादा चुने गए पॉइंट के बीच का रास्ता दिखाता है. साथ ही, यह दूरी और यात्रा में लगने वाला समय भी दिखाता है. इससे डेवलपर को, दिए गए निर्देशों पर ज़्यादा कंट्रोल मिलता है. GMP के Maps URLs Directions दस्तावेज़ में, पसंद के मुताबिक दिशा-निर्देशों के लिए यूआरएल बनाने के बारे में ज़्यादा जानकारी दी गई है.

रास्ता दिखाने वाले यूआरएल का स्ट्रक्चर: 

https://www.google.com/maps/dir/?api=1&parameters

पहला उदाहरण: उपयोगकर्ता की मौजूदा जगह से किसी मंज़िल तक पहुंचने का सबसे अच्छा रास्ता खोजना

https://www.google.com/maps/dir/?api=1&destination=Flinders%20Station%20Melbourne&travelmode=driving

इस यूआरएल से Google Maps खुलता है और उपयोगकर्ता की मौजूदा जगह से ड्राइविंग के निर्देश दिखते हैं.

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

travelmode एक वैकल्पिक पैरामीटर है. इससे यात्रा के तरीके के बारे में पता चलता है. इस पैरामीटर को इस तरह सेट किया जा सकता है:

  • वाहन से
  • पैदल
  • साइकिल से
  • दोपहिया वाहन
  • ट्रांज़िट

अगर आपने यात्रा का कोई तरीका नहीं चुना है, तो Google Maps, तय किए गए रास्ते और/या उपयोगकर्ता की प्राथमिकताओं के हिसाब से, यात्रा के एक या उससे ज़्यादा सबसे काम के तरीके दिखाता है.

डेवलपर, origin_place_id पैरामीटर और destination_place_id का इस्तेमाल करके, जगह के आईडी भी तय कर सकते हैं. प्लेस आईडी का इस्तेमाल करने से, यह पक्का किया जा सकता है कि आपने सही जगह को लिंक किया है.

बिना किसी शुल्क के प्लेस आईडी पाना

प्रोग्राम के हिसाब से जगह के आईडी पाने के लिए, Places API: Text Search(ID Only) फ़ंक्शन का इस्तेमाल किया जा सकता है. जगह के आईडी पाने के लिए, यह बिना किसी शुल्क वाला तरीका है. जगह के आईडी और Place API(नया) के अनुरोध के बारे में ज़्यादा जानें.

Places API Text Search(ID Only) अनुरोध: 

curl -X POST -d '{"textQuery" : "Sydney Opera House"}'
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: places.id'
'https://places.googleapis.com/v1/places:searchText'

Places API Text Search(ID Only) Response: 

{
  "places": [
    {
      "id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
    }
  ]
}

जब कोई उपयोगकर्ता मैप पर किसी जगह के नाम पर क्लिक या टैप करता है, तब भी जगह के आईडी वापस पाए जा सकते हैं. क्लिक किए जा सकने वाले पीओएस आइकॉन के बारे में ज़्यादा जानें(JavaScript, Android, iOS)

उपयोगकर्ता की मौजूदा जगह से निर्देश
उपयोगकर्ता की मौजूदा जगह से दिशा-निर्देश

तीसरा उदाहरण: मोड़-दर-मोड़ रास्ते की जानकारी देना

https://www.google.com/maps/dir/?api=1&destination=Flinders%20Station%20Melbourne&travelmode=driving&dir_action=navigate

यूआरएल में dir_action=navigate सेट करने पर, Google Maps टर्न-बाय-टर्न नेविगेशन मोड में लॉन्च होगा. ऐसा तब होगा, जब उपयोगकर्ता की मौजूदा जगह (डिवाइस की जगह) की जानकारी उपलब्ध हो और उसे शुरुआती जगह के तौर पर इस्तेमाल किया गया हो. शुरुआती जगह की जानकारी साफ़ तौर पर दी गई हो या शुरुआती जगह के पैरामीटर को शामिल न करने पर, इसका इस्तेमाल अपने-आप किया गया हो. ऐसा न करने पर, रास्ते की झलक दिखेगी.

dir_action=navigate सेट होने पर, मोड़-दर-मोड़ नेविगेशन की सुविधा लॉन्च की जाती है. ऐसा तब होता है, जब:

  • ऑरिजिन की जानकारी दी गई हो और वह उपयोगकर्ता की मौजूदा जगह के आस-पास हो
  • इसमें ओरिजिन की जानकारी नहीं होती है और उपयोगकर्ता की मौजूदा जगह की जानकारी उपलब्ध होती है

रास्ते की झलक दिखाने की सुविधा तब लॉन्च की जाती है, जब:

  • dir_action=navigate सेट नहीं है
  • dir_action=navigate सेट किया गया हो और मूल जगह की जानकारी दी गई हो. साथ ही, मूल जगह, उपयोगकर्ता की मौजूदा जगह के आस-पास न हो
  • dir_action=navigate सेट है और ऑरिजिन को शामिल नहीं किया गया है. साथ ही, उपयोगकर्ता की मौजूदा जगह की जानकारी उपलब्ध नहीं है

ध्यान दें कि नेविगेशन की सुविधा, Google Maps के सभी प्रॉडक्ट पर उपलब्ध नहीं है. जैसे, Google Maps Web और/या सभी जगहों के बीच नेविगेशन की सुविधा उपलब्ध नहीं है. ऐसे मामलों में, इस पैरामीटर को अनदेखा कर दिया जाएगा.

मोड़-दर-मोड़ नेविगेशन रास्ते की झलक
मोड़-दर-मोड़ नेविगेशन
रास्ते की झलक

निष्कर्ष

Maps के यूआरएल सही तरीके से बनाकर, यह पक्का किया जा सकता है कि उपयोगकर्ताओं को उनकी ज़रूरत की सही जानकारी जल्दी और आसानी से मिले.

  • हमेशा डेस्टिनेशन की जानकारी दें. साथ ही, सटीक जानकारी पाने के लिए, जब भी हो सके प्लेस आईडी का इस्तेमाल करें

  • अगर लक्ष्य तुरंत नेविगेशन की सुविधा देना है, तो मोड़-दर-मोड़ नेविगेशन की सुविधा चालू करने के लिए, dir_action=navigate पैरामीटर शामिल करें. अगर डिवाइस की जगह की जानकारी उपलब्ध है और उसे शुरुआती जगह के तौर पर इस्तेमाल किया जाता है, तो नेविगेशन उपयोगकर्ता की मौजूदा जगह से शुरू होगा. शुरुआती जगह को साफ़ तौर पर सेट किया गया हो या उसे छोड़ दिया गया हो

अपने ऐप्लिकेशन के लिए सही तरीका चुनना

आपके पास दो मुख्य विकल्प हैं: Places API से मिले पहले से फ़ॉर्मैट किए गए यूआरएल का इस्तेमाल करना या अपने ऐप्लिकेशन में Maps के यूआरएल को मैन्युअल तरीके से बनाना. हर तरीके के अपने फ़ायदे और नुकसान हैं.

Places API:

  • जगह की जानकारी वाले जवाब में मौजूद googleMapsUri और googleMapsLinks फ़ील्ड में, इस्तेमाल के लिए तैयार यूआरएल दिए जाते हैं. इससे डेवलपमेंट में लगने वाला समय कम हो जाता है. साथ ही, यूआरएल फ़ॉर्मैटिंग में गड़बड़ियों का जोखिम कम हो जाता है.

  • इससे दिशाओं के कॉन्फ़िगरेशन पर कम कंट्रोल मिलता है. googleMapsLinks में बुनियादी दिशा-निर्देश मिलते हैं. हालांकि, इसमें वेपॉइंट या ऐडवांस लेवल पर मनमुताबिक बनाने की सुविधा नहीं मिलती. इसके अलावा, सीधे तौर पर बारी-बारी से मिलने वाले निर्देशों को ट्रिगर करना भी आसान नहीं है.

Maps के यूआरएल:

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

  • इसके लिए, यूआरएल पैरामीटर और स्ट्रक्चर के बारे में ज़्यादा जानकारी होना ज़रूरी है. अगर मैन्युअल तरीके से कॉन्फ़िगरेशन ठीक से नहीं किया जाता है, तो गड़बड़ियां होने की संभावना बढ़ जाती है.

यूटीएम पैरामीटर वाले Maps यूआरएल को बेहतर बनाना

हमारा सुझाव है कि आप यूआरएल बनाते समय, यूटीएम ट्रैकिंग पैरामीटर शामिल करें. इससे Google को यह समझने में मदद मिलेगी कि डेवलपर, Maps के यूआरएल को कैसे इंटिग्रेट कर रहे हैं. साथ ही, इससे यह पक्का किया जा सकेगा कि Maps की परफ़ॉर्मेंस सबसे अच्छी हो. utm_source और utm_campaign पैरामीटर जोड़कर, अहम डेटा उपलब्ध कराया जाता है. इससे हमें इस्तेमाल के पैटर्न का विश्लेषण करने और Maps के यूआरएल प्रॉडक्ट को बेहतर बनाने में मदद मिलती है.

utm_source पैरामीटर के लिए, अपने ऐप्लिकेशन का नाम इस्तेमाल करें. utm_campaign पैरामीटर में, उपयोगकर्ता की इंटेंड की गई कार्रवाई दिखनी चाहिए. जैसे, "location_sharing," "place_details_search," या "directions_request".

उदाहरण के लिए, यूटीएम पैरामीटर वाला यूआरएल ऐसा दिख सकता है: 

https://www.google.com/maps/search/?api=1&query=Sydney+Opera+House&query_place_id=ChIJ3S-JXmauEmsRUcIaWtf4MzE&utm_source=YourAppName&utm_campaign=place_details_search

इन पैरामीटर का लगातार इस्तेमाल करने से, हमें उन क्षेत्रों की पहचान करने में मदद मिलती है जिनमें सुधार किया जा सकता है. साथ ही, समस्याओं को ज़्यादा असरदार तरीके से हल किया जा सकता है. इससे, सभी उपयोगकर्ताओं को बेहतर अनुभव मिलता है.

अगले चरण

इस बारे में और पढ़ें:

योगदानकर्ता

मुख्य लेखक:

टेरेसा किन | Google Maps Platform की Solutions Engineer