public interface GeoCoder
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).
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.
|
void getRouteableFromLocation(double latitude, double longitude, int maxResults, Routeable.ListListener listener)
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).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.java.lang.IllegalArgumentException
- if the listener is null.void getRouteableFromLocationName(java.lang.String locationName, int maxResults, Routeable.ListListener listener)
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).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.java.lang.IllegalArgumentException
- if the listener is null.