geoRunApp (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

geoRunApp (Function)

In french: géoLanceAppli

Starts the native mapping application of the device to display:

a specific geographical position,
an itinerary between two positions.

Versions 18 and later

This function is now available in Android Widget mode.

New in version 18

This function is now available in Android Widget mode.

Example

// Starts the mapping application to display the itinerary
// between the current position of the device and a location
MyPosition is geoPosition = GPSGetPosition()
MyAddress is Address = geoGetAddress("Eiffel Tower, Paris, France")
IF ErrorOccurred = False THEN
geoRunApp(MyPosition, MyAddress..Position)
END

Syntax

Displaying a geographical location Hide the details

<Result> = geoRunApp(<Position> [, <Zoom> [, <Display mode>]])

<Result>: Boolean

True if the application was started,
False otherwise. To find out the error details, use ErrorInfo.

<Position>: geoPosition variable

Name of the geoPosition variable corresponding to the geographical position (latitude and longitude) to display in the mapping application.

<Zoom>: Optional integer

Zoom level that must be applied to the map displayed in the mapping application. This value must be included between 1 (the entire Earth is displayed) and 23. If this parameter is not specified, the maximum zoom will be applied.

<Display mode>: Optional integer constant

Position display mode in the application:
geoMap2D
(default value) The position is displayed on a two-dimensional map.
geoView360 The position is displayed as images with a view at 360°. In this mode, the specified position must correspond to a position listed by the StreetView service of Google.

Displaying an itinerary between two positions Hide the details

<Result> = geoRunApp(<Start position> , <End position>)

<Result>: Boolean

True if the application was started,
False otherwise. To find out the error details, use ErrorInfo.

<Start position>: geoPosition variable

Name of the geoPosition variable corresponding to the geographical position (latitude and longitude) of the start point of the itinerary.

<End position>: geoPosition variable

Name of the geoPosition variable corresponding to the geographical position (latitude and longitude) of the end point of the itinerary.

Syntax available from version 170069

Displaying a marker in the mapping application Hide the details

<Result> = geoRunApp(<Position> , <Marker text>)

<Result>: Boolean

True if the application was started,
False otherwise. To find out the error details, use ErrorInfo.

<Position>: geoPosition variable

Name of the geoPosition variable corresponding to the geographical position (latitude and longitude) of the marker.

<Marker text>: Character string

Text to associate with the marker

Remarks

To retrieve the list of addresses corresponding to the description of a location or to a geographical position, use geoGetAddress.