POST Fetches the results of the query applied between two dataset as well as between one datset and user defimed geometry.

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.

Request target

Call the operation

POST

https://mgis-api.mapmyindia.com/query_apply/join?queryType=functionBased&datasetSource=geocode_ii&operator=Intersects&sourceProperty=id

Base URLhttps://mgis-api.mapmyindia.com/

Authenticationbearer

Journey rolecommand

Content typesapplication/json

Path, query, and headers

Parameters

NameLocationTypeDescriptionExample

queryTyperequired

querystring

queryType value can be basic, spatialOperation or functionBased .

functionBased

datasetSourcerequired

querystring

Source dataset name. Mandatory both in case of Spatial as well as Non-Spatial Query.

geocode_ii

datasetRef

querystring

Source dataset name. Mandatory both in case of Non-Spatial Query.

geocode_iii

operatorrequired

querystring

Mandatory both in case of Spatial as well as Non-Spatial Query. Operators allowed for queryType = 'basic' are: =, =, , <>, IN and NOT IN Operators allowed for queryType = 'spatialOperation' are: Intersects, Disjoint, Overlaps, Equals, Touches, DWithin, Within, Contains and Crosses

Intersects

sourcePropertyrequired

querystring

Source property attributes to be queried. Mandatory both in case of Spatial(between 2 datasets) as well as Non-Spatial Query.

id

refProperty

querystring

Reference property attributes to be queried. Mandatory in case of Non-Spatial Query.

id

selectionParamSource

querystring

Source property attributes to be reflected in the result. Optional in case of arithmetic operations, Spatial(between 2 datasets) as well as Non-Spatial Query.

id, lat

selectionParamRef

querystring

Reference property attributes to be reflected in the result. Optional both in case of Spatial(between 2 datasets) as well as Non-Spatial Query.

osm_id, name

userGeom

querystring

Value of UserGeom will be 'true' if user wants to perform spatial filters with user-defined geometry.

true

distance

querynumber

Mandatory in case of operator DWithin, else it is not required.

10

comparisonFunction

querystring

The functions allowed are: Area, Length and isEmpty . This parameter is mandatory for queryType functionBased.

Area

comparisonOperator

querystring

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

=

comparisonValue

querystring

The values allowed are: Numeric (in meters) (for comparisonFunction area and length) Boolean (for comparisonFunction isEmpty) . This parameter is mandatory for queryType functionBased.

100

saveAsNewDataset

querystring

Boolean if true cross join result will be saved in to db as new table.

true

newDatasetNme

querystring

Name of new Table(mandatory if saveAsNewDataset = true)

JoinTable

Required body

Body schema

FieldTypeDescriptionExample

type

string

No field description in the source contract.

FeatureCollection

features

array<object>

No field description in the source contract.

example

features[].type

string

No field description in the source contract.

Feature

features[].properties

object

No field description in the source contract.

example

features[].geometry

object

No field description in the source contract.

28.612964,77.229463

features[].geometry.type

string

No field description in the source contract.

Polygon

features[].geometry.coordinates

array<string>

No field description in the source contract.

28.612964,77.229463

Request body example

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": "example",
      "geometry": {
        "type": "Polygon",
        "coordinates": []
      }
    }
  ]
}

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

POSTRequest inputs

15 editable · 0 protected

