Quick start

Requirements and Installation

Understanding SD application development

The development cycle

Application look and feel






Cache Management



Online resources


SD Maps Control

Official Content
This documentation is valid for:

The Smart Devices Map (SD Maps) control provides an elegant way for displaying locations using a map and interacting with them.

A location is an attribute or variable based on the Geolocation domain (link).

When you include a location in a grid control, it could be displayed as a map. For example, when you apply Work With for Smart Devices pattern over a transaction with any location attribute, the List node could be showed as a SD Map grid.

Default WorkWithSmartDevices.List object WorkWithSmartDevices.List object using SD Map Control
SD ImageGallery User Control picture1 SD Map User Control picture2


Before using the control

In order the device could be able to show the map (asuming you are generating Android language), you must configure the Smart Devices generator's property Androids Maps API, with the value Google Maps API v2.

After that, you should get a Google Maps Api Key here, and set the obtained value in the Smart Devices generator's property Android Maps API Key. You may get further information about this here.


Using the control

For example, go to the relevant WorkWithDevices<Object> instance, select the List node, select the Grid element in the Layout editor and configure the ControlType grid property with the value SD Maps (being PropertyGeolocation an attribute representing the location of each property -hose or appartment- handled by a real estate). 

SD Maps - grid properties


There are several properties that control the behavior of the Maps control, under Control Info and Appearance sections.

Location Attribute Specifies which Geolocation attribute should the map show for each element.
Initial Zoom

Indicates what is the position where the map must center.

• Default: Show all points.
• Nearest point visible: Shows my location and at least one point near me
• Radius: Enables the Initial Zoom Radius Attribute property.

Initial Zoom Radius Attribute (/ Field Specifier)

Should be a numeric type. Indicates the minimum distance (in meters) that should be visible around the designated center point. The map's zoom level will be adjusted so that at least this distance is visible in all directions.


Indicates what is the position where the map must center.

• Default: center on the point in the center of all points in the view.
• My Location: center the map on my location.
• Custom: enable the Custom Center Attribute to specify the point to be the center.

Map type

Indicates the type of map that will be used in the control.

• Standard: Shows the streets.
• Satellite: Shows satellite images of the earth.
• Hybrid: Shows the streets over the satellite images.

User can choose map type If this property is True, there will be a button on screen allowing the user to choose the type of map in runtime.
Pin Image You can use this property to set an image from the KB to be used as the pin image for all the pins that appear on the map.
If you don't set this property (or the Pin Image Attribute, see below), the default pin image for the platform is used. (*)
Pin Image Attribute Also, you can provide one pin image for each pin, by setting this attribute to the Map control.
If this property is not set or the attribute has an empty value, then the pin image is taken from the Pin Image property (if set) or the default pin for the platform is used. (*)
Show Navigation on Full Screen When the application is executing in Full Screen (iPad only, setting the property Navigation Style property = Flip under Platforms/iPad), the map can hide automatically the navigation controls (navigation bar, toolbar, filters), by setting this property to False. The default value is True.
Show Traffic If this property is True, shows the traffic information. The traffic information is only shown if the maps provider provides that information for the specific region that is shown.
Show My Location If this property is True, shows the current device position.
Pin Show My Location Also, you can provide one pin image for your current position. If this property is not set or the attribute has an empty value, then the pin image is taken from the Pin Image property (if set) or the default pin for the platform is used.
Rows (Grid) If this property is <default>, a limited number of registers will be fetched from the server: 25 registers in iPad, 15 registers in iPhone and 10 in Android.
If this property is <unlimited>, the whole data will be fetched from the server.
If this property is N. The whole data will be fetched but paging the requests using N as "page size" (ie each request will return N or fewer rows).


SD Maps - example


Take a look at the Map in the KB:CowBook.


  • When Show my location property is set to False, or the current location could not be determined,  the behavior will be like Initial Zoom Behavior = Show all points and Center = Default.
  • Android: to use Google Maps in an Android application, you must have an API Key from Google. If not, maps will not show. See HowTo: Get an API Key from Google
  • iOS: The street view isn't supported because the base control doesn't support it. If you need that feature, you should link to Google Maps for example. Reference:
  • For a grid based on SDT, the Center Attribute (when choosing Center = Custom) you can put any attribute or variable, not necessarily one that is in the SDT.
  • (*) From GeneXus X Evolution 2 Upgrade #3, in Android devices, pin images are scaled to have the same size, not depending on the device screen resolution. In spite of every pin image size is allowed, use images with a size of 40x40 is recommended. Some references about this topic can be found here and here.


Start Video Work With for Smart Devices – General Aspects and List layout
Start Video WorkWith for Smart Devices – Detail Layout

Was this page helpful?
What Is This?
Your feedback about this content is important. Let us know what you think.