Class

CLPlacemark

A user-friendly description of a geographic coordinate, often containing the name of the place, its address, and other relevant information.

Overview

A CLPlacemark object stores placemark data for a given latitude and longitude. Placemark data includes information such as the country, state, city, and street address associated with the specified coordinate. It can also include points of interest and geographically related data.

When you reverse geocode a geographic coordinate using a CLGeocoder object, you receive a CLPlacemark object containing the descriptive information for that location. You can also create CLPlacemark object and fill it with address information yourself, which you might do when you want to determine the geographic coordinate associated with the location.

Topics

Initializing a Placemark Object

init(placemark: CLPlacemark)

Initializes and returns a placemark object from another placemark object.

init(location: CLLocation, name: String?, postalAddress: CNPostalAddress?)

Creates and initializes a placemark object using the specified location and address information.

Accessing the Location Data

var location: CLLocation?

The location object containing latitude and longitude information.

Accessing the Placemark Attributes

var name: String?

The name of the placemark.

var isoCountryCode: String?

The abbreviated country name.

var country: String?

The name of the country associated with the placemark.

var postalCode: String?

The postal code associated with the placemark.

var administrativeArea: String?

The state or province associated with the placemark.

var subAdministrativeArea: String?

Additional administrative area information for the placemark.

var locality: String?

The city associated with the placemark.

var subLocality: String?

Additional city-level information for the placemark.

var thoroughfare: String?

The street address associated with the placemark.

var subThoroughfare: String?

Additional street-level information for the placemark.

var region: CLRegion?

The geographic region associated with the placemark.

var timeZone: TimeZone?

The time zone associated with the placemark.

Accessing Address Information

var postalAddress: CNPostalAddress?

The postal address associated with the location, formatted for use with the Contacts framework.

var addressDictionary: [AnyHashable : Any]?

A dictionary containing the Address Book keys and values for the placemark.

Deprecated

Accessing Geographic Information

var inlandWater: String?

The name of the inland water body associated with the placemark.

var ocean: String?

The name of the ocean associated with the placemark.

Accessing Landmark Information

var areasOfInterest: [String]?

The relevant areas of interest associated with the placemark.

Relationships

Inherits From

See Also

Geocoding

Converting Between Coordinates and User-Friendly Place Names

Convert between a latitude/longitude pair and a more user-friendly description of that location.

class CLGeocoder

An interface for converting between geographic coordinates and place names.