add utilities to decode locations