queryTyperequiredqueryqueryType value can be basic, spatialOperation or functionBased .datasetSourcerequiredquerySource dataset name. Mandatory both in case of Spatial as well as Non-Spatial Query.datasetRefquerySource dataset name. Mandatory both in case of Non-Spatial Query.operatorrequiredqueryMandatory both in case of Spatial as well as Non-Spatial Query. Operators allowed for queryType = 'basic' are: =, =, , <>, IN and NOT IN Operators allowed for queryType = 'spatialOperation' are: Intersects, Disjoint, Overlaps, Equals, Touches, DWithin, Within, Contains and CrossessourcePropertyrequiredquerySource property attributes to be queried. Mandatory both in case of Spatial(between 2 datasets) as well as Non-Spatial Query.refPropertyqueryReference property attributes to be queried. Mandatory in case of Non-Spatial Query.selectionParamSourcequerySource property attributes to be reflected in the result. Optional in case of arithmetic operations, Spatial(between 2 datasets) as well as Non-Spatial Query.selectionParamRefqueryReference property attributes to be reflected in the result. Optional both in case of Spatial(between 2 datasets) as well as Non-Spatial Query.userGeomqueryValue of UserGeom will be 'true' if user wants to perform spatial filters with user-defined geometry.distancequeryMandatory in case of operator DWithin, else it is not required.comparisonFunctionqueryThe functions allowed are: Area, Length and isEmpty . This parameter is mandatory for queryType functionBased.comparisonOperatorqueryThe operators allowed are: =, >, , >= and <=. This parameter is mandatory for queryType functionBased.comparisonValuequeryThe values allowed are: Numeric (in meters) (for comparisonFunction area and length) Boolean (for comparisonFunction isEmpty) . This parameter is mandatory for queryType functionBased.saveAsNewDatasetqueryBoolean if true cross join result will be saved in to db as new table.newDatasetNmequeryName of new Table(mandatory if saveAsNewDataset = true)

JSON bodyrequired

Generated in eight languages

Environment-backed credentials

POST

https://mgis-api.mapmyindia.com/query_apply/join?queryType=functionBased&datasetSource=geocode_ii&datasetRef=geocode_iii&operator=Intersects&sourceProperty=id&refProperty=id&selectionParamSource=id%2C+lat&selectionParamRef=osm_id%2C+name&userGeom=true&distance=10&comparisonFunction=Area&comparisonOperator=%3D&comparisonValue=100&saveAsNewDataset=true&newDatasetNme=JoinTable

Credential-free sandboxExecute this contract without a provider call

How fixtures work

Generated from your inputs

curl --request POST \
  --url 'https://mgis-api.mapmyindia.com/query_apply/join?queryType=functionBased&datasetSource=geocode_ii&datasetRef=geocode_iii&operator=Intersects&sourceProperty=id&refProperty=id&selectionParamSource=id%2C+lat&selectionParamRef=osm_id%2C+name&userGeom=true&distance=10&comparisonFunction=Area&comparisonOperator=%3D&comparisonValue=100&saveAsNewDataset=true&newDatasetNme=JoinTable' \
  --header "Accept: application/json" \
  --header "Authorization: Bearer ${MAPPLS_ACCESS_TOKEN}" \
  --header "Content-Type: application/json" \
  --data-raw '{"type":"FeatureCollection","features":[{"type":"Feature","properties":"example","geometry":{"type":"Polygon","coordinates":[]}}]}'

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.

POST /query_apply/join

curl --request POST \
  --url 'https://mgis-api.mapmyindia.com/query_apply/join?queryType=functionBased&datasetSource=geocode_ii&operator=Intersects&sourceProperty=id' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": "example",
      "geometry": {
        "type": "Polygon",
        "coordinates": [

        ]
      }
    }
  ]
}'

Success and failure behavior

Responses

200

206

Impartial Content.

400

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

401

Unauthorized.

404

No data found in database.

405

Method not allowed.

409

Conflict in parameters passed.

422

Parameter missing

500

Internal server error.

200 response fields

FieldTypeDescriptionExample

code

string

Response code.

200

result

array<object>

No field description in the source contract.

example

result[].prop1

string

Prop1 value

example

result[].prop2

string

Prop2 value

example

result[].prop3

string

Prop3 value

example

result[].prop4

string

Prop4 value

example

result[].prop5

string

Prop5 value

example

result[].prop6

string

Prop6 value

example

result[].prop7

string

Prop7 value

example

result[].prop8

string

Prop8 value

example

Response example

{
  "code": "200",
  "result": [
    {
      "prop1": "example",
      "prop2": "example",
      "prop3": "example",
      "prop4": "example",
      "prop5": "example",
      "prop6": "example",
      "prop7": "example",
      "prop8": "example"
    }
  ]
}

stateful integration

Operate it safely

command

This operation creates or triggers durable state. Supply an idempotency strategy and persist the returned identifier before continuing.

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/v1/custom/dqv-apis.yml
SHA-256: ec78e94e77644b4d9ff44c58916c40813cc7f96798318569b33204ebd94fba04
Normalization: Fields are parsed from OpenAPI. Operational guidance and language samples are generated and labeled separately.
Source record: Open repository audit