MapLicenseGgl (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Controls, pages and windows / Map functions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

MapLicenseGgl (Function)

In french: CarteLicenceGgl

Indicates the "Google Maps API" license key that will be used in the Map controls (of WINDEV or WEBDEV). This key may be required to use the "Google Maps API for work" features. For more details, see the "Google Maps API" license.

You also have the ability to enter the "Google Maps API" license in the description window of project ("Project" tab).

Important When calling the function MapLicenseGgl FUNCTION must be made before the Map control window is opened. If the Map control is found in the first project window, the call to MapLicenseGgl must be performed in the project initialization code.

In test mode, the Map control uses the Map control of WINDEV. This function is used to specify (if necessary) the "Google Maps API" license key in order for the Map control to be displayed properly during a GO on the development computer.

Example

// Initialize the Google key
MapLicenseGgl("ABCDEF12345789abcdef")

Syntax

MapLicenseGgl(<Google key>)

<Google key>: Character string or Secret string

Key supplied by Google.
New in version 2025
Secret strings: If you use the secret string vault, the type of secret string used for this parameter must be "Ansi or Unicode string".
To learn more about secret strings and how to use the vault, see Secret string vault.
Secret strings are not available for this parameter in Android/Android widget applications.

Remarks

The use of the Map control is subject to specific terms and conditions. Check the Google license regarding the use of mapping services.

Please note: As of June 22, 2016, the terms of use for Google's mapping services have changed. 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 Google project if necessary.
- Access the "API manager" of the project.
- In the "Google Maps API" item, click the "Google Maps JavaScript API" link.
- Click "Enable" to enable the Google Maps JavaScript API.
- In the "Identifiers" item, expand the "Create identifiers" button.
- Select "API key".
- Select "API key".
  - For a WEBDEV website, select "Browser key". It is recommended to specify the domain that will use the key in order to monitor queries and avoid any fraud.
  - For a WINDEV application, select "Server key". It is recommended to specify the address that will use the key in order to monitor queries and avoid any fraud.
- Validate the key creation and copy the key created by Google.
Specify the key used in the application or site with MapLicenseGgl.

This function allows you to specify the license to use in order for the provider of Google Maps to give the application:
- from June 22 2016, access to the "Google Maps JavaScript API" features.
- access to the extended features of "Maps API for work" (greater number of queries, monitoring, quota, ...).
The license is applied to all the maps of the application and it will be used for all the new Map controls created after this call. We advise you to call this function in the project initialization code.

Business / UI classification: UI Code

Component: wd300obj.dll