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

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

अपनी मेनिफ़ेस्ट फ़ाइल में जाकर, कैटगरी के लिए सहायता उपलब्ध होने की जानकारी देना

आपके ऐप्लिकेशन को, 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 से मिला अगला टेंप्लेट उसी टाइप का होता है, तब तक उसे रीफ़्रेश माना जाता है. साथ ही, उसे टेंप्लेट के कोटे में शामिल नहीं किया जाता.

App Actions का इस्तेमाल करके, Gemini या Google Assistant के साथ इंटिग्रेट करना

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