Skip to content
Finovel
API documentation

Google Maps Location

Reverse geocode latitude and longitude with Google Maps.

Endpoint

POST https://api.finovel.in/v1/reverse-geocode

Charged only when the call succeeds. Errors are never charged. See how every API works for keys, retries and status codes.

Request fields

FieldTypeRequiredDescription
latitudetextYesLatitude
longitudetextYesLongitude

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:

FieldDescription
results.0.formatted_addressAddress
results.0.place_idPlace ID
statusStatus

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)