Image To Map Multiray

URL:: https://<imageservice-url>/imageToMapMultiray
Methods:: GET
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

Parameter	Details
`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 Use dark colors for code blocksCopy 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 //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 Use dark colors for code blocksCopy `1 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:

Use dark colors for code blocksCopy
https://organization.example.com/<context>/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

Use dark colors for code blocksCopy
{
  "x": <x>,
  "y": <y>,
  "z": <z>,
  "spatialReference": {
    <spatialReference>
  }
}

Multipoint syntax

Use dark colors for code blocksCopy
{
  "hasZ": <true|false>,
  "points": [
    [
      <x1>,
      <y1>,
      <z1>
    ],
    [
      <x2>,
      <y2>,
      <z2>
    ]
  ],
  "spatialReference": {
    <spatialReference>
  }
}

Polyline syntax

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

Polygon syntax

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

JSON Response example

Use dark colors for code blocksCopy
{
  "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
  }
}