Control Description

It allows including a map in a Web Form and marking points on it. In addition, it allows setting map display properties such as precision, map type, zoom control, etc. Currently there are three providers Google and Yahoo for any city along the world.

Using the control

Uncompress the zip file to the User control directory of the GeneXus X installation. At design time, the control can be opened from View/Tool Windows/Toolbox. With drag & drop a map is added to the Web Form and a sample is consolidated to mark some points on the map.
For each point a title, text and link can be specified.
To geoposition the map or a point on it, the coordinates (latitude/longitude) are needed. To this end there is a City property with a set of cities and their coordinates or two Latitude Longitude properties (N/E positive number, S/W negative number). These values are in decimal degrees format. In order to convert from degrees, minute and second could you se here


You can see a runtime example from http://samples.genexus.com/mapcontrol/mapcontrol.aspx

Example - GeneXus Code

 &Radisson = new GxMap.Point()
 &Radisson.PointLat = "-34.9056247303566"
 &Radisson.pointLong = "-56.198415756225586"
 &Radisson.PointInfowinTit = 'XIX International GeneXus Meeting'
 &Radisson.PointInfowinDesc = "Radisson Montevideo Victoria Plaza Hotel - September 14-16"
 &Radisson.PointInfowinLink = "http://genexus.com/event/" 
 &Radisson.PointInfowinLinkDsc = "Genexus Site"  
 &Radisson.PointIcon = "Red"   // or http://wiki.gxtechnical.com/commwiki/servlet/apgetwikiimage?6327,1


 &Radisson.PointInfowinImg = http://wiki.gxtechnical.com/commwiki/servlet/apgetwikiimage?6327,1 


 &GxMapdata.Points.Add(&Radisson) 

// when &Radisson is based on GxMap.Pointtype and GxMapdata is based on GxMap type 

Licensing

Google Provider: You have to obtain an access key from http://www.google.com/apis/maps/signup.html with the following terms of use

Yahoo Provider: You have to obtain an access key from http://developer.yahoo.com/maps/simple/index.html with the following terms of use

Implementation

Versions:
6.0 - coming soon ... using V3 implementation of the api 
5.1 - New properties: OpenlinkinNewwindow. 
        Rename property Get readonly to Onclick and include a new value "getvalue & center"
        Fix: when is marked a point , it is possible to use another icon different from the predetermined 
5.0 - Breaking change: Change the name of the control to GoogleMapControl
       New GetCoordenate section include GetIcon Property, Get readonly property and getlatitude/getlongitude (boths are readonly in design time).
4.0 - Access to new api V2 (required for Ruby prototyping ) 
       It is possible to change the icon color:
                   For the entire map using the Icon property of the control 
                   Per each marked point using the PointIcon property of Gxmap.point data type
3.1 - Fix some default values and implement the Access Yahoo Key
3.0 - Include Icon (google Provider). Include Linkdescription and image (google, yahoo)
2.0 - Include Ica Provider - Montevideo Local Map
1.3 - Include a fix for google and Yahoo map
1.2 - Update the control for breaking change of Build 6884
1.0 - google and Yahoo map implementation

You can choose the control provider from the window properties selecting and setting the Provider property. Your selection depends of your needs because each provider offers differents functionalities.

Provider = Google (googlemaps.js)

• City – coordinates (Latitude, Longitude) of the city represented in grades. They are defined in User control/Map/Mapdefinition.xml
• Specific Latitude – the value is represented in grades. N/E positive, S/W negative
• Specific Longitude – the value is represented in grades. N/E positive, S/W negative
• Precision - levels 1 to 16 to indicate the zoom (the higher the number, the closer the zoom)
  

  map.setCenter(new GLatLng(This.Latitude,this.Longitude), This.Precision );  

  Type
• • Map
  • Satellital Image
  • Hybrid
    

     map.setMapType(this.Type); 
    
    

• Access Key – the key is obtained from http://www.google.com/apis/maps/signup.html. The URL for publishing the map has to be specified. It has some restrictions such as the number of accesses per day to the page.
  

• Small - let us pan/zoom the map.
  

  map.addControl(newGSmallMapControl());

   
  SmallZoom

• map.addControl(new GSmallZoomControl());

• Type
  
  

  map.addControl(newGMapTypeControl());

• Overviewype (Only Google)

  map.addControl(new GOverviewMapControl());

• Large-

  map.addControl(new GLargeMapControl());

• Scale-

  map.addControl(new GScaleControl());