AdminConsole
API reference/mGIS Analytics
GETstatefulexact public snapshotv2 · compare 2

Fetches the maptiles of the dataset name of a bounding box for Spatial Join between 2 datasets as well as between one dataset and userDefined geometry.

/map/getLayerJoin

Fetches the maptiles of the dataset name of a bounding box for Spatial Join between 2 datasets as well as between one dataset and userDefined geometry.

Build a requestGet credentials
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.

Open field-level comparison and migration checklist
Request target

Call the operation

GEThttps://mgis-apiv2.mappls.com/map/getLayerJoin?queryType=basic&datasetSource=india&operator=%3D&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
queryTyperequired
querystring

The queryType can be 'basic' or 'spatialOperation'.

basic
userGeom
querystring

Value of UserGeom will be 'true' if user wants to perform geometric operations with user-defined geometry. It is mandatory in case of queryType 'spatialOperation' for userDefined geometry.

true
datasetSourcerequired
querystring

The datasetNme of whose maptiles has to be fetched. It is mandatory both in case of queryType 'basic' as well as queryType 'spatialOperation'.

india
datasetRef
querystring

The datasetNme of whose maptiles has to be fetched. It is mandatory in case of queryType 'basic' as well as for queryType 'spatialOperation' in case of performing the operation between 2 datsets.

geo
sourceProperty
querystring

Source property on which the user wants to fetch the result. It is mandatory in case of queryType 'basic'

id
refProperty
querystring

Reference property on which the user wants to fetch the result. It is mandatory in case of queryType 'basic'

id
operatorrequired
querystring

Operators acceptable for queryType 'basic' are: =, =, , <>, IN and NOT IN Operators acceptable for queryType 'spatialOperation' are: Intersects, Disjoint, Overlaps, Equals, Touches, DWithin, Within, Contains and Crosses It is mandatory both in case of queryType 'basic' as well as queryType 'spatialOperation'.

=
heightrequired
querynumber

To set the height of the maptiles. It is mandatory both in case of queryType 'basic' as well as queryType 'spatialOperation'.

256
widthrequired
querynumber

To set the width of the maptiles. It is mandatory both in case of queryType 'basic' as well as queryType 'spatialOperation'.

256
bboxrequired
querystring

Defines the set of substitution values that can be used in SLD variable substitution. It is mandatory both in case of queryType 'basic' as well as queryType 'spatialOperation'.

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 queryType 'basic' as well as queryType 'spatialOperation'.

YOUR_ACCESS_TOKEN
geom
querystring

User defined geometry will be of geoJSON format. It will contain the geometry key-value part of the geojson. The geojson should contain the coordinates in [lon, lat] format . It is mandatory in case of queryType 'spatialOperation' for userDefined geometry.

{ "type": "Polygon", "coordinates": [[[74.02587890625,21.739091217718574],[77.71728515624999,21.739091217718574],[77.71728515624999,25.20494115356912],[74.02587890625,25.20494115356912],[74.02587890625,21.739091217718574]]]}
transparent
querystring

To set the transparency of the maptiles.

true
srs
querystring

To pass the projection of the maptiles.

EPSG:3857
distance
querynumber

Distance is only required when the operator is DWITHIN .

10
env
querystring

Enables the user to change the styling of the layer.

fillcolor:023e8a, fillopacity:2a9d8f, strokecolor:283618,strokewidth:1,labelsize: 18, labelcolor: 772e25
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
16 editable · 1 protected
Generated in eight languages
Environment-backed credentials
GEThttps://mgis-apiv2.mappls.com/map/getLayerJoin?queryType=basic&userGeom=true&datasetSource=india&datasetRef=geo&sourceProperty=id&refProperty=id&operator=%3D&height=256&width=256&bbox=7514065.628545968%2C2504688.542848655%2C8766409.899970295%2C3757032.8142729844&geom=%7B+%22type%22%3A+%22Polygon%22%2C+%22coordinates%22%3A+%5B%5B%5B74.02587890625%2C21.739091217718574%5D%2C%5B77.71728515624999%2C21.739091217718574%5D%2C%5B77.71728515624999%2C25.20494115356912%5D%2C%5B74.02587890625%2C25.20494115356912%5D%2C%5B74.02587890625%2C21.739091217718574%5D%5D%5D%7D&transparent=true&srs=EPSG%3A3857&distance=10&env=fillcolor%3A023e8a%2C+fillopacity%3A2a9d8f%2C+strokecolor%3A283618%2Cstrokewidth%3A1%2Clabelsize%3A+18%2C+labelcolor%3A+772e25&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/getLayerJoin?queryType=basic&userGeom=true&datasetSource=india&datasetRef=geo&sourceProperty=id&refProperty=id&operator=%3D&height=256&width=256&bbox=7514065.628545968%2C2504688.542848655%2C8766409.899970295%2C3757032.8142729844&geom=%7B+%22type%22%3A+%22Polygon%22%2C+%22coordinates%22%3A+%5B%5B%5B74.02587890625%2C21.739091217718574%5D%2C%5B77.71728515624999%2C21.739091217718574%5D%2C%5B77.71728515624999%2C25.20494115356912%5D%2C%5B74.02587890625%2C25.20494115356912%5D%2C%5B74.02587890625%2C21.739091217718574%5D%5D%5D%7D&transparent=true&srs=EPSG%3A3857&distance=10&env=fillcolor%3A023e8a%2C+fillopacity%3A2a9d8f%2C+strokecolor%3A283618%2Cstrokewidth%3A1%2Clabelsize%3A+18%2C+labelcolor%3A+772e25&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/getLayerJoin
curl --request GET \
  --url 'https://mgis-apiv2.mappls.com/map/getLayerJoin?queryType=basic&datasetSource=india&operator=%3D&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

OK

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.