GET Fetches the maptiles of the dataset name of a bounding box.

Exact public source snapshot

This operation is retained because its version-labelled public specification differs structurally from another generation. It is comparison evidence, not a promise of current support, compatibility, entitlement, or availability.

Version-aware contract

Compare before changing adapters

This is the v2 declaration and the highest version-labelled source evidence. “Preferred” does not prove provider support or semantic compatibility.

v1Open exact reference v2This reference

Open field-level comparison and migration checklist

Request target

Call the operation

GET

https://mgis-apiv2.mappls.com/map/getMap?datasetNme=india&height=256&width=256&bbox=7514065.628545968%2C2504688.542848655%2C8766409.899970295%2C3757032.8142729844&access_token=YOUR_ACCESS_TOKEN

Base URLhttps://mgis-apiv2.mappls.com/

Authenticationbearer

Journey roleobserve

Content typesNo request body

Path, query, and headers

Parameters

NameLocationTypeDescriptionExample

datasetNmerequired

querystring

The datasetNme of whose maptiles has to be fetched.

india

heightrequired

querynumber

To set the height of the maptiles.

256

widthrequired

querynumber

To set the width of the maptiles.

256

bboxrequired

querystring

Defines the set of substitution values that can be used in SLD variable substitution.

7514065.628545968,2504688.542848655,8766409.899970295,3757032.8142729844

access_tokenrequired

querystring

To authorization token for the API access. It is mandatory both in case of user-defined geometry as well as for the published dataset.

YOUR_ACCESS_TOKEN

queryType

querystring

queryType value should be 'functionBased'. Mandatory when user has to perform geometric operations with or without 'cqlfilter'.

functionBased

comparisonFunction

querystring

The functions allowed are: Area and Length . This parameter is mandatory for queryType functionBased. Applicable for only queryType = 'functionBased'.

Area

comparisonOperator

querystring

The operators allowed are: =, >, , >= and <=. This parameter is mandatory for queryType functionBased. Applicable for only queryType = 'functionBased'.

=

comparisonValue

querynumber

The value should be in numeric (in meters). This parameter is mandatory for queryType functionBased. Applicable for only queryType = 'functionBased'.

10

transparent

querystring

To set the transparency of the maptiles.

true

env

querystring

Enables the user to change the styling of the layer.

fillcolor:023e8a, fillopacity:2a9d8f, strokecolor:283618,strokewidth:1,labelsize: 18, labelcolor: 772e25

cql_filter

querystring

To pass the cqlfilter for fetching the filtered maptiles. This is an optional paramter when queryType = 'functionBased' is passed.

name = 'India'

srs

querystring

To pass the projection of the maptiles.

EPSG:3857

style

querystring

To pass the style of the maptiles.

example

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

13 editable · 1 protected

datasetNmerequiredqueryThe datasetNme of whose maptiles has to be fetched.heightrequiredqueryTo set the height of the maptiles.widthrequiredqueryTo set the width of the maptiles.bboxrequiredqueryDefines the set of substitution values that can be used in SLD variable substitution.queryTypequeryqueryType value should be 'functionBased'. Mandatory when user has to perform geometric operations with or without 'cqlfilter'.comparisonFunctionqueryThe functions allowed are: Area and Length . This parameter is mandatory for queryType functionBased. Applicable for only queryType = 'functionBased'.comparisonOperatorqueryThe operators allowed are: =, >, , >= and <=. This parameter is mandatory for queryType functionBased. Applicable for only queryType = 'functionBased'.comparisonValuequeryThe value should be in numeric (in meters). This parameter is mandatory for queryType functionBased. Applicable for only queryType = 'functionBased'.transparentqueryTo set the transparency of the maptiles.envqueryEnables the user to change the styling of the layer.cql_filterqueryTo pass the cqlfilter for fetching the filtered maptiles. This is an optional paramter when queryType = 'functionBased' is passed.srsqueryTo pass the projection of the maptiles.stylequeryTo pass the style of the maptiles.

Generated in eight languages

Environment-backed credentials

GET

https://mgis-apiv2.mappls.com/map/getMap?datasetNme=india&height=256&width=256&bbox=7514065.628545968%2C2504688.542848655%2C8766409.899970295%2C3757032.8142729844&queryType=functionBased&comparisonFunction=Area&comparisonOperator=%3D&comparisonValue=10&transparent=true&env=fillcolor%3A023e8a%2C+fillopacity%3A2a9d8f%2C+strokecolor%3A283618%2Cstrokewidth%3A1%2Clabelsize%3A+18%2C+labelcolor%3A+772e25&cql_filter=name+%3D+%27India%27&srs=EPSG%3A3857&style=example

access_token is required.

Credential-free sandboxExecute this contract without a provider call

How fixtures work

Generated from your inputs

curl --request GET \
  --url 'https://mgis-apiv2.mappls.com/map/getMap?datasetNme=india&height=256&width=256&bbox=7514065.628545968%2C2504688.542848655%2C8766409.899970295%2C3757032.8142729844&queryType=functionBased&comparisonFunction=Area&comparisonOperator=%3D&comparisonValue=10&transparent=true&env=fillcolor%3A023e8a%2C+fillopacity%3A2a9d8f%2C+strokecolor%3A283618%2Cstrokewidth%3A1%2Clabelsize%3A+18%2C+labelcolor%3A+772e25&cql_filter=name+%3D+%27India%27&srs=EPSG%3A3857&style=example' \
  --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 /map/getMap

curl --request GET \
  --url 'https://mgis-apiv2.mappls.com/map/getMap?datasetNme=india&height=256&width=256&bbox=7514065.628545968%2C2504688.542848655%2C8766409.899970295%2C3757032.8142729844&access_token=YOUR_ACCESS_TOKEN' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Success and failure behavior

Responses

200

400

Bad Request, User made an error while creating a valid request.

401

Unauthorized.

404

No data found in database.

500

Bad Request, User made an error while creating a valid request.

Response example

"example"

stateful integration

Operate it safely

observe

This operation observes durable platform state. Preserve resource identifiers and account for pagination, delay, and eventual consistency.

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.Persist resource identifiers and apply commands exactly once in effect across retries and event replay.

Auditable source

Contract provenance

Source file: mappls-developer-platform/data/corpus/public-api-contracts/mapmyindia-mgis-apis/docs/v2/custom/layer_visualization.yml
SHA-256: 789212df7cef0c3c95f49b37b2ce29dd4e8cedfaa496a797b04008071fc8fa34
Normalization: Fields are parsed from OpenAPI. Operational guidance and language samples are generated and labeled separately.
Source record: Open repository audit