documented new optional map feature