शुरू करें

परिचय

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

Maps के यूआरएल इस्तेमाल करने के लिए, आपको Google API पासकोड की ज़रूरत नहीं है.

यूनिवर्सल क्रॉस-प्लैटफ़ॉर्म सिंटैक्स

Android ऐप्लिकेशन, iOS ऐप्लिकेशन या वेबसाइट के डेवलपर के तौर पर, एक सामान्य यूआरएल बनाया जा सकता है. इससे Google Maps खुल जाएगा और अनुरोध किया गया काम हो जाएगा. इससे कोई फ़र्क़ नहीं पड़ता कि मैप खोलते समय किस प्लैटफ़ॉर्म का इस्तेमाल किया जा रहा है.

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

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

• Android के लिए Google Maps इंटेंट — खास तौर पर, Android के लिए Google Maps ऐप्लिकेशन को लॉन्च करने के लिए
• iOS के लिए Google Maps की यूआरएल स्कीम — खास तौर पर, iOS के लिए Google Maps ऐप्लिकेशन लॉन्च करने के लिए

Google Maps लॉन्च करना और कोई खास कार्रवाई करना

Google Maps को लॉन्च करने और इसके साथ काम करने वाले किसी फ़ंक्शन को इस्तेमाल करने के लिए, इनमें से किसी एक यूआरएल स्कीम का इस्तेमाल करें. यह इस बात पर निर्भर करता है कि आपको कौनसी कार्रवाई करनी है:

• खोजें — Google Maps लॉन्च करें, जो किसी खास जगह के लिए पिन दिखाता है या सामान्य खोज करें और नतीजे दिखाने के लिए मैप लॉन्च करें:
  https://www.google.com/maps/search/?api=1&parameters
• रास्ते की जानकारी — रास्ते की जानकारी का अनुरोध करें और नतीजों के साथ Google Maps लॉन्च करें:
  https://www.google.com/maps/dir/?api=1&parameters
• मैप दिखाना — Google Maps को बिना किसी मार्कर या दिशा-निर्देश के लॉन्च करें:
  https://www.google.com/maps/@?api=1&map_action=map&parameters
• शॉर्टलिस्ट बनाना — Google Maps को खास जगहों की सूची के साथ लॉन्च करें:
  https://www.google.com/maps/@?api=1&map_action=shortlist&parameters
• Street View पैनोरमा दिखाना — इंटरैक्टिव पैनोरमा इमेज लॉन्च करें:
  https://www.google.com/maps/@?api=1&map_action=pano&parameters

अहम जानकारी: पैरामीटर api=1, Maps के यूआरएल के उस वर्शन की पहचान करता है जिसके लिए यह यूआरएल बनाया गया है. हर अनुरोध में इस पैरामीटर का इस्तेमाल करना ज़रूरी है. सिर्फ़ 1 वैल्यू मान्य है. अगर यूआरएल में api=1 नहीं है, तो सभी पैरामीटर को अनदेखा कर दिया जाता है. साथ ही, इस्तेमाल किए जा रहे प्लैटफ़ॉर्म के आधार पर, डिफ़ॉल्ट Google Maps ऐप्लिकेशन, ब्राउज़र या Google Maps मोबाइल ऐप्लिकेशन में लॉन्च हो जाएगा. उदाहरण के लिए, https://www.google.com/maps.

मान्य यूआरएल बनाना

आपको यूआरएल को सही तरीके से कोड में बदलना होगा.

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

उदाहरण के लिए, कुछ पैरामीटर सेपरेटर के तौर पर पाइप वर्ण (|) का इस्तेमाल करते हैं. आपको इसे फ़ाइनल यूआरएल में %7C के तौर पर एन्कोड करना होगा. अन्य पैरामीटर, कॉमा लगाकर अलग की गई वैल्यू का इस्तेमाल करते हैं. जैसे, अक्षांश/देशांतर के निर्देशांक या शहर, राज्य. आपको कॉमा को %2C के तौर पर कोड में बदलना होगा. स्पेस को %20 के साथ एन्कोड करें या उन्हें प्लस के निशान (+) से बदलें.

इसके अलावा, हर अनुरोध के लिए यूआरएल में ज़्यादा से ज़्यादा 2,048 वर्ण हो सकते हैं. यूआरएल बनाते समय, इस सीमा का ध्यान रखें.

मैप पर कार्रवाइयां

मैप पर ये कार्रवाइयां की जा सकती हैं: खोजना, रास्ते की जानकारी पाना, मैप दिखाना, शॉर्टलिस्ट बनाना, और Street View पैनोरमा दिखाना. अनुरोध के यूआरएल में, ज़रूरी और वैकल्पिक पैरामीटर के साथ-साथ कार्रवाई की जानकारी दी जाती है. यूआरएल में स्टैंडर्ड के तौर पर, पैरामीटर को एंपरसैंड (&) वर्ण का इस्तेमाल करके अलग किया जाता है. हर कार्रवाई के लिए, पैरामीटर और उनकी संभावित वैल्यू की सूची, खोज पैरामीटर सेक्शन में दी गई है.

