Geocode a given address (retrieve the position)

Variables
final int	MSG_RI_GEOCODE = 500

---

Detailed Description

Geocode a given address

Geocode (return the mercator position) from a given address.

Sending bundle:

Not all keys have to be set to get a valid result.

Key	Value	Type	Info
CC	The country code of the country to search in (e.g. "DE")	String
PostCode	The postcode to search for	String
TownName	The town name to search	String
StreetName	The street name to search	String
HNr	The house number to search for	String

Compatibility mode (MSG_RI_SET_COMPATIBILITY_MODE) set to true:

Returned bundle:

Key	Value	Type	Info
PosX	The found mercator x position of the address	int
PosY	The found mercator y position of the address	int
CC	The found country code	String
PostCode	The found postcode	String
TownName	The found town name	String
StreetName	The found street name	String
HNr	The found housenumber	String

Compatibility mode (MSG_RI_SET_COMPATIBILITY_MODE) set to false:

Returned bundle:

Key	Value	Type	Info
Longitude	The longitude of the address	double
Latitude	The latitude of the address	double
CC	The found country code	String
PostCode	The found postcode	String
TownName	The found town name	String
StreetName	The found street name	String
HNr	The found housenumber	String

Returned error codes:

RI_ERROR_NONE if everything is ok.
RI_ERROR_INVALID_PARAMETER if the received bundle is empty.
RI_ERROR_RI_DISABLED if the Remote Interface service is disabled and/or not licensed.
RI_ERROR_NOT_INITIALIZED if the Remote Interface service is not initialized yet.
RI_ERROR_NO_RESULT_FOUND if the address couldn't be found.
RI_ERROR_NO_STREET_FOUND and a bundle of data if the search succeeded, but no street was found (return position is the town center).
RI_ERROR_NO_LICENSE if the navigator has no valid license.