Reverse Geocode
Table of Contents
Overview
The zoho.map.rGeoCode task returns the address of the specified GPS coordinates (latitude and longitude).
Note:
- Zoho Maps use open-source address data. Hence, accuracy might not be on par with commercial vendors.
- This task is available only in US, EU, IN domains due to the availability of Zoho Maps.
Syntax
<response> = zoho.map.rGeoCode(<latitude>, <longitude>);
where:
| Params | Data type | Description |
|---|---|---|
| <response> | KEY-VALUE | The address of the specified location, and the status of the executed task. |
| <latitude> | NUMBER | The latitude of the address that needs to be obtained. |
| <longitude> | NUMBER | The longitude of the address that needs to be obtained. |
Example
The following script returns the address of the specified location using its latitude and longitude:
response = zoho.map.rGeoCode(12.8311007, 80.0494381542286);
where:
responseThe KEY-VALUE variable that holds the address of the specified location, and the status of the executed task.
12.8311007The NUMBER that represents the latitude of the location whose address needs to be obtained.
80.0494381542286The NUMBER that represents the longitude of the location whose address needs to be obtained.
Response Format
Success Response
The success response will be returned in the following format:
{
"country": "India",
"country_code": "in",
"address": "Bucket Building, Grand Southern Trunk Road, Vardhaman Nagar, Guduvancheri, Potheri, Kanchipuram district, Tamil Nadu, 603202, India","road": "Grand Southern Trunk Road",
"state_district": "Kanchipuram district",
"neighbourhood": "Vardhaman Nagar",
"postcode": "603202",
"suburb": "Guduvancheri",
"state": "Tamil Nadu",
"village": "Potheri",
"building": "Bucket Building",
"status": "success"
}
Failure Response
The failure response for an undetectable latitude and longitude values will be returned in the following format:
{
"error": "unable to geocode",
"status": "failure"
}