oracle.panama.spatial.geocoder
Interface Geocoder

public interface Geocoder

This interface defines the functionality of a geocoder: computing lat/lon coordinates for an address. Any class implementing this interface should be thread-safe.

Field Summary

Type	Field
static java.lang.String	MATCH_MODE_NORMAL
static java.lang.String	MATCH_MODE_RELAXED
static java.lang.String	MATCH_MODE_STANDARD
static java.lang.String	MATCH_MODE_TIGHT

Method Summary

Type	Method
Location[]	geocodeAddress(Location inp, java.lang.String matchMode) This returns an array of Location objects with the geocoded result.
Location[][]	geocodeAddresses(Location[] inp, java.lang.String matchMode) Bulk geocoding for an array of addresses.
Location[]	reverseGeocodePoint(Point pt) This function reverse geocodes a point to result in a matching address.
java.lang.String	xmlGeocode(org.w3c.dom.Document xmlRequest) This function performs geocoding based on an XML request (eLocation XML).

Field Detail

MATCH_MODE_NORMAL

public static final java.lang.String MATCH_MODE_NORMAL

MATCH_MODE_STANDARD

public static final java.lang.String MATCH_MODE_STANDARD

MATCH_MODE_TIGHT

public static final java.lang.String MATCH_MODE_TIGHT

MATCH_MODE_RELAXED

public static final java.lang.String MATCH_MODE_RELAXED

Method Detail

geocodeAddress

public Location[] geocodeAddress(Location inp,
                                 java.lang.String matchMode)

This returns an array of Location objects with the geocoded result. If the address in unambiguous there will only be one result. This function MUST be implemented by each provider proxy. It is part of the required core functionality. Any provider not supporting this function might have serious restrictions in supporting any reasonable application. At the very least, such a "lacking" provider proxy could not be used as a "primary" provider. However, fail-over guarantees that applications would work if this function is covered by at least one provider proxy.

Parameters:

inp - a Location object representing an address to be geocoded

matchMode - a String representing the requested matchmode

Returns:

an array of Location objects representing the geocoded lat/lon

geocodeAddresses

public Location[][] geocodeAddresses(Location[] inp,
                                     java.lang.String matchMode)

Bulk geocoding for an array of addresses. This function MAY be implemented by a provider proxy. It is part of the optional functionality and some provider proxies do support it.

Parameters:

inp - an array of Location objects representing addresses to be geocoded

matchMode - a String representing the requested matchmode

Returns:

an array of arrays of Location objects representing the geocoded lat/lons

reverseGeocodePoint

public Location[] reverseGeocodePoint(Point pt)

This function reverse geocodes a point to result in a matching address. This function MAY be implemented by a provider proxy. It is part of the optional functionality and some provider proxies do support it.

Parameters:

pt - a Point representing the location for which to find an address

Returns:

an array of Location representing the (possibly more than one) alternative addresses matching this point

xmlGeocode

public java.lang.String xmlGeocode(org.w3c.dom.Document xmlRequest)

This function performs geocoding based on an XML request (eLocation XML). This function IS NOT TO BE implemented by any provider proxy. It is performed by the framework itself and translated to other functions.

Parameters:

xmlRequest - a Document object representing the XMl document of the geocoding request.

Returns:

a String representing the XMl String of the geocoding response.