PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
This content has been translated automatically. Click here to view the French version.
  • Managing multiple addresses
  • Required application feature
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Retrieves an address or a list of addresses corresponding to the description of a geographic location.
Versions 18 and later
Android Widget This function is now available in Android widget mode.
New in version 18
Android Widget This function is now available in Android widget mode.
Android Widget This function is now available in Android widget mode.
Versions 20 and later
iPhone/iPad This function is now available for iPhone/iPad applications.
New in version 20
iPhone/iPad This function is now available for iPhone/iPad applications.
iPhone/iPad This function is now available for iPhone/iPad applications.
Versions 21 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Versions 27 and later
WEBDEV - Server code This function is now available for WEBDEV sites in Windows.
WEBDEV - Server codeLinux This function is now available for WEBDEV sites in Linux.
WINDEVLinux This function is now available for WINDEV applications in Linux.
WINDEV This function is now available for WINDEV applications in Windows.
New in version 27
WEBDEV - Server code This function is now available for WEBDEV sites in Windows.
WEBDEV - Server codeLinux This function is now available for WEBDEV sites in Linux.
WINDEVLinux This function is now available for WINDEV applications in Linux.
WINDEV This function is now available for WINDEV applications in Windows.
WEBDEV - Server code This function is now available for WEBDEV sites in Windows.
WEBDEV - Server codeLinux This function is now available for WEBDEV sites in Linux.
WINDEVLinux This function is now available for WINDEV applications in Linux.
WINDEV This function is now available for WINDEV applications in Windows.
Example
// Récupère l'adresse d'un monument historique
MonAdresse is Address
MonAdresse = geoGetAddress("Tour Eiffel")
IF ErrorOccurred = False THEN
Info(MonAdresse.Country)
END
Syntax
Mac Catalyst Not available in Catalyst mode

Recovering 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
Location whose address must be retrieved. This character string can correspond to:
  • the location specified as city and country. Example: "Paris, France".
    Remark: The location must be specified in the language of the telephone.
  • the location expressed by the position ("<latitude>, <longitude>"). Example: "43.639942,3.837672".
Mac Catalyst Not available in Catalyst mode

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 get the details of the error, use ErrorInfo.
<Description>: Character string
Location whose address must be retrieved. This character string can correspond to:
  • the location specified as city and country. Example: "Paris, France".
    Remark: The location must be specified in the language of the telephone.
  • 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.
Versions 25 and later

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

geoGetAddress(<Description> , <WLanguage procedure> [, <Number of addresses>])
<Description>: Character string
Location whose address must be retrieved. This character string can correspond to:
  • the location specified as city and country. Example: "Paris, France".
    Remark: The location must be specified in the language of the telephone.
  • the location expressed by the position ("<latitude>, <longitude>"). Example: "43.639942,3.837672".
<WLanguage procedure>: Procedure name
Name of the WLanguage procedure ("callback") 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.
New in version 25

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

geoGetAddress(<Description> , <WLanguage procedure> [, <Number of addresses>])
<Description>: Character string
Location whose address must be retrieved. This character string can correspond to:
  • the location specified as city and country. Example: "Paris, France".
    Remark: The location must be specified in the language of the telephone.
  • the location expressed by the position ("<latitude>, <longitude>"). Example: "43.639942,3.837672".
<WLanguage procedure>: Procedure name
Name of the WLanguage procedure ("callback") 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.

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

geoGetAddress(<Description> , <WLanguage procedure> [, <Number of addresses>])
<Description>: Character string
Location whose address must be retrieved. This character string can correspond to:
  • the location specified as city and country. Example: "Paris, France".
    Remark: The location must be specified in the language of the telephone.
  • the location expressed by the position ("<latitude>, <longitude>"). Example: "43.639942,3.837672".
<WLanguage procedure>: Procedure name
Name of the WLanguage procedure ("callback") 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.
Versions 22 and later
Universal Windows 10 App

Required application feature

When this function is used, an application feature is declared in the application generation wizard.
Required feature: Internet and public networks (incoming and outgoing)
New in version 22
Universal Windows 10 App

Required application feature

When this function is used, an application feature is declared in the application generation wizard.
Required feature: Internet and public networks (incoming and outgoing)
Universal Windows 10 App

Required application feature

When this function is used, an application feature is declared in the application generation wizard.
Required feature: Internet and public networks (incoming and outgoing)
Related Examples:
WM Geolocation 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: wd270device.dll
Minimum version required
  • Version 17
This page is also available for…
Comments
Click [Add] to post a comment