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 के यूआरएल, जो बिना किसी शुल्क के उपलब्ध होते हैं और जिनके लिए पासकोड की ज़रूरत नहीं होती. यहां दिए गए समाधान, अलग-अलग स्थितियों और इस्तेमाल के उदाहरणों के हिसाब से हैं:

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: टेक्स्ट खोजने की सुविधा(सिर्फ़ आईडी) का इस्तेमाल किया जा सकता है. यह प्लेस आईडी पाने का बिना किसी शुल्क वाला तरीका है. जगह का आईडी और Place API(नया) अनुरोध के बारे में ज़्यादा जानें.

Places API टेक्स्ट सर्च(सिर्फ़ आईडी) अनुरोध:

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 टेक्स्ट सर्च(सिर्फ़ आईडी) का जवाब:

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

जब कोई उपयोगकर्ता Maps पर किसी पीओआई पर क्लिक या टैप करता है, तब भी प्लेस आईडी वापस पाया जा सकता है. क्लिक किए जा सकने वाले पीओआई आइकॉन(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 पैरामीटर ज़रूरी है. इसमें किसी जगह का नाम, अक्षांश/देशांतर के निर्देशांक या खोज के लिए इस्तेमाल किया जाने वाला सामान्य शब्द डाला जा सकता है. निर्देशांक डालते समय, कॉमा का इस्तेमाल करें.

Search Network में दिखने वाले यूआरएल का स्ट्रक्चर: 

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 पर जगहों की सूची वाला पेज खोलना
यूनीक नाम न खोजने के लिए प्लेसमेंट की सूची वाला पेज

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

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

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

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

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

Places API टेक्स्ट सर्च(सिर्फ़ आईडी) अनुरोध: 

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 टेक्स्ट सर्च(सिर्फ़ आईडी) का जवाब: 

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

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

निष्कर्ष

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

  • 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 के यूआरएल के निर्देश दस्तावेज़ में, अपनी पसंद के मुताबिक निर्देशों के लिए यूआरएल बनाने के बारे में ज़्यादा जानकारी दी गई है.

निर्देशों के यूआरएल का स्ट्रक्चर: 

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

Places API टेक्स्ट सर्च(सिर्फ़ आईडी) अनुरोध: 

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 टेक्स्ट सर्च(सिर्फ़ आईडी) का जवाब: 

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

जब कोई उपयोगकर्ता Maps पर किसी पीओआई पर क्लिक या टैप करता है, तब भी प्लेस आईडी वापस पाया जा सकता है. क्लिक किए जा सकने वाले पीओआई आइकॉन(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 के यूआरएल:

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

  • इसके लिए, यूआरएल पैरामीटर और स्ट्रक्चर की अच्छी समझ होनी चाहिए. मैन्युअल तरीके से कन्वर्ज़न ट्रैकिंग टूल बनाने पर, गलतियों की संभावना बढ़ जाती है. ऐसा इसलिए, क्योंकि इस काम को ध्यान से नहीं किया जाता.

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

Google को यह समझने में मदद करने के लिए कि डेवलपर, Maps के यूआरएल को कैसे इंटिग्रेट कर रहे हैं और सबसे अच्छी परफ़ॉर्मेंस को पक्का करने के लिए, हमारा सुझाव है कि आप अपने यूआरएल में UTM ट्रैकिंग पैरामीटर शामिल करें. 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 के सलूशन इंजीनियर