1. Define the Action in UI Design

• Log in to the Kuika platform.
• Open the project you will be working on from the Apps screen.
• Go to the UI Design module.

• Open the Properties panel on the right side.
• Select the element (e.g. a button) for which you want to run the action.
• Follow these steps from the + ADD ACTION menu:
  
  • Initial Actions → Geolocation → Location Address Of Coordinates

2. Configure Action Parameters

• Latitude (Decimal - required): The latitude (horizontal) coordinate value of the point where the address conversion will be performed. For example, it can be selected with a Symbol Picker such as mapCoordinates.latitude.
• Longitude (Decimal - required): The longitude (vertical) coordinate value of the point where the address conversion will be performed.

When a user clicks on a point on the map, the physical address corresponding to those coordinates should be retrieved by the system and displayed in a Text field.

Application Flow:

• Go to the UI Design module.
• Drag and drop the following elements from the Elements panel:
  
  • Map → Allows the user to select a location by clicking.
  • Label → The area where the address information will be displayed. (labelAddress)
  • Button → Button that starts the ‘Get Address’ process.

Action Flow and Configuration

1. Adding an Action to the ‘Get Address’ Button
   
   • Select the button → +ADD ACTION → OnClick → Geolocation → Add the Location Address Of Coordinates action.
2. Configure the Parameters
   
   • Latitude
   • Longitude
3. Display Result (with Set Value action)
   
   • Immediately after, as a second action:
   • Set Value →
     
     • Target
     • Value‍

When the user clicks on any point on the map and then presses the ‘Get Address’ button:

• The coordinates of the point clicked on the map are obtained.
• These coordinates are converted to a physical address with the Location Address Of Coordinates action.
• The resulting address information is displayed to the user via the relevant label element in the application interface.

• Integrated Use with Map: Use with the map component to get the coordinates from the location marked by the user on the map.
• Automatic Address Update: Use the OnChange or OnMapClick event to automatically trigger the action whenever the user changes a point on the map.
• Form Integration: Address information can be automatically filled in a form (e.g., delivery address).
• GPS Usage: The Get Current Location + Location Address Of Coordinates combination can be used to obtain the user's current location via GPS and retrieve the address of that location.

Technical Risks and Controls

• Invalid Coordinates: If invalid latitude-longitude values (e.g., 0,0) are sent, an empty result may be returned.
• Internet Connection Requirement: An internet connection is required since the operation is performed via an API.
• Response Time: Reverse geocoding may cause delays depending on the API. A loader display is recommended.

The Location Address Of Coordinates action allows you to convert the user's location data into meaningful address information. It is ideal for map-based operations, delivery and visit systems, or location verification in user forms. It greatly improves the user experience with its dynamic and real-time address retrieval feature.