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

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

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:

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

1
2
3
4
5
6
7
8
{
  "x": <x>,
  "y": <y>,
  "z": <z>,
  "spatialReference": {
    <spatialReference>
  }
}

Multipoint syntax

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

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

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

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.

You can no longer sign into this site. Go to your ArcGIS portal or the ArcGIS Location Platform dashboard to perform management tasks.

Your ArcGIS portal

Create, manage, and access API keys and OAuth 2.0 developer credentials, hosted layers, and data services.

Your ArcGIS Location Platform dashboard

Manage billing, monitor service usage, and access additional resources.

Learn more about these changes in the What's new in Esri Developers June 2024 blog post.

Close