Features
Key Features
Data Streaming

Data Streaming

Asset streaming

When you upload your digital reality datasets to HxDR, automatic pipelines are triggered to make the point cloud and mesh data streamable. This enables you to visualize and analyze the datasets quickly for e.g. in reality Cloud Studio just after the upload.

Use groupedAssetId to query for your asset and retrieve streaming endpoints and service type for your assets. Connect to this endpoint from your application or any standard OGC clients.

  • asset
    • artifactV2
      • contents
        • addresses
          • contents
            • AddressOutput
              • endpoint
 
"addresses": {
  "contents": [
    {
      "__typename": "AddressOgc3DOutput",
      "id": "c470c939-5f23-4e0f-b3d6-b25b1c0807e4",
      "endpoint": "/files/assets/64daf1a3-8d69-4d8c-960d-b5dd006425cc/artifacts/a8e5afbf-4bdc-4dd2-bbae-a9911d8de407/MESH/OGC3D_TILES/tileset.json?signature=NNEYrDgY_FvxhsIJKE2NFt5vc7xmFoo9pmvrwqAf9CR97YJl-fFbuOM27l48Rp52T7SiewTshshWiGWxBws_hIElkEVL_S99Dl4Ng2C3qFXoyxZUrqy2Kcg-3MWxNrWBoDYD1L93Y4Ux6XN2CvaX5XbVf3qFDsiLbfV2BCNsFtAG7iNfsHdIKA65AMkBmu-5vKDt23y7g7ie5YVEANTOB21cTVwJGe_yzwRLwHg5nTa_SozxyOWXbCbrgm8Ec5FxxFi-l1EKseAFB1XZT_BLSvvS_9u6b-rhJEE_bLP5nMpzoYZrYe3KaLc7vzPs1YEzrFS_wQ8l5qdQIdtU3zYhsg1dPjBIY5vFXtYmdwB6OndRFMvb-PIDlJbvSH6ivGfOVE_iWRXuX4Va6xT17c5z0z-LNHANC4WoAmYNkd9-edv5LMN2ITjYwoWobElLTYkbMEpB8Wb5khJB4PnnUdzRS8D8QAqCSKEOz7a_OYyV8saiP5R4XeyovBQ6dGsLExpp2UxCA6lQ56pkToIkAnVn4oou05t-GmYUWPbSgjmVI_W-j4FlP2uis8hztO1oJP4oYJzmclg1I1WJAVzOeB0OfVIs2lB2lvQOAF2_NwXXsQzm3Dzz5axdrLMNN7FSZzD-x0Ys1-pPN_B11llLHRZb1IAMVf5pm26dxOVSiyjeEjStLADMNpBcUqQZOkipQzR7xRcTETnXTyx6Ons-p9WfwA==",
      "label": "a8e5afbf-4bdc-4dd2-bbae-a9911d8de407",
      "consumptionType": "STREAMABLE",
      "serviceType": "OGC_3D_TILES",
      "processingPipelineInfo": {
        "id": "04cd88d7-e2ea-4372-8d05-dc16ba77b9ac",
        "name": "TECHNODIGIT_HSPC_TO_OGC3DTILES",
        "status": "SUCCESS",
        "errors": [],
        "__typename": "ProcessingPipelineInfoOutput"
      },
      "qualityFactor": 1
    }
  ],
  "__typename": "AddressPageOutput"
},

Catalog Streaming

Connect to subscribed endpoints

With an active streaming subscription from HxDR, you get the OGC3DTILES and HSPC (Hexagon smart point cloud) endpoint url along with unique signature(authorization) string which can be used from applications to connect and visualize data sets.

  • Point cloud streaming and download.
  • Meshes streaming and download.

Streaming point clouds and meshes from HxGN datastore in your application

streamingSubscriptions StreamingSubscriptionsUnion! Retrieve the streaming subscription of the given account (ADMIN only) or of the account of the logged-in user.