खोजें

खोज की कार्रवाई, मैप पर दिख रहे इलाके में की गई खोज के नतीजे दिखाती है. किसी खास जगह को खोजने पर, मैप में उस जगह पर एक पिन दिखता है. साथ ही, उस जगह की जानकारी भी दिखती है.

खोज के लिए यूआरएल बनाया जा रहा है

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

पैरामीटर

• query (ज़रूरी है): इससे मैप पर हाइलाइट की जाने वाली जगहों के बारे में पता चलता है. खोज के सभी अनुरोधों के लिए, क्वेरी पैरामीटर ज़रूरी है.
  • जगहों की जानकारी देने के लिए, किसी जगह का नाम, पता या कॉमा लगाकर अलग किए गए अक्षांश/देशांतर निर्देशांक डालें. स्ट्रिंग को यूआरएल-कोड में बदला जाना चाहिए. इसलिए, "सिटी हॉल, न्यूयॉर्क, एनवाई" जैसे पते को City+Hall%2C+New+York%2C+NY में बदला जाना चाहिए.
  • खोज के लिए इस्तेमाल होने वाले सामान्य शब्दों को यूआरएल कोड में बदली गई स्ट्रिंग के तौर पर डालें. जैसे, grocery+stores या restaurants+in+seattle+wa.
• query_place_id (ज़रूरी नहीं): जगह का आईडी, टेक्स्ट के तौर पर मौजूद एक आइडेंटिफ़ायर होता है. इससे किसी जगह की खास तौर पर पहचान की जाती है. search कार्रवाई के लिए, आपको query तय करना होगा. हालांकि, query_place_id भी तय किया जा सकता है. अगर आपने दोनों पैरामीटर दिए हैं, तो query का इस्तेमाल सिर्फ़ तब किया जाएगा, जब Google Maps को जगह का आईडी नहीं मिल पाता है. अगर आपको किसी खास कारोबार को लिंक करना है, तो जगह का आईडी इस्तेमाल करना सबसे सही तरीका है. इससे यह पक्का किया जा सकता है कि आपने सही जगह को लिंक किया है. हमारा यह भी सुझाव है कि अक्षांश/देशांतर के निर्देशांकों का इस्तेमाल करके, किसी खास जगह के लिए क्वेरी करते समय query_place_id सबमिट करें.

सर्च क्वेरी के उदाहरण

जगह की जानकारी के हिसाब से खोज

जगह की खोज में, किसी जगह के नाम, पते या कॉमा लगाकर अलग किए गए अक्षांश/देशांतर निर्देशांकों का इस्तेमाल करके, किसी खास जगह को खोजा जाता है. इसके बाद, नतीजे के तौर पर दिखने वाले मैप में उस जगह पर एक पिन दिखता है. इन तीन उदाहरणों से पता चलता है कि जगह की अलग-अलग वैल्यू का इस्तेमाल करके, एक ही जगह को कैसे खोजा जा सकता है.

पहला उदाहरण: "Lumen Field" नाम की जगह को खोजने पर, यह मैप दिखता है:

https://www.google.com/maps/search/?api=1&query=lumen+field

दूसरा उदाहरण: सिर्फ़ अक्षांश/देशांतर के निर्देशांकों का इस्तेमाल करके, Lumen Field को खोजने पर यह मैप दिखता है. ध्यान दें कि मैप पर एक पिन मौजूद है, लेकिन मैप या साइड पैनल में जगह की कोई अतिरिक्त जानकारी नहीं दी गई है:

https://www.google.com/maps/search/?api=1&query=47.5951518%2C-122.3316393

तीसरा उदाहरण: अक्षांश/देशांतर के निर्देशांकों के साथ-साथ जगह के आईडी का इस्तेमाल करके, Lumen Field को खोजने पर यह मैप दिखता है:

https://www.google.com/maps/search/?api=1&query=47.5951518%2C-122.3316393&query_place_id=ChIJKxjxuaNqkFQR3CK6O1HNNqY

चौथा उदाहरण: "Starbucks" नाम की जगह खोजने पर, यह मैप दिखता है:

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

उदाहरण 5: जगह के नाम और जगह के आईडी का इस्तेमाल करके, किसी खास Starbucks को खोजने पर, यह मैप दिखता है:

https://www.google.com/maps/search/?api=1&query=starbucks&query_place_id=ChIJsU30zM1qkFQRbnOm1_LBoG0

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

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

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

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

कैटगरी के हिसाब से खोज

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

