Google Maps Web

Stable Version 2.2.5 (O11)
Also available for 10, 9.1, 9.0
Published on 29 Apr (14 days ago) by 
Stable Version 2.2.5 (O11)
Also available for 10, 9.1, 9.0
Published on 29 Apr (14 days ago) by 
Created on 25 November 2014

Google Maps Web

Documentation

How to use the Google Maps component

After installing the component from the Forge, it's a good idea to obtain a valid Google Maps API Browser Key: it will allow you to track requests and manage your daily access quota. Head on over to their Developer API Console page and log in with your Google account. Once you have created a project, you can access the credentials section and obtain your Browser Key:


This key should then be inserted into the DefaultBrowserAPIKey site property, through Service Center (accessible through the button). Then you should add references to the component. You can do this by clicking, while on the Module that you intend to use it with, and ticking the checkboxes of what you want to use.




Now you are ready to start using the component. First, what you came here for: Maps. You can add a map to a Web Screen by using the Map Web Block, filling in the relevant options. By specifying a Name, you can then reference this map to associate other objects, so fill it in if you intend to. If you're wondering what MapOptions are for, you can scroll to the end of this page for an explanation.

Once you have a map on the Web Screen and its name set, you can use the other widgets to add objects: Markers, Directions or Events. As previously stated, they need a Map Id to refer to it, which you can see below as 'SimpleMap.Id'. Events are special, in that they bind functionality to existing markers or maps. This functionality is described on the Handler JavaScript function you provide on the Web Block, which will be executed when the specified 'Triggering Event' is fired.



All of these objects (except Events) can be customized through JSON objects on their arguments, according to options available to them. Additionally, you can customize the libraries included with your Maps through the APILibraries site property. Check out the Google Maps JavaScript API v3, under the reference for Map Options, Marker Options and DirectionsRequest, for the customizations available to each of them.



Support Options
This component is not supported by OutSystems. You may use the discussion forums to leave suggestions or obtain best-effort support from the community, including from Labs who created this component.
Dependencies
Google Maps Web has no dependencies.