We want to investigate various ways that maps can be broken and record them. This will be used for future evaluation to decide which might be able to be improved, which might need error messages, etc.
Broken might mean missing information, parts of maps not loading or complete maps not loading. What are the different states, and different problems encountered in each? What are the types of information that can be missing? What does it looks like? If known from this investigation, also note the reasons for things not loading but this can be in follow-up tickets as well.
Different states to investigate (list incomplete, needs thought, just a starting point):
[] Loading (nothing visible)
[] Static maps not loading
[] Dynamic embedded maps
[] Full-screen dynamic maps
[] Tiles not loading
[] Geoshapes not loading (sometimes they load in the small and not the big, sometimes only the full screen but not small)
[] Objects in OSM not visible
[] Editing, preview, final
== Review: Examples
Please add here as you come across more examples. Also check the notes section considering possible solutions.
| Category | Description | Screenshot | Notes (Category) | Potential improvements |
| | Errors | **Broken image icon ** | {F35039203} | Might be hard to add a translatable error message. Possible reasons: server down, ... | - This is about r309522 Rendering the error on the server side with i18n support -> T309522 |
| | Errors | **Blank map image (static)** | {F35192828} | Happens when the mapdata group ID can't be loaded for an article, for example [[ https://maps.wikimedia.org/img/osm-intl,10,a,a,270x200.png?lang=zh&domain=zh.wikipedia.org&title=%E4%BF%84%E7%BE%85%E6%96%AF%E9%A7%90%E8%8F%AF%E5%A4%A7%E4%BD%BF%E9%A4%A8&revid=71908380&groups=_bc660fd4ba69fba1a1a083ce694bb530f37ad88f | this image ]] embedded in this article when "uselang=zn-cn" is included, [[ https://zh.wikipedia.org/wiki/%E4%BF%84%E7%BE%85%E6%96%AF%E9%A7%90%E8%8F%AF%E5%A4%A7%E4%BD%BF%E9%A4%A8?uselang=zh-cn | thus ]]. See the bug report T246314. | Should be able to serve a localized error message image. |
| Missing map while loading (static) | {F35101431}{F35101444}| The loading displays a broken map stage for a short time: {F35106087} | - ShError | **[Dynamic?] Map doesn't load, but markers do** | {F35101428} | Might be tile server issues | - Could be possible to add a background image with a spinner/whatevernote to the user when we have missing tiles -> T309541 |3 |
| Missing features/broken map while loading (dynamic) | | Error | **Map not visible in VE** | {F35101438}| | - Should be possible to add a background image with a spinner/whateverlook into this, probably fixable - TBD TICKET |
| Map tiles missing | {F35101425} | Mostly happens while loading. | - Could be possible to add a note to the user when we have missing tiles -> T309543 Loading | **[Static] Missing map while loading** | {F35101431}{F35101444}| The loading displays a broken map stage for a short time: {F35106087} | T309541 Add a background image with a spinner or similar to static maps |
| Map doesn't load, but markers do | {F35101428} | Might be tile server issues | - Could be possible to add a note to the user when we have missing tiles -> T309543 Loading | **[Dynamic] Missing features/broken map while loading**| | | T309541 Add a background image with a spinner or similar to static maps|
| Map not visible in VE| Loading | **[Dynamic?] Map tiles missing** | {F35101438}| | - Should look into this,25} | Mostly happens while loading. probably fixable - TBD TICKET || - Could be possible to add a note to the user when we have missing tiles -> T309543 |
|| Annotations | **[Dynamic] Geoshapes and markers missing (interactive)** | {F35101662}{F35101663} | Should be possible to add an error message. See also {T306987}. May be because the mapdata is missing or unavailable. | Easy to add an i18n error annotation |
| Annotations | **[Static] Plain map without any features/annotations (static)** | {F35101684}{F35101685} | | - This is about rendering the error on the server side with i18n support -> T309522 |
| | Annotations | **Plain map without any features/annotations (** | {F35102704}| Console showing an error message for a failed sparql query ) | {F35102704}| | Easy to add an i18n error annotation |
| | Out of scope? | **Cropped labels** | {F35102560} | This is an OSM issue. See also {T228812}. | Potentially out of scope |
| | Out of scope? | **Entire world is repeated twice** | {F35129729} | Happens when the map width is larger than the proper aspect ratio. This can also happen when a mapframe is set to automatically choose the bounding box based on a geoshape, but the shape doesn't load. | - Could limit the aspect ratio to never exceed one world - Crop off map on the sides |
Initial categorization of errors:
* No image is loaded at all.
* The water outline is rendered, but no map details.
* The base map is rendered, but no geojson overlays.
* The overlays are rendered, but no base layer.
* Corruption of the base map or overlay.