इस उदाहरण में, वॉशिंगटन के सिऐटल में पिज़्ज़ा रेस्टोरेंट खोजने पर, यह मैप दिखता है:

https://www.google.com/maps/search/?api=1&query=pizza+seattle+wa

---

निर्देश

निर्देश कार्रवाई, मैप पर दो या उससे ज़्यादा जगहों के बीच का रास्ता दिखाती है. साथ ही, दूरी और यात्रा में लगने वाला समय भी दिखाती है.

निर्देशों वाला यूआरएल बनाना

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

पैरामीटर

• origin: इससे वह शुरुआती जगह तय होती है जहां से दिशा-निर्देश दिखाने हैं. डिफ़ॉल्ट रूप से, शुरुआत की सबसे काम की जगह पर सेट होता है. जैसे, डिवाइस की जगह की जानकारी, अगर उपलब्ध हो. अगर कोई भी नतीजा नहीं मिलता है, तो मैप में एक खाली फ़ॉर्म दिख सकता है. इससे उपयोगकर्ता को ऑरिजिन की जानकारी डालने की अनुमति मिलती है. वैल्यू के तौर पर, किसी जगह का नाम, पता या कॉमा लगाकर अलग किए गए अक्षांश/देशांतर के निर्देशांक डाले जा सकते हैं. स्ट्रिंग को यूआरएल के तौर पर कोड में बदला जाना चाहिए, ताकि "City Hall, New York, NY" जैसे पते को City+Hall%2C+New+York%2C+NY में बदला जा सके.

  ध्यान दें: यह पैरामीटर ज़रूरी नहीं है. हालांकि, अगर आपने अपने यूआरएल में origin_place_id तय किया है, तो इसे शामिल करना ज़रूरी है. अगर आपको origin_place_id की जानकारी देनी है, तो आपको यूआरएल में origin की जानकारी भी शामिल करनी होगी.

• origin_place_id (ज़रूरी नहीं): जगह का आईडी, टेक्स्ट के तौर पर मौजूद एक आइडेंटिफ़ायर होता है. इससे किसी जगह की खास तौर पर पहचान की जाती है. अगर आपको किसी कारोबार की जगह की सटीक जानकारी देनी है, तो जगह के आईडी का इस्तेमाल करना सबसे अच्छा तरीका है. इससे यह पक्का किया जा सकता है कि आपने सही जगह को लिंक किया है. इस पैरामीटर का इस्तेमाल करने वाले यूआरएल में origin भी शामिल होना चाहिए.
• destination: इससे दिशाओं के एंडपॉइंट के बारे में पता चलता है. अगर कोई भी नहीं चुना जाता है, तो नतीजे के तौर पर मिले मैप में एक खाली फ़ॉर्म दिख सकता है. इससे उपयोगकर्ता को मंज़िल की जानकारी डालने की अनुमति मिलती है. वैल्यू के तौर पर, किसी जगह का नाम, पता या कॉमा लगाकर अलग किए गए अक्षांश/देशांतर निर्देशांक डाले जा सकते हैं. स्ट्रिंग को यूआरएल के तौर पर कोड में बदला जाना चाहिए, ताकि "City Hall, New York, NY" जैसे पते को City+Hall%2C+New+York%2C+NY में बदला जा सके.

  ध्यान दें: यह पैरामीटर ज़रूरी नहीं है. हालांकि, अगर आपने यूआरएल में destination_place_id तय किया है, तो यह पैरामीटर ज़रूरी है. अगर आपको कोई destination_place_id तय करना है, तो आपको यूआरएल में destination भी शामिल करना होगा.