{
    "data": {
        ""streamingSubscriptions"": {
            "__typename": "StreamingSubscriptionOutput",
            "streamingSubscriptionUuid": "12e21dc7-b326-40f6-b904-e94925ea52bd",
            "userUuid": "f9cbc599-94f9-44b8-b8d4-4eea3fae622b",
            "productCode": "HxGN_Mesh_EU_5.0cm",
            "quadrants": [
                "de-by-munich"
            ],
            "enabled": true,
            "endpoints": [
                {
                    "endpoint": "/catalog/streaming/user/f9cbc599-94f9-44b8-b8d4-4eea3fae622b/account/fc604e29-fac9-4a59-ba3f-c453de6d05bb/StreamingSubscription/12e21dc7-b326-40f6-b904-e94925ea52bd/subscription/12e21dc7-b326-40f6-b904-e94925ea52bd/tileset.json",
                    "endpointType": "OGC_3D_TILES",
                    "quadrantName": "MAIN"
                },
                {
                    "endpoint": "/catalog/streaming/user/f9cbc599-94f9-44b8-b8d4-4eea3fae622b/account/fc604e29-fac9-4a59-ba3f-c453de6d05bb/StreamingSubscription/12e21dc7-b326-40f6-b904-e94925ea52bd/subscription/12e21dc7-b326-40f6-b904-e94925ea52bd/quadrantHash/742a10a7-e100-38c6-b197-a0493f0e7c07/mesh/de-by-munich/allowed/tileset.json",
                    "endpointType": "MESH",
                    "quadrantName": "de-by-munich"
                }
            ],
            "signature": "NNEYrDgY_FvxhsIJKE2NFglIj8Z_81vmpmvrwqAf9CR97YJl-fFbuLsCDRhLdhq9G8CAyLVsegps44266mHFpJ2EIWpGuPOxAATsSNMImm0JhkOCjlVQaTDP6FqL4VQkhHEjW6d2OHZid1LjY1RvJbDacaoELQ4pu3P2NvEml9eJQQLCA2Xjk3HiC3cyCZj0akM-ziKFRvWKZwa1JnVjPJLIpPKTFBRIVrZpxy167HebNcUKITCVersC51_sFjp7niB2gGkhzt-qxSgqUkMY9lhNDE3OiGBJNiqDuP908zH-ms1lTI1T8vIzGG6Gv9XfZfhdOSRpLuntB8Q3jLkeVKhrd8J_oQQ4JeU764rqIYNSaor2MXuw-r26w6nRs4SMJY_Uc6a3JqADE7oy7lwY8UIxN-14tjh9Djr1DLRb_mVJQVf4GGG53szzEhPlVwNGUhpfpzCLCS_aCFoxz-qDmE-M8qZddmiCTquZtMA0v3qYp9bBGcovvT0OzLRIdtmiMwentuJ_Ns0P2THtc8g75OzrxEBSHSwQRYVgYzMcNhO91wVP_u3IL-_jCuBSh456yPK-eLXJd8R_XZVLppVQ0Yw54UDFE40R",
            "volumeInGB": 200,
            "title": "Test Munich Streaming",
            "description": "MunichStreamingSubscription"
        }
    }
}

  • The streaming subscription will generate response based on stream configuration:

  • Steps for accessing streaming subscriptions:

Save the endpoint URL. Save the signature string.

  • To access each quadrant, there are two endpoints:

    • HSPC
    • OGC3DTILES

  • To access all quadrants, one MAIN endpoint is provided:

    • OGC3dTILES (using the subtrees functionality in OGC 3D Tiles).

  • To call the endpoint from your application: Prefix the HxDR hostname

  • Add the signature string as:

    • Header
      https://hxdr.app/catalog/streaming/user/.........../StreamingSubscription//ogc3dtiles/tileset.json
 
  Authorization: Signature N-wsvFQ9zKtOewBM1B6oR0rbZ9j8NF*....
    • HTTP query parameter
      https://hxdr.app/catalog...StreamingSubscription//ogc3dtiles/tileset.json?Authorization=Signature%20N-wsvxyzs...
  • Monitor used volume of subscription in a dashboard under “Data Streaming” tab in “Purchased contents”

Note: The point cloud streaming from HxGN Datastore is currently in beta stage and is being improved. Please reach out to your sales account manager for getting early access to catalog streaming subscriptions.

Related Pages

Assets→Import and Export→OGC Services→

GraphQL API reference

This section lists a few examples. Please refer to HxDR GraphQL Playground (opens in a new tab) to explore complete schema.


Retrieves the specified asset, provided the user has access to it.
query GetAsset {
  getAsset(groupedAssetId: "[groupedAssetId]") {
    id
    assetType
    asset {
      id
      groupedAssetId
      artifactsV2 {
        parentId
        contents {
          id
          groupedAssetId
          addresses {
            parentId
            groupedAssetId
            contents {
              ... on AddressOgc3DOutput {
                id
                endpoint
                type
                serviceType
                consumptionType
                label
                qualityFactor
              }
            }
          }
        }
      }
    }
  }
}

A GroupedAsset is a symbolic link to the underneath Asset and the files connected to it. Every grouped asset gets an ID, when it is created. This groupedAssetId variable is used here to retrieve OGC3DTILES streaming link for the asset.

To successfully execute a request on HxDR GraphQL playground, See following :

Using HxDR GraphQL API→Authentication→Access token→

JS-SDK reference

  • Data Streaming

    Data Streaming services

CollaborationGeotags