API reference/Core Maps, Search & Routing
GETstatelesslegacy-source evidence

Reverse Geocode API

/{REST_KEY}/rev_geocode

Reverse Geocoding is a process to give the closest matching address to a provided geographical coordinates (latitude/longitude). MapmyIndia reverse geocoding API provides real addresses along with nearest popular landmark for any such geo-positions on the map. This API also works in Hindi language response. Live Demo | Download Sample Code

Legacy contract evidence

This operation was normalized from a MapmyIndia-generation specification. Validate its current Mappls host, path, package entitlement, authentication generation, and commercial availability before production use.

Call the operation

GEThttps://apis.mapmyindia.com/advancedmaps/v1/YOUR_REST_KEY/rev_geocode?lat=28.612964&lng=77.229463
Base URLhttps://apis.mapmyindia.com/advancedmaps/v1
Authenticationnot declared
Journey rolerequest response
Content typesNo request body

Parameters

NameLocationTypeDescriptionExample
latrequired
querynumber

The latitude of the location

28.612964
lngrequired
querynumber

The longitude of the location

77.229463
REST_KEYrequired
pathstring

The rest key allocated to your account.

YOUR_REST_KEY
region
querystring

It takes in the country code. Possible values are listed in a table here. Default is India (IND).

IND
lang
querystring

This parameter accepts the "hi" (ISO 639-1 Language Code for Hindi) as a value. This optional parameter & its related effect on response is not applicable for regions apart from India (IND).

hi

Build your request in eight languages

Change source-backed examples once, validate required inputs, and copy the synchronized cURL, JavaScript, Python, Java, C#, Go, PHP, or Ruby request. Credentials remain environment references, and this page never sends a provider request.

Local request composerCode stays local · fixtures are explicit
GETRequest inputs
4 editable · 1 protected
Generated in eight languages
Environment-backed credentials
GEThttps://apis.mapmyindia.com/advancedmaps/v1/${MAPPLS_REST_KEY}/rev_geocode?lat=28.612964&lng=77.229463&region=IND&lang=hi
Credential-free sandboxExecute this contract without a provider call
How fixtures work
Generated from your inputs
curl --request GET \
  --url "https://apis.mapmyindia.com/advancedmaps/v1/${MAPPLS_REST_KEY}/rev_geocode?lat=28.612964&lng=77.229463&region=IND&lang=hi" \
  --header "Accept: application/json"

Credential-safe by constructionSet MAPPLS_REST_KEY only in your trusted runtime. Code generation stays local. Sandbox execution sends only bounded fixture inputs to this developer platform and never reads a credential or calls Mappls.

Send a production-shaped request

Examples use environment-backed access tokens, explicit timeouts where supported, status checks, and JSON bodies derived from the source schema. Replace sample identifiers and coordinates with values from your application.

GET /{REST_KEY}/rev_geocode
curl --request GET \
  --url 'https://apis.mapmyindia.com/advancedmaps/v1/YOUR_REST_KEY/rev_geocode?lat=28.612964&lng=77.229463'

Responses

200

OK

204

Not found

400

Bad request

401

API access denied

403

Forbidden

500

Something went wrong

503

Internal server error

200 response fields

FieldTypeDescriptionExample
responseCoderequired
integer

This shows the response code of the results.

200
versionrequired
string

This shows the API version

211.19
resultsrequired
array<object>

The object contains the results of the reverse geocode API.

example
results[].houseNumber
string

House Number of the POI.

237
results[].houseName
string

House Name of the POI.

MMI Building
results[].poi
string

Name of the POI.

MapmyIndia Head Office
results[].poi_dist
string

The value of the poi district

8
results[].street
string

Name of the street.

Unnamed Road
results[].street_dist
string

The value of the street district.

14
results[].subSubLocality
string

Name of the subsublocality.

results[].subLocality
string

Name of the sublocality.

results[].locality
string

Name of the locality.

Okhla industrial phase 3
results[].village
string

Name of the village.

Okhla Vilage
results[].subDistrict
string

Name of the subDistrict.

results[].cityrequired
string

Name of the city.

New Delhi
results[].staterequired
string

Name of the state.

1700000000000
results[].pincode
integer

Pincode of the location.

110010
results[].latrequired
string

It shows us the latitude of the location searched.

28.612964
results[].lngrequired
string

It shows us the longitude of the location searched.

77.229463
results[].area
string

It shows the area on which the result has been found. for eg: India, Bangladesh, etc.

India
results[].formatted_addressrequired
string

This shows the formatted address of the POI.

237, MMI Building, MapmyIndia Head Office, Okhla industrial phase 3, Okhla Vilage, South Delhi, New Delhi, Delhi, 110010
Response example
{
  "responseCode": 200,
  "version": "211.19",
  "results": [
    {
      "city": "New Delhi",
      "state": "Delhi",
      "lat": "28.426335",
      "lng": "77.092001",
      "formatted_address": "237, MMI Building, MapmyIndia Head Office, Okhla industrial phase 3, Okhla Vilage, South Delhi, New Delhi, Delhi, 110010"
    }
  ]
}

Operate it safely

request-response

This operation is evaluated independently from the request. Cache and retry according to its documented semantics.

Keep credentials and raw tokens out of source, client bundles, prompts, and logs.Record the operation ID, status, latency, retry count, and source contract version in traces.Classify 4xx responses before retrying; back off and add jitter for retryable 5xx or transport failures.Cache only when request inputs, authorization scope, and freshness requirements permit it.

Contract provenance

Source file
contenthub/dochub/mapmyindia-rest-api/docs/custom/revGeocode.yml
SHA-256
fe7746feeb136f533afaf6048c5d0d69a8f193de3c71ade521c9aa6f412eb2b1
Normalization
Fields are parsed from OpenAPI. Operational guidance and language samples are generated and labeled separately.