• destination_place_id (ज़रूरी नहीं): जगह का आईडी, टेक्स्ट के तौर पर मौजूद एक आइडेंटिफ़ायर होता है. इससे किसी जगह की खास तौर पर पहचान की जाती है. अगर आपको किसी कारोबार की जगह की सटीक जानकारी देनी है, तो जगह के आईडी का इस्तेमाल करना सबसे अच्छा तरीका है. इससे यह पक्का किया जा सकता है कि आपने सही जगह को लिंक किया है. इस पैरामीटर का इस्तेमाल करने वाले यूआरएल में destination भी शामिल होना चाहिए.
• travelmode (ज़रूरी नहीं): इससे यात्रा का तरीका तय होता है. यहां विकल्पों की सूची दी गई है:
• driving
• walking: जहां भी पैदल चलने के रास्ते और फ़ुटपाथ उपलब्ध होते हैं वहां इनका इस्तेमाल करता है.
• bicycling: साइकल के रास्तों से होकर जाने वाले रूट, जहां उपलब्ध हों. "साइकल चलाना" का मतलब है, इंसान के पैरों से चलने वाली साइकल से यात्रा करना.
• two-wheeler: दोपहिया वाहनों के लिए पसंदीदा सड़कों से होकर जाने वाले रास्ते. हालांकि, यह सुविधा चुनिंदा जगहों पर ही उपलब्ध है. "दोपहिया वाहन" का मतलब, मोटर से चलने वाले दोपहिया वाहनों से है, जैसे कि मोटरसाइकल. ज़्यादा जानकारी के लिए, दोपहिया वाहन के लिए कवरेज देखें.
• transit
अगर कोई travelmode नहीं दिया गया है, तो Google Maps, तय किए गए रास्ते और/या उपयोगकर्ता की प्राथमिकताओं के हिसाब से, सबसे ज़्यादा काम के एक या उससे ज़्यादा मोड दिखाता है.
• dir_action=navigate (ज़रूरी नहीं): यह तय की गई मंज़िल के लिए, रास्ते के दिशा-निर्देश या रास्ते की झलक दिखाता है. यह इस बात पर निर्भर करता है कि शुरुआती जगह की जानकारी उपलब्ध है या नहीं. अगर उपयोगकर्ता ने कोई शुरुआती जगह बताई है और वह उसकी मौजूदा जगह के आस-पास नहीं है या डिवाइस की मौजूदा जगह की जानकारी उपलब्ध नहीं है, तो मैप पर रास्ते की झलक दिखेगी. अगर उपयोगकर्ता ने यात्रा शुरू करने की जगह की जानकारी नहीं दी है, तो डिफ़ॉल्ट रूप से डिवाइस की मौजूदा जगह की जानकारी को यात्रा शुरू करने की जगह माना जाता है. इसके अलावा, अगर यात्रा शुरू करने की जगह, उपयोगकर्ता की मौजूदा जगह के आस-पास है, तो मैप पर रास्ते के दिशा-निर्देश दिखने लगते हैं. ध्यान दें कि नेविगेशन की सुविधा, Google Maps के सभी प्रॉडक्ट और/या सभी डेस्टिनेशन के बीच उपलब्ध नहीं है. ऐसे मामलों में, इस पैरामीटर को अनदेखा कर दिया जाएगा.
• waypoints: इससे origin और destination के बीच की एक या उससे ज़्यादा जगहों के बारे में जानकारी मिलती है. पाइप (|) वर्ण का इस्तेमाल करके, एक से ज़्यादा वेपॉइंट तय किए जा सकते हैं. इससे जगहों को अलग-अलग किया जा सकता है. उदाहरण के लिए, Berlin,Germany|Paris,France. लिंक खुलने वाले प्लैटफ़ॉर्म के हिसाब से, वेपॉइंट की संख्या अलग-अलग हो सकती है. मोबाइल ब्राउज़र पर ज़्यादा से ज़्यादा तीन वेपॉइंट इस्तेमाल किए जा सकते हैं. वहीं, अन्य प्लैटफ़ॉर्म पर ज़्यादा से ज़्यादा नौ वेपॉइंट इस्तेमाल किए जा सकते हैं. रास्ते के पॉइंट, मैप पर उसी क्रम में दिखते हैं जिस क्रम में वे यूआरएल में दिए गए हैं. हर वेपॉइंट, किसी जगह का नाम, पता या कॉमा लगाकर अलग किए गए अक्षांश/देशांतर निर्देशांक हो सकता है. स्ट्रिंग को यूआरएल के हिसाब से कोड में बदला गया होना चाहिए. इसलिए, "Berlin,Germany|Paris,France" जैसे वेपॉइंट को Berlin%2CGermany%7CParis%2CFrance में बदला जाना चाहिए.

  ध्यान दें:

  • वेपॉइंट, Google Maps के सभी प्रॉडक्ट पर काम नहीं करते. ऐसे मामलों में, इस पैरामीटर को अनदेखा कर दिया जाएगा.
  • यह पैरामीटर ज़रूरी नहीं है. हालांकि, अगर आपने यूआरएल में waypoint_place_ids डाला है, तो यह पैरामीटर ज़रूरी है. अगर आपको waypoint_place_ids की जानकारी देनी है, तो आपको यूआरएल में waypoints को भी शामिल करना होगा.
