Structure

# MKMapPoint

A point on a two-dimensional map projection.

## Overview

If you project the curved surface of the globe onto a flat surface, what you get is a two-dimensional version of a map where longitude lines appear to be parallel. Such maps are often used to show the entire surface of the globe all at once. An `MKMapPoint` data structure represents a point on this two-dimensional map.

The actual units of a map point are tied to the underlying units used to draw the contents of an `MKMapView`, but you should never need to worry about these units directly. You use map points primarily to simplify computations that would be complex to do using coordinate values on a curved surface. By converting to map points, you can perform those calculations on a flat surface, which is generally much simpler, and then convert back as needed. You can map between coordinate values and map points using the `MKMapPointForCoordinate` and `MKCoordinateForMapPoint` functions.

When saving map-related data to a file, you should always save coordinate values (latitude and longitude) and not map points.

## Topics

### Getting the Point Coordinates

`x`

The location of the point along the x-axis of the map.

`y`

The location of the point along the y-axis of the map.

`MKCoordinateForMapPoint`

Returns the latitude and longitude that corresponds to the specified map point.

### Comparing Map Points

`MKMapPointEqualToPoint`

Returns a Boolean value indicating whether the two map points are equal.

### Getting the Distance Between Points

`MKMetersBetweenMapPoints`

Returns the number of meters between two map points.

`MKMetersPerMapPointAtLatitude`

Returns the distance spanned by one map point at the specified latitude.

`MKMapPointsPerMeterAtLatitude`

Returns the number of map points that represent one meter at the given latitude.

### Getting a Description of the Point

`MKStringFromMapPoint`

Returns a formatted string for the specified map point.

### Map Coordinates

`MKCoordinateRegion`

A rectangular geographic region centered around a specific latitude and longitude.

`MKCoordinateSpan`

The width and height of a map region.

`MKMapRect`

A rectangular area on a two-dimensional map projection.

`MKMapSize`

Width and height information on a two-dimensional map projection.

`MKDistanceFormatter`

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