Skip To Content

Image To Map Multiray

  • URL:https:// <imageservice-url> /imageToMapMultiray
  • Required Capability:Catalog
  • Version Introduced:11.2

Description

The imageToMapMultiray operation computes a 3D geometry in a map from multiple image space geometries on multiple corresponding raster items of one same object. For example, a house shows up in several raster items. Users may specify the house location on each image using the geometries parameter. In the rasterIds parameter, specify the rasterIds of the images in the same order. Then the imageToMapMultiray operation will find the house location in the map space.

Request parameters

ParameterDetails
geometries

The array of geometries for the same object in each raster item (use image space coordinates). The structure of each geometry in the array is the same as the structure of the JSON geometry objects.

Examples


//Example one
geometries={
  "geometries": [
    {
      "x": 110.99999871311138,
      "y": -222.00000275354887
    },
    {
      "x": 149.88271993130002,
      "y": -1332.124490085996
    },
    {
      "x": 212.3135059459787,
      "y": -2405.780743590703
    }
  ],
  "geometryType": "esriGeometryPoint"
}

//Example two
geometries={
  "geometries": [
    {
      "rings": [
        [
          [
            407.18848443657043,
            -47.53429040903461,
            632.83443
          ],
          [
            4073.1899990601496,
            -478.534976572578,
            632.83443
          ],
          [
            404.19004220650277,
            -477.52214124464854,
            632.83443
          ],
          [
            407.18848443657043,
            -47.53429040903461,
            632.83443
          ]
        ]
      ]
    },
    {
      "rings": [
        [
          [
            435.4416439257707,
            -1154.9573799256277,
            632.83443
          ],
          [
            4064.897144450215,
            -1581.4135131905628,
            632.83443
          ],
          [
            435.43320639918966,
            -1580.4688456028869,
            632.83443
          ],
          [
            435.4416439257707,
            -1154.9573799256277,
            632.83443
          ]
        ]
      ]
    }
  ],
  "geometryType": "esriGeometryPolygon"
}
rasterIds

Specifies the objectIds of the raster items. The order needs to match the geometries parameter.

Example

rasterIds=1,2
outSR

(optional)

The spatial reference of the output geometry. The spatial reference can be specified as either as well-known ID or as a spatial reference JSON object.

f

(optional)

The response format. The default response format is html.

Values: html | json | pjson

Example usage

The following is a sample request URL for the imageToMapMultiray operation:

https://machine.domain.com/webadaptor/rest/services/imageinspection/ImageServer/imageToMapMultiray?geometries={"geometries":[{"rings":[[[407.18848443657043,-47.53429040903461,632.83443],[4073.1899990601496,-478.534976572578,632.83443],[404.19004220650277,-477.52214124464854,632.83443],[407.18848443657043,-47.53429040903461,632.83443]]]},{"rings":[[[435.4416439257707,-1154.9573799256277,632.83443],[4064.897144450215,-1581.4135131905628,632.83443],[435.43320639918966,-1580.4688456028869,632.83443],[435.4416439257707,-1154.9573799256277,632.83443]]]}],"geometryType":"esriGeometryPolygon"}&rasterIds=1,2&outSR=&f=html

JSON Response syntax

Point syntax


{
  "x": <x>,
  "y": <y>,
  "z": <z>, 
  "spatialReference": {
    <spatialReference>
  }
}

Multipoint syntax


{  
  "hasZ": <true|false>,
  "points": [
    [
      <x1>,
      <y1>,
      <z1>
    ],
    [
      <x2>,
      <y2>,
      <z2>
    ]
  ], 
  "spatialReference": {
    <spatialReference>
  }
}

Polyline syntax


{
  "hasZ": <true|false>,
  "paths": [
    [
      [<x11>, <y11>, <z11>],
      [<x1N>, <y1N>, <z1N>]
    ],
    [
      [<xk1>, <yk1>, <zk1>],
      [<xkM>, <ykM>, <zkM>]
    ]
  ],
  "spatialReference": {<spatialReference>}
}

Polygon syntax


{
  "hasZ": <true | false>,
  "rings": [
    [
      [<x11>, <y11>, <z11>],
      [<x1N>, <y1N>, <z1N>]
    ],
    [
      [<xk1>, <yk1>, <zk1>],
      [<xkM>, <ykM>, <zkM>]
    ]
  ],
  "spatialReference": {<spatialReference>}
}

JSON Response example


{
  "hasZ": true,
  "rings": [
    [
      [
        491401.54924809793,
        3762933.304103659,
        726.4049935976818
      ],
      [
        491315.3563173413,
        3762950.815125823,
        722.4229142777622
      ],
      [
        491316.3635633588,
        3762950.6344630867,
        722.4680534284562
      ],
      [
        491315.3563173413,
        3762950.815125823,
        722.4229142777622
      ],
      [
        491401.54924809793,
        3762933.304103659,
        726.4049935976818
      ]
    ]
  ],
  "spatialReference": {
    "wkid": 32611,
    "latestWkid": 32611
  }
}