composed experience90–120 min4 stages8 code languages

Application flow: A delivery promise customers can trust

Fewer failed deliveries and a live, explainable ETA from checkout to doorstep.

The real-world moment

At 18:05 a customer places a same-evening grocery order to a loosely formatted apartment address. The promise engine has eight minutes to validate serviceability and a two-hour window; dispatch must combine it with 37 stops, the driver may lose connectivity, and support needs one explainable timeline when the entrance is hard to find.

Operating contract

Make ownership visible before code.

Compose multiple capabilities while the application owns user intent, policy, and continuity.

Application state: hybrid
Planning calls: 0
Credentials accepted: No
Write authority: None

Capability map

directSearch & Placesstateless directRoutes & Navigationhybrid directInTouch Telematicsstateful entitlement-dependentCapture & Feedbackhybrid

Normalized operation coverage

An adjacent API is never substituted when the captured corpus has no exact contract.

Search & Places8 exact · normalized contractsExact normalized operations are linked below; account contract and entitlement still require validation.Routes & Navigation11 exact · normalized contractsExact normalized operations are linked below; account contract and entitlement still require validation.InTouch Telematics53 exact · normalized contractsExact normalized operations are linked below; account contract and entitlement still require validation.Capture & Feedback0 exact · reference onlyNo exact normalized REST operation is present in the captured contract corpus for this product. Use its source guides, SDK/widget/distribution surface, and entitlement process without substituting an adjacent API.

Order system of record

Normalize the destination and retain its Mappls Pin

Owns order, customer promise, consent, service window, package constraints, payment, and terminal delivery outcome.

Stage operation

Order ↔ destination Mappls Pin and acceptance timestamp

GETAutoSuggest API/api/places/search/jsonThis normalized operation matches the stage intent and remains subject to its source, lifecycle, authentication, entitlement, host, and regional gates.

Evidence to retain

Record stage 1 with the application identity, source fingerprint, request or aggregate identity, timestamp, and observable outcome.

Failure drillAmbiguous apartment entrance

Offer landmark/entrance candidates, let the customer confirm one stable pin, and preserve the original address plus every selection revision.

Location normalization

Optimize stops against capacity and time windows

Search and address services produce candidates; the accepted Mappls Pin becomes the durable destination identity rather than repeatedly geocoding text.

Stage operation

Route revision ↔ ordered stop IDs, profile, constraints, provider request identity

GETRoute Optimization API/{rest_key}/{resources}/{profile}/{geopositions}This normalized operation matches the stage intent and remains subject to its source, lifecycle, authentication, entitlement, host, and regional gates.

Evidence to retain

Record stage 2 with the application identity, source fingerprint, request or aggregate identity, timestamp, and observable outcome.

Failure drillDriver telemetry goes silent

Show last verified progress and age, alert dispatch after policy threshold, and avoid inventing a moving ETA.

Planning and guidance

Navigate with live rerouting

Route and matrix boundaries sequence eligible stops, preserve route revisions, and provide driver guidance without making the map UI authoritative.

Stage operation

Telemetry event ↔ source/event/content identity, event time, receipt time, accuracy

GETRouting API/{REST_KEY}/{resources}/{profile}/{geopositions}This normalized operation matches the stage intent and remains subject to its source, lifecycle, authentication, entitlement, host, and regional gates.

Evidence to retain

Record stage 3 with the application identity, source fingerprint, request or aggregate identity, timestamp, and observable outcome.

Failure drillProvider accepts a route/trip command after timeout

Reconcile by idempotency/provider identity before issuing another command or closing locally.

Trip evidence

Stream driver and order state

InTouch observations are deduplicated by source identity and event time; ETA revisions and exceptions are derived without rewriting raw telemetry.

Stage operation

Proof submission ↔ consent purpose, media hashes, location evidence, reviewer decision

GETGets the details of a single trip/trips/{id}This normalized operation matches the stage intent and remains subject to its source, lifecycle, authentication, entitlement, host, and regional gates.

Evidence to retain

Record stage 4 with the application identity, source fingerprint, request or aggregate identity, timestamp, and observable outcome.

Failure drillAmbiguous apartment entrance

Offer landmark/entrance candidates, let the customer confirm one stable pin, and preserve the original address plus every selection revision.

Interactive contract lab

Edit once. Generate eight trusted-runtime implementations.

The recipe starts from the normalized GET /api/places/search/json contract. Execute six deterministic fixture outcomes before an issued account is involved.

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.

Reliability contract

Break the journey before customers do.

These controls are required at this operating depth; deeper recipes add durable truth rather than merely more API calls.

Application-owned intentStable cross-capability identityPartial-failure fallbackCancellation and teardownFreshness and provenanceQuota and latency budget

Definition of done

Every capability has one owner, bounded input, explicit timeout, and useful unavailable state.

Application intent survives refresh, back navigation, duplicate callbacks, and partial capability failure.

Provider identities, source fingerprints, request identities, and application decisions remain attributable.

Accessibility, privacy, quota, observability, support, and rollback evidence cover the complete user flow.

Continue with canonical evidence

Contracts, tutorials, and journeys stay linked.

Maintained capstone

Care Transfer Desk

Confirm the correct receiving entrance, assign eligible transport, preserve courier custody, review condition exceptions, and reconcile receiver acceptance without retaining patient or clinical data.

Inspect 17 verified tests Download full application

Source-grounded, not authority-granting

This recipe composes source-derived contracts, application architecture, fixtures, and maintained learning evidence. It does not prove package availability, provider payload shape, account entitlement, regional behavior, production compatibility, or release approval.

Make ownership visible before code.

Edit once. Generate eight trusted-runtime implementations.

Break the journey before customers do.

Definition of done

Contracts, tutorials, and journeys stay linked.

Contract set

Progressive tutorials

Durable state machines

Care Transfer Desk