ReverseGeocoderOptions

Reverse Geocoding request options.

Reverse geocoding options are used to specify the parameters of a reverse geocoding request. They consist of a position and optional parameters such as heading, radius, roadUses, areaTypes, locale, preferClosestAccurateAddress, and fetchGeometry.

To specify reverse geocoding options, create an instance of ReverseGeocoderOptions class:

val reverseGeocoderOptions = ReverseGeocoderOptions(
position = GeoPoint(52.377271, 4.909466),
heading = Angle.Companion.degrees(90.0),
radius = Distance.Companion.meters(1000.0),
areaTypes = setOf(AreaType.Municipality),
locale = Locale.ENGLISH,
preferClosestAccurateAddress = false,
fetchGeometry = false
)

Constructors

Link copied to clipboard
constructor(position: GeoPoint, heading: Angle? = null, radius: Distance = DEFAULT_RADIUS, roadUses: Set<RoadUse> = emptySet(), areaTypes: Set<AreaType> = emptySet(), locale: Locale = Locale.getDefault(), preferClosestAccurateAddress: Boolean = false, fetchGeometry: Boolean = false)

Constructs a ReverseGeocoderOptions object with the given parameters.

constructor(position: GeoPoint, heading: Angle? = null, radius: Distance = DEFAULT_RADIUS, areaTypes: Set<AreaType> = emptySet(), locale: Locale = Locale.getDefault(), preferClosestAccurateAddress: Boolean = false, fetchGeometry: Boolean = false)

Constructs a ReverseGeocoderOptions object with the given parameters.

Types

Link copied to clipboard
object Companion

Contains the default values for reverse geocoding options.

Properties

Link copied to clipboard

Filters results to specific geographical area types. When areaTypes is set, the parameters heading and roadUses are ignored.

Link copied to clipboard

Specifies if geometry shapes should be fetched for reverse geocoding results, where available.

Link copied to clipboard

The directional heading of the vehicle in degrees while traveling on a road segment. North is 0 degrees, East is 90 degrees, etc.

Link copied to clipboard

The language used for displaying results. If not provided, the system default language is used.

Link copied to clipboard

The geographical coordinates to be translated into a human-readable address.

Link copied to clipboard

Determines whether the closest accurate address is preferred over the address with the closest navigable coordinates.

Link copied to clipboard

The maximum distance from the specified position that the reverse geocoder will search within. Defaults to DEFAULT_RADIUS.

Link copied to clipboard

Filters results to roads with specific intended usages.

Functions

Link copied to clipboard
operator fun component1(): GeoPoint

Returns the first component of this ReverseGeocoderOptions object, which is the geographical coordinates.

Link copied to clipboard
operator fun component2(): Angle?

Returns the second component of this ReverseGeocoderOptions object, which is the directional heading of the vehicle in degrees while traveling on a road segment.

Link copied to clipboard
operator fun component3(): Distance

Returns the third component of this ReverseGeocoderOptions object, which is the maximum distance from the specified position that the reverse geocoder will search within. Defaults to DEFAULT_RADIUS.

Link copied to clipboard
operator fun component4(): Set<RoadUse>

Returns the fourth component of this ReverseGeocoderOptions object, which is a component that filters results to roads with specific intended usages.

Link copied to clipboard
operator fun component5(): Set<AreaType>

Returns the fifth component of this ReverseGeocoderOptions object, which is a component that filters results to specific geographical area types. When areaTypes is set, the parameters heading and roadUses are ignored.

Link copied to clipboard
operator fun component6(): Locale

Returns the sixth component of this ReverseGeocoderOptions object, which is the language used for displaying results. If not provided, the system default language is used.

Link copied to clipboard
operator fun component7(): Boolean

Returns the seventh component of this ReverseGeocoderOptions object, which determines whether the closest accurate address is preferred over the address with the closest navigable coordinates.

Link copied to clipboard
operator fun component8(): Boolean

Returns the eighth component of this ReverseGeocoderOptions object, which specifies if geometry shapes should be fetched for reverse geocoding results, where available.

Link copied to clipboard
fun copy(position: GeoPoint = this.position, heading: Angle? = this.heading, radius: Distance = this.radius, areaTypes: Set<AreaType> = this.areaTypes, locale: Locale = this.locale, preferClosestAccurateAddress: Boolean = this.preferClosestAccurateAddress, fetchGeometry: Boolean = this.fetchGeometry): ReverseGeocoderOptions
fun copy(position: GeoPoint = this.position, heading: Angle? = this.heading, radius: Distance = this.radius, roadUses: Set<RoadUse> = this.roadUses, areaTypes: Set<AreaType> = this.areaTypes, locale: Locale = this.locale, preferClosestAccurateAddress: Boolean = this.preferClosestAccurateAddress, fetchGeometry: Boolean = this.fetchGeometry): ReverseGeocoderOptions

Creates a copy of this ReverseGeocoderOptions object with optional parameter overrides.