PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
  • Overview of Map control
  • Creating a Map control
  • Popup for displaying markers
  • Displaying and handling maps
  • Displaying the maps
  • Maps handled by the user
  • Specific features
  • Modifying the permissions
  • Map control and Google license
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
Overview of Map control
Versions 18 and later
iPhone/iPad The Map control is now available for iPhone/iPad applications.
New in version 18
iPhone/iPad The Map control is now available for iPhone/iPad applications.
iPhone/iPad The Map control is now available for iPhone/iPad applications.
Versions 21 and later
Universal Windows 10 App The Map control is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App The Map control is now available in Universal Windows 10 App mode.
Universal Windows 10 App 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:
  • Android the Google Maps service for Android applications.
    Caution: The use of the Map control is subject to specific terms and conditions. For more details, see Conditions for using the Map control. Check the Google license before deploying your applications.
  • Versions 18 and later
    iPhone/iPad 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
    iPhone/iPad 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.
    iPhone/iPad 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 21 and later
    Universal Windows 10 App 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
    Universal Windows 10 App 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.
    Universal Windows 10 App 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 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:
  1. On the "Creation" pane, in the "Graphic controls" group, click "Map".
  2. Click where the control will be created in the window or page.
To view the control characteristics, select "Description" in the popup menu of the control.
The "General" tab allows you to define:
  • the display mode: map or satellite,
  • Versions 26 and later
    whether traffic information is shown or hidden.
    New in version 26
    whether traffic information is shown or hidden.
    whether traffic information is shown or hidden.
  • Universal Windows 10 AppAndroid whether the zoom buttons must be displayed (or not) in the control,
  • AndroidiPhone/iPad how the compass is displayed.
The "Details" tab is used to define:
  • AndroidiPhone/iPad gesture options:
    • AndroidiPhone/iPad Enable zoom.
    • AndroidiPhone/iPad Allow rotation.
    • AndroidiPhone/iPad Allow scrolling.
    • AndroidiPhone/iPad Allow tilt.
  • the image used for the POI markers.
    Android These markers can be displayed with or without a shadow.
  • Versions 26 and later
    WINDEV Mobile the popup displayed by default when a marker is clicked on. This popup can correspond to:
    • None: the default popup will be used.
    • Preset window: In this case, an internal window is automatically integrated into your project..
    • an internal window of your application.
    New in version 26
    WINDEV Mobile the popup displayed by default when a marker is clicked on. This popup can correspond to:
    • None: the default popup will be used.
    • Preset window: In this case, an internal window is automatically integrated into your project..
    • an internal window of your application.
    WINDEV Mobile the popup displayed by default when a marker is clicked on. This popup can correspond to:
    • None: the default popup will be used.
    • Preset window: In this case, an internal window is automatically integrated into your project..
    • an internal window of your application.
  • Universal Windows 10 AppAndroidiPhone/iPad remember the last position displayed.
Remarks:
  • AndroidiPhone/iPad A single Map control can be used in a window. Several Map controls cannot be used in the same window.
  • AndroidiPhone/iPad geoRunApp is used to start the device's native maps application.
Versions 26 and later

Popup for displaying markers

Depending on the platform, when a preset window or page is used to manage marker popups, the following elements are included:
  • WINDEV Mobile FI_WinDevPopupMarqueur_WM (internal window in the WDFAA component).
These elements contain:
  • two controls used to display the name and description of the marker.
  • a declaration code to handle the current Marker variable.
New in version 26

Popup for displaying markers

Depending on the platform, when a preset window or page is used to manage marker popups, the following elements are included:
  • WINDEV Mobile FI_WinDevPopupMarqueur_WM (internal window in the WDFAA component).
These elements contain:
  • two controls used to display the name and description of the marker.
  • a declaration code to handle the current Marker variable.

Popup for displaying markers

Depending on the platform, when a preset window or page is used to manage marker popups, the following elements are included:
  • WINDEV Mobile FI_WinDevPopupMarqueur_WM (internal window in the WDFAA component).
These elements contain:
  • two controls used to display the name and description of the marker.
  • a declaration code to handle the current Marker variable.
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.
Universal Windows 10 AppAndroidiPhone/iPad You can display the last position: simply select "Remember last position displayed" in the "Details" 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:
  • Universal Windows 10 AppAndroidiPhone/iPad by scrolling the map with one or more fingers.
  • Universal Windows 10 AppAndroid via the control positioning buttons (if "Show zoom buttons" has been selected in the "General" tab of the control description window).
The user can zoom in or out:
  • Universal Windows 10 AppAndroid by using the zoom buttons of the control (if the option has been selected in the "General" tab of the control description window).
  • Universal Windows 10 AppAndroidiPhone/iPad by performing a "scale" or "pinch" gesture: spreading two fingers apart on the screen allows zooming in, and pinching them together allows zooming out.
  • Universal Windows 10 AppAndroid 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 programming with Zoom.
Versions 26 and later
AndroidiPhone/iPad If "Enable zoom" is disabled (in the "Details" tab of the control description or WithZoom property), the user will not be able to zoom in or out.
New in version 26
AndroidiPhone/iPad If "Enable zoom" is disabled (in the "Details" tab of the control description or WithZoom property), the user will not be able to zoom in or out.
AndroidiPhone/iPad If "Enable zoom" is disabled (in the "Details" tab of the control description or WithZoom property), the user will not be able to zoom in or out.
AndroidiPhone/iPad Remark: Optional events specific to the Map control can also be used. See Events associated with the Map control for more details.
Specific features
Android

Modifying the permissions

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

Map control and Google license

Android 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:
  1. 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.
  2. 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.
Related Examples:
The Map control 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.
The Map control 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.
The GglGetStaticMap function Unit examples (WINDEV): The GglGetStaticMap function
[ + ] Using gglGetMap to display a Google map in an Image control.
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.
WM Sports 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.
Minimum version required
  • Version 17
This page is also available for…
Comments
Click [Add] to post a comment