• waypoint_place_ids (ज़रूरी नहीं): जगह का आईडी, टेक्स्ट के तौर पर मौजूद एक आइडेंटिफ़ायर होता है. इससे किसी जगह की खास तौर पर पहचान की जाती है. Waypoint_place_ids की मदद से, जगह के आईडी की सूची दी जा सकती है, ताकि उसे waypoints की सूची से मैच किया जा सके. जगह के आईडी, वेपॉइंट के क्रम में होने चाहिए. साथ ही, उन्हें पाइप कैरेक्टर "|" ( URL-encoded के तौर पर %7C) का इस्तेमाल करके अलग किया जाना चाहिए. अगर आपको कुछ खास जगहों के बारे में जानकारी देनी है, तो जगह के आईडी सबसे अच्छा तरीका है. इससे यह पक्का किया जा सकता है कि आपने सही जगहों के लिंक दिए हैं. इस पैरामीटर का इस्तेमाल करने वाले यूआरएल में waypoints भी शामिल होना चाहिए.
• avoid (ज़रूरी नहीं): इससे ऐसी सुविधाएं सेट की जाती हैं जिनसे रास्ते को बचने की कोशिश करनी चाहिए. इसे इनमें से एक या उससे ज़्यादा विकल्पों पर सेट किया जा सकता है. इसके लिए, कॉमा "," का इस्तेमाल करके, विकल्पों को अलग-अलग करें ( यूआरएल कोड में बदला गया %2C):
  • ferries
  • highways
  • tolls

रास्ते की जानकारी देने वाले उदाहरण

यहां दिया गया यूआरएल, मैप को निर्देश मोड में लॉन्च करता है. साथ ही, एक फ़ॉर्म उपलब्ध कराता है, ताकि उपयोगकर्ता शुरुआती जगह और मंज़िल की जानकारी डाल सके.

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

नीचे दिए गए उदाहरण में, सिऐटल, वॉशिंगटन में स्पेस नीडल से पाइक प्लेस मार्केट तक, साइकल सवार के लिए रास्ते के निर्देशों वाला मैप लॉन्च किया गया है.

https://www.google.com/maps/dir/?api=1&origin=Space+Needle+Seattle+WA&destination=Pike+Place+Market+Seattle+WA&travelmode=bicycling

नीचे दिए गए उदाहरण में, Google मुंबई से मुंबई अंतरराष्ट्रीय हवाई अड्डे तक, दोपहिया वाहन के लिए दिशा-निर्देशों वाला मैप लॉन्च किया गया है.

ध्यान दें: दोपहिया वाहन के लिए लिंक का यह उदाहरण सिर्फ़ तब काम करता है, जब आप उस देश में मौजूद हों जहां दोपहिया वाहन के लिए नेविगेशन की सुविधा उपलब्ध है. यह लिंक उन देशों में काम करता है जहां दोपहिया वाहनों के लिए नेविगेशन की सुविधा उपलब्ध है.इसके बारे में जानने के लिए, दोपहिया वाहनों के लिए नेविगेशन की सुविधा लेख पढ़ें.

https://www.google.com/maps/dir/?api=1&origin=Google+Mumbai+India&destination=Mumbai+Airport&travelmode=two-wheeler

नीचे दिए गए उदाहरण में, Google सिडनी, ऑस्ट्रेलिया से क्वीन विक्टोरिया बिल्डिंग तक पैदल रास्ते की जानकारी वाला मैप लॉन्च किया गया है.

https://www.google.com/maps/dir/?api=1&origin=Google+Pyrmont+NSW&destination=QVB&destination_place_id=ChIJISz8NjyuEmsRFTQ9Iw7Ear8&travelmode=walking

मैप दिखाना

मैप ऐक्शन से ऐसा मैप मिलता है जिसमें कोई मार्कर या दिशा-निर्देश नहीं होते.

मैप का यूआरएल बनाना

https://www.google.com/maps/@?api=1&map_action=map&parameters

पैरामीटर

• map_action=map (ज़रूरी है): इससे पता चलता है कि मैप व्यू का कौनसा टाइप दिखाना है. Maps और Street View, दोनों के लिए एक ही एंडपॉइंट इस्तेमाल किया जाता है. मैप दिखे, इसके लिए ज़रूरी है कि map_action को map के तौर पर सेट किया गया हो.
• center (ज़रूरी नहीं): इससे मैप विंडो का सेंटर तय होता है. साथ ही, अक्षांश/देशांतर के निर्देशांकों को कॉमा लगाकर अलग की गई वैल्यू के तौर पर स्वीकार किया जाता है. उदाहरण के लिए, -33.8569,151.2152.
• zoom (ज़रूरी नहीं): इससे मैप के लिए ज़ूम करने का शुरुआती लेवल सेट होता है. इसके लिए, 0 (पूरी दुनिया) से लेकर 21 (अलग-अलग इमारतें) तक के पूर्णांक इस्तेमाल किए जा सकते हैं. ज़ूम करने की ऊपरी सीमा, चुनी गई जगह पर उपलब्ध मैप डेटा के हिसाब से अलग-अलग हो सकती है. डिफ़ॉल्ट रूप से, यह 15 पर सेट होता है.
• basemap (ज़रूरी नहीं): इससे यह तय होता है कि किस तरह का मैप दिखाना है. इसकी वैल्यू roadmap (डिफ़ॉल्ट), satellite या terrain हो सकती है.
• layer (ज़रूरी नहीं): अगर मैप पर कोई अतिरिक्त लेयर दिखानी है, तो उसे तय करता है. वैल्यू इनमें से कोई एक हो सकती है: none (डिफ़ॉल्ट), transit, traffic या bicycling.

