Uploading Tours with JSON Files

What is the JSON file

The JSON file includes information necessary to create a Cupix Virtual tour. The file contains the names of the 360 photos in each section, their locations, orientations, and a list of connected images for each pano. You may already have this spatial information for the 360 photos in certain cases, such as exporting photo-realistically rendered images. When creating a new 3D tour, or when viewing old tours with the Cupix web app, you can upload a set of photos with the associated JSON file. The Cupix web app will use information from the JSON file to automatically align the photos without using manual inputs or algorithms to calculate photo positions. The JSON file helps create the 3D tour much more quickly than if only photos were uploaded.

Details about the JSON format

• To use a JSON file, each tour must have more than one section, and each section must have more than one 360 photo (pano).

• All 360 photos in the tour must have unique names, and they can only belong to one section. All file names must be in ASCII.

• The connection information of each pano is defined by the names of other connected photos. This includes any connected panos from other sections.

• The connection information of panos should be mutually registered between connected panos. For example, if the connection information of pano A includes pano B, the connection information of pano B must also include pano A.

• The transformation_matrix is a 4x4 matrix representing the location and orientation of each pano in the global coordinate system. The locations of each pano can be in units of m, cm, mm, in, ft, yd, and mile.

• The software is currently on version 1.0.

• “Tour_name” and “section_name” can be 255 bytes long in ASCII or UNICODE. The “floor_height” represents section elevation of each section in global coordinate system.

Sample JSON data

 {
    "format": "Cupix 3D Tour Structure", 
    "tour_name": "BlackStone 3 Photos - 8/3/2018, 5:23:31 PM", 
    "unit": "meter", 
    "version": [
        1, 
        0
    ], 
    "sections": [
        {
            "panoramas": [
                {
                    "connections": [
                        "R360_(7) A.JPG", 
                        "R360_(8) A.JPG"
                    ], 
                    "file_name": "R360_(6) A.JPG", 
                    "transformation_matrix": [
                        -0.9751261046125089, 
                        0.05537820172414033, 
                        0.2146213756293497, 
                        0.06918879776532715, 
                        0.20400683839957906, 
                        -0.1543481831903705, 
                        0.9667253220186381, 
                        0.8029864153577804, 
                        0.08666192929679087, 
                        0.9864633257854204, 
                        0.13921141077844798, 
                        1.529911294553305, 
                        0, 
                        0, 
                        0, 
                        1
                    ]
                }, 
                {
                    "connections": [
                        "R360_(6) A.JPG", 
                        "R360_(8) A.JPG"
                    ], 
                    "file_name": "R360_(7) A.JPG", 
                    "transformation_matrix": [
                        -0.8357839310058041, 
                        0.02474755425253168, 
                        -0.5485004824346131, 
                        0.5285489098895007, 
                        -0.5456044405591157, 
                        -0.14931188678105667, 
                        0.8246343158685889, 
                        -0.5126317673734498, 
                        -0.06148995946217466, 
                        0.9884804090240733, 
                        0.13829485117292406, 
                        1.272607730847493, 
                        0, 
                        0, 
                        0, 
                        1
                    ]
                }, 
                {
                    "connections": [
                        "R360_(6) A.JPG", 
                        "R360_(7) A.JPG"
                    ], 
                    "file_name": "R360_(8) A.JPG", 
                    "transformation_matrix": [
                        -0.5277222005058098, 
                        0.0959332143722708, 
                        0.8439822850472096, 
                        -0.5977377076548279, 
                        0.8312007427600614, 
                        -0.14634792900481336, 
                        0.5363651824187735, 
                        -0.29035464798433047, 
                        0.17497029556021165, 
                        0.9845705165483097, 
                        -0.00250870790770354, 
                        1.397480974599202, 
                        0, 
                        0, 
                        0, 
                        1
                    ]
                }
            ], 
            "section_name": "Section1", 
            "transformation_matrix": [
                1, 
                0, 
                0, 
                0, 
                0, 
                1, 
                0, 
                0, 
                0, 
                0, 
                1, 
                0, 
                0, 
                0, 
                0, 
                1
            ]
        }
    ]
}