The Location Address Of Coordinates action enables the system to retrieve the physical address (street, neighbourhood, district, city, etc.) corresponding to a latitude and longitude value.

It is commonly used in map-based applications to display the exact address information of a point selected by the user.

Technical Features

Reverse Geocoding Process: Converts coordinates to physical addresses.
Dynamic Usage: Latitude and longitude values can be obtained through user interaction (e.g., map selection).
Real-Time Address Retrieval: Returns real-time address information via API.
Location Verification: Enables address verification for processes such as delivery, visits, and services.
Integrated Use: Can be integrated with a map component, user form, or location obtained via GPS.
Web & Mobile Support: Compatible with both web and mobile applications.

Location Address Of Coordinates Action Application Steps

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.

Use Case: Displaying the Address of the Selected Point on the Map

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

Adding an Action to the ‘Get Address’ Button
- Select the button → +ADD ACTION → OnClick → Geolocation → Add the Location Address Of Coordinates action.
Configure the Parameters
- Latitude
- Longitude
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.

Location Address Of Coordinates Action Advanced Customisations

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.