मैप के उदाहरण

इस उदाहरण में दिया गया यूआरएल, डिफ़ॉल्ट Google Maps को लॉन्च करता है. यह उपयोगकर्ता की मौजूदा जगह के हिसाब से सेट होता है.

https://www.google.com/maps/@?api=1&map_action=map

यहां दिए गए उदाहरण में, ऑस्ट्रेलिया के न्यू साउथ वेल्स में मौजूद कटुम्बा शहर को केंद्र में रखकर बनाया गया मैप दिखाया गया है. इसमें -33.712206,150.311941 पर मौजूद मैप को दिखाया गया है. साथ ही, इसमें zoom और basemap पैरामीटर सेट किए गए हैं.

https://www.google.com/maps/@?api=1&map_action=map&center=-33.712206%2C150.311941&zoom=12&basemap=terrain

---

Street View पैनोरमा दिखाना

पैनो ऐक्शन की मदद से, व्यूअर को लॉन्च किया जा सकता है. इससे Street View की तस्वीरें, इंटरैक्टिव पैनोरामा के तौर पर दिखती हैं. हर Street View पैनोरमा, किसी एक जगह से 360-डिग्री व्यू दिखाता है. इमेज में 360 डिग्री का हॉरिज़ॉन्टल व्यू (पूरी तरह से रैप-अराउंड) और 180 डिग्री का वर्टिकल व्यू (ऊपर से नीचे तक) शामिल होता है. पैनो ऐक्शन, व्यूअर लॉन्च करता है. यह व्यूअर, पैनोरामा को एक गोले के तौर पर रेंडर करता है. इस गोले के बीच में कैमरा होता है. कैमरे को ज़ूम और ओरिएंटेशन को कंट्रोल करने के लिए, कैमरे में बदलाव किया जा सकता है.

Google Street View, कवरेज एरिया में मौजूद जगहों के पैनोरामिक व्यू दिखाता है. उपयोगकर्ताओं के योगदान से बने फ़ोटोस्फ़ीयर और Street View के खास कलेक्शन भी उपलब्ध हैं.

Street View का यूआरएल बनाना

https://www.google.com/maps/@?api=1&map_action=pano&parameters

पैरामीटर

• map_action=pano (ज़रूरी है): इससे पता चलता है कि किस तरह का व्यू दिखाना है. Maps और Street View, दोनों के लिए एक ही एंडपॉइंट का इस्तेमाल किया जाता है. पैनोरामा दिखाने के लिए, action को pano के तौर पर सेट करना ज़रूरी है.

इनमें से कोई एक यूआरएल पैरामीटर भी ज़रूरी है:

• viewpoint: दर्शक को viewpoint लोकेशन के सबसे पास का पैनोरमा दिखता है. इसे कॉमा लगाकर अलग किए गए अक्षांश/देशांतर निर्देशांकों के तौर पर दिखाया जाता है. उदाहरण के लिए, 46.414382,10.013988. Street View की तस्वीरों को समय-समय पर रीफ़्रेश किया जाता है. साथ ही, हर बार फ़ोटो थोड़ी अलग जगहों से ली जा सकती हैं. इसलिए, ऐसा हो सकता है कि तस्वीरों को अपडेट करने पर, आपकी जगह की जानकारी किसी दूसरे पैनोरामा पर स्नैप हो जाए.
• pano: इमेज का खास पैनोरामा आईडी, जिसे दिखाना है. अगर आपने pano की वैल्यू दी है, तो viewpoint की वैल्यू भी दी जा सकती है. viewpoint का इस्तेमाल सिर्फ़ तब किया जाता है, जब Google Maps को पैनोरामा आईडी नहीं मिलता. अगर pano की जानकारी दी गई है, लेकिन वह नहीं मिला और viewpoint की जानकारी नहीं दी गई है, तो कोई पैनोरामा इमेज नहीं दिखाई जाती. इसके बजाय, Google Maps डिफ़ॉल्ट मोड में खुलता है. इसमें उपयोगकर्ता की मौजूदा जगह के हिसाब से मैप दिखता है.

इन यूआरएल पैरामीटर को शामिल करना ज़रूरी नहीं है:

