शुरू करें

सुविधा के बारे में जानकारी

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

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
  • स्ट्रीट व्यू पैनोरामा दिखाना — इंटरैक्टिव पैनोरामा इमेज लॉन्च करना:
    https://www.google.com/maps/@?api=1&map_action=pano&parameters

ज़रूरी जानकारी: पैरामीटर 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&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 सबमिट करें.

खोज के उदाहरण

जगह खोजना

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

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

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&parameters

पैरामीटर

  • 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

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

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

नीचे दिए गए उदाहरण में, Katoomba, 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


स्ट्रीट व्यू पैनोरामा दिखाना

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

Google 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 आईडी के साथ-साथ पहले उदाहरण में सेट किए गए पैरामीटर का ही इस्तेमाल किया जाता है. तीसरा उदाहरण, इनडोर पैनोरामा इमेज दिखाता है.

उदाहरण 1: जगह की जानकारी देने के लिए सिर्फ़ 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

तीसरा उदाहरण: वेपॉइंट जिनसे शहर, देश का पता चलता है, और हर वेपॉइंट में किसी खास जगह के लिए 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 (satellite) और layer (transit) वाला मैप दिखाता है.

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 की इमेज कुंजी का इस्तेमाल करके, स्ट्रीट व्यू पैनोरामा दिखाता है. ध्यान दें कि 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