GET AutoSuggest API · Mappls Developers

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.

Request target

Call the operation

GEThttps://atlas.mapmyindia.com/api/places/search/json?query=mapmyindia

Base URLhttps://atlas.mapmyindia.com

Authenticationoauth2 bearer

Journey rolerequest response

Content typesNo request body

Path, query, and headers

Parameters

NameLocationTypeDescriptionExample

queryrequired

querystring

Enter the query on which the search has to be done.

mapmyindia

location

querystring

Location is required to get location biased autosuggest results.

28.612964,77.229463

region

querystring

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

IND

tokenizeAddress

queryboolean

It is the valueless parameter provides the different address attributes in a structured object.

YOUR_ACCESS_TOKEN

pod

querystring

It takes in the place type code which helps in restricting the results to certain chosen type. This optional parameter & its related effect on response is not applicable for regions apart from India (IND). Below mentioned are the codes for the pod: SLC: Sublocality LC: Locality CITY: City VLG: Village SDIST: Subdistrict DIST: District STATE: State SSLC: Subsublocality

CITY

filter

querystring

This parameter helps you restrict the result either by mentioning a bounded area or to certain eloc (6 digit code to any poi, locality, city, etc.). This optional parameter & its related effect on response is not applicable for regions apart from India (IND). Below mentioned are the available types: filter = pin:It takes pincode/postal code of an area{e.g. filter=pin:110055} filter = bounds lat1,lng1;lat2,lng2(latitude,longitude){e.g. filter=bounds 28.598882, 77.212407; 28.467375, 77.353513} filter = cop {eloc} (string) {e.g. filter=cop:YMCZ0J}

pin:110001

bridge

queryboolean

(Valueless)It initiates a bridge to be created to provide applicable nearby API searches in the suggestedSearches response object. This optional parameter & its related effect on response is not applicable for regions apart from India (IND).

true

hyperLocal

queryboolean

(valueless): This parameter lets the search give results that are hyper-localized to the reference location passed in the location parameter. This means that nearby results are given higher ranking than results far from the reference location. Highly prominent results will still appear in the search results, however they will be lower in the list of results. This parameter will work ONLY in conjunction with the location parameter. This optional parameter & its related effect on response is not applicable for regions apart from India (IND).

true

Interactive, local, and credential-safe

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

7 editable · 1 protected

queryrequiredqueryEnter the query on which the search has to be done.locationqueryLocation is required to get location biased autosuggest results.regionqueryIt takes in the country code. Possible values are listed in a table here. Default is India (IND).podqueryIt takes in the place type code which helps in restricting the results to certain chosen type. This optional parameter & its related effect on response is not applicable for regions apart from India (IND). Below mentioned are the codes for the pod: SLC: Sublocality LC: Locality CITY: City VLG: Village SDIST: Subdistrict DIST: District STATE: State SSLC: SubsublocalityfilterqueryThis parameter helps you restrict the result either by mentioning a bounded area or to certain eloc (6 digit code to any poi, locality, city, etc.). This optional parameter & its related effect on response is not applicable for regions apart from India (IND). Below mentioned are the available types: filter = pin:It takes pincode/postal code of an area{e.g. filter=pin:110055} filter = bounds lat1,lng1;lat2,lng2(latitude,longitude){e.g. filter=bounds 28.598882, 77.212407; 28.467375, 77.353513} filter = cop {eloc} (string) {e.g. filter=cop:YMCZ0J}bridgequery(Valueless)It initiates a bridge to be created to provide applicable nearby API searches in the suggestedSearches response object. This optional parameter & its related effect on response is not applicable for regions apart from India (IND).hyperLocalquery(valueless): This parameter lets the search give results that are hyper-localized to the reference location passed in the location parameter. This means that nearby results are given higher ranking than results far from the reference location. Highly prominent results will still appear in the search results, however they will be lower in the list of results. This parameter will work ONLY in conjunction with the location parameter. This optional parameter & its related effect on response is not applicable for regions apart from India (IND).

