ideally this also takes an optional context-sensitive opts parameter so it can construct the entire url string (opts might be an array of location ids for instance).  We can fix that later though.