נתוני מזג האוויר בפורמט Watch Face Format

החל מגרסה 2, ה-Watch Face Format כולל תמיכה בנתוני מזג אוויר. הנתונים האלה כוללים מגוון מדדים ומסגרות זמן, מהתנאים הנוכחיים לתחזיות שעתיות ויומיות.

ניגשים למזג האוויר באמצעות ביטויים. לדוגמה, כדי להציג את הטקסט הנוכחי תנאי מזג האוויר ברכיב <Text>, צריך להשתמש בביטוי שדומה לזה הבאים:

<Text>
  <Font family="SYNC_TO_DEVICE" size="32">
    <Template>Today's weather: %s
        <Parameter expression="[WEATHER.CONDITION_NAME]"/>
    </Template>
  </Font>
</Text>

זמינות

בתצוגות השעון תמיד צריך לבדוק את הערך של [WEATHER.IS_AVAILABLE] לפני גישה לחברים אחרים באובייקט [WEATHER.*]:

<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>

בנוסף, בתצוגת השעון צריך לבדוק את [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.