Background
In 2025 we would like to offer logged-in users information about which country had the highest concentration of coordinates based on the articles they read that year.
Requirements
- User must be logged-in
- This slide is agnostic of primary language
- User should see for the articles they read for the year, which country are the coordinates for those articles with coordinates are most concentrated next to a specific country
- Display name of selected country
- Display articles used to select the chosen country (at least 2)
References
- Use this figma file
- Use this approach
Engineering Notes
- Create a new slide data controller for populating and persisting this new slide data. Data will need to be fetched from the MWKDataStore+LegacyPageViews.swift file (see yir-2025-explorations branch). Ensure an array of WMFLegacyPageView with location data is persisted with the slide data.
- Create a new slide using a new view model and view (WMFYearInReviewSlideV3LocationViewModel + WMFYearInReviewSlideV3LocationView). Ensure new slide is only inserted when V3 developer setting is enabled, otherwise use old slide design and copy for V2. Slides are inserted in the WMFYearInReviewViewModel.
- This new slide will need to contain a UIKit Map View that displays as much of the globe as possible.
- Display a spinner below the map view, where the content of the slide usually appears.
- When the map view appears, add all location annotations to the map view from the slide data's WMFLegacyPageViews.
- When map view clusters annotations, grab the cluster annotation that represents the most articles and zoom in on the map to that area.
- Get an average single coordinate of this larger cluster, then send it into Apple's reverse geocoding API
- Grab a country or ocean name from the response, then replace the spinner with content - insert the name into the body text title, and insert random article names from the WMFLegacyPageViews into the body text.
- Note: the yir-2025-explorations branch already does this work, it's just a matter of copy and pasting this logic on top of our latest in main, and possibly tweaking the annotation view colors.
- Create new sharing view for exporting as an image to share.
QA Notes
- Delete all Wikipedia apps on device. Fresh install the app (White icon, 7.8.5). Ensure device is logged in.
- Go to Places tab, visit several articles in one area.
- Go to developer settings, turn on YiR V3.
- Year in Review should show in Profile. Location slide should show.
