Batch Reverse Geocoding API

Convert large collections of GPS coordinate logs and IoT telemetry traces into structured, readable postal addresses.

Where it's used

Use cases, value and how it works

Overview & Solution

IoT tracking collars, vehicle GPS blackboxes, and field agent apps generate millions of geographic points daily. The Batch Reverse Geocoding API bulk-translates coordinate arrays into street names, districts, states, and postal codes.

Industry Use Cases

1. End-of-Day Field Trips & Audits

• Trip Log Summaries: Generate automated trip inspection reports for logistics carriers (e.g., "Trip started at Bhiwandi Hub, stopped at Thane West, concluded at Nhava Sheva Port").

2. Regulatory Compliance & Tax Reporting

• Interstate Milage Auditing: Document all state-border crossings and municipal entries for fuel and interstate permit audits.

API reference

Location and Address Intelligence APIs · API key only

Quick try

curl

curl -X POST 'https://api-gw.sovereignsolutions.com/gateway/geocode/reverse?api-key=$API_KEY' \
  -H 'Content-Type: application/json' \
  -d '[77.06615, 28.462238, 72.8455, 19.0829]'

Reverse geocode several points in one call

POST https://api-gw.sovereignsolutions.com/gateway/geocode/reverse

Auth: api-key query parameter only - no bearer token, no tenant in the URL

Request parameters

Parameter	In	Type	Required	Description
[]	body	number	-	Flat list of numbers: longitude, latitude for the first point, then the next point, and so on.

Request body

[
  77.06615,
  28.462238,
  72.8455,
  19.0829
]

Response

200 OK

[
  {
    "Country": "India",
    "District": "Gurugram",
    "PinCode": {
      "OfficeName": "Industrial Estate (Gurgaon)",
      "OfficeType": "S.O",
      "Value": "122007"
    },
    "Road": "",
    "State": "HARYANA",
    "Status": true,
    "Tehsil": "Gurgaon",
    "Village": ""
  },
  {
    "Country": "India",
    "District": "Mumbai Suburban",
    "PinCode": {
      "OfficeName": "Santacruz(East)",
      "OfficeType": "S.O",
      "Value": "400055"
    },
    "Road": "NCL Colony Road",
    "State": "MAHARASHTRA",
    "Status": true,
    "Tehsil": "Mumbai Suburban",
    "Village": ""
  }
]

Response fields (12)

Field	Type	Description
[]	object	One address per input point, in input order.
[].Country	string	Country.
[].District	string	District.
[].PinCode	object
[].PinCode.OfficeName	string	Post office name.
[].PinCode.OfficeType	string	Post office type, e.g. S.O (sub office).
[].PinCode.Value	string	Postal code (PIN).
[].Road	string	Nearest road name. Empty when none is known.
[].State	string	State.
[].Status	boolean	true when an address was found.
[].Tehsil	string	Tehsil (sub-district).
[].Village	string	Village. Empty when the point is not in a village.

Same endpoint as the Reverse Geocode API; sending a flat array of longitude, latitude pairs instead of an object returns one address per pair.

Errors: non-2xx responses use the standard status codes listed on Errors.