Android के लिए Google Maps इंटेंट

Android के लिए Google Maps ऐप्लिकेशन में कई इंटेंट मौजूद होते हैं. इनका इस्तेमाल करके, Google Maps को डिसप्ले, खोज, नेविगेशन या स्ट्रीट व्यू मोड में लॉन्च किया जा सकता है. अपने ऐप्लिकेशन में मैप को एम्बेड करने के लिए, Android के लिए Maps SDK टूल की शुरुआती जानकारी देखें.

.

Android Automotive OS (AAOS) प्लैटफ़ॉर्म के लिए, कुछ खास बातों और अतिरिक्त इंटेंट को ध्यान में रखा जाता है. ज़्यादा जानकारी के लिए, Android Automotive के लिए Google Maps के इंटेंट दस्तावेज़ देखें.

खास जानकारी

इंटेंट की मदद से, किसी दूसरे ऐप्लिकेशन में कोई गतिविधि शुरू की जा सकती है. इसके लिए, Intent ऑब्जेक्ट में वह कार्रवाई बतानी होती है जो आपको करनी है. जैसे, "मैप दिखाएं" या "हवाई अड्डे के लिए निर्देश दिखाएं". Android के लिए Google Maps ऐप्लिकेशन कई अलग-अलग इंटेंट के साथ काम करता है. इससे, Google Maps ऐप्लिकेशन को लॉन्च करके, चार में से कोई एक कार्रवाई की जा सकती है:

  1. किसी तय जगह और ज़ूम लेवल पर मैप दिखाएं.
  2. जगहें या लोकेशन खोजें और उन्हें मैप पर दिखाएं.
  3. एक जगह से दूसरी जगह जाने का रास्ता पूछना. यात्रा के तीन तरीकों के लिए निर्देश मिल सकते हैं: ड्राइविंग, पैदल चलना, और साइकल चलाना.
  4. Google Street View में पैनोरमा इमेज दिखाएं.

इस पेज पर उन इंटेंट के बारे में बताया गया है जिनका इस्तेमाल, Android के लिए Google Maps ऐप्लिकेशन के साथ किया जा सकता है. इंटेंट के बारे में ज़्यादा जानने के लिए, इंटेंट और इंटेंट फ़िल्टर और सामान्य इंटेंट देखें.

इंटेंट अनुरोध

किसी इंटेंट के साथ 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 loads 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 loads 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, मैप पर हाइलाइट करने के लिए जगहों की जानकारी देता है. Search Network में विज्ञापन दिखाने के सभी अनुरोधों के लिए, 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 का अक्षांश और देशांतर सेट किया गया है. हालांकि, पता को क्वेरी स्ट्रिंग के तौर पर पास किया गया है. किसी खास जगह को खोजते समय, अक्षांश और देशांतर की ज़रूरत नहीं होती. हालांकि, अगर आपको जगह का सटीक पता नहीं पता है, तो कोऑर्डिनेट डालकर खोज के नतीजों को अपने हिसाब से बनाया जा सकता है. उदाहरण के लिए, 'मुख्य सड़क' के लिए पता खोजने पर, बहुत ज़्यादा नतीजे मिल सकते हैं.

Java

// Searching for 'Main Street' returns too many results.
Uri gmmIntentUri = Uri.parse("geo:0,0?q=101+main+street");

Kotlin

// Searching for 'Main Street' returns too many results.
val gmmIntentUri = Uri.parse("geo:0,0?q=101+main+street")

इंटेंट यूआरआई में अक्षांश और देशांतर जोड़ने से, नतीजों में किसी खास इलाके को प्राथमिकता दी जाती है:

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 को अक्षांश और देशांतर के निर्देशांक के तौर पर तय किया गया हो.

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 preceding examples.

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 preceding examples.

मोड़-दर-मोड़ नेविगेशन की सुविधा चालू करना

