MKReverseGeocoder Class Reference
Available in iOS 3.0 and later.
This class is deprecated in iOS 5.0. Use the
CLGeocoder class instead.
MKReverseGeocoder class provides services for converting a map coordinate (specified as a latitude/longitude pair) into information about that coordinate, such as the country, city, or street. A reverse geocoder object is a single-shot object that works with a network-based map service to look up placemark information for its specified coordinate value.
The Google terms of service require that the reverse geocoding service be used in conjunction with a Google map; take this into account when designing your application's user interface.
Each Map Kit application has a limited amount of reverse geocoding capacity, so it is to your advantage to use reverse geocode requests sparingly. Here are some rules of thumb for using this class most effectively:
Send at most one reverse-geocoding request for any one user action.
If the user performs multiple actions that involve reverse-geocoding the same location, reuse the results from the initial reverse-geocoding request instead of starting individual requests for each action.
When you want to update the location automatically (such as when the user is moving), reissue the reverse-geocoding request only when the user's location has moved a significant distance and after a reasonable amount of time has passed. For example, in a typical situation, you should not send more than one reverse-geocode request per minute.
Do not start a reverse-geocoding request at a time when the user will not see the results immediately. For example, do not start a request if your application recently resigned the active state (possibly because of an interruption such as a phone call) and is waiting to become active again.
An iOS-based device must have access to the network in order for the reverse geocoder object to return valid information. The reverse geocoder returns information through its associated delegate object, which is an object that conforms to the
MKReverseGeocoderDelegate protocol. If the reverse geocoder is unable to retrieve the requested information, it similarly reports the error to its delegate object. For more information on this protocol, see MKReverseGeocoderDelegate Protocol Reference.
Initializing the Reverse Geocoder
– initWithCoordinate:Deprecated in iOS 5.0
Accessing Reverse Geocoder Attributes
coordinateproperty Deprecated in iOS 5.0
delegateproperty Deprecated in iOS 5.0
placemarkproperty Deprecated in iOS 5.0
Managing the Search
© 2011 Apple Inc. All Rights Reserved. (Last updated: 2011-10-12)