The Map control

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Help

Editors

Controls (window/page/report)

Controls

Map control

The Map control

Overview of Map control

Displaying and handling maps

Specific features

Related examples

See also

The Map control

Overview of Map control

Versions 18 and later

The Map control is now available for iPhone/iPad applications.

New in version 18

The Map control is now available for iPhone/iPad applications.

Versions 20 and later

The Map control is now available for WINDEV applications in Windows.

The Map control is now available for WEBDEV sites in Windows and Linux.

The Map control is now available for WEBDEV sites in PHP.

New in version 20

The Map control is now available for WINDEV applications in Windows.

The Map control is now available for WEBDEV sites in Windows and Linux.

The Map control is now available for WEBDEV sites in PHP.

The Map control is now available for WINDEV applications in Windows.

The Map control is now available for WEBDEV sites in Windows and Linux.

The Map control is now available for WEBDEV sites in PHP.

Versions 21 and later

The Map control is now available in Universal Windows 10 App mode.

New in version 21

The Map control is now available in Universal Windows 10 App mode.

The Map control allows you to display a map in order to geolocate, display points of interest (POI) and more, ...

This map comes from:

the Google Maps service for Android applications.
Caution: The use of the Map control is subject to specific terms and conditions. See Conditions for using the Map control for more details. Check the Google license before deploying your applications.
Versions 18 and later
Apple's geolocation service for iPhone/iPad applications from iOS 6.
Remarks:
- The Google Maps service is used for iPhone/iPad applications in iOS 5.
- You must comply with the service license.
New in version 18
Apple's geolocation service for iPhone/iPad applications from iOS 6.
Remarks:
- The Google Maps service is used for iPhone/iPad applications in iOS 5.
- You must comply with the service license.
Apple's geolocation service for iPhone/iPad applications from iOS 6.
Remarks:
- The Google Maps service is used for iPhone/iPad applications in iOS 5.
- You must comply with the service license.
Versions 20 and later
the Google Maps service for Web sites via the Google Maps API.
The use of the Map control is subject to specific terms and conditions. Depending on the use mode, you may have to use a Google key (MapLicenseGgl). Check the Google license before deploying your applications.
New in version 20
the Google Maps service for Web sites via the Google Maps API.
The use of the Map control is subject to specific terms and conditions. Depending on the use mode, you may have to use a Google key (MapLicenseGgl). Check the Google license before deploying your applications.
the Google Maps service for Web sites via the Google Maps API.
The use of the Map control is subject to specific terms and conditions. Depending on the use mode, you may have to use a Google key (MapLicenseGgl). Check the Google license before deploying your applications.
Versions 21 and later
the Bing Maps service for applications in Universal Windows 10 App mode.
Caution:
- The use of the Map control is subject to specific terms and conditions. A Bing key must be used (MapLicenseBing). Check the Bing license before deploying your applications.
- Using an address specified with a string in a Map control may return inconsistent results. It is recommended to specify an address via an Address or a geoPosition variable.
New in version 21
the Bing Maps service for applications in Universal Windows 10 App mode.
Caution:
- The use of the Map control is subject to specific terms and conditions. A Bing key must be used (MapLicenseBing). Check the Bing license before deploying your applications.
- Using an address specified with a string in a Map control may return inconsistent results. It is recommended to specify an address via an Address or a geoPosition variable.
the Bing Maps service for applications in Universal Windows 10 App mode.
Caution:
- The use of the Map control is subject to specific terms and conditions. A Bing key must be used (MapLicenseBing). Check the Bing license before deploying your applications.
- Using an address specified with a string in a Map control may return inconsistent results. It is recommended to specify an address via an Address or a geoPosition variable.

Caution: Evolutions of Google license
Google Maps terms of service changed on June 22, 2016. From now on, a license key must necessarily be specified to use this service. You must:

Generate the key in the Google developer console (https://console.developers.google.com). The operations to perform are as follows (valid at the date this page was written):
- Use a Google account to connect to the developer console.
- Create a project if necessary.
- Click "Enable APIs and services".
- Click "Maps JavaScript API".
- Click "Enable" to enable the Google Maps JavaScript API.
- Click "Credentials". Then, click the link "Credentials in APIs & Services".
- Click "Create credentials".
- Select "API key".
- Validate the key creation and copy the key created by Google.
Specify the key used in the application or in the site with MapLicenseGgl.

Google Maps terms of service changed on June 11, 2018. The license key for using this service now requires a payment.

The map displayed is interactive: you have the ability to zoom, move, ... It can be displayed in map view or satellite view.

Creating a Map control

To create a Map control:

On the "Creation" pane, in the "Graphic controls" group, click "Map".
Click where the control will be created in the window or page.

To view the control characteristics, select "Description" in the control popup menu. The main options of the control can be defined in the "General" tab:

the display mode: map or satellite,
whether the zoom buttons must be displayed (or not) in the control,
scaling by double tap,
scaling by double click,
remember the last position displayed.
the image used for the POI markers.
These markers can be displayed with or without a shadow.

Remarks:

Only one Map control can be used per window or page. You cannot have several Map controls in the same window or page.
The Map control cannot be used in automated tests.
geoRunApp is used to start the device's map application.

Displaying and handling maps

Displaying the maps

When the window containing a Map control is opened, a world map is automatically displayed: the map is centered on Europe, with medium zoom level.

You can display the last position: simply check "Remember last position displayed" in the "General" tab of the Map control description window. In this case, the last position is displayed with the same zoom level.

Maps handled by the user

The user can move on the map:

by scrolling the map with one or more fingers.
by scrolling the map using the mouse.
via the control positioning buttons (if the "Display the zoom buttons" option has been selected in the "General" tab of the control description window).

The user can zoom in or out:

by performing a "scale" or "pinch" gesture: spreading two fingers apart on the screen allows zooming in, and pinching them together allows zooming out.
by using the zoom buttons of the control (if the option has been selected in the "General" tab of the control description window).
by double-tapping the map to zoom in one level on a position (if this option has been checked in the "General" tab of the control description window).
by double-clicking the map to zoom one level on a position (if this option has been checked in the "General" tab of the control description window).
by programming with ..Zoom.

Remark: Optional events specific to the Map control can also be used. See Events associated with the Map control for more details.

To find out all the operations available at runtime, see Map control: Automatic Application Features (AAF).

Specific features

Internet Explorer: Required versions

In a WINDEV application, the Map control uses Internet Explorer's ActiveX on the client computer. To use the Map control in the application, the client computer must have Internet Explorer 10 or 11.

To view a Map control in a WEBDEV site, the Web user must use:

Internet Explorer 10 or 11.
Another browser (Chrome, Firefox, etc.).

Modifying the permissions

Using a Map control automatically adds the INTERNET permission to the list of permissions required by the application.

Related Examples:

Unit examples (WEBDEV): The Map control

[ + ] This example explains how to use the Map control of WEBDEV.
It can be used to display a map that includes markers as well as an itinerary.

Unit examples (WINDEV): The Map control

[ + ] Using the Map control of WINDEV.
It is used to display a map that includes markers as well as an itinerary.

Unit examples (WINDEV): The GglGetStaticMap function

[ + ] Using gglGetMap to display a Google map in an Image control.

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.

Cross-platform examples (WINDEV Mobile): WM Sports

[ + ] This example is a sport application used to save your performances.
The application calculates the distance, the time, the average speed and the number of calories spent according to the sport.
The run is displayed on a map control via markers and an itinerary.

The example also includes a server part used to synchronize the user data.
This webservice is available in the WEBDEV "WW_Sports" example.