com.tomtom.navapp

Interface GeoCoder

public interface GeoCoder

The NavApp GeoCoder interface, for handling geocoding and reverse geocoding.

Geocoding is the process of finding a set of geographic coordinates (latitude and longitude) from a street address, or other geographic data.

Reverse Geocoding is the process of finding a readable address or placename, from a set of geographic coordinates (latitude and longitude).

Since:

1

Method Summary

Modifier and Type	Method and Description
void	getRouteableFromLocation(double latitude, double longitude, int maxResults, Routeable.ListListener listener) Perform a reverse geocoding lookup.
void	getRouteableFromLocationName(java.lang.String locationName, int maxResults, Routeable.ListListener listener) Perform a geocoding lookup.

Method Detail

getRouteableFromLocation

void getRouteableFromLocation(double latitude,
                              double longitude,
                              int maxResults,
                              Routeable.ListListener listener)

Perform a reverse geocoding lookup. Returns a list of Routeable objects surrounding the given latitude and longitude. The information returned can vary in detail depending on the passed in location. Part of the address will be localized to the current device language see Address. If no addresses were found around this location, or the location was outside the current active map, or outside the valid range for coordinates, an empty list will be returned.

Note: The maxResults argument is currently ignored and the listener will always return a single result.

The passed in listener is only active until the result of the call has been returned. Once a result has been returned the listener won't receive any more callbacks (but can be re-used).

Parameters:

latitude - The latitude in degrees of the location. This is at 10^6 accuracy (micro degrees), for example 51.482586. The latitude has to be within -90 and 90 degrees.

longitude - The longitude in degrees of the location. This is at 10^6 accuracy (micro degrees), for example -0.007904. The longitude has to be within -180 and 180 degrees.

maxResults - Max number of results to return. Smaller numbers are recommended (recommended less than 5).

listener - The Routeable.ListListener to receive the list of Routeable objects.

Throws:

java.lang.IllegalArgumentException - if the listener is null.

Since:

1

getRouteableFromLocationName

void getRouteableFromLocationName(java.lang.String locationName,
                                  int maxResults,
                                  Routeable.ListListener listener)

Perform a geocoding lookup. Returns a list of Routeable objects matching the given location-name. The passed in location name is free text, and can for example contain an address such as "10 Downing Street, London", or a less accurate location such as "High Street, London". The returned results can vary in detail depending on the passed in location string, and are best guesses only and may not be meaningful or correct. Part of the address will be localized to the current device language see Address. If no addresses were found for this location an empty list will be returned. The passed in listener is only active until the result of the call has been returned. Once a result has been returned the listener won't receive any more callbacks (but can be re-used).

Parameters:

locationName - A string describing the location.

maxResults - Max number of results to return. Smaller numbers are recommended (recommended less than 5).

listener - The Routeable.ListListener to receive the list of Routeable objects.

Throws:

java.lang.IllegalArgumentException - if the listener is null.

Since:

1