Enhancements to Zoho Map integration tasks

Enhancements to Zoho Map integration tasks

Hello everyone,

We're excited to announce enhancements to the Zoho Map integration tasks in Deluge, which will boost its performance. This post will walk you through the upcoming changes, explain why we're making them, and detail the steps you need to take.

What's this change about?
We're rolling out a new, high-performance backend update for Zoho Map. This change will affect all three Zoho Map integration tasks (Geocode, Reverse Geocode, and Distance Between).
The update brings several key benefits, like:
  1. Improved response times
  2. Better structure response
  3. More detailed and contextual information
  4. Future scalability 
What's changing?  
As a result of this update, the response format for Geocode and Reverse Geocode Map tasks will change. We're moving from a simple response to a more structured, JSON-like response as shown below.

For zoho.map.GeoCode()
Current format:
  1. {
  2.   "latitude": "37.68612315",
  3.   "longitude": "-121.89374181126261",
  4.   "status": "success"
  5. }

New format:

  1. {
  2.   "country": "United States of America",
  3.   "country_code": "us",
  4.   "address_line2": "Pleasanton",
  5.   "address_line1": "4141, Hacienda Drive",
  6.   "city": "Pleasanton",
  7.   "street": "Hacienda Drive",
  8.   "lon": "-121.89374",
  9.   "state": "California",
  10.   "label": "Zoho Corporation, 4141, Hacienda Drive, Hacienda, Pleasanton, Alameda County, California, 94588, United States",
  11.   "postal_code": "94588",
  12.   "lat": "37.68612",
  13.   "status": "success" 
  14. }

For zoho.map.rGeoCode()
Current format:

  1. {
  2.   "country": "India",
  3.   "country_code": "in",
  4.   "address": "Bucket Building, Grand Southern Trunk Road, Guduvancheri, Tamil Nadu, 603202, India",
  5.   "road": "Grand Southern Trunk Road",
  6.   "ISO3166-2-lvl4": "IN-TN",
  7.   "postcode": "603202",
  8.   "state": "Tamil Nadu",
  9.   "village": "Guduvancheri",
  10.   "building": "Bucket Building",
  11.   "status": "success"
  12. }

New format:

  1. {
  2.    "country": "India",
  3.    "country_code": "in",
  4.    "address_line2": "Guduvancheri",
  5.    "address_line1": "Grand Southern Trunk Road, Bucket Building",
  6.    "city": "Guduvancheri",
  7.    "street": "Grand Southern Trunk Road",
  8.    "state": "Tamil Nadu",
  9.    "label": "Bucket Building, Grand Southern Trunk Road, Guduvancheri, Tamil Nadu, 603202, India",
  10.    "postal_code": "603202",
  11.    "status": "success"
  12.   }
For zoho.map.getDistance(): The response format for this task will not change. The update only changes the methodology used to provide more accurate real-world distance calculations. Specifically, this involves a move from the spherical law of cosines to the haversine formula, which is the standard for modern GPS apps.

What should you do?
To prevent any disruption to your applications, you'll need to update your Deluge scripts that use these map tasks. To help you identify where these tasks are being used, we'll automatically add a v1 identifier in your existing scripts (e.g., "zoho.map.v1.geoCode;").

Your action plan should be:
  1. Identify: Locate all instances of Zoho Map integration tasks in your Deluge scripts by searching for the v1 identifier.
  2. Update: Make necessary changes to your scripts to make sure it aligns with the new response format.
  3. Test: Thoroughly test your updated scripts to ensure they handle the new data structure correctly.
Help documentation
We've updated our help pages to reflect the latest changes and provide clear guidance on using these enhanced Map tasks. For more information, visit the Zoho Map Integration Tasks help page.

When does this take effect?
We have rolled out the update to Map tasks on October 21, 2025. Going forward, any newly created Map tasks will use the enhanced version.

All your existing Map tasks will be marked with a v1 identifier in the task name. These v1 tasks must be updated to support the new response format by January 30, 2026. After this date, the old response format will be deprecated and will no longer be supported.

We request your utmost attention to this matter and encourage you to make the necessary changes before the deadline to avoid any disruption to your workflows.

We're confident that these enhancements will make it even easier and more efficient to incorporate location capabilities into your Zoho apps using Deluge.

If you need any assistance or have questions, please feel free to reach out to us; we're always here to help.

Regards,
The Deluge team