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

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

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
1
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

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
{
  "x": <x>,
  "y": <y>,
  "z": <z>,
  "spatialReference": {
    <spatialReference>
  }
}

Multipoint syntax

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
  "hasZ": <true|false>,
  "points": [
    [
      <x1>,
      <y1>,
      <z1>
    ],
    [
      <x2>,
      <y2>,
      <z2>
    ]
  ],
  "spatialReference": {
    <spatialReference>
  }
}

Polyline syntax

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
  "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
1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
  "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
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
{
  "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
  }
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.