शुरुआती जानकारी
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 मैप लॉन्च करें जो किसी खास जगह का पिन दिखाता हो या
सामान्य खोज करें और नतीजे दिखाने के लिए मैप लॉन्च करें:
https://www.google.com/maps/search/?api=1¶meters
- निर्देश
— निर्देशों का अनुरोध करें और नतीजों के साथ Google Maps लॉन्च करें:
https://www.google.com/maps/dir/?api=1¶meters
- मैप दिखाएं
— बिना किसी मार्कर या निर्देश के Google Maps लॉन्च करें:
https://www.google.com/maps/@?api=1&map_action=map¶meters
- Street View पैनोरामा दिखाना
— इंटरैक्टिव पैनोरामा इमेज लॉन्च करें:
https://www.google.com/maps/@?api=1&map_action=pano¶meters
अहम जानकारी: पैरामीटर 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¶meters
पैरामीटर
query
(ज़रूरी है): मैप पर हाइलाइट की जाने वाली जगहों के बारे में बताता है. सभी खोज अनुरोधों के लिए क्वेरी पैरामीटर ज़रूरी है.- जगहों को जगह के नाम, पते या कॉमा लगाकर अलग किए गए अक्षांश/देशांतर निर्देशांक के तौर पर
बताएं. स्ट्रिंग,
यूआरएल के हिसाब से कोड में बदली गई हों. इसलिए, "City Hall, New York, NY" जैसे
पते को
City+Hall%2C+New+York%2C+NY
में बदलना चाहिए. - खोज के लिए इस्तेमाल हुए सामान्य शब्दों को
यूआरएल के कोड में बदले गए स्ट्रिंग के तौर पर बताएं, जैसे कि
grocery+stores
याrestaurants+in+seattle+wa
.
- जगहों को जगह के नाम, पते या कॉमा लगाकर अलग किए गए अक्षांश/देशांतर निर्देशांक के तौर पर
बताएं. स्ट्रिंग,
यूआरएल के हिसाब से कोड में बदली गई हों. इसलिए, "City Hall, New York, NY" जैसे
पते को
query_place_id
(ज़रूरी नहीं): जगह का आईडी, टेक्स्ट के तौर पर एक आइडेंटिफ़ायर होता है. यह किसी जगह की खास तौर पर पहचान करता है.search
कार्रवाई के लिए, आपकोquery
बताना होगा, लेकिन आपquery_place_id
भी तय कर सकते हैं. अगर दोनों पैरामीटर तय किए जाते हैं, तोquery
का इस्तेमाल सिर्फ़ तब किया जाता है, जब Google Maps को जगह का आईडी नहीं मिल रहा हो. अगर आपको किसी खास जगह से लिंक करना है, तो जगह का आईडी इस बात की सबसे ज़्यादा गारंटी है कि आप सही जगह से लिंक करेंगे. जब अक्षांश/देशांतर निर्देशांक का इस्तेमाल करके किसी खास जगह के लिए क्वेरी की जाती है, तोquery_place_id
सबमिट करने का सुझाव भी दिया जाता है.
खोज के उदाहरण
जगह की जानकारी खोजना
जगह की जानकारी खोजते समय, किसी जगह के नाम, पते या कॉमा लगाकर अलग किए गए अक्षांश/देशांतर निर्देशांक इस्तेमाल करके, किसी जगह को खोजा जाता है और आपको दिखने वाला मैप, उस जगह का पिन दिखाता है. इन तीन उदाहरणों में एक ही जगह के लिए, अलग-अलग वैल्यू का इस्तेमाल करके CenturyLink फ़ील्ड (सिऐटल, वॉशिंगटन का स्पोर्ट्स स्टेडियम) के लिए की गई खोजें दिखाई गई हैं.
उदाहरण 1: नीचे दिए गए मैप में जगह के नाम "CenturyLink फ़ील्ड" पर खोज करने पर नतीजा दिखता है:
https://www.google.com/maps/search/?api=1&query=centurylink+field
उदाहरण 2: नीचे दिए गए मैप में, अक्षांश/देशांतर निर्देशांक और जगह के आईडी से मिले CenturyLink फ़ील्ड को खोजने पर:
उदाहरण 3: नीचे दिए गए मैप में, सिर्फ़ अक्षांश/देशांतर निर्देशांक के नतीजों का इस्तेमाल करके CenturyLink फ़ील्ड खोजने पर दिखेगा. ध्यान दें कि मैप में एक पिन है, लेकिन मैप पर या साइड पैनल में जगह की कोई अतिरिक्त जानकारी नहीं दी गई है:
https://www.google.com/maps/search/?api=1&query=47.5951518%2C-122.3316393
कैटगरिकल सर्च
कैटगरी के आधार पर की गई खोज में, आपको खोज के लिए एक सामान्य शब्द पास किया जाता है. इसके बाद, 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¶meters
पैरामीटर
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
(जो साइकल के रास्ते और जहां उपलब्ध हो, वहां की पसंदीदा सड़कों से होकर जाता है) याtransit
. अगरtravelmode
के बारे में नहीं बताया गया है, तो Google मैप उस रास्ते और/या उपयोगकर्ता की पसंद के मुताबिक एक या एक से ज़्यादा काम के मोड दिखाता है.dir_action=navigate
(ज़रूरी नहीं): ऑरिजिन उपलब्ध है या नहीं, इसके आधार पर तय की गई मंज़िल के लिए मोड़-दर-मोड़ नेविगेशन या रास्ते की झलक को लॉन्च करता है. अगर उपयोगकर्ता, शुरुआत की जगह के बारे में जानकारी देता है और वह उपयोगकर्ता की मौजूदा जगह के आस-पास नहीं है या डिवाइस की मौजूदा जगह की जानकारी उपलब्ध नहीं है, तो मैप, रास्ते की झलक लॉन्च करता है. अगर उपयोगकर्ता, शुरुआत की जगह के बारे में जानकारी नहीं देता है (इस मामले में, ऑरिजिन डिफ़ॉल्ट रूप से डिवाइस की मौजूदा जगह के हिसाब से होता है) या ऑरिजिन, उपयोगकर्ता की मौजूदा जगह के करीब होता है, तो मैप मोड़-दर-मोड़ नेविगेशन लॉन्च कर देता है. ध्यान दें कि Google Maps के सभी प्रॉडक्ट और/या सभी डेस्टिनेशन के बीच नेविगेशन की सुविधा उपलब्ध नहीं है. उन मामलों में इस पैरामीटर को अनदेखा कर दिया जाएगा.waypoints
:origin
सेdestination
के बीच तक पहुंचने के लिए, रास्ते के निर्देश देने वाली एक या एक से ज़्यादा मध्यस्थ जगहों की जानकारी देता है. जगहों (उदाहरण के लिए,Berlin,Germany|Paris,France
) को अलग-अलग करने के लिए पाइप वर्ण (|
) का इस्तेमाल करके कई वेपॉइंट दिए जा सकते हैं. लिंक खुलने वाले प्लैटफ़ॉर्म के हिसाब से, वेपॉइंट की संख्या अलग-अलग हो सकती है. मोबाइल ब्राउज़र पर काम करने वाले ज़्यादा से ज़्यादा तीन वेपॉइंट हो सकते हैं और ज़्यादा से ज़्यादा नौ वेपॉइंट इस्तेमाल किए जा सकते हैं. मैप पर वेपॉइंट उसी क्रम में दिखाए जाते हैं जिस क्रम में वे यूआरएल में दिए गए हैं. हर वेपॉइंट या तो जगह का नाम, पता या कॉमा लगाकर अलग किए गए अक्षांश/देशांतर निर्देशांक हो सकते हैं. स्ट्रिंग को यूआरएल के हिसाब से कोड में बदला जाना चाहिए. इसलिए, "बर्लिन,जर्मनी|पेरिस,फ़्रांस" जैसे वेपॉइंट कोBerlin%2CGermany%7CParis%2CFrance
में बदला जाना चाहिए.Notes:
- Google Maps के सभी प्रॉडक्ट पर वेपॉइंट का इस्तेमाल नहीं किया जा सकता. इन मामलों में, इस पैरामीटर को अनदेखा कर दिया जाएगा.
- अगर आपने यूआरएल में
waypoint_place_ids
शामिल नहीं किया है, तो इस पैरामीटर का इस्तेमाल करना ज़रूरी नहीं है. अगर आपwaypoint_place_ids
के बारे में बताना चाहते हैं, तो आपको यूआरएल मेंwaypoints
को भी शामिल करना होगा.
waypoint_place_ids
(ज़रूरी नहीं): जगह का आईडी, टेक्स्ट के तौर पर एक आइडेंटिफ़ायर होता है. यह किसी जगह की खास तौर पर पहचान करता है.Waypoint_place_ids
आपकोwaypoints
की सूची से मैच करने वाली जगह के आईडी की सूची देने की अनुमति देता है. प्लेस आईडी उसी क्रम में लिस्ट किए जाने चाहिए जिस क्रम में वेपॉइंट हैं. साथ ही, उन्हें पाइप वर्ण "|
" ( यूआरएल को%7C
के तौर पर कोड में बदला गया) का इस्तेमाल करके अलग किया जाना चाहिए. अगर आपको कुछ खास जगहों की जानकारी देनी है, तो प्लेस आईडी इस बात की सबसे अच्छी गारंटी है कि आप सही जगहों से लिंक करेंगे. इस पैरामीटर का इस्तेमाल करने वाले यूआरएल मेंwaypoints
भी शामिल होना चाहिए.avoid
(ज़रूरी नहीं): उन सुविधाओं को सेट करता है जिन्हें रूट करने से बचना चाहिए. इसे इनमें से एक या ज़्यादा विकल्पों पर सेट किया जा सकता है. इन्हें कॉमा लगाकर ",
" लगाकर अलग किया जा सकता है ( यूआरएल-कोड में बदला गया, जैसा कि%2C
है):ferries
highways
tolls
दिशा-निर्देशों के उदाहरण
यह यूआरएल, दिशा-निर्देश मोड में एक मैप लॉन्च करता है. साथ ही, एक फ़ॉर्म देता है, ताकि उपयोगकर्ता मूल और मंज़िल की जानकारी डाल सके.
https://www.google.com/maps/dir/?api=1
नीचे दिए गए उदाहरण में, एक मैप लॉन्च किया गया है. इसमें, सिएटल, वॉशिंगटन में स्पेस नीडल से लेकर पाइक प्लेस मार्केट तक साइकल से जाने के रास्ते हैं.
नीचे दिए गए उदाहरण में एक मैप लॉन्च किया गया है. इसमें, Google से सिडनी, ऑस्ट्रेलिया में क्वीन विक्टोरिया बिल्डिंग तक पैदल जाने के निर्देश दिए गए हैं.
मैप दिखाया जा रहा है
मैप कार्रवाई, बिना किसी मार्कर या दिशा-निर्देश वाला मैप दिखाती है.
मैप का यूआरएल बनाना
https://www.google.com/maps/@?api=1&map_action=map¶meters
पैरामीटर
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 मैप लॉन्च किया गया है.
https://www.google.com/maps/@?api=1&map_action=map
इस उदाहरण में, कटूम्बा, NSW, ऑस्ट्रेलिया (-33.712206,150.311941
पर) पर फ़ोकस किया गया मैप दिखाया गया है. साथ ही, zoom
और basemap
पैरामीटर के वैकल्पिक पैरामीटर को सेट किया गया है.
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¶meters
पैरामीटर
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
का इस्तेमाल करता है.
उदाहरण 2: pano
आईडी के साथ-साथ viewpoint
जगह का इस्तेमाल करता है.
pano
आईडी को viewpoint
के मुकाबले प्राथमिकता दी जाती है.
इस उदाहरण में, पैनोरामा आईडी मिला है, इसलिए viewpoint
को अनदेखा कर दिया गया है. ध्यान दें
कि pano
आईडी के लिए दिखाई जाने वाली पैनोरामा इमेज, सिर्फ़ viewpoint
का इस्तेमाल करके मिली इमेज से थोड़ी अलग और
सबसे नई होती है.
उदाहरण 3: लंदन, यूके में मौजूद सारस्ट्रो रेस्टोरेंट के अंदरूनी हिस्से का पैनोरामा दिखाता है और इसकी जानकारी के लिए पैनोरामा आईडी देता है.
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 को लॉन्च किया गया है. साथ ही, पेरिस, फ़्रांस से चेरबर्ग, फ़्रांस के लिए ड्राइविंग दिशा-निर्देश दिखाए गए हैं. यह वेपॉइंट है:
शहर, देश | स्थान नाम | जगह का आईडी |
---|---|---|
1. वर्सैलेस, फ़्रांस | वर्साय का महल | ChIJdUyx15R95kcRj85ZX8H8OAU |
2. चार्ट्रेस, फ़्रांस | शार्त्र कैथेड्रल | ChIJKzGHdEgM5EcR_OBTT3nQoEA |
3. ल मॉ, फ़्रांस | ले मैंस के सेंट जूलियन का कैथेड्रल | ChIJG2LvQNCI4kcRKXNoAsPi1Mc |
4. कान, फ़्रांस | कान का किला | ChIJ06tnGbxCCkgRsfNjEQMwUsc |
उदाहरण के तौर पर दिए गए यूआरएल में, वेपॉइंट अलग-अलग तरीके से बताए गए हैं, ताकि आप बनने वाले मैप पर वेपॉइंट के डिसप्ले के बीच के अंतर की तुलना कर सकें.
उदाहरण 1: शहर, देश के रूप में वेपॉइंट:
उदाहरण 2: वेपॉइंट, जगहों के खास नाम के तौर पर बताए गए हैं:
उदाहरण 3: वेपॉइंट, शहर और देश के तौर पर तय किए जाते हैं. साथ ही, हर वेपॉइंट में किसी खास होटल के लिए waypoint_place_ids
की सुविधा भी मिलती है:
चौथा उदाहरण: वेपॉइंट को शहर, देश के तौर पर तय करता है. हालांकि, पिछले उदाहरणों की तुलना में वेपॉइंट अलग-अलग क्रम में दिए गए होते हैं. यह दिखाता है कि मैप, वेपॉइंट उसी क्रम में दिखाता है जैसे वे यूआरएल में दिए गए हैं.
मैप के उदाहरण
तय किए गए basemap
(सैटलाइट) और
layer
(ट्रांज़िट) के साथ मैप दिखाता है.
Street View के उदाहरण
pano
आईडी के तौर पर FIFE इमेज कुंजी इस्तेमाल करके, Street View पैनोरामा दिखाता है. ध्यान दें
कि pano
आईडी की शुरुआत F: से होती है.