GET Performs geometric operations.

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

GEThttps://mgis-apiv2.mappls.com/dqv/geometricFunction?functionNme=area

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

Authenticationbearer

Journey roleobserve

Content typesNo request body

Path, query, and headers

Parameters

NameLocationTypeDescriptionExample

functionNmerequired

querystring

Geometric operators which are acceptable are: For user defined geometry: intersection, area, buffer, distance, centroid, isEmpty, length and endPoint For within the dataset: area, buffer, centroid, isEmpty, length and endPoint

area

datasetNme

querystring

The dataset on which geometric operation has to be performed. It is mandatory in case of performing geometric operations within the datset.

geo

userGeom

querystring

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

true

geom1

querystring

user defined geometry in terms of geoJSON. It is mandatory in case of user-defined geometry for all the geometric opertaions.

{
"type": "Polygon",
"coordinates": [
[
[
75.9375,
23.725011735951796
],
[
78.92578124999999,
23.725011735951796
],
[
78.92578124999999,
26.115985925333536
],
[
75.9375,
26.115985925333536
],
[
75.9375,
23.725011735951796
]
]
]
}

geom2

querystring

user defined geometry in terms of geoJSON. It is mandatory in case of user-defined geometry for distance and intersection geometric opertaions.

{ "type": "Polygon", "coordinates": [ [ [ 75.9375, 23.725011735951796 ], [ 78.92578124999999, 23.725011735951796 ], [ 78.92578124999999, 26.115985925333536 ], [ 75.9375, 26.115985925333536 ], [ 75.9375, 23.725011735951796 ] ] ] }

distance

querynumber

Mandatory in case when opertaor used is Buffer, else it is not required.

10

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

6 editable · 0 protected

functionNmerequiredqueryGeometric operators which are acceptable are: For user defined geometry: intersection, area, buffer, distance, centroid, isEmpty, length and endPoint For within the dataset: area, buffer, centroid, isEmpty, length and endPointdatasetNmequeryThe dataset on which geometric operation has to be performed. It is mandatory in case of performing geometric operations within the datset.userGeomqueryValue of UserGeom will be 'true' if user wants to perform geometric operations with user-defined geometry.geom1queryuser defined geometry in terms of geoJSON. It is mandatory in case of user-defined geometry for all the geometric opertaions.geom2queryuser defined geometry in terms of geoJSON. It is mandatory in case of user-defined geometry for distance and intersection geometric opertaions.distancequeryMandatory in case when opertaor used is Buffer, else it is not required.

Generated in eight languages

Environment-backed credentials

GET

https://mgis-apiv2.mappls.com/dqv/geometricFunction?functionNme=area&datasetNme=geo&userGeom=true&geom1=%7B%0A%22type%22%3A+%22Polygon%22%2C%0A%22coordinates%22%3A+%5B%0A%5B%0A%5B%0A75.9375%2C%0A23.725011735951796%0A%5D%2C%0A%5B%0A78.92578124999999%2C%0A23.725011735951796%0A%5D%2C%0A%5B%0A78.92578124999999%2C%0A26.115985925333536%0A%5D%2C%0A%5B%0A75.9375%2C%0A26.115985925333536%0A%5D%2C%0A%5B%0A75.9375%2C%0A23.725011735951796%0A%5D%0A%5D%0A%5D%0A%7D&geom2=%7B+%22type%22%3A+%22Polygon%22%2C+%22coordinates%22%3A+%5B+%5B+%5B+75.9375%2C+23.725011735951796+%5D%2C+%5B+78.92578124999999%2C+23.725011735951796+%5D%2C+%5B+78.92578124999999%2C+26.115985925333536+%5D%2C+%5B+75.9375%2C+26.115985925333536+%5D%2C+%5B+75.9375%2C+23.725011735951796+%5D+%5D+%5D+%7D&distance=10

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/dqv/geometricFunction?functionNme=area&datasetNme=geo&userGeom=true&geom1=%7B%0A%22type%22%3A+%22Polygon%22%2C%0A%22coordinates%22%3A+%5B%0A%5B%0A%5B%0A75.9375%2C%0A23.725011735951796%0A%5D%2C%0A%5B%0A78.92578124999999%2C%0A23.725011735951796%0A%5D%2C%0A%5B%0A78.92578124999999%2C%0A26.115985925333536%0A%5D%2C%0A%5B%0A75.9375%2C%0A26.115985925333536%0A%5D%2C%0A%5B%0A75.9375%2C%0A23.725011735951796%0A%5D%0A%5D%0A%5D%0A%7D&geom2=%7B+%22type%22%3A+%22Polygon%22%2C+%22coordinates%22%3A+%5B+%5B+%5B+75.9375%2C+23.725011735951796+%5D%2C+%5B+78.92578124999999%2C+23.725011735951796+%5D%2C+%5B+78.92578124999999%2C+26.115985925333536+%5D%2C+%5B+75.9375%2C+26.115985925333536+%5D%2C+%5B+75.9375%2C+23.725011735951796+%5D+%5D+%5D+%7D&distance=10' \
  --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 /dqv/geometricFunction

curl --request GET \
  --url 'https://mgis-apiv2.mappls.com/dqv/geometricFunction?functionNme=area' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Success and failure behavior

Responses

200

206

Impartial Content.

400

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

404

No data found in database.

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.

true

data

array<object>

No field description in the source contract.

example

data[].area

number

value of area after spatial operation

0.2670491076815

Response example

{
  "code": "200",
  "success": true,
  "message": true,
  "data": [
    {
      "area": "0.2670491076815"
    }
  ]
}

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