The Map User Control allows including a map in a Web Form and marking points on it.
When dragging it from the Toolbox to a Web Form, a sample is imported to mark some points on the map. As a result, variables and events are automatically defined. In addition, properties are set in those events and you can replace the default values.
The control is distributed by GeneXus, however, it is possible to download and install a newer version. In order to do this, download the control from here and uncompress the zip file to the User control directory of the GeneXus installation.
Currently, there are three providers: Google, Baidu, and Yahoo for any city in the world.
As previously described, you have to drag and drop the Map User Control from the Toolbox to the Web form. Then, a sample is imported, marking some points on the map. For each point, a title, text, and link can be specified.
To geoposition the map or to position a point on it, the coordinates (latitude/longitude) are needed. To this end, you can set the Latitude property and Longitude property (N/E positive number, S/W negative number). These values are in decimal degrees format. In addition, you can configure the Map User Control City property.
To draw a point on a Map, you just have to program something like:
&BusStation = new GxMap.Point()
&BusStation.PointLat = "-34.9056247303566"
&BusStation.pointLong = "-56.198415756225586"
&BusStation.PointInfowinTit ='!"Tres Cruces"
&BusStation.PointInfowinDesc = !"Terminal Tres Cruces"
&BusStation.PointInfowinLink = !"https://www.trescruces.com.uy/terminal/"
&Image.fromImage(BusStation)
&BusStation.PontIcon = &Image.ImageUri
&GxMapdata.Points.Add(&Radisson)
At runtime, it is displayed as:
To see more details on how to program the most common use cases, go to Map User Control Use Cases.
See the list of properties available to set for a Map User Control in: Map User Control Properties.
Google Provider: https://developers.google.com/maps/pricing-and-plans/
Since 22 June 2016, an ApiKey is required http://googlegeodevelopers.blogspot.com.uy/2016/06/building-for-scale-updates-to-google.html
In order to get an API key, go to https://developers.google.com/maps/web/ with the following terms of use,
Since June 2018 you must include an API key with all API requests and you must enable billing on each of your projects.
https://developers.google.com/maps/documentation/javascript/usage-and-billing
Yahoo Provider: The component was discontinued by the provider.
Breaking change: To configure a Google Maps API key after the Google policy changes of 22 June 2016, please download version 8.1 or higher from here or the marketplace.
Please visit: Default Installation Instructions for User Controls.