geoGetAddress (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

The content of this page has been updated to version 27. See documentation 27 now.

Help / WLanguage / WLanguage functions / Standard functions / Geolocation functions

Managing multiple addresses
Required application feature

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

geoGetAddress (Function)

In french: géoRécupèreAdresse

Retrieves an address (or a list of addresses) corresponding to the description of a geographical location.

Example

// Retrieves the address of a monument
MyAddress is Address
MyAddress = geoGetAddress("Eiffel Tower")
IF ErrorOccurred = False THEN
Info(MyAddress..Country)
END

Syntax

Retrieving an address Hide the details

<Result> = geoGetAddress(<Description>)

<Result>: Address variable

Address variable corresponding to the description of the location.
To find out whether the position failed to be retrieved, use the ErrorOccurred variable. To get the details of the error, use ErrorInfo.

<Description>: Character string (with quotes)

Location whose address must be retrieved. This character string can correspond to:
the location expressed by the city and the country. Example: "Paris, France".
the location expressed by the position ("<latitude>, <longitude>"). Example: "43.639942,3.837672".

Retrieving a list of addresses Hide the details

<Result> = geoGetAddress(<Description> , <Array of addresses> [, <Number of addresses>])

<Result>: Boolean

True if at least one address was retrieved,
False otherwise.
To find out whether the position failed to be retrieved, use the ErrorOccurred variable. To find out the error details, use ErrorInfo.

<Description>: Character string (with quotes)

Location whose address must be retrieved. This character string can correspond to:
the location expressed by the city and the country. Example: "Paris, France".
the location expressed by the position ("<latitude>, <longitude>"). Example: "43.639942,3.837672".

<Array of addresses>: Array

Name of the array of Address variables that will be filled with the list of addresses corresponding to the position. The different properties of the Address variables (street, city, etc.) will be filled according to the precision of the information returned by the geolocation service.

<Number of addresses>: Optional integer

Maximum number of addresses returned in the list. If this parameter is not specified, the maximum number of addresses will be set to 10. }}

New in version 25

Retrieving a list of addresses (asynchronous mode) Hide the details

geoGetAddress(<Description> , <WLanguage procedure> [, <Number of addresses>])

<Description>: Character string (with quotes)

Location whose address must be retrieved. This character string can correspond to:
the location expressed by the city and the country. Example: "Paris, France".
the location expressed by the position ("<latitude>, <longitude>"). Example: "43.639942,3.837672".

<WLanguage procedure>: Procedure name

Name of WLanguage procedure ("callback") that will be called for the place with the address that must be retrieved. For more details on this procedure, see Parameters of the procedure used by geoGetAddress.

<Number of addresses>: Optional integer

Maximum number of addresses returned in the list. If this parameter is not specified, the maximum number of addresses will be set to 10.

Remarks

Managing multiple addresses

If several addresses correspond to the same description, a dialog box is automatically displayed to allow the user to select one of these addresses.

To retrieve the list of addresses corresponding to the description, use the second syntax.

Required application feature

The use of this function triggers the declaration of one application feature in the application generation wizard.

Required feature: Internet and public networks (incoming and outgoing)

Related Examples:

Cross-platform examples (WINDEV Mobile): WM Geolocation

[ + ] This example explains how to perform proximity searches with geolocation :
- search around me
- search in a city, at a given address, or close to a specific address.
The results are displayed in a looper and in a map with markers.

Business / UI classification : Business Logic

Component : wd250android.aar