शुरू करें

संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

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

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 के उन वर्शन की पहचान करता है जिनके लिए यह यूआरएल बनाया गया है. हर अनुरोध में यह पैरामीटर ज़रूरी होता है. वैल्यू सिर्फ़ 1 है. अगर यूआरएल में 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, 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 सबमिट करें.

खोज के उदाहरण

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

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

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

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

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


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

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

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

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