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
| Parameter | In | Type | Required | Description | Example |
|---|---|---|---|---|---|
[] | body | number | No | 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 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": ""
}
]
| 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.
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]'