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

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

अपने मेनिफ़ेस्ट में बताएं कि यह कैटगरी कैसे काम करती है

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

अहम जानकारी: कार ऐप्लिकेशन लाइब्रेरी के वर्शन 1.3 के बाद, androidx.car.app.category.PARKING और androidx.car.app.category.CHARGING कार के ऐप्लिकेशन की कैटगरी बंद कर दिया गया है. इसके बजाय, 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 का इस्तेमाल, सूचियां और इस तरह की दूसरी चीज़ें दिखाने के लिए किया जा सकता है कॉन्टेंट को उस मैप के साथ जोड़ सकता है जिसे आपके ऐप्लिकेशन ने रेंडर किया है. यहां जाएं: इसका इस्तेमाल करने के बारे में ज़्यादा जानकारी के लिए, मैप बनाएं टेम्प्लेट.

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

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

ध्यान दें: PlaceListMapTemplate, सिर्फ़ उन ऐप्लिकेशन के लिए उपलब्ध है जो यह बताते हैं कि androidx.car.app.category.POI श्रेणी या बहिष्कृत androidx.car.app.category.PARKING या androidx.car.app.category.CHARGING श्रेणियां. नेविगेशन ऐप्लिकेशन के लिए, देखें नेविगेशन टेंप्लेट ऐक्सेस करें.

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

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

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

Kotlin

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

Java

new PlaceListMapTemplate.Builder()
        ...
        .setOnContentRefreshListener(() -> {
            // Execute any desired logic
            ...
            // Then call invalidate() so onGetTemplate() is called again
            invalidate();
        })
        .build();

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

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

ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयों का इस्तेमाल करके, Google Assistant से इंटिग्रेट करना

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

---