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

Datasource: Determines the data source of the locations to be shown on the map. Sources such as REST API and SQL Actions are supported.
Latitude: The latitude value that the map will focus on at the first launch. It can be assigned statically or dynamically.
Longitude: The longitude value that the map will focus on at first opening.
Circle Radius In Km: Highlights a specific area on the map within a circular boundary.
Auto Center: Centers on a specific location each time the map is opened.
Group Picker Icon: Allows nearby locations to be grouped under a single icon during zoom-out.
Current Location Icon: Shows the user's current location.
Selected Location Icon: Marks the user's selected location.
Keep Center On Zoom: The map center remains fixed during zooming.
Map Type: Determines the view style of the map. The supported map types are:
- Roadmap: This is the standard road map. Highways, streets and city details are clearly shown.
- Terrain: A map type that shows elevation differences and natural terrain features. Mountains, hills and valleys become clear.
- Satellite: Shows the map with real-world visuals using satellite imagery. Buildings, nature areas and water sources are clearly visible.
- Hybrid : A map mode that combines satellite imagery with road and settlement information. Satellite imagery is overlaid with road and city names for a more comprehensive view.

Latitude and Longitude values must be in “Decimal” format.

The Maps element opens the map screen and displays other locations even when latitude and longitude values are Null (empty).

Getting Location

To get the latitude and longitude values of a location on Google Maps, you can right click on the map and copy the coordinates from the menu that appears. Add these values to the Latitude and Longitude fields of the Maps element.

Events

On Location Click: Triggered when the user clicks on a location on the map.
On Map Load: Fires when the map is loaded.
On Zoom Change: Fires when the user zooms in or out.

The Maps element dynamically displays information from different data sources on the map. This allows your app to provide location-based services in a more user-friendly and interactive way.

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.