נתוני מזג האוויר בפורמט 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 באלפיות השנייה.

אפשר לעצב את הערך הזה באמצעות השיטה icuText(,) כדי לקבל ייצוג שנוח לקריאה, כמו שמוצג בדוגמה של נתוני מזג האוויר.

תנאי מזג האוויר

התנאים הנוכחיים זמינים בכתובת [WEATHER.CONDITION], וגרסה שקל להבין זמינה בכתובת [WEATHER.CONDITION_NAME].

אפשר לראות את הערכים של [WEATHER.CONDITION] במקורות הנתונים. לדוגמה, 4 מייצג את HEAVY_RAIN.

ערכים אחרים

ב-Watch Face Format יש מגוון מדדים נוספים, כמו [WEATHER.TEMPERATURE] ו-[WEATHER.UV_INDEX]. פרטים מלאים על המדדים הזמינים, כולל יחידות וסוגי נתונים, זמינים בדף העזר בנושא מקורות נתונים.

תחזיות יומיות ושעתיות

כך אפשר לגשת לתנאי התחזית לשעה או ליום ספציפיים בעתיד:

• ‫[WEATHER.HOURS.1.CONDITION] – תנאי התחזית שעה מעכשיו.
• ‫[WEATHER.DAYS.2.CONDITION] – תנאי התחזית בעוד יומיים.

הנתונים השעתיים יכולים להיות זמינים עד 8 שעות מראש, והנתונים היומיים עד 5 ימים מראש. עם זאת, תצוגת השעון צריכה תמיד לבדוק אם נתוני התחזית זמינים. יכול להיות שטווח שעות או ימים שונה יהיה זמין בשעות שונות או במכשירים שונים. לדוגמה, כדי לבדוק אם נתוני התחזית זמינים לשעה אחת מעכשיו, משתמשים ב-[WEATHER.HOURS.1.IS_AVAILABLE].

בתחזיות היומיות והשעתיות מוצגים גם מגוון מדדים, כמו [WEATHER.HOURS.<N>.TEMPERATURE] ו- [WEATHER.DAYS.<N>.CHANCE_OF_PRECIPITATION]. פרטים מלאים על המדדים הזמינים, כולל יחידות וסוגי נתונים, זמינים בדף העזר בנושא מקורות נתונים.

בדיקה באמצעות נתוני מזג אוויר

כדי לקבל נתוני מזג אוויר, מכשיר Wear OS צריך לדעת את מיקום המכשיר.

כדי לחסוך בצריכת החשמל, השעון לא משתמש בחיישן ה-GPS המובנה כדי לקבוע את המיקום לתחזית מזג האוויר, אלא מסתמך על המיקום ממכשיר נייד מחובר או מרשתות זמינות.

כדי להפוך את נתוני המיקום לזמינים לבדיקה, אפשר לבצע אחת מהפעולות הבאות:

• התאמה של אמולטור Wear OS לטלפון פיזי או לאמולטור טלפון.
• מדמים מיקום באמצעות פקודת ה-adb הבאה:

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.