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 tasks. This change will affect all three Zoho Map integration tasks (GeocodeReverse 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 marker.
  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 tag 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 Zoho Creator team
    • Sticky Posts

    • Introducing Zoho Creator's 2025 Release Projection 2

      Hello Creators! I'm Prakash, from the Creator product management team, and today I'm delighted to unveil our next set of features as part of Release Projection 2 for 2025. With thoughtful analysis and planning, we've curated powerful new capabilities
    • Zoho Creator - 2023 Release Projection 1

      Hello everyone! A very Happy New Year to you and your family. Hope you're all good and having a great time using Zoho Creator to make your lives easier and your businesses prosper. 2022 was an action-packed year for us at Creator, and we hope to continue
    • Zoho Creator User Group meetups in a city near you! - Oct - Nov, 2023

      Greetings from the Zoho Creator team! We're hosting a series of Zoho Creator meetups in various cities across the globe, and we'd love to meet you there! Our meetups are a great opportunity to network with industry peers, exchange ideas and best practices,
    • Zoho Creator - 2023 Release Projection 2

      Hello everyone! Time truly flies when you're having an incredible journey, and today we mark the completion of an eventful and action-packed six months. It feels like just yesterday when we embarked on this adventure together with the launch of our new
    • Upcoming Updates - August 2022

      Hi all, Greetings from the Zoho Creator team! Today we've got news for you on some exciting updates. And rest assured— there’s more to come! In this post, we'll be going over the upcoming features and improvements for this month as mentioned below. A