====== Access Orbit 3DM Viewer ======

This page describes how to access the Orbit 3DM Viewer for Orbit 3DM Publisher or Orbit 3DM Cloud. \\
For more information on the Orbit 3DM Viewer, see [[237:products:3dm_viewer|]].

===== Open Viewer =====

==== Orbit 3DM Publisher ====

== Saved Publication ==

Access to a single, specific publication: \\
''<nowiki><Orbit 3DM Publisher URL>/publication/<Publication Name></nowiki>''

== Publications Portal ==

Access to the Publications Portal is available for Named Users only. \\
This portal lists all Publications shared with the Login. Publications that do not require a Login are not listed. \\
''<nowiki><Orbit 3DM Publisher Service>/publications/</nowiki>'' \\
''<nowiki><Orbit 3DM Publisher Service>/viewer/</nowiki>''

==== 3DM Cloud ====

== Personal Workspace ==

Access to personal workspace, available for Named Users only: \\
''<nowiki>https://3dmapping.cloud/viewer</nowiki>''

== Saved Publication ==

Access to a single, specific publication: \\
''<nowiki>https://3dmapping.cloud/publication/<token></nowiki>''

== Publications Portal ==

Access to the Publications Portal is available for Named Users only: \\
[[237:viewer:core:viewer_catalog|Viewer > Catalog]] \\
Console > My Catalog > Publications

===== Publication URL query arguments =====

The following arguments can be added to the publication URL. This applies to the 3DM Publisher and 3DM Cloud. 

=== Open Publication by XYZ ===

Open the publication on a specific location and with a specific orientation by adding URL arguments"
  * Required: x, y, crs
  * Optional: z, heading, pan, tilt

Example \\
''<nowiki> https://3dmapping.cloud/publication/<publication name>?x=<value>&y=<value>&crs=<value>&heading=<value>&tilt=<value></nowiki>''

=== Open Publication by PhotoID ===

Clear the opened views and add image view(s) with the photoID in the Publication URL. \\
The resource value is the name of the visible resource of which the image is opened. When this parameter is not defined, the first resource that matches the given photoID will be opened. \\
The photoID value is the photoID of the image(s) to be opened. 

Example \\
''<nowiki> https://3dmapping.cloud/publication/<publication name>?resource=<value>&photoID=<value1>,<value2></nowiki>''

=== Download Snapshot ===

Trigger the direct download of a view by adding the view number to the publication URL. \\
The view value is the number of the view. Use 'reference' to download the snapshot of the reference view.

Example: \\
''<nowiki> https://3dmapping.cloud/publication/<publication name>?snapshot=true&view=<value></nowiki>''