सुविधा के बारे में जानकारी
Maps यूआरएल का इस्तेमाल करके, सभी प्लैटफ़ॉर्म के लिए एक यूनिवर्सल यूआरएल बनाया जा सकता है. इससे, Google Maps लॉन्च हो सकता है. साथ ही, खोज की जा सकती है, निर्देश पाए जा सकते हैं, और नेविगेशन के साथ मैप व्यू और पैनोरामा इमेज दिखाई जा सकती हैं. चाहे यूआरएल किसी भी प्लैटफ़ॉर्म पर हो, यूआरएल सिंटैक्स एक जैसा ही होता है.
Maps यूआरएल का इस्तेमाल करने के लिए, आपको Google API (एपीआई) कुंजी की ज़रूरत नहीं है.
यूनिवर्सल क्रॉस-प्लैटफ़ॉर्म सिंटैक्स
Android ऐप्लिकेशन, iOS ऐप्लिकेशन या वेबसाइट के डेवलपर के तौर पर, एक कॉमन यूआरएल बनाया जा सकता है. साथ ही, इससे Google Maps खुल जाएगा और अनुरोध की गई कार्रवाई को पूरा करेगा, भले ही मैप खोलने पर किसी भी प्लैटफ़ॉर्म का इस्तेमाल किया जा रहा हो.
- Android डिवाइस पर:
- अगर Android के लिए Google Maps ऐप्लिकेशन इंस्टॉल है और चालू है, तो यूआरएल Maps ऐप्लिकेशन में लॉन्च होगा और अनुरोध की गई कार्रवाई को पूरा करेगा.
- अगर Google Maps ऐप्लिकेशन इंस्टॉल नहीं है या बंद है, तो यूआरएल किसी ब्राउज़र में Google Maps लॉन्च करता है और अनुरोध की गई कार्रवाई करता है.
- iOS डिवाइस पर:
- अगर iOS के लिए Google Maps ऐप्लिकेशन इंस्टॉल किया गया है, तो यूआरएल को 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¶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
- स्ट्रीट व्यू पैनोरामा दिखाना
— इंटरैक्टिव पैनोरामा इमेज लॉन्च करना:
https://www.google.com/maps/@?api=1&map_action=pano¶meters
ज़रूरी जानकारी: पैरामीटर api=1
, इस वर्शन के लिए तय किए गए Maps के वर्शन की पहचान करता है. हर अनुरोध में यह पैरामीटर डालना ज़रूरी है. सिर्फ़ एक वैल्यू सही है. अगर यूआरएल में api=1
मौजूद नहीं है, तो ब्राउज़र या Google Maps के मोबाइल ऐप्लिकेशन में सभी पैरामीटर को अनदेखा किया जाता है और डिफ़ॉल्ट Google Maps ऐप्लिकेशन लॉन्च किया जाता है. यह इस बात पर निर्भर करता है कि प्लैटफ़ॉर्म का इस्तेमाल किस समय किया जा रहा है (उदाहरण के लिए, https://www.google.com/maps).
मान्य यूआरएल बनाना
यूआरएल को सही तरीके से कोड में बदलें.
उदाहरण के लिए, कुछ पैरामीटर विभाजक के रूप में पाइप वर्ण (|
) का इस्तेमाल करते हैं, जिसे आपको फ़ाइनल यूआरएल में %7C
के तौर पर कोड में बदलना होगा. दूसरे पैरामीटर में कॉमा/सेपरेटेड वैल्यू का इस्तेमाल किया जाता है, जैसे कि अक्षांश/देशांतर के निर्देशांक या शहर, राज्य. आपको कॉमा को %2C
के तौर पर कोड में बदलना होगा. स्पेस को %20
से बदलें या उन्हें प्लस के निशान (+
) से बदलें.
इसके अलावा, यूआरएल के हर अनुरोध में ज़्यादा से ज़्यादा 2,048 वर्ण इस्तेमाल किए जा सकते हैं. अपने यूआरएल बनाते समय इस सीमा के बारे में ध्यान रखें.
मैप ऐक्शन
मैप पर ये कार्रवाइयां मिलती हैं: खोजना, निर्देश, मैप दिखाना, और स्ट्रीट व्यू पैनोरामा दिखाना. आप अनुरोध के यूआरएल में ज़रूरी और वैकल्पिक पैरामीटर के साथ कार्रवाई तय करते हैं. जैसा कि यूआरएल में स्टैंडर्ड है, एंपरसैंड (&
) वर्ण का इस्तेमाल करके पैरामीटर को अलग किया जाता है. हर कार्रवाई के लिए, पैरामीटर और उनकी संभावित वैल्यू की सूची, Search पैरामीटर सेक्शन में दी जाती है.
खोजें
खोज की कार्रवाई, मैप पर दिखने वाली सभी जगहों पर की गई खोज के नतीजे दिखाती है. किसी खास जगह को खोजने पर, मैप उसकी जगह पर पिन डाल देता है और उस जगह की जानकारी दिखाता है.
सर्च यूआरएल बनाना
https://www.google.com/maps/search/?api=1¶meters
पैरामीटर
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
सबमिट करें.
खोज के उदाहरण
जगह खोजना
जगह खोजने के दौरान, आप किसी जगह के नाम, पते या कॉमा-सेपरेटेड अक्षांश/देशांतर निर्देशांकों का इस्तेमाल करके किसी खास जगह को खोजते हैं. नतीजे के तौर पर मिला मैप उस जगह पर एक पिन दिखाता है. इन तीन उदाहरणों में एक ही जगह की खोजों को दिखाया गया है. साथ ही, इन जगहों के अलग-अलग वैल्यू का इस्तेमाल करके, सेंचुरीलिंक फ़ील्ड (सिएटल, डब्ल्यूए में एक स्पोर्ट्स स्टेडियम) की जानकारी दी गई है.
उदाहरण 1: स्थान नाम "CenturyLink फ़ील्ड" खोजने के नतीजे इस मैप पर दिखाई देंगे:
https://www.google.com/maps/search/?api=1&query=centurylink+field
उदाहरण 2: अक्षांश/देशांतर निर्देशांकों के साथ-साथ जगह के आईडी के नतीजों का इस्तेमाल करके, CenturyLink फ़ील्ड को खोजना:
उदाहरण 3: सिर्फ़ अक्षांश/देशांतर का इस्तेमाल करके सेंचुरीलिंक फ़ील्ड खोजने से इस मैप के नतीजे मिलते हैं. ध्यान दें कि मैप पर एक पिन मौजूद है, लेकिन मैप या साइड पैनल में उस जगह की कोई और जानकारी नहीं है:
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
निर्देश
दिशा-निर्देश कार्रवाई, मैप पर दिए गए दो या ज़्यादा खास बिंदुओं के साथ-साथ दूरी और यात्रा का समय दिखाती है.
निर्देश URL बनाना
https://www.google.com/maps/dir/?api=1¶meters
पैरामीटर
origin
: दिशा-निर्देश दिखाने की शुरुआत की जगह बताता है. सबसे ज़्यादा काम की शुरुआत की जगह डिफ़ॉल्ट पर सेट होती है, जैसे कि डिवाइस की जगह की जानकारी (अगर उपलब्ध हो). अगर कोई भी एक नतीजे के तौर पर नहीं दिखता है, तो उपयोगकर्ता को ऑरिजिन में जाने के लिए, एक खाली फ़ॉर्म दिखाया जा सकता है. वैल्यू किसी जगह का नाम, पता या कॉमा से अलग किए गए अक्षांश/देशांतर के निर्देशांक हो सकते हैं. स्ट्रिंग को यूआरएल कोड में बदला गया होना चाहिए. इसलिए, "सिटी हॉल, न्यूयॉर्क, एनवाई" जैसे पते कोCity+Hall%2C+New+York%2C+NY
में बदला जाना चाहिए.ध्यान दें: जब तक आप अपने यूआरएल में
origin_place_id
न डालें, तब तक यह पैरामीटर ज़रूरी नहीं होता है. अगर आपorigin_place_id
के बारे में बताना चाहते हैं, तो आपको यूआरएल मेंorigin
भी शामिल करना होगा.origin_place_id
(ज़रूरी नहीं): जगह का आईडी, टेक्स्ट के तौर पर एक आइडेंटिफ़ायर होता है. यह किसी जगह की पहचान करता है. अगर आप कोई इमारत बनाने की कोशिश करेंगे, तो पक्का करें कि जगह का आईडी इस्तेमाल करके, आप सही जगह पर जा सकें. इस पैरामीटर का इस्तेमाल करने वाले यूआरएल मेंorigin
भी होना चाहिए.destination
: निर्देशों के एंडपॉइंट के बारे में बताता है. अगर कोई भी नतीजा नहीं मिलता, तो नतीजे में मैप एक खाली फ़ॉर्म दिखा सकता है, ताकि उपयोगकर्ता मंज़िल पर जा सके. वैल्यू किसी जगह का नाम, पता या कॉमा से अलग किए गए अक्षांश/देशांतर के निर्देशांक हो सकते हैं. स्ट्रिंग को यूआरएल कोड में बदला गया होना चाहिए. इसलिए, "सिटी हॉल, न्यूयॉर्क, एनवाई" जैसे पते को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 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
की सूची से मेल खाने के लिए, जगह के आईडी की सूची देने की सुविधा देता है. जगह के आईडी को वेपॉइंट के क्रम में लगाया जाना चाहिए. साथ ही, उन्हें पाइप वर्ण "|
" ( यूआरएल कोड में बदले गए) का इस्तेमाल करके,%7C
के तौर पर अलग किया जाना चाहिए. अगर साइट के लिए कुछ तय जगहों के बारे में बताने की कोशिश की जा रही है, तो पक्का करें कि प्लेस आईडी सही जगह पर ले जाए. इस पैरामीटर का इस्तेमाल करने वाले यूआरएल मेंwaypoints
भी शामिल होने चाहिए.
दिशा-निर्देशों के उदाहरण
नीचे दिया गया यूआरएल, निर्देश मोड में एक मैप लॉन्च करता है. साथ ही, एक फ़ॉर्म देकर, उपयोगकर्ता को शुरुआत की जगह और मंज़िल की जानकारी डालने की अनुमति दी जाती है.
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
नीचे दिए गए उदाहरण में, Katoomba, NSW, ऑस्ट्रेलिया (-33.712206,150.311941
में) पर आधारित मैप दिखाया गया है. साथ ही, zoom
और basemap
के वैकल्पिक पैरामीटर सेट किया गया है.
स्ट्रीट व्यू पैनोरामा दिखाना
Pano कार्रवाई की मदद से, आप व्यूअर को Street View इमेज को इंटरैक्टिव पैनोरामा के तौर पर दिखा सकते हैं. हर Street View पैनोरामा में, एक ही जगह से 360 डिग्री का पूरा व्यू दिखता है. इमेज में 360 डिग्री हॉरिज़ॉन्टल व्यू (पूरा रैप-अराउंड) और 180 डिग्री वर्टिकल व्यू (सीधे ऊपर से नीचे की ओर) शामिल हैं. पैनोरामा कार्रवाई एक व्यूअर को लॉन्च करती है, जो नतीजे में दिखने वाले पैनोरामा को कैमरे के बीच में कैमरे के साथ रेंडर करता है. अपने कैमरे के ज़ूम और उसका ओरिएंटेशन कंट्रोल करने के लिए, आपके पास उसमें बदलाव करने का विकल्प होता है.
Google 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
आईडी के साथ-साथ
पहले उदाहरण में सेट किए गए पैरामीटर का ही इस्तेमाल किया जाता है. तीसरा उदाहरण, इनडोर पैनोरामा इमेज दिखाता है.
उदाहरण 1: जगह की जानकारी देने के लिए सिर्फ़ 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: खास जगहों के नाम के लिए तय किए गए वेपॉइंट:
तीसरा उदाहरण: वेपॉइंट जिनसे शहर, देश का पता चलता है, और हर वेपॉइंट में किसी खास जगह के लिए waypoint_place_ids
की जानकारी भी देता है:
चौथा उदाहरण: वेपॉइंट को शहर, देश के तौर पर बताता है. हालांकि, इसमें पिछले उदाहरणों की तुलना में वेपॉइंट को अलग-अलग क्रम में दिखाया जाता है. यह दिखाता है कि मैप में यूआरएल को जिस क्रम में दिखाया गया है उसी क्रम में मैप में उन्हें दिखाया जाता है.
मैप के उदाहरण
तय किए गए basemap
(satellite) और
layer
(transit) वाला मैप दिखाता है.
Street View के उदाहरण
pano
आईडी के तौर पर FIFE की इमेज कुंजी का इस्तेमाल करके, स्ट्रीट व्यू पैनोरामा दिखाता है. ध्यान दें कि pano
आईडी के पहले वाला F: होता है.