API documentation
Google Maps Location
Reverse geocode latitude and longitude with Google Maps.
Endpoint
POST https://api.finovel.in/v1/reverse-geocodeCharged only when the call succeeds. Errors are never charged. See how every API works for keys, retries and status codes.
Request fields
| Field | Type | Required | Description |
|---|---|---|---|
latitude | text | Yes | Latitude |
longitude | text | Yes | Longitude |
Example request
curl -X POST https://api.finovel.in/v1/reverse-geocode \
-H "Authorization: Bearer fin_test_your_key" \
-H "Content-Type: application/json" \
-d '{"latitude":"19.0760","longitude":"72.8777"}'Response fields
Inside data:
| Field | Description |
|---|---|
results.0.formatted_address | Address |
results.0.place_id | Place ID |
status | Status |
Example response from the sandbox
{
"request_id": "req_...",
"success": true,
"status": "success",
"environment": "sandbox",
"message": "OK",
"data": {
"status": "OK",
"results": [
{
"place_id": "place_sandbox_1a2b3c",
"formatted_address": "12 MG Road, Indiranagar, Bengaluru, Karnataka 560038"
}
]
},
"error": null,
"charged_paise": 0
}Sandbox scenarios
With a test key, this API can return:
- Success (default)
- Not found (contains 0000)
- Provider error (contains 9999)