add explanatory comments to maps.js