Generated in eight languages

Environment-backed credentials

GET

https://atlas.mapmyindia.com/api/places/search/json?query=mapmyindia&location=28.612964%2C77.229463&region=IND&pod=CITY&filter=pin%3A110001&bridge=true&hyperLocal=true

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/search/json?query=mapmyindia&location=28.612964%2C77.229463&region=IND&pod=CITY&filter=pin%3A110001&bridge=true&hyperLocal=true' \
  --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.

Five language quickstarts

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/search/json

curl --request GET \
  --url 'https://atlas.mapmyindia.com/api/places/search/json?query=mapmyindia' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Success and failure behavior

Responses

200

204

Not found

400

Bad request

401

API access denied

403

Forbidden

500

Something went wrong

503

Internal server error

200 response fields

FieldTypeDescriptionExample

suggestedLocationsrequired

array<object>

No field description in the source contract.

28.612964,77.229463

suggestedLocations[].typerequired

string

This is the type whether the results is POI or any building point.

POI

suggestedLocations[].typeXrequired

integer

Type attribute for internal use only for MapmyIndia.

7

suggestedLocations[].placeAddressrequired

string

Address of the location.

Yippee Rooms, Sector 56, Gurugram, Haryana, 122011

suggestedLocations[].latituderequired

number

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

suggestedLocations[].longituderequired

number

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

suggestedLocations[].eLocrequired

string

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

MMI000

suggestedLocations[].entryLatituderequired

number

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

28.612964

suggestedLocations[].entryLongituderequired

number

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

77.229463

suggestedLocations[].placeNamerequired

string

This shows the name of the POI

OYO Hotel

suggestedLocations[].alternateNamerequired

string

This shows the alternate name of the POI

OyoRooms,OYO 40400 Yippe Rooms,OYO Rooms Hotel

suggestedLocations[].keywordsrequired

array<object>

The keywords/category codes associated with the given result.

example

suggestedLocations[].addressTokensrequired

object

No field description in the source contract.

YOUR_ACCESS_TOKEN

suggestedLocations[].addressTokens.houseNumber

string

House Number of the POI.

237

suggestedLocations[].addressTokens.houseName

string

House Name of the POI.

MMI Building

suggestedLocations[].addressTokens.poi

string

Name of the POI.

MapmyIndia Head Office

suggestedLocations[].addressTokens.street

string

Name of the street.

—

suggestedLocations[].addressTokens.subSubLocality

string

Name of the subsublocality.

—

suggestedLocations[].addressTokens.subLocality

string

Name of the sublocality.

—

suggestedLocations[].addressTokens.locality

string

Name of the locality.

Okhla industrial phase 3

suggestedLocations[].addressTokens.village

string

Name of the village.

Okhla Vilage

suggestedLocations[].addressTokens.subDistrict

string

Name of the subDistrict.

—

suggestedLocations[].addressTokens.districtrequired

string

Name of the District.

South Delhi

suggestedLocations[].addressTokens.cityrequired

string

Name of the city.

New Delhi

suggestedLocations[].addressTokens.staterequired

string

Name of the STATE.

1700000000000

suggestedLocations[].addressTokens.pincode

integer

PINcode of the location.

110010

suggestedLocations[].prequired

integer

This shows the priority of the POI

11663

suggestedLocations[].orderIndexrequired

integer

This shows the order of the search results priority wise.

1

suggestedLocations[].scorerequired

number

This shows the score of the POI.

1.5075794782130676

suggestedLocations[].suggesterrequired

string

This shows on which basis the search results has been found.

alternateName

suggestedLocations[].richInforequired

array<object>

This shows the rich info associated with the given result.

—

userAddedLocationrequired

array<object>

No field description in the source contract.

28.612964,77.229463

userAddedLocation[].eLocrequired

string

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

MMI000

userAddedLocation[].entryLatituderequired

number

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

28.612964

