Reverse Geocoding (Coordinates to Address)

GET/v1/geocode/reverse5 Credits / request($0.0005 / request ($0.20–$0.50 / 1K calls))

Convert raw GPS latitude and longitude coordinates into structured street addresses, postal codes, administrative areas, and corresponding Google Maps Place IDs.

Parameters

latnumber (-90 to 90)required
Latitude coordinate (-90 to 90).
Example: 40.722341
lngnumber (-180 to 180)required
Longitude coordinate (-180 to 180).
Example: -74.001298
languagestring
ISO 639-1 language code (default 'en').
Example: en

Example Request (cURL / Python / JavaScript)

curl "https://api.googlemapsapi.io/v1/geocode/reverse?lat=40.722341&lng=-74.001298" \
  -H "x-api-key: gm_live_your_api_key"

Live Response Preview

{
  "request_id": "req_gm_22901b8de512",
  "status": "ok",
  "data": [
    {
      "place_id": "ChIJN5X_gWdZwokRck9rk2guJ1M",
      "formatted_address": "450 Broome St, New York, NY 10013, USA",
      "address_components": {
        "street_number": "450",
        "route": "Broome St",
        "neighborhood": "SoHo",
        "locality": "New York",
        "administrative_area_level_1": "NY",
        "postal_code": "10013",
        "country_code": "US"
      },
      "coordinates": {
        "latitude": 40.722341,
        "longitude": -74.001298
      },
      "plus_code": "87G7PXXW+8Q"
    }
  ],
  "meta": {
    "credits_used": 5,
    "credits_remaining": 1914,
    "count": 1,
    "has_more": false,
    "next_cursor": null,
    "cache_hit": false
  }
}

Response Fields

Structured address components and matching place_ids for the coordinates.

Field	Type	Sample / Notes
`request_id`	string	Unique request trace identifier.
`status`	string	Response status ('ok').
`data`	array of ReverseGeocodeResult	Reverse geocoded addresses.
`place_id`	string	Nearest Google Maps Place ID.
`formatted_address`	string	Formatted street address.
`coordinates`	CoordinatesObject
`latitude`	number	WGS84 latitude coordinate.
`longitude`	number	WGS84 longitude coordinate.
`plus_code`	string	Open Location Code.
`meta`	ResponseMeta
`credits_used`	integer	Credits deducted for this API call.
`credits_remaining`	integer	Remaining credit balance on the account.
`count`	integer	Number of records returned in data.
`has_more`	boolean	Whether additional pages are available.
`next_cursor`	string	Opaque cursor token for fetching the next page.
`cache_hit`	boolean	Whether the response was served from the sub-50ms local index.

Status Codes

200: Structured address components and matching place_ids for the coordinates.