Android के लिए Google Maps ऐप्लिकेशन में ऐसे कई इंटेंट दिखाए गए हैं जिनका इस्तेमाल करके Google Maps को डिसप्ले, सर्च, नेविगेशन या Street View मोड में लॉन्च किया जा सकता है. अगर आपको अपने ऐप्लिकेशन में कोई मैप एम्बेड करना है, तो कृपया Google Maps Android API शुरुआती निर्देश देखें.
खास जानकारी
इंटेंट आपको किसी Intent
ऑब्जेक्ट में आसान कार्रवाई (जैसे कि "मैप दिखाना" या "हवाई अड्डे
के लिए दिशा-निर्देश दिखाएं") के बारे में जानकारी देकर दूसरे ऐप्लिकेशन में कोई गतिविधि शुरू करने का विकल्प देता है. Android के लिए Google Maps ऐप्लिकेशन, कई अलग-अलग इंटेंट के साथ काम करता है. इससे Google Maps ऐप्लिकेशन लॉन्च करके, चार में से कोई एक कार्रवाई की जा सकती है:
- किसी खास जगह पर मैप दिखाएं और उस पर ज़ूम करें.
- जगहें या जगहें खोजें और उन्हें मैप पर दिखाएं.
- एक जगह से दूसरी जगह जाने के लिए निर्देशों का अनुरोध करें. यात्रा के तीन साधनों से दिशा-निर्देश लौटाए जा सकते हैं: ड्राइविंग, पैदल चलना, साइकल चलाना.
- Google Street View में पैनोरामा तस्वीरें दिखाएं.
इस पेज पर उन इंटेंट के बारे में बताया गया है जिनका इस्तेमाल, Android के लिए Google Maps ऐप्लिकेशन के साथ किया जा सकता है. इंटेंट और इंटेंट फ़िल्टर या Android प्लैटफ़ॉर्म पर आम तौर पर इस्तेमाल होने वाले इंटेंट के बारे में ज़्यादा जानकारी के लिए, Android डेवलपर का दस्तावेज़ देखें.
इंटेंट के अनुरोध
किसी इंटेंट के साथ Google Maps को लॉन्च करने के लिए, पहले आपको एक Intent
ऑब्जेक्ट बनाना होगा, जिसमें उसकी कार्रवाई, यूआरआई, और पैकेज की जानकारी दी गई हो.
- कार्रवाई: Google Maps के सभी इंटेंट को 'व्यू ऐक्शन' कहा जाता है —
ACTION_VIEW
. - यूआरआई: Google Maps के इंटेंट, कोड में बदले गए यूआरएल का इस्तेमाल करते हैं. इससे, कार्रवाई के बारे में जानकारी मिलती है. साथ ही, कार्रवाई करने के लिए कुछ डेटा भी मिलता है.
- पैकेज:
setPackage("com.google.android.apps.maps")
को कॉल करने से यह पक्का होगा कि Android के लिए Google Maps ऐप्लिकेशन इंटेंट को हैंडल करता है. अगर पैकेज सेट नहीं है, तो सिस्टम यह तय करेगा कि कौनसे ऐप्लिकेशनIntent
को हैंडल कर सकते हैं. अगर एक से ज़्यादा ऐप्लिकेशन उपलब्ध हैं, तो उपयोगकर्ता से पूछा जा सकता है कि उसे किस ऐप्लिकेशन का इस्तेमाल करना है.
Intent
बनाने के बाद, कई तरीकों से सिस्टम से उससे जुड़े ऐप्लिकेशन को लॉन्च करने का अनुरोध किया जा सकता है. आम तौर पर, Intent
को startActivity()
तरीके में पास किया जाता है. सिस्टम ज़रूरी ऐप्लिकेशन लॉन्च करेगा — इस मामले में Google Maps. इसके बाद, संबंधित ऐप्लिकेशन Activity
को शुरू करेगा.
Java
// Create a Uri from an intent string. Use the result to create an Intent. Uri gmmIntentUri = Uri.parse("google.streetview:cbll=46.414382,10.013988"); // Create an Intent from gmmIntentUri. Set the action to ACTION_VIEW Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); // Make the Intent explicit by setting the Google Maps package mapIntent.setPackage("com.google.android.apps.maps"); // Attempt to start an activity that can handle the Intent startActivity(mapIntent);
Kotlin
// Create a Uri from an intent string. Use the result to create an Intent. val gmmIntentUri = Uri.parse("google.streetview:cbll=46.414382,10.013988") // Create an Intent from gmmIntentUri. Set the action to ACTION_VIEW val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) // Make the Intent explicit by setting the Google Maps package mapIntent.setPackage("com.google.android.apps.maps") // Attempt to start an activity that can handle the Intent startActivity(mapIntent)
अगर सिस्टम किसी ऐसे ऐप्लिकेशन की पहचान नहीं कर पाता जो इंटेंट को जवाब दे सकता है, तो आपका ऐप्लिकेशन क्रैश हो सकता है. इस वजह से, किसी उपयोगकर्ता को इनमें से कोई इंटेंट दिखाने से पहले आपको यह पुष्टि करनी चाहिए कि ऐप्लिकेशन इंस्टॉल हो गया है.
यह पुष्टि करने के लिए कि कोई ऐप्लिकेशन इंटेंट पाने के लिए उपलब्ध है, अपने Intent
ऑब्जेक्ट पर
resolveActivity()
को कॉल करें. अगर नतीजा शून्य नहीं है, तो कम से कम एक ऐसा ऐप्लिकेशन है जो इंटेंट को मैनेज कर सकता है और startActivity()
को कॉल करना सुरक्षित है.
अगर नतीजा null
है, तो आपको इंटेंट का इस्तेमाल नहीं करना चाहिए. अगर हो सके, तो इंटेंट को शुरू करने वाली सुविधा बंद कर दें.
Java
if (mapIntent.resolveActivity(getPackageManager()) != null) { ... }
Kotlin
mapIntent.resolveActivity(packageManager)?.let { ... }
उदाहरण के लिए, दिल्ली का मैप दिखाने के लिए, इस कोड का इस्तेमाल किया जा सकता है:
Java
Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); if (mapIntent.resolveActivity(getPackageManager()) != null) { startActivity(mapIntent); }
Kotlin
val gmmIntentUri = Uri.parse("geo:37.7749,-122.4194") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") mapIntent.resolveActivity(packageManager)?.let { startActivity(mapIntent) }
यूआरएल के लिए कोड में बदली गई क्वेरी स्ट्रिंग
Google Maps इंटेंट को भेजी गई सभी स्ट्रिंग, यूआरआई कोड में बदली गई होनी चाहिए. उदाहरण के लिए,
स्ट्रिंग "1st & Pike, Seattle" को 1st%20%26%20Pike%2C%20Seattle
बन जाना चाहिए.
स्ट्रिंग में मौजूद स्पेस को %20 से एन्कोड किया जा सकता है या प्लस के निशान (+) से बदला जा सकता है.
स्ट्रिंग को कोड में बदलने के लिए, android.net.Uri
parse()
तरीके का इस्तेमाल किया जा सकता है.
उदाहरण के लिए:
Java
Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4192?q=" + Uri.encode("1st & Pike, Seattle"));
Kotlin
val gmmIntentUri = Uri.parse("geo:37.7749,-122.4192?q=" + Uri.encode("1st & Pike, Seattle"))
मैप दिखाया जा रहा है
किसी खास जगह पर मैप दिखाने और ज़ूम लेवल पर मैप दिखाने के लिए, geo:
इंटेंट का इस्तेमाल करें.
geo:latitude,longitude?z=zoom
पैरामीटर
latitude
औरlongitude
ने मैप का केंद्र बिंदु सेट किया.z
, वैकल्पिक तौर पर मैप का शुरुआती ज़ूम लेवल सेट करता है. स्वीकार की जाने वाली वैल्यू 0 (पूरी दुनिया के लिए) से लेकर 21 (अलग-अलग बिल्डिंग) तक होती हैं. ऊपरी सीमा चुनी गई जगह पर उपलब्ध मैप डेटा के आधार पर अलग-अलग हो सकती है.
उदाहरण
Java
// Creates an Intent that will load a map of San Francisco Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); startActivity(mapIntent);
Kotlin
// Creates an Intent that will load a map of San Francisco val gmmIntentUri = Uri.parse("geo:37.7749,-122.4194") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") startActivity(mapIntent)
कोई जगह खोजी जा रही है
किसी तय व्यूपोर्ट में खोज क्वेरी दिखाने के लिए इस इंटेंट का इस्तेमाल करें. जब क्वेरी के लिए एक ही नतीजा मिलता है, तो इस इंटेंट का इस्तेमाल किसी खास जगह या पते, जैसे कि लैंडमार्क, कारोबार, भौगोलिक सुविधा या शहर पर पिन दिखाने के लिए किया जा सकता है.
geo:latitude,longitude?q=query geo:0,0?q=my+street+address geo:0,0?q=latitude,longitude(label)
पैरामीटर
मैप दिखाने के लिए इस्तेमाल किए गए पैरामीटर के साथ-साथ, Search इन पैरामीटर के साथ काम करता है:
q
, मैप पर हाइलाइट की जाने वाली जगहों के बारे में बताता है. खोज के सभी अनुरोधों के लिए,q
पैरामीटर ज़रूरी है. यह किसी जगह को जगह के नाम या पते के तौर पर स्वीकार करता है. स्ट्रिंग, यूआरएल के हिसाब से कोड में बदली गई होनी चाहिए. इसलिए, "City Hall, New York, NY" जैसे पते को City+Hall,New+York,NY में बदलना चाहिए.label
की मदद से, मैप में बताई गई जगह पर कस्टम लेबल सेट किया जा सकता है.label
को स्ट्रिंग के तौर पर बताया जाना चाहिए.
कैटगरी के अनुसार खोज
अगर खोज के लिए इस्तेमाल हुए किसी सामान्य शब्द को पास किया जाता है, तो Google Maps आपके बताए गए अक्षांश/देशांतर के आस-पास की ऐसी जगह ढूंढने की कोशिश करेगा जो आपकी शर्तों से मेल खाती हो. अगर कोई जगह तय नहीं की गई है, तो Google Maps आस-पास की लिस्टिंग ढूंढने की कोशिश करेगा. उदाहरण के लिए:
Java
// Search for restaurants nearby Uri gmmIntentUri = Uri.parse("geo:0,0?q=restaurants"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); startActivity(mapIntent); // Search for restaurants in San Francisco Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194?q=restaurants"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); startActivity(mapIntent);
Kotlin
// Search for restaurants nearby val gmmIntentUri = Uri.parse("geo:0,0?q=restaurants") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") startActivity(mapIntent) // Search for restaurants in San Francisco val gmmIntentUri = Uri.parse("geo:37.7749,-122.4194?q=restaurants") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") startActivity(mapIntent)
क्वेरी स्ट्रिंग के साथ ज़ूम पैरामीटर तय करके, खोज के नतीजों को और भी बेहतर बनाया जा सकता है. नीचे दिए गए उदाहरण में, 10 का ज़ूम जोड़ने पर, रेस्टोरेंट को आस-पास के बजाय शहर के लेवल पर ढूंढने की कोशिश की जाएगी.
Java
Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194?z=10&q=restaurants"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); startActivity(mapIntent);
Kotlin
val gmmIntentUri = Uri.parse("geo:37.7749,-122.4194?z=10&q=restaurants") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") startActivity(mapIntent)
जगह की जानकारी खोजें
किसी खास पते को खोजने पर, उस जगह पर एक पिन दिखेगा.
Java
Uri gmmIntentUri = Uri.parse("geo:0,0?q=1600 Amphitheatre Parkway, Mountain+View, California"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); startActivity(mapIntent);
Kotlin
val gmmIntentUri = Uri.parse("geo:0,0?q=1600 Amphitheatre Parkway, Mountain+View, California") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") startActivity(mapIntent)
ऊपर दिया गया उदाहरण 0
,0
का अक्षांश/lng सेट करता है, लेकिन पते को क्वेरी स्ट्रिंग के रूप में पास करता है. किसी खास जगह की खोज करते समय, अक्षांश और देशांतर की ज़रूरत नहीं होती. हालांकि, अगर आपको सटीक पता नहीं पता है, तो आप निर्देशांक तय करके खोज के नतीजों को पक्षपात करने की कोशिश कर सकते हैं. उदाहरण
के लिए, 'मुख्य सड़क' के लिए पता खोजने से कई नतीजे मिलेंगे.
Java
// Searching for 'Main Street' will return too many results Uri gmmIntentUri = Uri.parse("geo:0,0?q=101+main+street");
Kotlin
// Searching for 'Main Street' will return too many results val gmmIntentUri = Uri.parse("geo:0,0?q=101+main+street")
इंटेंट यूआरआई में अक्षांश/lng जोड़ने से नतीजे, किसी खास इलाके के प्रति मापदंड से अलग हो जाएंगे:
Java
// Searches for 'Main Street' near San Francisco Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194?q=101+main+street"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); startActivity(mapIntent);
Kotlin
// Searches for 'Main Street' near San Francisco val gmmIntentUri = Uri.parse("geo:37.7749,-122.4194?q=101+main+street") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") startActivity(mapIntent)
जब आपको पता हो कि आपकी खोज कोई एक वैल्यू दिखाएगी, तो हो सकता है कि आप एक वैकल्पिक लेबल पास करना चाहें. लेबल को स्ट्रिंग के रूप में तय किया जाना चाहिए और ये मैप मार्कर के नीचे दिखेंगे. ध्यान दें कि लेबल सिर्फ़ तब उपलब्ध होते हैं, जब q
को अक्षांश/lng निर्देशांक के तौर पर तय किया गया हो.
Java
// Display a label at the location of Google's Sydney office Uri gmmIntentUri = Uri.parse("geo:0,0?q=Google+Sydney@-33.8666,151.1957"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); startActivity(mapIntent);
Kotlin
// Display a label at the location of Google's Sydney office val gmmIntentUri = Uri.parse("geo:0,0?q=-33.8666,151.1957(Google+Sydney)") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") startActivity(mapIntent)
मोहल्ले के पते या अक्षांश/देशांतर के विकल्प के तौर पर, प्लस कोड का इस्तेमाल करके किसी जगह पर पिन दिखाया जा सकता है.
Java
// Display the location of Google, San Francisco using a global plus code. Uri gmmIntentUri = Uri.parse("http://plus.codes/849VQJQ5+XX"); // Equivalently, define the same location using a local plus code gmmIntentUri = Uri.parse("https://plus.codes/QJQ5+XX,San%20Francisco"); // Construct and use the Intent as in the examples above
Kotlin
// Display the location of Google, San Francisco using a global plus code. var gmmIntentUri = Uri.parse("http://plus.codes/849VQJQ5+XX") // Equivalently, define the same location using a local plus code gmmIntentUri = Uri.parse("https://plus.codes/QJQ5+XX,San%20Francisco") // Construct and use the Intent as in the examples above
मोड़-दर-मोड़ नेविगेशन लॉन्च किया जा रहा है
इस इंटेंट का इस्तेमाल, बताए गए पते या निर्देशांक के लिए मोड़-दर-मोड़ निर्देशों के साथ Google Maps नेविगेशन को लॉन्च करने के लिए करें. निर्देश हमेशा उपयोगकर्ता की मौजूदा जगह के आधार पर दिए जाते हैं.
google.navigation:q=a+street+address google.navigation:q=latitude,longitude
पैरामीटर
q
: नेविगेशन से जुड़ी खोजों के लिए, एंड पॉइंट सेट करता है. यह वैल्यू अक्षांश, देशांतर निर्देशांक या क्वेरी फ़ॉर्मैट किया गया पता हो सकती है. अगर यह ऐसी क्वेरी स्ट्रिंग है जो एक से ज़्यादा नतीजे दिखाती है, तो पहला नतीजा चुना जाएगा.mode
, परिवहन का तरीका सेट करता है. मोड ज़रूरी नहीं है और इसे इनमें से किसी एक पर सेट किया जा सकता है:- ड्राइविंग के लिए
d
(डिफ़ॉल्ट) - साइकल चलाने के लिए
b
- दोपहिया वाहन के लिए
l
- पैदल पहुंचने के लिए
w
- ड्राइविंग के लिए
avoid
सेट ऐसी सुविधाएं सेट करता है जिनसे रास्ते को बचना चाहिए. बचने का विकल्प ज़रूरी नहीं है. इसे इनमें से एक या ज़्यादा पर सेट किया जा सकता है:- टोल का किराया
t
है - हाइवे के लिए
h
- फ़ेरी के लिए
f
- टोल का किराया
उदाहरण
नीचे दिया गया Intent
, सिडनी ऑस्ट्रेलिया के टारोंगा ज़ू के लिए
मोड़-दर-मोड़ नेविगेशन का अनुरोध करेगा:
Java
Uri gmmIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); startActivity(mapIntent);
Kotlin
val gmmIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") startActivity(mapIntent)
अगर आपको टोल का पेमेंट नहीं करना है या फ़ेरी से यात्रा नहीं करनी है, तो ऐसे रूट का अनुरोध किया जा सकता है जिसमें इन चीज़ों से बचने की कोशिश की जाती है.
Java
Uri gmmIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia&avoid=tf"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); startActivity(mapIntent);
Kotlin
val gmmIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia&avoid=tf") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") startActivity(mapIntent)
अगर आपको थोड़ा कसरत करना है, तो साइकल चलाने के निर्देशों का अनुरोध किया जा सकता है.
Java
Uri gmmIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia&mode=b"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); startActivity(mapIntent);
Kotlin
val gmmIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia&mode=b") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") startActivity(mapIntent)
अगर आपको मोटर वाली दोपहिया वाहन चाहिए, तो उससे मिले दिशा-निर्देशों में उन गलियों और रास्तों की जानकारी शामिल होनी चाहिए जो कार तक नहीं पहुंचती हैं. नीचे दिया गया intent
भारत में
एक रास्ता दिखाता है.
Java
Uri gmmIntentUri = Uri.parse("google.navigation:q=Connaught+Place,+New+Delhi,Delhi&mode=l"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); startActivity(mapIntent);
Kotlin
val gmmIntentUri = Uri.parse("google.navigation:q=Connaught+Place,+New+Delhi,Delhi&mode=l") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") startActivity(mapIntent)
Street View पैनोरामा दिखाया जा रहा है
Google Street View लॉन्च करने के लिए, google.streetview
इंटेंट का इस्तेमाल करें. Google Street View, Google Street View पूरे कवरेज वाले इलाके में, तय की गई जगहों से पैनोरामा वाले व्यू दिखाता है.
उपयोगकर्ता के योगदान से बनाए गए फ़ोटोस्फ़ीयर और
Street View के खास कलेक्शन
भी उपलब्ध हैं.
google.streetview:cbll=latitude,longitude&cbp=0,bearing,0,zoom,tilt google.streetview:panoid=id&cbp=0,bearing,0,zoom,tilt
पैरामीटर
सभी google.streetview
यूआरआई में, cbll
या panoid
पैरामीटर शामिल होना चाहिए.
cbll
, अक्षांश और देशांतर को कॉमा लगाकर अलग की गई वैल्यू (46.414382,10.013988
) के तौर पर स्वीकार करता है. ऐप्लिकेशन इस जगह के पास की ली गई पैनोरामा फ़ोटो दिखाएगा. दरअसल, Street View की तस्वीरों को समय-समय पर रीफ़्रेश किया जाता है और हर बार फ़ोटोग्राफ़ को अलग-अलग जगहों से लिया जा सकता है. इसलिए, हो सकता है कि तस्वीरें अपडेट होने पर, आपकी जगह की जानकारी किसी दूसरे पैनोरामा में दिख सके.panoid
एक विशिष्ट पैनोरामा आईडी है. अगरpanoid
औरcbll
दोनों दिए गए हैं, तो Google Maps पैनोरामा आईडी का इस्तेमाल करेगा. Android ऐप्लिकेशन के लिए पैनोरामा आईडी,StreetViewPanoramaLocation
ऑब्जेक्ट से उपलब्ध हैं.cbp
एक वैकल्पिक पैरामीटर है, जो कैमरे के शुरुआती ओरिएंटेशन को अडजस्ट करता है.cbp
पैरामीटर में पांच वैल्यू अलग-अलग होती हैं, जिन्हें कॉमा लगाकर अलग किया जाता है. ये सभी ज़रूरी नहीं होते. सबसे अहम वैल्यू, दूसरा, चौथा, और पांचवां होता है. इससे बेयरिंग, ज़ूम, और टिल्ट को सेट किया जाता है. पहली और तीसरी वैल्यू इस्तेमाल नहीं की जा सकतीं और उन्हें0
पर सेट होना चाहिए.bearing
: उत्तर से घड़ी की दिशा में डिग्री में कैमरे के कंपास शीर्षक को दिखाता है. सही उत्तर 0 है, पूर्व का मतलब 90 है, दक्षिण 180 है, पश्चिम का मतलब 270 है. बेयरिंग में पास की गई वैल्यू, यानी 0°, 360°, और 720° सभी पॉइंट एक ही दिशा में ले जाएंगे. बेयरिंग को पांच कॉमा से अलग किए गए वैल्यू में से दूसरा वैल्यू माना जाता है.zoom
: कैमरे का ज़ूम लेवल सेट करता है. ज़ूम का डिफ़ॉल्ट लेवल 0 पर सेट होता है. 1 का ज़ूम ज़ूम करने पर दोगुना हो जाएगा. ज़ूम को मौजूदा पैनोरामा के लिए 0 और उसके ज़्यादा से ज़्यादा ज़ूम स्तर के बीच रखा जाता है. इसका मतलब है कि इस रेंज के बाहर आने वाली कोई भी वैल्यू, रेंज के अंदर आने वाली सबसे नज़दीकी एक्सट्रीम पर सेट की जाएगी. उदाहरण के लिए, -1 की वैल्यू 0 पर सेट की जाएगी. कॉमा लगाकर अलग की गई पांच वैल्यू में से ज़ूम चौथा नंबर है.tilt
: कैमरे के ऊपर या नीचे के कोण की जानकारी देता है. रेंज -90 से लेकर 0 से 90 तक होती है, जिसमें 90 सीधे नीचे की ओर, 0 क्षितिज के बीच में, और -90 सीधे ऊपर की ओर देखने पर होते हैं.
उदाहरण
Street View इंटेंट का इस्तेमाल करने के कुछ उदाहरण यहां दिए गए हैं.
Java
// Displays an image of the Swiss Alps Uri gmmIntentUri = Uri.parse("google.streetview:cbll=46.414382,10.013988"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); startActivity(mapIntent); // Uses a PanoID to show an image from Maroubra beach in Sydney, Australia Uri gmmIntentUri = Uri.parse("google.streetview:panoid=Iaa2JyfIggYAAAQfCZU9KQ"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); startActivity(mapIntent); // Opens Street View between two Pyramids in Giza. The values passed to the // cbp parameter will angle the camera slightly up, and towards the east. Uri gmmIntentUri = Uri.parse("google.streetview:cbll=29.9774614,31.1329645&cbp=0,30,0,0,-15"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); startActivity(mapIntent);
Kotlin
// Displays an image of the Swiss Alps val gmmIntentUri = Uri.parse("google.streetview:cbll=46.414382,10.013988") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") startActivity(mapIntent) // Uses a PanoID to show an image from Maroubra beach in Sydney, Australia val gmmIntentUri = Uri.parse("google.streetview:panoid=Iaa2JyfIggYAAAQfCZU9KQ") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") startActivity(mapIntent) // Opens Street View between two Pyramids in Giza. The values passed to the // cbp parameter will angle the camera slightly up, and towards the east. val gmmIntentUri = Uri.parse("google.streetview:cbll=29.9774614,31.1329645&cbp=0,30,0,0,-15") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") startActivity(mapIntent)