इन टेंप्लेट का इस्तेमाल करते समय, उपयोगकर्ताओं को आपकी बनाई गई ड्रॉइंग के साथ इंटरैक्ट करने की सुविधा दी जा सकती है. जैसे, उन्हें ज़ूम इन और पैन करके मैप के अलग-अलग हिस्से देखने की सुविधा देना.
| टेंप्लेट | Car App API के लिए ज़रूरी एपीआई लेवल |
|---|---|
NavigationTemplate |
2 |
(अब इस्तेमाल नहीं किया जाता) |
4 |
(अब इस्तेमाल नहीं किया जाता) |
4 |
(अब इस्तेमाल नहीं किया जाता) |
5 (टेंप्लेट लॉन्च किया गया) |
MapWithContentTemplate |
7 (टेंप्लेट लॉन्च किया गया) |
इंटरैक्टिविटी कॉलबैक लागू करना
SurfaceCallback इंटरफ़ेस में कई कॉलबैक तरीके होते हैं. इनका इस्तेमाल करके, पिछले सेक्शन में दिए गए टेंप्लेट से बनाए गए मैप में इंटरैक्टिविटी जोड़ी जा सकती है:
| इंटरैक्शन | Method | Car App API के लिए ज़रूरी एपीआई लेवल |
|---|---|---|
| टैप करें | onClick |
5 |
| ज़ूम करने के लिए पिंच करें | onScale |
2 |
| एक उंगली से खींचें और छोड़ें | onScroll |
2 |
| एक उंगली से फ़्लिंग करना | onFling |
2 |
| दो बार टैप करें |
(टेंप्लेट होस्ट, स्केल फ़ैक्टर तय करता है) |
2 |
| पैन मोड में रोटरी नॉब को घुमाकर कंट्रोल करना |
(टेंप्लेट होस्ट, दूरी के फ़ैक्टर का पता लगाता है) |
2 |
मैप ऐक्शन स्ट्रिप जोड़ना
इन टेंप्लेट में, मैप से जुड़ी कार्रवाइयों के लिए मैप ऐक्शन स्ट्रिप हो सकती है. जैसे, ज़ूम इन और ज़ूम आउट करना, फिर से सेंटर में लाना, कंपास दिखाना, और अन्य कार्रवाइयां जिन्हें आपको दिखाना है. मैप ऐक्शन स्ट्रिप में, सिर्फ़ आइकॉन वाले चार बटन हो सकते हैं. इन्हें टास्क की गहराई पर असर डाले बिना रीफ़्रेश किया जा सकता है. इस्तेमाल में नहीं होने पर, ऐक्शन स्ट्रिप छिप जाती है और इस्तेमाल में होने पर फिर से दिखने लगती है.
मैप इंटरैक्टिविटी कॉलबैक पाने के लिए, आपको मैप ऐक्शन स्ट्रिप में Action.PAN
बटन जोड़ना ज़रूरी है. जब उपयोगकर्ता पैन करें बटन दबाता है, तो होस्ट पैन मोड में आ जाता है. इसके बारे में पैन मोड के बारे में जानकारी लेख में बताया गया है.
अगर आपका ऐप्लिकेशन, मैप ऐक्शन स्ट्रिप में Action.PAN बटन को शामिल नहीं करता है, तो उसे SurfaceCallback तरीकों से उपयोगकर्ता का इनपुट नहीं मिलता. साथ ही, होस्ट पहले से चालू किए गए किसी भी पैन मोड को बंद कर देता है.
टचस्क्रीन पर, पैन करें बटन नहीं दिखता.
पैन मोड के बारे में जानकारी
पैन मोड में, टेंप्लेट होस्ट, रोटरी कंट्रोलर और टचपैड जैसे नॉन-टच इनपुट डिवाइसों से मिले उपयोगकर्ता के इनपुट को, सही SurfaceCallback तरीकों में बदलता है. उपयोगकर्ता के पैन मोड में जाने या उससे बाहर निकलने के ऐक्शन का जवाब देने के लिए, NavigationTemplate.Builder में setPanModeListener तरीके का इस्तेमाल करें.
उपयोगकर्ता के पैन मोड में होने पर, होस्ट टेंप्लेट में मौजूद अन्य यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट को छिपा सकता है.