de.monarchy.guideme.routing.nutiteq
Class NutiteqGeoCoding

java.lang.Object
  de.monarchy.guideme.routing.nutiteq.NutiteqGeoCoding

All Implemented Interfaces:

GeoCodingComponent

public class NutiteqGeoCoding
extends java.lang.Object
implements GeoCodingComponent

NutiteqGeoCoding is a geocoding provider using Nutiteq's Geocoder implementation. The service uses a Cloudmade backend. It is asynchronous, so the method with array return value is not supported and throws the corresponding exception.

Author:

dstuerze

Field Summary

Fields inherited from interface de.monarchy.guideme.routing.GeoCodingComponent

ERROR_NOT_FOUND, ERROR_SERVICE_DOWN, EVERYWHERE

Constructor Summary

NutiteqGeoCoding()

Method Summary

void	findNear(GeoCodingListener l, java.lang.String search, GeoCoordinate location, int maxDistance) Searches places defined by a search string in an area around a certain location.
PointOfInterest[]	findNear(java.lang.String search, GeoCoordinate location, int maxDistance) Searches places defined by a search string in an area around a certain location.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

NutiteqGeoCoding

public NutiteqGeoCoding()

Method Detail

findNear

public PointOfInterest[] findNear(java.lang.String search,
                                  GeoCoordinate location,
                                  int maxDistance)
                           throws java.lang.UnsupportedOperationException

Description copied from interface: GeoCodingComponent

Searches places defined by a search string in an area around a certain location. The method will call a geocoding service and deliver an array of possible matches. The search is restricted to an area near a given location. The maximal distance is denoted by the parameter maxDistance, which can be set to the constant value EVERYWHERE to search without restrictions.

Specified by:

findNear in interface GeoCodingComponent

Parameters:

search - place that is searched

location - location near the place

maxDistance - maximum distance between location and place

Returns:

array of possible matches

Throws:

java.lang.UnsupportedOperationException - in every case

findNear

public void findNear(GeoCodingListener l,
                     java.lang.String search,
                     GeoCoordinate location,
                     int maxDistance)
              throws java.lang.UnsupportedOperationException

Description copied from interface: GeoCodingComponent

Searches places defined by a search string in an area around a certain location. The method will call a geocoding service and deliver an array of possible matches. The search is restricted to an area near a given location. The maximal distance is denoted by the parameter maxDistance, which can be set to the constant value EVERYWHERE to search without restrictions. After the call is completed, the given listener receives an answer.

Specified by:

findNear in interface GeoCodingComponent

Parameters:

l - RoutingListener the result is delivered to

search - place that is searched

location - location near the place

maxDistance - maximum distance between location and place

Throws:

java.lang.UnsupportedOperationException - if an asynchronous call is not supported