Convert mentioned point cloud formats to web-friendly Orbit Point Cloud.

realityconversion

# Reality Conversion API

The *Reality Conversion API* provides the ability to convert reality files such as point clouds from [supported source format](#supportedconversiontypes) to [supported target format](#supportedconversiontypes). Point clouds produced by scanning devices are often stored in large files, in a format that reflects to the way data is captured but that is not ready to be directly consumed interactively in a web viewer. One of the main purposes of such a conversion is to make reality data, when stored in a non-web-friendly format, ready for web consumption.

##Input
One or more reality data containers with correct classification and type, each hosting one or more files.
All files processed in one conversion operation must have the same format.


##Output
One reality data container with the requested type.
Depending on the use of the `merge` option, the output reality data will host only one file (merge), or one per input file (no merge).
In the latter case, if several files from several input containers have the same name, only one of them will be processed in the conversion operation. For instance, if reality data container C1 contains two files, named fileA.las and fileB.las, and reality data container C2 contains one file named fileA.las, the output of conversion of C1 and C2 to OPC without merge will contain only 2 files: fileA.opc and fileB.opc. Only fileA.las from container C2 (last in alphabetical order) will be converted, the other file with the same name will be ignored.
 

##Supported data formats
The table below lists all the formats supported as input or output. Conversions can be run for any combination of one input and one output format.


|  File Format | File Extension  |  Reality Data Type |  Input |  Output |
| :------------: | :---------------: | :----------: | :------------: | :---------------: | 
|  ASTM E57  | .e57 | E57 | * | |
| Laser Exchange Format | .las | LAS | * | |
| LASzip Exchange Format | .laz  | LAZ | * | |
| Polygon File Format | .ply | PLY | * | |
| Orbit Point Cloud | .opc | OPC | | * |
| Cesium 3D Point Cloud | .3dTiles | PNTS | | * |


---

Create a new job to convert point cloud formats to web-friendly Orbit Point Cloud or Cesium 3D Point Cloud. The POST request body MUST include type, name, inputs and outputs.
Accepted input formats for conversion are LAS, LAZ, PLY, E57 and ouput formats are OPC and PNTS.

### Authentication

Requires `Authorization` header with valid Bearer token for scope `realityconversion:modify`.

For more documentation on authorization and how to get access token visit [OAUTH2 Authorization](https://developer.bentley.com/apis/overview/authorization/) page.

---


jobs-create

OAuth access token with scope `realityconversion:modify`

Authorization

Setting to `application/vnd.bentley.itwin-platform.v1+json` is recommended.

Accept

My first RCS job

This response indicates that request lacks valid authentication credentials. Access token might not been provided, issued by the wrong issuer, does not have required scopes or request headers were malformed.

application/json;InvalidAuthorizationScheme

The 422 (Unprocessable Entity) status code indicates that the request cannot be processed by the server due to a client error (e.g. malformed request syntax).

application/json;InvalidRealityConversionRequest

This response indicates that the user has sent too many requests in a given amount of time.

The number of requests exceeds the rate-limit for the client subscription.

retry-after

---

Delete an unsubmitted job. Job will not be deleted once it is in active state.

### Authentication

Requires `Authorization` header with valid Bearer token for scope `realityconversion:modify`.

For more documentation on authorization and how to get access token visit [OAUTH2 Authorization](https://developer.bentley.com/apis/overview/authorization/) page.

---

jobs-delete

Job cannot be deleted once it has been submitted.

---

Retrieve job details.

### Authentication

Requires `Authorization` header with valid Bearer token for scope `realityconversion:read`.

For more documentation on authorization and how to get access token visit [OAUTH2 Authorization](https://developer.bentley.com/apis/overview/authorization/) page.

---


jobs-get

OAuth access token with scope `realityconversion:read`

---

Retrieve job progress.

### Authentication

Requires `Authorization` header with valid Bearer token for scope `realityconversion:read`.

For more documentation on authorization and how to get access token visit [OAUTH2 Authorization](https://developer.bentley.com/apis/overview/authorization/) page.

---

jobs-progress

---

Patch can be used for changing the job state (to active or cancelled), updating job type, inputs , outputs, options or changing cost estimation parameters.

### Authentication

Requires `Authorization` header with valid Bearer token for scope `realityconversion:modify`.

For more documentation on authorization and how to get access token visit [OAUTH2 Authorization](https://developer.bentley.com/apis/overview/authorization/) page.

---