• heading: इससे पता चलता है कि कैमरे का कंपास, उत्तर दिशा से घड़ी की सुई की दिशा में कितने डिग्री पर है. स्वीकार की जाने वाली वैल्यू -180 से 360 डिग्री के बीच होती हैं. अगर इसे शामिल नहीं किया जाता है, तो क्वेरी के व्यूपॉइंट (अगर बताया गया हो) और इमेज की असल जगह के आधार पर, डिफ़ॉल्ट हेडिंग चुनी जाती है.
• pitch: इससे कैमरे के ऊपर या नीचे के ऐंगल के बारे में पता चलता है. पिच को -90 से 90 डिग्री के बीच में तय किया जाता है. पॉज़िटिव वैल्यू से कैमरा ऊपर की ओर झुकेगा, जबकि नेगेटिव वैल्यू से कैमरा नीचे की ओर झुकेगा. कैमरे की पोज़िशन के आधार पर, डिफ़ॉल्ट पिच 0 सेट की जाती है. यह पोज़िशन, इमेज कैप्चर करते समय कैमरे की पोज़िशन होती है. इस वजह से, 0 की पिच अक्सर हॉरिज़ॉन्टल होती है, लेकिन हमेशा ऐसा नहीं होता. उदाहरण के लिए, किसी पहाड़ी पर ली गई इमेज में डिफ़ॉल्ट रूप से ऐसी पिच दिख सकती है जो हॉरिज़ॉन्टल न हो.
• fov: इससे इमेज का हॉरिज़ॉन्टल फ़ील्ड ऑफ़ व्यू तय होता है. फ़ील्ड ऑफ़ व्यू को डिग्री में दिखाया जाता है. इसकी रेंज 10 से 100 के बीच होती है. यह डिफ़ॉल्ट रूप से 90 पर सेट होता है. तय साइज़ वाले व्यूपोर्ट के साथ काम करते समय, फ़ील्ड ऑफ़ व्यू को ज़ूम करने का लेवल माना जाता है. इसमें छोटी संख्याएं, ज़ूम करने के ज़्यादा लेवल को दिखाती हैं.

Street View के उदाहरण

पहले दो उदाहरणों में, आइफ़िल टावर का पैनोरमा दिखाया गया है. पहले उदाहरण में, सिर्फ़ जगह की जानकारी के लिए viewpoint का इस्तेमाल किया गया है. साथ ही, heading, pitch, और fov पैरामीटर सेट किए गए हैं. ये पैरामीटर ज़रूरी नहीं हैं. तुलना करने के लिए, दूसरे उदाहरण में pano आईडी के साथ-साथ पहले उदाहरण में सेट किए गए पैरामीटर का इस्तेमाल किया गया है. तीसरे उदाहरण में, घर के अंदर की पैनोरामा इमेज दिखाई गई है.

पहला उदाहरण: जगह की जानकारी देने के लिए, सिर्फ़ viewpoint का इस्तेमाल किया गया है.

https://www.google.com/maps/@?api=1&map_action=pano&viewpoint=48.857832%2C2.295226&heading=-45&pitch=38&fov=80

दूसरा उदाहरण: इसमें pano आईडी के साथ-साथ viewpoint जगह की जानकारी का इस्तेमाल किया गया है. pano आईडी को viewpoint के मुकाबले प्राथमिकता दी जाती है. इस उदाहरण में, पैनोरमा आईडी मिल गया है. इसलिए, viewpoint को अनदेखा कर दिया गया है. ध्यान दें कि pano आईडी के लिए दिखाई गई पैनोरमा इमेज, सिर्फ़ viewpoint का इस्तेमाल करके मिली इमेज से थोड़ी अलग है. साथ ही, यह ज़्यादा नई है.

https://www.google.com/maps/@?api=1&map_action=pano&pano=tu510ie_z4ptBZYo2BGEJg&viewpoint=48.857832%2C2.295226&heading=-45&pitch=38&fov=80

तीसरा उदाहरण: इसमें यूके के लंदन में मौजूद स्रास्त्रो रेस्टोरेंट के अंदर का पैनोरमा दिखाया गया है. इसे पैनोरमा आईडी के साथ दिखाया गया है.

https://www.google.com/maps/@?api=1&map_action=pano&pano=4U-oRQCNsC6u7r8gp02sLA

पैनोरामा आईडी ढूंढना

किसी पैनोरामा इमेज का आईडी ढूंढने के लिए, कई तरीके इस्तेमाल किए जा सकते हैं.

• JavaScript के लिए, StreetViewPanorama क्लास का इस्तेमाल करें.
• Android के लिए, सार्वजनिक क्लास StreetViewPanoramaLocation का इस्तेमाल करें.
• iOS के लिए, GMSPanorama क्लास का इस्तेमाल करें.
• Google Street View Image API का इस्तेमाल करके, मेटाडेटा के अनुरोध भी किए जा सकते हैं. इमेज के मेटाडेटा के अनुरोधों से, Street View पैनोरामा का डेटा मिलता है. इसमें पैनोरामा आईडी भी शामिल है.

---

शॉर्टलिस्ट बनाना

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

चुनी गई जगहों की सूची का यूआरएल बनाना

https://www.google.com/maps/@?api=1&map_action=shortlist&parameters

