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

Distance Matrix Predictive ETA API

/{REST_KEY}/distance_matrix_predictive/driving/{coordinates}

This API computes the distance and duration of a route between a source/primary position (geographical coordinates) and a list of all supplied secondary positions. Optionally one can input the deptime parameter and get the distance and duration optimized for that part of the day of a week. Time based functionality is available for selected cities only. Please note that maximum number of points are limited to 100 only including source and secondary positions. PREMIUM API

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/distance_matrix_predictive/driving/28.612964%2C77.229463
Base URLhttps://apis.mapmyindia.com/advancedmaps/v1
Authenticationnot declared
Journey rolerequest response
Content typesNo request body

Parameters

NameLocationTypeDescriptionExample
REST_KEYrequired
pathstring

The REST API licence key allocated to you by signing into our services and registering yourself as a developer.

YOUR_REST_KEY
coordinatesrequired
pathstring

Coordinates are pair of comma separated longitude & latitude values. First coordinate will be consider as start point (mandatory); a last coordinate will be considered as end point (mandatory) and those in between are via points (optional). Example: {longitude},{latitude};{longitude},{latitude}[;{longitude},{latitude} ...] (part of URL).

28.612964,77.229463
dep_time
queryinteger

the UNIX timestamp of departure in seconds. Distance and ETA will be optimized as per given time.

1700000000000

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
2 editable · 1 protected
Generated in eight languages
Environment-backed credentials
GEThttps://apis.mapmyindia.com/advancedmaps/v1/${MAPPLS_REST_KEY}/distance_matrix_predictive/driving/28.612964%2C77.229463?dep_time=1700000000000
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}/distance_matrix_predictive/driving/28.612964%2C77.229463?dep_time=1700000000000" \
  --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}/distance_matrix_predictive/driving/{coordinates}
curl --request GET \
  --url 'https://apis.mapmyindia.com/advancedmaps/v1/YOUR_REST_KEY/distance_matrix_predictive/driving/28.612964%2C77.229463'

Responses

200

OK

204

DB Connection error.

400

Bad request

401

API access denied

403

Forbidden

404

Not found

412

Precondition Failed, i.e. Some existing pre-condition in formulating a valid API request was not fulfilled.

500

Something went wrong

503

Internal server error

200 response fields

FieldTypeDescriptionExample
checkrequired
string

internal response (for MMI internal purposes only)

5025
versionrequired
string

API’s version information.

250.19.5222
responseCoderequired
string

See the service dependent and general status codes

200
resultsrequired
object

No field description in the source contract.

example
results.coderequired
string

if request is successful, response is ‘ok’. Else, see the service dependent and general status codes as available in the enum. In case of error, “NoRoute” code is supported (in addition to the general ones) which means “no route found”. Ok : Request could be processed as expected. InvalidUrl : URL string is invalid. InvalidService: Service name is invalid. InvalidVersion : Version is not found. InvalidOptions : Options are invalid. InvalidQuery : The query string is synctactically malformed. Inv

Ok
results.distancesrequired
array<unknown>

array of float distances in metres.

example
results.durationsrequired
array<unknown>

array of float durations in seconds.

example
Response example
{
  "check": 5025,
  "version": "250.19.5222",
  "responseCode": "200",
  "results": {
    "code": "Ok",
    "distances": [
      [
        14076.1,
        30927.6
      ]
    ],
    "durations": [
      [
        1884.9,
        2644.1
      ]
    ]
  }
}

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