Kuika's Maps element visually presents geographic data in your application. Users can view locations on the map, zoom in and inspect specific areas. The Maps element is ideal for indicating store locations, plotting routes or offering location-based services. In this course, you will learn how to use the Maps element and configure its settings.
This training content consists of the following topics:
Add Maps Element
Maps Element Properties
Element settings and customization
Add Maps Element
Log in to the Kuika platform.
Open the project you will work on from the Apps screen.
In the UI Design module, drag and drop the Maps element under the Special category from the Elements panel on the left edge to the workspace.
Maps Element Properties
General Settings
Datasource: Defines the data source for the locations to be displayed on the map. Sources like REST API and SQL Actions are supported.
Latitude: The latitude the map will focus on at initial load. Can be assigned statically (e.g., 38.4237) or dynamically.
Longitude: The longitude the map will focus on at initial load. Can be defined statically or dynamically.
Circle Radius In Km: Highlights a specific area on the map with a circular boundary defined by a radius in kilometers.
Auto Center: Automatically centers the map on the specified location every time it loads.
Keep Center On Zoom: Keeps the map center fixed during zoom in/out operations.
Appearance & Icon Settings
Group Picker Icon: Groups nearby locations under a single cluster icon at low zoom levels.
Group Picker Color: Sets the background color of the grouped location icons.
Current Location Icon: Defines the icon that represents the user's current location.
Current Location Color: Allows setting the color of the current location icon.
Selected Location Icon: The icon used to display the location selected (clicked) by the user.
Marker Popup Width: Sets the width (in pixels) of the info popup that appears when a marker is clicked.
Map Type
Map Type: Specifies the general visual style of the map.
Roadmap: Standard road map.
Terrain: Topographic map showing elevation and land features.
Satellite: Displays real-world satellite imagery.
Hybrid: Combines satellite view with road and city labels.
Latitude and Longitude values must be in Decimal format (e.g., 38.4237, 27.1428).
The map still loads and displays available locations even if the Latitude and Longitude values are null.
Location Retrieval Tip
To obtain latitude and longitude values from Google Maps:
Right-click on the desired location on the map.
Copy the coordinates from the context menu.
Paste the values into the Latitude and Longitude fields of the Maps element.
Events
On Location Click: Triggered when the user clicks a location on the map.
On Map Load: Triggered when the map is fully loaded.
On Zoom Change: Triggered when the user zooms in or out on the map.
Element Settings and Customization
Authorization
Anonymous Access: Allows users to access without entering account information.
All Roles Access: Provides access by verifying users' account information.
For element-level authorization, edit Authorization settings in the Properties panel.
Visibility
Always Visible: Element is always visible.
Hidden: Element is hidden.
Sometimes Visible: The element is visible depending on a specific condition.
To configure the setting:
Select the element on the screen.
Open the Properties panel on the right edge.
In the Visibility field, select an option according to your needs.
Editability
Enabled: Elements can be edited.
Disabled: Element cannot be edited.
Sometimes Enabled: The element can be edited or uneditable according to certain conditions.
Interface Design with Style Panel
By customizing your elements with the Styling Panel, you can create impressive interfaces for your web and mobile applications. In this section, you can configure the following settings:
Layout: Sizing, alignment and padding settings. Settings include Size, Min Size and Align.
Text: Font, style, color, size and spacing settings.
Fill: Customize the background with color or images.
Border: Add borders and corner radius settings.
Shadow: Add a shadow effect to add depth to elements.
By following these steps, you can configure the Area Chart element to suit your needs.
Actions
Kuika supports the following system actions:
Arithmetic, Authorization, Condition, Device, Export, Geolocation, Inversion, Local Storage, Multi Language, Navigation, Notification, Payment, UI Control, Process Administration, Process Automation, Trigger, Process Automation, Process Administration and String Operations.
You can also use SQL actions that you create yourself.
You can use the +ADD ACTION button from the Properties panel to add an action.
Actions support may not be available in some elements.
