The Location Coordinates Of Address action is used to convert address information into geographical coordinates (latitude and longitude). This process is called ‘geocoding’ and enables location-based applications to work with address information.

Technical Specifications

Geocoding Process: Converts address information into latitude and longitude information.
Address-Based Location Detection: The location of the address entered by the user on the map can be determined.
Delivery and Navigation Scenarios: Ideal for checking the accuracy of addresses in map, route, and delivery systems.
Dynamic Data Usage: Can work based on address values received from the user.
Web & Mobile Compatibility: Compatible with web and mobile applications.

Location Coordinates Of Address 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) where you want to run the action.
- +ADD ACTION → Initial Actions → Geolocation → Location Coordinates Of Address.

2. Configure Action Parameters

Address (String - required): Address information for which latitude and longitude conversion will be performed.

Use Case: Obtaining Map Coordinates from Address Information

When a user enters their address on the form and clicks the ‘Get Location’ button, the system should calculate and display the latitude and longitude coordinates of that address on the map.

Application Flow

Go to the UI Design module.
Drag and drop the following elements from the Elements panel:
- Text Input → Field where the user will enter their address
- Label → Field where the latitude information will be displayed
- Label → Field where the longitude information will be displayed
- Button → Button that starts the ‘Get Location’ process

Action Flow and Configuration

Add Action to ‘Get Location’ Button
- Select the button → +ADD ACTION → OnClick → Geolocation → Location Coordinates Of Address
- Configure Parameter
- Address
Display Coordinate Information
- Immediately after, as the second and third actions:
  - Set Value
    - Target
    - Value
  - Set Value
    - Target
    - Value

Location Coordinates Of Address Action Advanced Customisations

Marking on the Map: The latitude and longitude information obtained can be linked to a Map component to display a point on the map.
Automatic Location Retrieval: Coordinates can be automatically retrieved with the OnChange trigger as the address field is updated.
Combination with GPS: Can be used in conjunction with Get Current Location to compare the user's location with the manually entered address.
Form Validation: If the address field is empty, a warning can be displayed to the user before the action is initiated.

Technical Risks and Controls

Invalid Address Format: Coordinates may not be returned for incomplete or incorrect addresses. In this case, the user should be informed.
API Delays: The response time may vary depending on the internet connection or service. The use of a loader is recommended.
Internet Requirement: An internet connection is required as it is API-based.
Response Errors: Control mechanisms should be added for null or error values returned by the action.

The Location Coordinates Of Address action systematically converts address information received from the user into coordinates, forming the basis for all map and location-based scenarios. It can be used effectively in many areas, from delivery systems to field operations, and is a powerful tool for enhancing the user experience.