1. Log in to the Kuika platform.
2. Open the project you will work on from the Apps screen.

3. 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.

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: Determines how the map will be positioned when it opens.
  
  • True: The map automatically centers itself to cover all locations in the data source and determines the appropriate zoom level itself.
  • (It positions itself to include all markers.
  • False: The map does not perform any automatic centering. The opening position is set according to the values specified in the Latitude and Longitude fields. If these fields are empty, the map opens at the default starting position.
  • When Auto Center = True, the Latitude and Longitude values are not used.
• 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.
• HideTransitLayer: Controls whether public transportation routes (train, subway, tram, etc.) are displayed on the map. The default value is false.
• HideTrafficLayer: Controls whether the traffic density layer (road occupancy status) is displayed on the map. The default value is false.

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:

1. Right-click on the desired location on the map.
2. Copy the coordinates from the context menu.
3. 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.

Authorization

To manage access control at the element level, you can use the Authorization section in the Properties panel.

Access Types

Anonymous

Allows all users to view the element without logging in.

Restricted

Restricts access to only verified users or specific roles.

• Everyone: When enabled, all logged-in users can access the element.
• Roles: The roles allowed to access the element are selected here. To edit the role list, click the gear (⚙️) icon next to the Roles field to open the Role Management window. From this window, you can add new roles, create folders, or manage existing roles.

Unauthorized Behavior (Hide / Disable)

If the user does not have the required role, you can specify how the element should behave in the Choose field:

• Hide: If the user is not authorized, the element is completely hidden and does not appear on the screen.
• Disable: The element remains visible but becomes unclickable / unusable.

This setting is used to manage how unauthorized users encounter the element.

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:

1. Select the element on the screen.
2. Open the Properties panel on the right edge.
3. 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.