userAddedLocation[].entryLongituderequired

number

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

77.229463

userAddedLocation[].latituderequired

number

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

userAddedLocation[].longituderequired

number

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

userAddedLocation[].orderIndexrequired

integer

This shows the order of the search results priority wise.

1

userAddedLocation[].placeAddressrequired

string

This is the address of the text searched by you.

Yippee Rooms, Sector 56, Gurugram, Haryana, 122011

userAddedLocation[].placeNamerequired

string

This shows the name of the POI.

OYO Hotel

userAddedLocation[].resultTyperequired

string

It Shows the the category of result falling into. For eg. UAP

UAP

userAddedLocation[].typerequired

string

No field description in the source contract.

—

userAddedLocation[].userNamerequired

string

It shows the UserID of the person who added the location.

usr1577100139i799918080

suggestedSearchesrequired

array<object>

No field description in the source contract.

example

suggestedSearches[].keywordrequired

string

It shows the result keyword

corona testing lab

suggestedSearches[].identifierrequired

string

on what basis the results shown

near

suggestedSearches[].locationrequired

string

location near the results are shown

28.612964,77.229463

suggestedSearches[].hyperlinkrequired

string

direct link of the poi.

https://atlas.mapmyindia.com/api/places/nearby/json?explain&richData&username=atlasuser&refLocation=28.550592,77.26877&keywords=hsptst

suggestedSearches[].orderIndexrequired

integer

This shows the order of the search results priority wise.

0

suggestedSearches[].eLocrequired

string

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

MMI000

langrequired

string

Used to indicate if the response is in some language other than the default(which is en). Valid values are hi, which indicates Hindi response.

hi

Response example

{
  "suggestedLocations": [
    {
      "type": "POI",
      "typeX": 7,
      "placeAddress": "Yippee Rooms, Sector 56, Gurugram, Haryana, 122011",
      "latitude": "RESTRICTED",
      "longitude": "RESTRICTED",
      "eLoc": "2LH9OC",
      "entryLatitude": "RESTRICTED",
      "entryLongitude": "RESTRICTED",
      "placeName": "OYO Hotel",
      "alternateName": "OyoRooms,OYO 40400 Yippe Rooms,OYO Rooms Hotel",
      "keywords": [
        "FINATM"
      ],
      "addressTokens": {
        "district": "South Delhi",
        "city": "New Delhi",
        "state": "Delhi"
      },
      "p": 11663,
      "orderIndex": 1,
      "score": 1.5075794782130676,
      "suggester": "alternateName",
      "richInfo": ""
    }
  ],
  "userAddedLocation": [
    {
      "eLoc": "2LH9OC",
      "entryLatitude": "RESTRICTED",
      "entryLongitude": "RESTRICTED",
      "latitude": "RESTRICTED",
      "longitude": "RESTRICTED",
      "orderIndex": 1,
      "placeAddress": "Yippee Rooms, Sector 56, Gurugram, Haryana, 122011",
      "placeName": "OYO Hotel",
      "resultType": "UAP",
      "type": "",
      "userName": "usr1577100139i799918080"
    }
  ],
  "suggestedSearches": [
    {
      "keyword": "corona testing lab",
      "identifier": "near",
      "location": "me",
      "hyperlink": "https://atlas.mapmyindia.com/api/places/nearby/json?explain&richData&username=atlasuser&refLocation=28.550592,77.26877&keywords=hsptst",
      "orderIndex": 0,
      "eLoc": "null"
    }
  ],
  "lang": "hi"
}

stateless integration

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.

Auditable source

Contract provenance

Source file: contenthub/dochub/mapmyindia-rest-api/docs/custom/autosuggest.yml
SHA-256: 853e2a51f94cc6cc10291bdfdfbd49d57c6cbe56b91a8ab7893a66639a595cf4
Normalization: Fields are parsed from OpenAPI. Operational guidance and language samples are generated and labeled separately.
Source record: Open repository audit