eLoc API

MapmyIndia eloc is a simple, standardized and precise pan-India digital address system. Every location has been assigned a unique digital address or an eLoc. The eLoc API can be used to extract the details of a place with the help of its eLoc i.e. a 6 digit code or a place_id.

API URL

  1. Basic URL structure:
    http://apis.mapmyindia.com/advancedmaps/v1/<licence_key>/place_detail?place_id=<eLoc> 
  2. Output:The output format would be JSON.
  3. HTTP Request Method:GET


Request Parameters

The following input parameters will be supported in the place details API request –

  1. place_id: the id or eLoc of the place whose details are required. The 6-digit alphanumeric
    code for any location. (e.g. mmi000).
  2. Licence_key: the REST API licence key allocated to you by signing into our services and
    registering yourself as a developer (28 Char Alphanumeric).

Response Parameters

The place details API will return an enveloped response in the results object which will be a collection containing a single item. The following output parameters will be supported in the place details API response

  1. responseCode (int): The response code of the operation. The 400 series is for client side (yours) error while 500 series for server side (ours) error, 200 for success.
  2. version (string): The version of the API you’re connected to.
  3. results (object[ ]): a collection containing a single object of details of a location matching the provided eLoc. The contains the following properties:
    • houseNumber (string): The house number of the location.
    • houseName (string): The name of the location.
    • poi (string): The name of the POI if the location is a place of interest (POI).
    • street (string): The name of the street of the location.
    • subSubLocality (string): The name of the sub-sub-locality where the location exists.
    • subLocality (string): The name of the sub-locality where the location exists.
    • locality (string): The name of the locality where the location exists.
    • village (string): The name of the village if the location exists in a village.
    • district (string): The name of the district in which the location exists.
    • subDistrict (string): The name of the sub-district in which the location exists.
    • city (string): The name of the city in which the location exists.
    • state (string): The name of the state in which the location exists.
    • pincode (string): The pin code of the location area.
    • latitude (double): The latitude of the location.
    • longitude (double): The longitude of the location.
    • place_id (string): The eLoc or placeId assigned for a place in map database. An eLoc is the digital identity for an address or business to identify its unique location. For more information on eLoc, click here.
    • type (string): defines the type of location matched (HOUSE_NUMBER, HOUSE_NAME, POI, STREET, SUB_LOCALITY, LOCALITY, VILLAGE, DISTRICT, SUB_DISTRICT, CITY, STATE, SUBSUBLOCALITY, PINCODE)

Performance

The place details API must respond within 100 Ms under all circumstances on a stable internet connection although on an unstable one, response times may vary.

Transaction Information

One request using the API link will be considered as one transaction.

Use Cases

  • To get details of a search result that was not the first result in the search results of the Autosuggest API.
  • To get details of a search result that was not the first result in the search results of the Geocode API.
  • To get the details of a location by providing it’s eLoc or place Id.

Example

Input:
https://apis.mapmyindia.com/advancedmaps/v1/<licence_key>/place_detail?place_id=D75CA2

Output:

{  "responseCode": 200,  "version": "130.10",  "results": [  {  "houseNumber": "",  "houseName": "ICICI ATM",  "poi": "",  "street": "ICICI ATM",  "subSubLocality": "",  "subLocality": "",  "locality": "Jasola Vihar",  "village": "",  "district": "South District",  "subDistrict": "Kalkaji",  "city": "New Delhi",  "state": "Delhi",  "pincode": "110020",  "longitude": "77.2807510000001",  "latitude": "28.5414020000001",  "type": "POI",  "place_id": "D75CA2"  }  ]  }