Class

CLPlacemark

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

Declaration

@interface CLPlacemark : NSObject

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

- initWithPlacemark:

Initializes and returns a placemark object from another placemark object.

+ placemarkWithLocation:name:postalAddress:

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

Accessing the Location Data

location

The location object containing latitude and longitude information.

Accessing the Placemark Attributes

name

The name of the placemark.

ISOcountryCode

The abbreviated country name.

country

The name of the country associated with the placemark.

postalCode

The postal code associated with the placemark.

administrativeArea

The state or province associated with the placemark.

subAdministrativeArea

Additional administrative area information for the placemark.

locality

The city associated with the placemark.

subLocality

Additional city-level information for the placemark.

thoroughfare

The street address associated with the placemark.

subThoroughfare

Additional street-level information for the placemark.

region

The geographic region associated with the placemark.

timeZone

The time zone associated with the placemark.

Accessing Address Information

postalAddress

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

addressDictionary

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

Deprecated

Accessing Geographic Information

inlandWater

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

ocean

The name of the ocean associated with the placemark.

Accessing Landmark Information

areasOfInterest

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.

CLGeocoder

An interface for converting between geographic coordinates and place names.