POST Returns the array of features which contains objects of geometry of the uploaded image.

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/ai_ml/imageSegmentation

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

Authenticationbearer

Journey rolecommand

Content typesmultipart/form-data

Path, query, and headers

Parameters

NameLocationTypeDescriptionExample

No explicit parameters are declared by the source operation.

Request body

Body schema

FieldTypeDescriptionExample

filerequired

string

Image file in .tiff or .jpg or .png. formats

example

geotagrequired

string

Case1 - Will be 0 for .jpeg, .jpg and .png images without bounds and will return geoJson reponse in pixels. Case2- Will be 1 for .tiff and .tif images without bounds and will return geoJson reponse in pixels. Case3-Will be 2 for .jpg, .jpeg and .png images with bounds and returns geoJson response.

example

featureNmerequired

string

Can be either FP, RD, SOIL, VEG and WATER.

example

bounds

object

will be an object containing south-west and north-east corner of the image uploaded. Bounds is mandatory in case when geotag value is 2 and is not required in case when geotag value is 0 and 1.

example

imageType

string

type of image i.e. google or bhuwan.

example

scale

integer

integer value which should greater than 0.

1

Request body example

{
  "file": "example",
  "geotag": "example",
  "featureNme": "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

Generated in eight languages

Environment-backed credentials

POSThttps://mgis-apiv2.mappls.com/ai_ml/imageSegmentation

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/ai_ml/imageSegmentation' \
  --header "Accept: application/json" \
  --header "Authorization: Bearer ${MAPPLS_ACCESS_TOKEN}" \
  --header "Content-Type: multipart/form-data" \
  --data-raw '{"file":"example","geotag":"example","featureNme":"example"}'

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 /ai_ml/imageSegmentation

curl --request POST \
  --url 'https://mgis-apiv2.mappls.com/ai_ml/imageSegmentation' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "file": "example",
  "geotag": "example",
  "featureNme": "example"
}'

Success and failure behavior

Responses

200

400

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

500

Internal server error.

200 response fields

FieldTypeDescriptionExample

Features

array<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.coordinates

array<string>

No field description in the source contract.

28.612964,77.229463

Response example

{
  "Features": [
    {
      "geometry": {
        "coordinates": []
      }
    }
  ]
}

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