# get_dist proc

Source: https://ref.dm-lang.org/proc/get_dist

### Format
> `get_dist(Loc1, Loc2)`

### Returns
> The distance between `Loc1` and `Loc2`, in tiles. This is the number of full-tile movements (disregarding any obstacles and allowing diagonal moves *including across Z levels*) required to go from one to the other. You can think of it as the max of their x, y, and z distances.

### Args
- `Loc1`: An object on the map.
- `Loc2`: An object on the map.


For a distance in pixels, use `bounds_dist()`.

`get_dist()` will return -1 when `Loc1` and `Loc2` are the same object. If one or both of them is not on the map, an infinite value is returned.

> [!note]
> 
> Prior to BYOND 515, `get_dist()` never returned a value greater than 127, which it counted as "infinite".

### See also
> [bounds_dist proc](https://ref.dm-lang.org/proc/bounds_dist.md)
