HERE iOS SDK Developer's Guide

NMAGeocoder

Class Summary

class NMAGeocoder

Derived from: NSObject

Represents a factory used to instantiate geocoder requests.

Include: NMAKit.framework/headers/NMAGeocoder.h

Inheritance Diagrams

Figure 1. Public inheritance diagram for NMAGeocoder

[For complete information, see the section Class Details]

Instance Method Summary

Table 1. Instance Methods
Instance Method Summary

-( NMAGeocodeRequest *) createGeocodeRequestWithQuery:(NSString *) query searchArea:( NMAGeoBoundingBox *) searchArea

Creates a geocoder request that resolves a free text query into an array of NMAPlaceLocation

-( NMAGeocodeRequest *) createGeocodeRequestWithQuery:(NSString *) query searchRadius:(NSInteger) searchRadius searchCenter:( NMAGeoCoordinates *) geoCoordinates

Creates a geocoder request that resolves a free text query into an array of NMAPlaceLocation

-( NMAReverseGeocodeRequest *) createReverseGeocodeRequestWithGeoCoordinates:( NMAGeoCoordinates *) geoCoordinates

Creates a reverse geocoder request that resolves a NMAGeoCoordinates context into a NMAPlaceLocation

Class Method Summary

Table 2. Class Methods
Class Methods

+( NMAGeocoder *) sharedGeocoder

Returns the NMAGeocoder singleton instance

Class Details

Represents a factory used to instantiate geocoder requests.

A NMAGeocoder enables searching for location data by way of the following search services:
Note:

NMAGeocoder requires valid authentication credentials to be set via NMAApplicationContext. If valid credentials are not present an attempt to call sharedNMAGeocoder will result in a runtime assert.

Instance Method Details

-( NMAGeocodeRequest *) createGeocodeRequestWithQuery:(NSString *) query searchArea:( NMAGeoBoundingBox *) searchArea

Creates a geocoder request that resolves a free text query into an array of NMAPlaceLocation. After creating the request, [request startWithListener:(id<NMAResultListener>)] needs to be called to start the search.

Parameters:

  • query

    Query text specifying the search item to locate

  • searchArea

    NMAGeoBoundingBox representing the search area. Note that the search area may be ignored if the query text already specifies a search area, such as a state.

Returns:

The NMAGeocodeRequest

-( NMAGeocodeRequest *) createGeocodeRequestWithQuery:(NSString *) query searchRadius:(NSInteger) searchRadius searchCenter:( NMAGeoCoordinates *) geoCoordinates

Creates a geocoder request that resolves a free text query into an array of NMAPlaceLocation. After creating the request, [request startWithListener:(id<NMAResultListener>)] needs to be called to start the search.

Parameters:

  • query

    Query text specifying the search item to locate

  • searchRadius

    Radius in meters, in which the search should be performed

  • geoCoordinates

    NMAGeoCoordinates object representing the location context used to search for results that are appropriate to the query parameter. Note that this search location can be overridden if the query text already specifies a search area, such as a state.

Returns:

The NMAGeocodeRequest

-( NMAReverseGeocodeRequest *) createReverseGeocodeRequestWithGeoCoordinates:( NMAGeoCoordinates *) geoCoordinates

Creates a reverse geocoder request that resolves a NMAGeoCoordinates context into a NMAPlaceLocation. After creating the request, [request startWithListener:(id<NMAResultListener>)] needs to be called to start the search.

Parameters:

Returns:

The NMAReverseGeocodeRequest

Class Method Details

+( NMAGeocoder *) sharedGeocoder

Returns the NMAGeocoder singleton instance.

Note:

Use this method to obtain a NMAGeocoder instance. Do not call init directly.

Returns:

shared NMAGeocoder instance

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on selfservesupport@here.com.