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

Geocode API

/api/places/geocode

All mapping APIs that are used in mobile or web apps need some geo-position coordinates to refer to any given point on the map. Our Geocoding API converts real addresses into these geographic reference positions to be placed on a map, be it for any street, area, postal code, POI or a house number etc. This APIs follow OAuth2 based security. To know more on how to create your authorization tokens, please use our authorization token URL. More details available here. 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://atlas.mapmyindia.com/api/places/geocode?address=237+Okhla+industrial+estate+phase+3+new+delhi%2C+delhi+110020
Base URLhttps://atlas.mapmyindia.com
Authenticationoauth2 bearer
Journey rolerequest response
Content typesNo request body

Parameters

NameLocationTypeDescriptionExample
region
querystring

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

ind
addressrequired
querystring

address to be geocoded

237 Okhla industrial estate phase 3 new delhi, delhi 110020
itemCount
queryinteger

parameter can be set to get maximum number of result items from the API (default: 1).

1
bias
queryinteger

This parameter can be used to set Urban or Rural bias. A positive value sets the Urban bias and a negative value sets Rural bias. This optional parameter & its related effect on response is not applicable for regions apart from India (IND). Allowed values are: 0 : Default: (No bias) -1 : Rural 1 : Urban

0
podFilter
querystring

This parameter can be used to set admin level restriction. The result will be either the given admin level or equivalent admin or higher in the hierarchy. No lower admin will be considered for geocoding.This optional parameter & its related effect on response is not applicable for regions apart from India (IND). Allowed values are: hno : house number hna : house name poi : point of interest street : street sslc : sub sub locality village : village slc : sub locality sdist : sub district loc : locality city : city dist : district pincode :pincode state : state

example
bound
querystring

This parameter can be used to set admin boundary, which means geocoding will be done within the given admin. The allowed admin bounds are Sub-District, District, City, State and Pincode. The parameter accepts the admin eLoc as value. This optional parameter & its related effect on response is not applicable for regions apart from India (IND). Note: Please note that podFilter & bound parameters are mutually exclusive. They cannot be used together in an API call.

TAVI5S

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
6 editable · 0 protected
Generated in eight languages
Environment-backed credentials
GEThttps://atlas.mapmyindia.com/api/places/geocode?region=ind&address=237+Okhla+industrial+estate+phase+3+new+delhi%2C+delhi+110020&itemCount=1&bias=0&podFilter=example&bound=TAVI5S
Credential-free sandboxExecute this contract without a provider call
How fixtures work
Generated from your inputs
curl --request GET \
  --url 'https://atlas.mapmyindia.com/api/places/geocode?region=ind&address=237+Okhla+industrial+estate+phase+3+new+delhi%2C+delhi+110020&itemCount=1&bias=0&podFilter=example&bound=TAVI5S' \
  --header "Accept: application/json" \
  --header "Authorization: Bearer ${MAPPLS_ACCESS_TOKEN}"

Credential-safe by constructionSet MAPPLS_ACCESS_TOKEN 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 /api/places/geocode
curl --request GET \
  --url 'https://atlas.mapmyindia.com/api/places/geocode?address=237+Okhla+industrial+estate+phase+3+new+delhi%2C+delhi+110020' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

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
copResultsrequired
object

No field description in the source contract.

example
copResults.houseNumber
string

House Number of the POI.

237
copResults.houseName
string

House Name of the POI.

MMI Building
copResults.poi
string

Name of the POI.

MapmyIndia Head Office
copResults.street
string

Name of the street.

copResults.subSubLocality
string

Name of the subsublocality.

copResults.subLocality
string

Name of the sublocality.

copResults.locality
string

Name of the locality.

Okhla industrial phase 3
copResults.village
string

Name of the village.

Okhla Vilage
copResults.subDistrict
string

Name of the subDistrict.

copResults.districtrequired
string

Name of the District.

South Delhi
copResults.cityrequired
string

Name of the city.

New Delhi
copResults.staterequired
string

Name of the State.

1700000000000
copResults.pincode
integer

Pincode of the location.

110010
copResults.formattedAddressrequired
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
copResults.eLocrequired
string

It is the Six or eight digit unique code offered only by mapmyindia to search for any address through this eLoc.

MMI000
copResults.latituderequired
integer

It shows us the latitude of the location searched. Geometry information is NOT available in most use-case driven response; and is RESTRICTED.

28.612964
copResults.longituderequired
integer

It shows us the longitude of the location searched. Geometry information is NOT available in most use-case driven response; and is RESTRICTED.

77.229463
copResults.geocodeLevelrequired
string

This shows the level of the geocode means on which basis the poi has been geocoded.

houseNumber
copResults.confidenceScorerequired
integer

The confidence for current of geocodelevel.

0.4
Response example
{
  "copResults": {
    "district": "South Delhi",
    "city": "New Delhi",
    "state": "Delhi",
    "formattedAddress": "237, MMI Building, MapmyIndia Head Office, Okhla industrial phase 3, Okhla Vilage, South Delhi, New Delhi, Delhi, 110010",
    "eLoc": "2LH9OC",
    "latitude": "RESTRICTED",
    "longitude": "RESTRICTED",
    "geocodeLevel": "houseNumber",
    "confidenceScore": 0.4
  }
}

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/geocode.yml
SHA-256
b1ce0d03e44035477f0d722d623b9d0ff2c5c392613f0f5106fa75392aeb3c05
Normalization
Fields are parsed from OpenAPI. Operational guidance and language samples are generated and labeled separately.