BMReverseGeocoder provides context about a latitude/longitude coordinate, such as street address and locality. More...
Public Member Functions | |
(id) | - initWithCoordinate: |
Initializes BMReverseGeocoder with a coordinate. | |
(void) | - start |
Starts an asynchronous reverse geocoding process. | |
(void) | - cancel |
Cancels a previously started reverse geocoding process. | |
(BOOL) | - isQuerying [implementation] |
Inidicates whether BMReverseGeocoder is currently performing a reverse geocoding query. (read-only) | |
Properties | |
id< BMReverseGeocoderDelegate > | delegate |
The delegate for the reverse geocoder. | |
CLLocationCoordinate2D | coordinate |
The coordinate to be used by the reverse geocoder. (read-only) | |
BMEntity * | entity |
The returned entity for the reverse geocoder query containing geocoded results. |
BMReverseGeocoder provides context about a latitude/longitude coordinate, such as street address and locality.
BMReverseGeocoder is typically used in scenarios where it is necessary to show the user a description of a coordinate, such as the user's location.
Reverse geocoded data is returned via the BMReverseGeocoderDelegate which provides a method for accessing the data with a BMEntity and a method called if an error is returned.
The Bing Maps geocoding service is used to provide data for this class. It is possible to reach the transaction limits for this service when called too often. When updating the location's information automatically, create a new request only when a sufficient distance has been travelled. It is worth subscribing to the notification that indicates that the device is locked or in a call in order to prevent further calls when a user is not interacting with the map view.
You can return localized geocoding results by setting Region Format in the International settings menu.
- (void) cancel |
Cancels a previously started reverse geocoding process.
This function immediately changes the status of the reverse geocode to cancelled.
- (id) initWithCoordinate: | (CLLocationCoordinate2D) | coordinate |
Initializes BMReverseGeocoder with a coordinate.
coordinate | The coordinate to use to initialize BMReverseGeocoder. |
- (BOOL) isQuerying | [implementation] |
Inidicates whether BMReverseGeocoder is currently performing a reverse geocoding query. (read-only)
This property contains YES if the process is on-going or NO if the process is done or has not yet been initiated.
- (void) start |
Starts an asynchronous reverse geocoding process.
A BMReverseGeocoder should only be started once.
- (CLLocationCoordinate2D) coordinate [read, assign] |
The coordinate to be used by the reverse geocoder. (read-only)
- (id< BMReverseGeocoderDelegate >) delegate [read, write, assign] |
The delegate for the reverse geocoder.
- (BMEntity *) entity [read, assign] |
The returned entity for the reverse geocoder query containing geocoded results.