Skip to main content

Batch Reverse Geocoding API

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


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

Endpoints​

All requests need only your API key, as the api-key query parameter - no bearer token:

?api-key=<apiKey>

Reverse geocode several points in one call​

POST /geocode/reverse

Base URL: https://api-gw.sovereignsolutions.com/gateway

Request Parameters

ParameterInTypeRequiredDescriptionExample
[]bodynumberNoFlat 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 Schema

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": ""
}
]
FieldTypeDescription
[]objectOne address per input point, in input order.
[].CountrystringCountry.
[].DistrictstringDistrict.
[].PinCodeobject
[].PinCode.OfficeNamestringPost office name.
[].PinCode.OfficeTypestringPost office type, e.g. S.O (sub office).
[].PinCode.ValuestringPostal code (PIN).
[].RoadstringNearest road name. Empty when none is known.
[].StatestringState.
[].Statusbooleantrue when an address was found.
[].TehsilstringTehsil (sub-district).
[].VillagestringVillage. 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.

Example​

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]'