Package com.esri.arcgisruntime.tasks.geocode

Class GeocodeResult

java.lang.Object

com.esri.arcgisruntime.tasks.geocode.GeocodeResult

public final class GeocodeResult
extends java.lang.Object

A match candidate returned from a LocatorTask geocode or reverse geocode operation.

GeocodeResult provides information about the candidate, such as a collection of requested attribute values, user-friendly label text, and locations suited for accurate match display or for routing input.

Since:

100.0.0

See Also:

LocatorTask.geocodeAsync(String), LocatorTask.geocodeAsync(Map), LocatorTask.geocodeAsync(SuggestResult), LocatorTask.geocodeAsync(String, GeocodeParameters), LocatorTask.geocodeAsync(Map, GeocodeParameters), LocatorTask.geocodeAsync(SuggestResult, GeocodeParameters), LocatorTask.reverseGeocodeAsync(Point), LocatorTask.reverseGeocodeAsync(Point, ReverseGeocodeParameters)

Method Summary

Modifier and Type	Method	Description
java.util.Map<java.lang.String,java.lang.Object>	getAttributes()	Gets a collection of attributes as requested by GeocodeParameters.getResultAttributeNames() or ReverseGeocodeParameters.getResultAttributeNames().
Point	getDisplayLocation()	Gets the location of the candidate suitable for display on a map.
Envelope	getExtent()	Gets an extent suitable for zooming the map to display the candidate.
Point	getInputLocation()	The Point provided as input to LocatorTask.reverseGeocodeAsync(Point).
java.lang.String	getLabel()	Gets a user-friendly text that describes this result.
Point	getRouteLocation()	Gets the nearest street location for the result.
double	getScore()	Gets a value that indicates how well the address was matched.

Methods inherited from class java.lang.Object

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

Method Detail

getAttributes

public java.util.Map<java.lang.String,java.lang.Object> getAttributes()

Gets a collection of attributes as requested by GeocodeParameters.getResultAttributeNames() or ReverseGeocodeParameters.getResultAttributeNames().

Available attributes depend on the data stored with the locator, and can include things like place, name, URL, phone number, and so on.

Returns:

an unmodifiable Map; the keys are Strings containing the names of the attributes and the values are Objects containing the values of the attributes

Since:

100.0.0

getExtent

public Envelope getExtent()

Gets an extent suitable for zooming the map to display the candidate.

Returns:

an Envelope describing the extent

Since:

100.0.0

getLabel

public java.lang.String getLabel()

Gets a user-friendly text that describes this result.

Returns:

a formatted address string

Since:

100.0.0

getDisplayLocation

public Point getDisplayLocation()

Gets the location of the candidate suitable for display on a map. For example, this may provide a more precise rooftop location of a house, whereas getRouteLocation() represents the nearest street location.

Returns:

the display location

Since:

100.0.0

getInputLocation

public Point getInputLocation()

The Point provided as input to LocatorTask.reverseGeocodeAsync(Point). Only applicable for results of reverse-geocode operations.

Returns:

the input location

Since:

100.0.0

getRouteLocation

public Point getRouteLocation()

Gets the nearest street location for the result. Use this location if you want to use the candidate as a stop in a route. For example, getDisplayLocation() provide a more precise rooftop location of a house, whereas getRouteLocation() will provide the nearest street location.

Returns:

the route location

Since:

100.0.0

getScore

public double getScore()

Gets a value that indicates how well the address was matched. The score is in the range between 0 (no match) and 100 (perfect match).

Returns:

a match score value in the range [0..100]

Since:

100.0.0