Geo Tagging Beta
The Geo Tagging captures and returns geographic coordinates when executed. It includes latitude and longitude details, along with accuracy measurements, to provide precise location data. This module is useful for verifying locations, tracking activities, or enhancing location based workflows.
This flow supports both Mobile and Web applications.
Prerequisites
- If Mobile application is configured, make sure to download the ezto verify mobile app before proceeding with the flow,
How to Setup
1 Navigate to Workspace > Workflows, and click on the flow created for Geo Tagging. If you need understanding in creating a workflow, refer to the step-by-step guide here.
2 Hover over the plus (+) symbol and select Workflow. From the list, click Geo Tagging to add it.
3 Click on the newly added workflow, then select the General tab to customize your preferences.
Manage General
(*) Indicates an action to be mandatory.
| Name | Description |
|---|---|
| Display Name* | Set a name to the workflow for easy identification. |
| Description | Summarize the purpose and functionality of this workflow module. |
| Enable | This toggle is enabled by default. When enabled, the particular workflow module begins its execution. Conversely, if disabled, the workflow module remains inactive and won't proceed. |
| Rule | This determines the criteria for triggering the particular workflow module. When the selected rule is evaluated, and is satisfied, the workflow proceeds as provided. If not, the workflow will not be executed. Note: If no rules are set, the workflow defaults to its standard action without any rule. For more information about the rules, refer here. |
4 Then, click on the Configs tab to set the necessary configurations.
Manage Configs
| Name | Description |
|---|---|
| Retry Count | Specify the number of allowed retries (1 to 3). The maximum limit is 3. If left empty, it defaults to 1. |
| Error Codes | For error codes related to Geo Tagging, see here. |
5 After you've configured everything needed, click on SAVE.
6 Proceed to attach the workflow to the relevant application for execution. Refer to the instructions on how to attach a workflow to an application here.
Expected Result
Based on the provided configuration, the information that will be fetched for Geo Tagging includes the following parameters:
| Name | Description |
|---|---|
geo_tagging_verified_at | Timestamp (in Unix epoch format) indicating when the Geo Tagging details were verified. |
geo_tagging_verified | This indicates whether geo tagging verification has been completed. The value will be "True" if the registration is successfully completed and "False" if it is not. |
geo_tagging_accuracy | Accuracy level of the geo-tagging data, typically measured in meters. |
geo_tagging_longitude | Longitude coordinate of the captured location. |
geo_tagging_latitude | Latitude coordinate of the captured location. |
The response received will include the accurate information mentioned above. Note that, the response values can vary depending on the specific workflow modules.
How it Works
The Geo Tagging Verification has two types of verification methods,
Web Application: Verification happens through a web-based process. Any web-supported Verification Way and Result Notification Way can be used.
Mobile Application: Verification is done via the ezto verify mobile app. The Verification Way must be configured as Mobile, and any applicable Result Notification Way can be used.
1 Launch Postman or your preferred API tool and execute the flow by configuring the suitable Method, URL, and Body settings. If you're seeking guidance on how to perform these actions, see here.
2 Upon initiating the API call, a verification request will be sent to your configured Verification Way settings.
3 Based on the request, execute the flow in an incognito browser and follow the prompts to complete the verification process.
- Web
- Mobile
To ensure Geo Tagging works correctly, location access must be enabled for your browser.
- If the location is not enabled, follow the prompted steps to enable location access. The steps provided may differ based on the browser. For instance, Google Chrome is used here.
- Once enabled, click the on Retry button.
- Geo Tagging will begin retrieving location details.
- The verification process will then be completed.
To ensure Geo Tagging works correctly, location access must be enabled for the ezto verify mobile app.
- Begin by scanning the QR code with the ezto verify mobile app.
This depends on what you have configured for the mobile notification way, i.e, QR code or Push integration. To know the difference between QR code or Push, refer here.
- Ensure location access is enabled for the ezto verify mobile app. If not, you will be prompted to enable it for the Geo Tagging process.
Once the location access is provided, Geo Tagging will begin retrieving location details.
The verification process will then be completed.
4 The response can differ depending on the chosen Verification Way and Notification Way configurations. To know more, see here.
5 Here is a sample response for Geo Tagging:
{
"workflow": "verification",
"user_id": "mark@gmail.com",
"request_id": "e892b4c7-b3e2-4f5c-a328-54d1370fa77f",
"geo_tagging_accuracy": "13.713",
"geo_tagging_longitude": "80.24825",
"geo_tagging_latitude": "12.96868",
"geo_tagging_verified_at": "1740995695",
"geo_tagging_verified": "true/false",
}