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 addressDictionary: [AnyHashable : Any]?

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

Deprecated
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 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.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software