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

आज के दौर में, लोग अपनी जगह की जानकारी के हिसाब से चीज़ें ढूंढते हैं. इसलिए, वे चाहते हैं कि उन्हें किसी जगह की जानकारी, दिशा-निर्देश, और नेविगेशन की सुविधा आसानी से मिले. चाहे वह मेसेंजर ऐप्लिकेशन हो, स्थानीय कॉन्टेक्स्ट की जानकारी देने वाला ऐप्लिकेशन हो, लॉजिस्टिक्स और परिवहन प्लैटफ़ॉर्म हो, यात्रा की योजना बनाने वाला ऐप्लिकेशन हो या रियल एस्टेट लिस्टिंग प्लैटफ़ॉर्म हो, उपयोगकर्ताओं को अक्सर जगह की जानकारी तुरंत देखनी होती है या A से B तक का सबसे अच्छा रास्ता ढूंढना होता है. डेवलपर, ऐप्लिकेशन में अपना अनुभव बना सकते हैं. हालांकि, 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: Text Search(ID Only) फ़ंक्शन का इस्तेमाल किया जा सकता है. जगह के आईडी पाने के लिए, यह बिना किसी शुल्क वाला तरीका है. जगह के आईडी और Places API(नया) के अनुरोध के बारे में ज़्यादा जानें.

Places API Text Search(ID Only) Request:

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) Request: 

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) Request: 

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 की सलूशन इंजीनियर