लोकप्रिय जगह के लिए ऐप्लिकेशन बनाएं

इस गाइड में, कार ऐप्लिकेशन लाइब्रेरी की अलग-अलग सुविधाओं के बारे में बताया गया है. इनका इस्तेमाल करके, दिलचस्पी की जगह (पीओआई) के ऐप्लिकेशन की सुविधाओं को लागू किया जा सकता है.

मेनिफ़ेस्ट फ़ाइल में, कैटगरी के साथ काम करने की सुविधा के बारे में जानकारी देना

आपके ऐप्लिकेशन को, CarAppService के इंटेंट फ़िल्टर में androidx.car.app.category.POI कार ऐप्लिकेशन कैटगरी का एलान करना होगा.

यहां दिए गए उदाहरण में, ऐप्लिकेशन की कैटगरी तय करने का तरीका बताया गया है:

<application>
    ...
   <service
       ...
        android:name=".MyCarAppService"
        android:exported="true">
      <intent-filter>
        <action android:name="androidx.car.app.CarAppService" />
        <category android:name="androidx.car.app.category.POI"/>
      </intent-filter>
    </service>
    ...
<application>

मैप टेंप्लेट ऐक्सेस करना

पीओआई ऐप्लिकेशन, PlaceListMapTemplate और MapWithContentTemplate को ऐक्सेस कर सकते हैं.

PlaceListMapTemplate को खास तौर पर, पीओआई की सूची दिखाने के लिए डिज़ाइन किया गया है. यह सूची, होस्ट किए गए मैप के साथ दिखती है.

MapWithContentTemplate का इस्तेमाल, सूचियां और अन्य तरह का कॉन्टेंट दिखाने के लिए किया जा सकता है. यह कॉन्टेंट, आपके ऐप्लिकेशन से रेंडर किए गए मैप के साथ दिखाया जाता है. इस टेंप्लेट का इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, मैप बनाना लेख पढ़ें.

इन टेंप्लेट को ऐक्सेस करने के लिए, आपके ऐप्लिकेशन को अपनी AndroidManifest.xml फ़ाइल में androidx.car.app.MAP_TEMPLATES अनुमति का एलान करना होगा:

<manifest ...>
  ...
  <uses-permission android:name="androidx.car.app.MAP_TEMPLATES"/>
  ...
</manifest>

PlaceListMapTemplate का कॉन्टेंट रीफ़्रेश करना

ड्राइवर को कॉन्टेंट रीफ़्रेश करने का विकल्प दिया जा सकता है. इसके लिए, PlaceListMapTemplate की मदद से बनाई गई जगहों की सूची ब्राउज़ करते समय, किसी बटन पर टैप करें. OnContentRefreshListener इंटरफ़ेस के onContentRefreshRequested तरीके को लागू करें. साथ ही, सूची को रीफ़्रेश करने की सुविधा चालू करने के लिए, टेंप्लेट पर लिसनर सेट करने के लिए PlaceListMapTemplate.Builder.setOnContentRefreshListener का इस्तेमाल करें.

यहां दिए गए स्निपेट में, टेंप्लेट पर लिसनर सेट करने का तरीका बताया गया है:

return PlaceListMapTemplate.Builder()
    // ...
    .setOnContentRefreshListener {
        // Execute any desired logic
        // ...
        // Then call invalidate() so onGetTemplate() is called again
        invalidate()
    }
    .build()
POI.kt

अगर लिसनर के पास कोई वैल्यू है, तो रीफ़्रेश बटन सिर्फ़ PlaceListMapTemplate के हेडर में दिखता है.

जब उपयोगकर्ता रीफ़्रेश बटन पर क्लिक करता है, तब आपके OnContentRefreshListener के लागू किए गए onContentRefreshRequested तरीके को कॉल किया जाता है. onContentRefreshRequested में, Screen.invalidate तरीके को कॉल करें. इसके बाद, होस्ट आपके ऐप्लिकेशन के Screen.onGetTemplate तरीके को वापस कॉल करता है, ताकि अपडेट किए गए कॉन्टेंट के साथ टेंप्लेट को वापस पाया जा सके. टेंप्लेट रीफ़्रेश करने के बारे में ज़्यादा जानने के लिए, टेंप्लेट के कॉन्टेंट रीफ़्रेश करना लेख पढ़ें. जब तक onGetTemplate से मिला अगला टेंप्लेट उसी तरह का होता है, तब तक उसे रीफ़्रेश माना जाता है. साथ ही, उसे टेंप्लेट के कोटे में नहीं गिना जाता.

ऐप्लिकेशन ऐक्शन का इस्तेमाल करके, Google Assistant के साथ इंटिग्रेट करना

Assistant का इस्तेमाल करके, अपने पीओएस ऐप्लिकेशन में आवाज़ से कंट्रोल करने की सुविधा चालू करें. इससे लोग, "Hey Google, ExampleApp पर आस-पास के चार्जिंग स्टेशन ढूंढो" जैसे सवाल पूछकर, दिलचस्पी की जगहें खोज पाएंगे. ज़्यादा जानकारी के लिए, कार के लिए ऐप्लिकेशन ऐक्शन देखें.