WMDE Technical Wishes/Geoinformation/Maki icons

From Meta, a Wikimedia project coordination wiki
Tracked in Phabricator:
Task T145475

In Kartographer maps, you can use Maki icons on markers for common points of interest. See mw:Help:Extension:Kartographer/Icons for the full list of all available icons.

Status and next steps[edit]

Yes The maki icons were updated on all wikis on September 20, 2022


In the past,

  • several icons weren’t working, e.g. castle, mountain, stadium;
  • other helpful icons were not available in the icon set;
  • the meaning of some existing icons was not very clear.


maki 7.2 icons

As a first step, the Technical Wishes team updated the Maki icon set used in the Wikimedia projects to a newer version, from 0.5.0 to 7.0.0. This brings the following changes:

  • All icons have been updated, for clarity and to make them work better in international contexts.
  • Comparison: icons Maki 0.5 vs. icons Maki 7.2
  • The appearance of the icons has been improved (contrast, size)
  • About 100 new icons have been added (expand to get the full list)
New icons
  • amusement-park, aquarium, arrow
  • bank-JP, barrier, bbq, beach, bicycle-share, blood-bank, bowling-alley, bridge, building-alt1
  • car-rental, car-repair, casino, castle-JP, castle, caution, cemetery-JP, charging-station, college-JP, communications-tower, confectionery, construction, convenience
  • defibrillator, diamond, doctor, drinking-water
  • elevator, entrance-alt1
  • fence, ferry-JP, fire-station-JP, fitness-centre, florist, furniture
  • gaming, garden-centre, gate, globe
  • hardware, highway-rest-area, historic, home, horse-riding, hospital-JP, hotspring
  • information
  • jewelry-store
  • karaoke
  • landmark-JP, landmark, liftgate, lighthouse-JP
  • monument-JP, mountain
  • observation-tower, optician
  • paint, park-alt1, picnic-site, police-JP, post-JP
  • racetrack-boat, racetrack-cycling, racetrack-horse, racetrack, rangerstation, recycling, religious-buddhist, religious-shinto, residential-community, restaurant-bbq, restaurant-noodle, restaurant-pizza, restaurant-seafood, restaurant-sushi, road-accident
  • school-JP, shelter, shoe, skateboard, slipway, snowmobile, stadium
  • table-tennis, teahouse, tollbooth, tunnel
  • veterinary, viewpoint, volcano, volleyball
  • watch, waterfall, watermill, wheelchair, windmill

Differences between Maki 0.5 and Maki 7.2[edit]

Icons that don't exist in Maki 7.2[edit]

A few icons from Maki 0.5 don’t exist in 7.2. For maps with these icons, the following alternatives will be shown automatically:

0.5 7.2 Icon that will be shown
chemist no longer exists pharmacy
london-underground no longer exists rail-metro
minefield no longer exists danger
oil-well no longer exists industry
polling-place no longer exists post
rail-above no longer exists rail
rail-underground no longer exists rail-metro

Icons with different names in Maki 7.2[edit]

In Maki 7.2, a few icons have a different name than they had in the old icon set. Maps using the old name will automatically show the new icon instead:

0.5 7.2
america-football new spelling: american-football
camera renamed to: attraction
disability renamed to: wheelchair
emergency-telephone new spelling: emergency-phone
industrial new spelling: industry
land-use new spelling: landuse
mobilephone new spelling: mobile-phone
park There are two types of park now:

park shows a decidious tree (like maple)

park-alt1 shows a coniferous tree (like pine)

toilets new spelling: toilet

A little glimpse into what was necessary to make this small change[edit]

  • The maki icon library was outdated by 7 years. In order to update the library to the new version, we had to rebuild the whole tool (makizushi) that draws the markers from the SVG library (create PNG, add pin markers, background color).
  • Rendering the new icons to fit the same space as the old icons took some fine-tuning.
  • We rebuilt the way alphanumeric markers were generated. Before, they were being clipped out of a master art board. Now, the SVGs can be generated dynamically from Javascript. This makes styling improvements much simpler in the future.
  • Unlike the old icons, the new icons did not come with black outlines. We were concerned that white images on light-colored marker backgrounds would be hard to see. So we used accessibility guidelines to determine when a light or dark icon would provide the best visual contrast, and switch between the two at a calculated threshold.
  • A few icons from Maki 0.5 were no longer included in Maki 7.2. We did some research on the meaning of the old icons, to find the best new icons for each old name.
  • To update the help page on mediawiki.org, we wrote a Lua module which shows all icons on a map, and produces a list view of the icon names which can be annotated with local translations or descriptions.