---
title: MKDistanceFormatter
framework: mapkit
role: symbol
role_heading: Class
path: mapkit/mkdistanceformatter
---

# MKDistanceFormatter

A utility object that converts between a geographic distance and a string-based expression of that distance.

## Declaration

```swift
class MKDistanceFormatter
```

## Overview

Overview Use a distance formatter to display distances to the user or to parse user-specified text to obtain a numerical value for a distance. When formatting strings containing distances, a distance formatter object takes into account the user’s locale and language settings. You can also specify a custom locale or custom units for any distances that you format.

## Topics

### Converting distances

- [string(fromDistance:)](mapkit/mkdistanceformatter/string(fromdistance:).md)
- [distance(from:)](mapkit/mkdistanceformatter/distance(from:).md)

### Specifying the format

- [locale](mapkit/mkdistanceformatter/locale.md)
- [units](mapkit/mkdistanceformatter/units-swift.property.md)
- [MKDistanceFormatter.Units](mapkit/mkdistanceformatter/units-swift.enum.md)
- [unitStyle](mapkit/mkdistanceformatter/unitstyle.md)
- [MKDistanceFormatter.DistanceUnitStyle](mapkit/mkdistanceformatter/distanceunitstyle.md)

## Relationships

### Inherits From

- [Formatter](foundation/formatter.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSCoding](foundation/nscoding.md)
- [NSCopying](foundation/nscopying.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)

## See Also

### Map coordinates

- [MKCoordinateRegion](mapkit/mkcoordinateregion.md)
- [MKCoordinateSpan](mapkit/mkcoordinatespan.md)
- [MKMapRect](mapkit/mkmaprect.md)
- [MKMapPoint](mapkit/mkmappoint.md)
- [MKMapSize](mapkit/mkmapsize.md)