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.
| Description | Screenshot | Notes (Category) | Potential improvements |
| Broken image icon | {F35039203} | Might be hard to add a translatable error message. Possible reasons: server down, ... | - This is about rendering the error on the server side with i18n support -> T309522 |
| Missing map while loading (static) | {F35101431}{F35101444}| The loading displays a broken map stage for a short time: {F35106087} | - Should be possible to add a background image with a spinner/whatever -> T309541 |
| Missing features/broken map while loading (dynamic) | | | - Should be possible to add a background image with a spinner/whatever - 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 - TBD TICKET |
| 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 - TBD TICKET |
| Map not visible in VE | {F35101438}| | - Should look into this, probably fixable - TBD TICKET |
| 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 |
| Plain map without any features/annotations (static) | {F35101684}{F35101685} | | - This is about rendering the error on the server side with i18n support -> T309522 |
| Plain map without any features/annotations ( Console showing an error message for a failed sparql query ) | {F35102704}| | Easy to add an i18n error annotation |
| Cropped labels | {F35102560} | This is a OSM issue. See also {T228812}. | Potentially 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.