AdminConsole
API reference/mGIS Analytics
POSTstatefulexact public snapshot

Fetches the results of the query applied on the single dataset. You cannot pass query, summerizeValue and uniqueValue paramater together.

/dqv/query_apply/single

You cannot pass query, summerizeValue and uniqueValue paramater together. You can perform 'order(sort) By' and 'groupBy' in 'query'. This has 3 cases: Only Order By Only Group By Both Order By and Group By together You can perform geometric operation (area and length) when queryType = 'functionBased' is passed. The query parameter is an optional paramater in this case. summerizeValue and uniqueValue paramater are not applicable in this case.

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.

Request target

Call the operation

POSThttps://mgis-apiv2.mappls.com/dqv/query_apply/single?datasetNme=india
Base URLhttps://mgis-apiv2.mappls.com/
Authenticationbearer
Journey rolecommand
Content typesNo request body
Path, query, and headers

Parameters

NameLocationTypeDescriptionExample
datasetNmerequired
querystring

The dataset name of whose information has to be fetched.

india
queryType
querystring

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

functionBased
query
querystring

Query to be applied on the dataset. Mandatory if uniqueValue, summerizeValue and queryType parameter is not passed. This is an optional paramter when queryType = 'functionBased' is passed.

state = 'Delhi'
uniqueValue
querystring

Unique values of a attribute of the dataset. Mandatory if query and summerizeValue parameter is not passed.

st_name
summerizeValue
querystring

Summerize values of a attribute of the dataset. Mandatory if query and uniqueValue parameter is not passed.

st_name
groupBy
querystring

Pass ‘true’ to perform groupBy on the datsetNme. Applicable for 'query'. 'propertyName' paramter is mandatory for 'groupBy' parameter.

true
propertyName
querystring

Pass the column names list which you want to display in the resultant. Optional in case of order(sortBy). Mandatory in case of 'groupBy'.

street,poi
sortBy
querystring

Pass ‘A' for ascending and ‘D’ for descending to perform order(sort) By. Applicable for all. Mandatory when order(sort) By is to be performed.

A
sortByProperty
querystring

Pass the column names which the user wants to order(sort) By in the resultant. Applicable for 'query'. Mandatory when order(sort) By is to be performed.

poi,street
propertyName
querystring

Property attributes to be reflected in the result. If not passed all the columns of the datasetNme will be displayed in the resultant.

housenumber
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
saveAsNewDataset
querystring

Pass ‘true’ for the resultant to be saved in to user's workspace as a new table. Applicable for only queryType = 'functionBased

true
newDatasetNme
querystring

Name of the table in which the resultant has to be stored. This parameter is mandatory if saveAsNewDataset = true. Applicable for only queryType = 'functionBased'

geotest
sortBy
querystring

Sort the result in ascending(A) or descending(D) order. Applicable for 'orderBy', 'groupBy', 'uniqueValue' and 'summerizeValue'.

A
startIndex
querynumber

To set the start index from which the user wants the result to be displayed. Applicable for 'query', 'uniqueValue' and 'summerizeValue'.

1
count
querynumber

To fix the number of results to be returned. Applicable for 'query', 'uniqueValue' and 'summerizeValue'.

3
bbox
querystring

Returns the bounding box of the dataset if set as true.

false
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
19 editable · 0 protected
Generated in eight languages
Environment-backed credentials
POSThttps://mgis-apiv2.mappls.com/dqv/query_apply/single?datasetNme=india&queryType=functionBased&query=state+%3D+%27Delhi%27&uniqueValue=st_name&summerizeValue=st_name&groupBy=true&propertyName=housenumber&sortBy=A&sortByProperty=poi%2Cstreet&comparisonFunction=Area&comparisonOperator=%3D&comparisonValue=10&saveAsNewDataset=true&newDatasetNme=geotest&startIndex=1&count=3&bbox=false
Credential-free sandboxExecute this contract without a provider call
How fixtures work
Generated from your inputs
curl --request POST \
  --url 'https://mgis-apiv2.mappls.com/dqv/query_apply/single?datasetNme=india&queryType=functionBased&query=state+%3D+%27Delhi%27&uniqueValue=st_name&summerizeValue=st_name&groupBy=true&propertyName=housenumber&sortBy=A&sortByProperty=poi%2Cstreet&comparisonFunction=Area&comparisonOperator=%3D&comparisonValue=10&saveAsNewDataset=true&newDatasetNme=geotest&startIndex=1&count=3&bbox=false' \
  --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.

POST /dqv/query_apply/single
curl --request POST \
  --url 'https://mgis-apiv2.mappls.com/dqv/query_apply/single?datasetNme=india' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'
Success and failure behavior

Responses

200

OK

206

Impartial Content.

400

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

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
success
string

No field description in the source contract.

true
message
string

No field description in the source contract.

—
data
object

No field description in the source contract.

example
data.type
string

No field description in the source contract.

FeatureCollection
data.features
array<object>

No field description in the source contract.

example
data.features[].type
string

No field description in the source contract.

Feature
data.features[].id
string

No field description in the source contract.

india.2
data.features[].geometry
string

No field description in the source contract.

28.612964,77.229463
data.features[].properties
object

No field description in the source contract.

example
data.features[].properties.st_name
string

No field description in the source contract.

Andhra Pradesh
data.totalFeatures
number

No field description in the source contract.

1
data.numberMatched
number

No field description in the source contract.

1
data.numberReturned
number

No field description in the source contract.

1
data.timestamp
string

No field description in the source contract.

1700000000000
data.crs
string

No field description in the source contract.

null
data.layerBounds
string

No field description in the source contract.

null
Response example
{
  "code": "200",
  "success": true,
  "message": "",
  "data": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "id": " india.2",
        "geometry": "null",
        "properties": {
          "st_name": "Andhra Pradesh"
        }
      }
    ],
    "totalFeatures": 1,
    "numberMatched": 1,
    "numberReturned": 1,
    "timestamp": "2020-08-10T13:59:51.624Z",
    "crs": "null",
    "layerBounds": "null"
  }
}
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/v2/custom/dqv-apis.yml
SHA-256
391a57c02f461cd4b27fba7b0ef8f838096a4cc16680bb2c6df225fbcf1fe427
Normalization
Fields are parsed from OpenAPI. Operational guidance and language samples are generated and labeled separately.