दिए गए पते या निर्देशों के लिए, मोड़-दर-मोड़ निर्देशों के साथ Google Maps नेविगेशन को लॉन्च करने के लिए, इस इंटेंट यूआरआई का इस्तेमाल करें. निर्देश हमेशा उपयोगकर्ता की मौजूदा जगह से दिए जाते हैं.

google.navigation:q=a+street+address
google.navigation:q=latitude,longitude  

पैरामीटर

  • q: नेविगेशन से जुड़ी खोजों के लिए एंडपॉइंट सेट करता है. यह वैल्यू, अक्षांश और देशांतर के निर्देशांक या क्वेरी फ़ॉर्मैट वाला पता हो सकता है. अगर क्वेरी स्ट्रिंग से एक से ज़्यादा नतीजे मिलते हैं, तो पहला नतीजा चुना जाता है.

  • mode, यात्रा के तरीके को सेट करता है. mode पैरामीटर की वैल्यू देना ज़रूरी नहीं है. इसे इनमें से किसी एक पर सेट किया जा सकता है:

    • ड्राइविंग के लिए d (डिफ़ॉल्ट)
    • b साइकल चलाने के लिए
    • दोपहिया वाहन के लिए l
    • पैदल चलने के लिए w
  • avoid उन सुविधाओं को सेट करता है जिनसे रास्ते को बचना चाहिए. 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)
टारोना ज़ू के लिए दिशा-निर्देश
दूसरी इमेज. Taronga Zoo के लिए निर्देश

अगर आपको टोल नहीं देना है या फ़ेरी नहीं लेनी है, तो रास्ते के ऐसे विकल्प का अनुरोध किया जा सकता है जो इन सुविधाओं से बचने की कोशिश करता है.

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, कवरेज वाले पूरे इलाके में चुनिंदा जगहों से पैनोरमिक व्यू दिखाता है. लोगों के योगदान से बने फ़ोटोस्फ़ीर और 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 पैनोरमा आईडी का इस्तेमाल करता है. पैनोरमा आईडी, StreetViewPanoramaLocation ऑब्जेक्ट से Android ऐप्लिकेशन के लिए उपलब्ध होते हैं.

  • cbp एक वैकल्पिक पैरामीटर है, जो कैमरे के शुरुआती ओरिएंटेशन में बदलाव करता है. cbp पैरामीटर में कॉमा लगाकर अलग की गई पांच वैल्यू डाली जा सकती हैं. हालांकि, इनमें से किसी भी वैल्यू को डालना ज़रूरी नहीं है. सबसे अहम वैल्यू दूसरी, चौथी, और पांचवीं होती हैं. ये वैल्यू, क्रमशः दिशा, ज़ूम, और झुकाव सेट करती हैं. पहली और तीसरी वैल्यू का इस्तेमाल नहीं किया जा सकता. इन्हें 0 पर सेट किया जाना चाहिए.

    • bearing: इससे कैमरे के कंपास हेडिंग की जानकारी मिलती है. यह जानकारी, उत्तर से घड़ी की सुई के घूमने की दिशा में डिग्री में दी जाती है. सही उत्तर 0, पूर्व 90, दक्षिण 180, पश्चिम
      1. बेअरिंग रैप में पास की गई वैल्यू; इसका मतलब है कि 0°, 360°, और 720° सभी एक ही दिशा में इंगित करते हैं. दिशा को कॉमा लगाकर अलग की गई पांच वैल्यू में से दूसरी वैल्यू के तौर पर तय किया गया है.
    • zoom: कैमरे के ज़ूम लेवल को सेट करता है. ज़ूम लेवल डिफ़ॉल्ट रूप से 0 पर सेट होता है. ज़ूम करने पर, इमेज दोगुनी हो जाएगी. ज़ूम को मौजूदा पैनोरमा के लिए, 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 angles 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 angles 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)
Street View में पिरामिड
तीसरी इमेज. Street View में पिरामिड