Watch Face Format में मौसम का डेटा

वॉच फ़ेस फ़ॉर्मैट के वर्शन 2 से, मौसम के डेटा को शामिल करने की सुविधा उपलब्ध है. इस डेटा में, कई तरह की मेट्रिक और समयावधि शामिल होती हैं. जैसे, मौजूदा मौसम की जानकारी, हर घंटे और हर दिन के मौसम का पूर्वानुमान.

एक्सप्रेशन का इस्तेमाल करके, मौसम की जानकारी ऐक्सेस की जाती है. उदाहरण के लिए, <Text> एलिमेंट में मौसम की मौजूदा स्थिति दिखाने के लिए, इस तरह के एक्सप्रेशन का इस्तेमाल करें:

<PartText x="100" y="100" width="200" height="50">
    <Text>
        <Font family="SYNC_TO_DEVICE" size="16">
            <Template><![CDATA[Today's weather: %s]]>
                <Parameter expression="[WEATHER.CONDITION_NAME]"/>
            </Template>
        </Font>
    </Text>
</PartText>
watchface_weather.xml

उपलब्धता

[WEATHER.*] ऑब्जेक्ट के अन्य सदस्यों को ऐक्सेस करने से पहले, [WEATHER.IS_AVAILABLE] वैल्यू की जांच करें:

<Condition>
    <Expressions>
        <Expression name="is_weather_available">[WEATHER.IS_AVAILABLE]</Expression>
    </Expressions>
    <Compare expression="is_weather_available">
        <!-- Weather is available, so show the weather data. -->
    </Compare>
    <Default>
        <!-- Weather isn't available, so show an appropriate message. -->
    </Default>
</Condition>
watchface_weather.xml

आपको [WEATHER.IS_ERROR] भी देखना चाहिए. इससे पता चलता है कि मौसम का डेटा लोड करने में गड़बड़ी हुई है.

ध्यान दें कि [WEATHER.IS_AVAILABLE] और [WEATHER.IS_ERROR], दोनों सही हो सकते हैं. ऐसा तब होता है, जब डेटा पुराना हो और उसे रीफ़्रेश करने की कोशिशें काम न करें. ऐसे मामलों में, मौसम की उपलब्ध जानकारी दिखाई जा सकती है. साथ ही, यह दिखाने के लिए एक इंडिकेटर भी दिखाया जा सकता है कि नया डेटा फ़ेच करने में गड़बड़ी हुई है.

डेटा अपडेट होने की फ़्रीक्वेंसी

उपलब्ध डेटा के टाइमस्टैंप को [WEATHER.LAST_UPDATED] का इस्तेमाल करके ऐक्सेस किया जा सकता है. यह मिलीसेकंड में दिखाया गया Unix epoch टाइमस्टैंप होता है.

इस वैल्यू को icuText(,) तरीके का इस्तेमाल करके फ़ॉर्मैट किया जा सकता है, ताकि इसे आसानी से समझा जा सके. जैसा कि मौसम के सैंपल में दिखाया गया है.

मौसम का हाल

मौजूदा शर्तें [WEATHER.CONDITION] में उपलब्ध हैं. साथ ही, इन्हें आसानी से समझने के लिए [WEATHER.CONDITION_NAME] में भी उपलब्ध कराया गया है.

[WEATHER.CONDITION] की वैल्यू, डेटा सोर्स में देखी जा सकती हैं. उदाहरण के लिए, 4 का मतलब HEAVY_RAIN है.

अन्य मेट्रिक

वॉच फ़ेस फ़ॉर्मैट में कई अतिरिक्त मेट्रिक मिलती हैं. जैसे, [WEATHER.TEMPERATURE] और [WEATHER.UV_INDEX]. उपलब्ध मेट्रिक की पूरी जानकारी के लिए, डेटा सोर्स के रेफ़रंस पेज पर जाएं. इसमें यूनिट और डेटा टाइप शामिल हैं.

हर घंटे और रोज़ के मौसम का अनुमान

आने वाले समय में किसी घंटे या दिन के मौसम का पूर्वानुमान देखने के लिए, यह तरीका अपनाएं:

  • [WEATHER.HOURS.1.CONDITION] - अब से एक घंटे बाद के मौसम की जानकारी.
  • [WEATHER.DAYS.2.CONDITION] - दो दिन बाद के मौसम का पूर्वानुमान.

हर घंटे का डेटा, आठ घंटे पहले और रोज़ का डेटा, पांच दिन पहले उपलब्ध हो सकता है. हालांकि, वॉच फ़ेस को हमेशा पूर्वानुमान के डेटा की उपलब्धता की जांच करनी चाहिए. अलग-अलग समय या अलग-अलग डिवाइसों पर, कारोबार के खुले रहने का समय या दिन अलग-अलग हो सकते हैं. उदाहरण के लिए, यह देखने के लिए कि क्या अभी से एक घंटे बाद के लिए पूर्वानुमान का डेटा उपलब्ध है, [WEATHER.HOURS.1.IS_AVAILABLE] का इस्तेमाल करें.

रोज़ाना और हर घंटे के पूर्वानुमान में कई मेट्रिक भी शामिल होती हैं. जैसे, [WEATHER.HOURS.<N>.TEMPERATURE] और [WEATHER.DAYS.<N>.CHANCE_OF_PRECIPITATION]. उपलब्ध मेट्रिक की पूरी जानकारी के लिए, डेटा सोर्स के रेफ़रंस पेज पर जाएं. इसमें यूनिट और डेटा टाइप शामिल हैं.

मौसम के डेटा की मदद से टेस्टिंग करना

मौसम की जानकारी का डेटा पाने के लिए, Wear OS डिवाइस को डिवाइस की जगह की जानकारी पता होनी चाहिए.

बैटरी बचाने के लिए, स्मार्टवॉच में मौसम का पूर्वानुमान बताने के लिए, ऑनबोर्ड जीपीएस सेंसर का इस्तेमाल नहीं किया जाता. इसके बजाय, यह कनेक्ट किए गए हैंडहेल्ड डिवाइस या उपलब्ध नेटवर्क से जगह की जानकारी पर निर्भर रहती है.

जगह की जानकारी का डेटा टेस्टिंग के लिए उपलब्ध कराने के लिए, इनमें से कोई एक तरीका अपनाएं:

adb unroot
adb shell cmd location set-location-enabled true
adb root
adb shell appops set 0 android:mock_location allow
adb shell cmd location providers add-test-provider gps
adb shell cmd location providers set-test-provider-enabled gps true
adb shell cmd location providers set-test-provider-location gps --location 37.773972,-122.431297

ज़्यादा जानकारी

मौसम के डेटा को ऐक्सेस करने और रेंडर करने का पूरा उदाहरण देखने के लिए, GitHub का सैंपल देखें.