पैरामीटर

• map_action=shortlist (ज़रूरी है): इससे शॉर्टलिस्ट करने की कार्रवाई के बारे में पता चलता है.
• place_ids (ज़रूरी है): इससे यह तय होता है कि शॉर्टलिस्ट में कौनसी जगहें शामिल करनी हैं. यह पैरामीटर, कॉमा लगाकर अलग की गई वैल्यू के तौर पर, एक या उससे ज़्यादा जगह के आईडी स्वीकार करता है. ज़्यादा से ज़्यादा 20 जगह के आईडी डाले जा सकते हैं.

चुनी गई जगहों की सूची का उदाहरण

यहां दिए गए उदाहरण में, तीन खास जगहों की शॉर्टलिस्ट वाला मैप लॉन्च किया गया है.

https://www.google.com/maps/@?api=1&map_action=shortlist&place_ids=ChIJKxjxuaNqkFQR3CK6O1HNNqY,ChIJdWjwULVqkFQRh8ifgzporms,ChIJQ_oEiK1qkFQRg3bU4l3mmWs

---

और उदाहरण

वेपॉइंट का इस्तेमाल करके दिशा-निर्देश पाने के उदाहरण

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

शहर, देश	स्थान नाम	जगह का आईडी
1. वर्सैलेस, फ़्रांस	वर्साय का महल	ChIJdUyx15R95kcRj85ZX8H8OAU
2. शार्ट्र, फ़्रांस	शार्त्र कैथेड्रल	ChIJKzGHdEgM5EcR_OBTT3nQoEA
3. ल मॉ, फ़्रांस	कैथेड्रल ऑफ़ सेंट जूलियन ऑफ़ ले मैंस	ChIJG2LvQNCI4kcRKXNoAsPi1Mc
4. काँ, फ़्रांस	कान कैसल	ChIJ06tnGbxCCkgRsfNjEQMwUsc

उदाहरण के तौर पर दिए गए यूआरएल में, वेपॉइंट को अलग-अलग तरीकों से तय किया गया है. इससे, आपको मैप पर वेपॉइंट के डिसप्ले में अंतर की तुलना करने में मदद मिलेगी.

पहला उदाहरण: शहर और देश के हिसाब से तय किए गए वेपॉइंट:

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Versailles%2CFrance%7CChartres%2CFrance%7CLe+Mans%2CFrance%7CCaen%2CFrance

दूसरा उदाहरण: वेपॉइंट को किसी जगह के नाम के तौर पर तय किया गया है:

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Palace+of+Versailles%7CChartres+Cathedral%7CCathedral+of+Saint+Julian+of+Le+Mans%7CCaen+Castle

उदाहरण 3: वेपॉइंट को शहर और देश के तौर पर तय किया गया है. साथ ही, हर वेपॉइंट में किसी खास जगह के लिए waypoint_place_ids भी दिया गया है:

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Versailles%2CFrance%7CChartres%2CFrance%7CLe+Mans%2CFrance%7CCaen%2CFrance&waypoint_place_ids=ChIJdUyx15R95kcRj85ZX8H8OAU%7CChIJKzGHdEgM5EcR_OBTT3nQoEA%7CChIJG2LvQNCI4kcRKXNoAsPi1Mc%7CChIJ06tnGbxCCkgRsfNjEQMwUsc

उदाहरण 4: इसमें वेपॉइंट को शहर, देश के तौर पर तय किया गया है. हालांकि, वेपॉइंट को पिछले उदाहरणों की तुलना में अलग क्रम में दिखाया गया है. इससे पता चलता है कि मैप, यूआरएल में दिए गए क्रम में वेपॉइंट दिखाता है.

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Versailles%2CFrance%7CCaen%2CFrance%7CLe+Mans%2CFrance%7CChartres%2CFrance

मैप के उदाहरण

यह मैप को तय किए गए basemap (सैटलाइट) और layer (बस, मेट्रो वगैरह) के साथ दिखाता है.

https://www.google.com/maps/@?api=1&map_action=map&center=37.7992940%2C-122.3976113&zoom=15&basemap=satellite&layer=transit

Street View के उदाहरण

इस उदाहरण में, FIFE इमेज कुंजी का इस्तेमाल करके Street View पैनोरामा दिखाया गया है. इसे pano आईडी के तौर पर इस्तेमाल किया गया है. ध्यान दें कि pano आईडी की शुरुआत में F: लिखा होता है.

https://www.google.com/maps/@?api=1&map_action=pano&pano=F:-ud6AZSB-sQg/V0cfCSV3OWI/AAAAAAAAG1U/UQEoc5sXPQEIP7zzD6SWzmKb8Vbug47uQCLIB&heading=22&pitch=-5&fov=55

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

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

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=YOUR_APP_NAME&utm_campaign=place_details_search