1. Define the Action in UI Design

• Open your project on the Kuika platform.
• Go to the UI Design module and select the screen where you want to add the location link.
• Create a button such as ‘View Location’.

• Select the button and follow this path from the + ADD ACTION menu according to the triggering event (Initial Actions, OnClick, OnBlur, etc.): Device → Open In Map

2. Configure Action Parameters

• Latitude: The latitude value of the location to be displayed on the map (e.g., 38.4237)
• Longitude: The longitude value (e.g., 27.1428)
• Pin Title: The title to be given to the marker on the map (e.g., ‘Kuika Office’)
• Draw Route: Enable this option if you want to draw a route from the user's location (true/false)‍
• Stops (Optional): Intermediate stops along the route. These can be defined as a list of additional latitude and longitude values between the start and end points.

In a shopping app, when the user clicks the ‘See Store’ button, the map application on their device opens and shows the location of the store.

Adding Open In Map Action

Enter the UI Design module and add a Button element.

1. Select the button and add the Open In Map action from the + ADD ACTION menu: OnClick → Device → Open In Map.

Specifying Action Parameters

• Latitude: 40.9910
• Longitude: 29.1234
• Pin Title: ‘Head Office’
• Draw Route: false

With this configuration, when the user clicks the button, the map application opens and the specified location is displayed.

• Enable Route Drawing: Draw Route can be set to true to draw a route from the user's current location to the destination.
• Multiple Stops: Additional stops can be defined along the journey. For example:
  
  • Stop 1: Hotel
  • Stop 2: Restaurant
  • Stop 3: Event venue
• Dynamic Location Usage: The latitude and longitude can be dynamically determined based on the location selected by the user:

Technical Risks

• Invalid Coordinates: If latitude or longitude is missing or incorrect, the map may not load.
• Application Support: If the user does not have a map application installed on their device, the action may fail.
• If the Stops Parameter is Defined in an Invalid Format: If multiple stops are defined in an incorrect format, the route cannot be created.

The Open In Map action is an ideal solution for displaying location-based content directly on a map in Kuika applications, enhancing the user experience and providing simple directions. It is a powerful tool for field operations, event navigation, and user support scenarios.