शुरू करें

शुरुआती जानकारी

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 के लिए प्लैटफ़ॉर्म के हिसाब से बने विकल्प का इस्तेमाल किया जा सकता है. यह दस्तावेज़ देखें:

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

Google Maps को लॉन्च करने और वैकल्पिक रूप से कोई एक फ़ंक्शन करने के लिए, अनुरोध की गई कार्रवाई के आधार पर इनमें से किसी एक फ़ॉर्म की यूआरएल स्कीम का इस्तेमाल करें:

  • खोजें — ऐसा Google मैप लॉन्च करें जो किसी खास जगह का पिन दिखाता हो या सामान्य खोज करें और नतीजे दिखाने के लिए मैप लॉन्च करें:
    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
  • 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, New York, NY" जैसे पते को 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 सबमिट करने का सुझाव भी दिया जाता है.

खोज के उदाहरण

जगह की जानकारी खोजना

जगह की जानकारी खोजते समय, किसी जगह के नाम, पते या कॉमा लगाकर अलग किए गए अक्षांश/देशांतर निर्देशांक इस्तेमाल करके, किसी जगह को खोजा जाता है और आपको दिखने वाला मैप, उस जगह का पिन दिखाता है. इन तीन उदाहरणों में एक ही जगह के लिए, अलग-अलग वैल्यू का इस्तेमाल करके CenturyLink फ़ील्ड (सिऐटल, वॉशिंगटन का स्पोर्ट्स स्टेडियम) के लिए की गई खोजें दिखाई गई हैं.

उदाहरण 1: नीचे दिए गए मैप में जगह के नाम "CenturyLink फ़ील्ड" पर खोज करने पर नतीजा दिखता है:

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

उदाहरण 2: नीचे दिए गए मैप में, अक्षांश/देशांतर निर्देशांक और जगह के आईडी से मिले CenturyLink फ़ील्ड को खोजने पर:

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

उदाहरण 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&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 (जो साइकल के रास्ते और जहां उपलब्ध हो, वहां की पसंदीदा सड़कों से होकर जाता है) या 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

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

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+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 मैप लॉन्च किया गया है.

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

इस उदाहरण में, कटूम्बा, NSW, ऑस्ट्रेलिया (-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

उदाहरण 2: 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

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

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

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

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

ज़्यादा उदाहरण

वेपॉइंट इस्तेमाल करके, रास्तों के उदाहरण

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

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

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

उदाहरण 1: शहर, देश के रूप में वेपॉइंट:

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

उदाहरण 2: वेपॉइंट, जगहों के खास नाम के तौर पर बताए गए हैं:

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

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

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 के उदाहरण

pano आईडी के तौर पर FIFE इमेज कुंजी इस्तेमाल करके, Street View पैनोरामा दिखाता है. ध्यान दें कि 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