360 Private Publisher
Manual for release 1.0.10
Download the Manual as a pdf.
Free Testing
360 Private Publisher is available as a free download for testing for a week.
Test it with your own recordings. Or give the provided test-data a try.
For the most thorough evaluation with all the features enabled get the 30-Days version.
Downloads
All downloads are available on this page:
https://www.360camsters.com/downloads/
What’s New?
Highlights
Other changes
Added features
- License: Page streamlined
- Export: Page cleaned up
- Import: Mass-import of many 360 video files at once.
- Import: A new recording now can be added directly to an existing project.
- General cleanup of the Graphical User interface (GUI)
Fixes
- Log: Clearer error message for when there is no disc space left.
- Streetview capture date was off by one month for some cameras.
Versions
Evaluation
Free for one week. Download.
Advantages
- One-click-publishing to the Amazon cloud works out-of-the-box.No setup at all required.
Limitations
- Watermarks on the streetviews.
- Watermark on the player.
- 360camsters player license only.
- Amazon cloud: “Frankfurt” AWS region only.
Subscription plans
Monthly Subscription, Annual Subscription
One-time payments
30-Day, 1-Year
Raise your data treasure!
Modern businesses need to know what’s going on at their facilities, plants and infrastructure at any time.
And there is a saying that a picture is worth a thousand words.
How about a million panoramas plus the “what, where and when” available to you at a single mouse click?
360 Private Publisher is the perfect way to raise your data treasure.
Turning your 360 recordings into data you can actually work with and gain knowledge.
Have a look at the Gallery.
Services
Consulting, Customisation & Integration
Data Processing and Data Management
Mr. Jan Mantkowski
Streetview Technology GmbH
Pittlerstrasse 53
63225 Langen (Hessen)
Germany
Phone: +49 (0)6103-3727494
WhatsApp: 4915124082072
Skype: live:.cid.c3c494532fd327d4
Email: info@360camsters.com
Website: www.360camsters.com
Webpage: Contact
Main Features
360 Private Publisher is a Mobile Mapping application to manage your 360 recordings and to convert them into a performant streetview player capable of displaying millions of streetviews.
The resulting streetview player can be deployed in many ways:
- Windows 10 or Windows 11 (Locally on your PC.)
- Windows Server
- Any webserver. E.g. Apache, NGINX, IIS. With shared or dedicated hosting.
- Any cloud. E.g. Amazon AWS, Google Cloud, Microsoft Azure.
For Amazon AWS there is an easy one-click-publishing function.
Also 360 Private Publisher itself can be installed to a server or a cloud too.
Then operate it by Remote Desktop Connection (RDP).
Features
- Privacy
Perfect privacy by local installation, processing and internal publishing.
Alternatively you have the option to run the program in a cloud.
- PublishingTo your own PC, servers, shared or dedicated hosting, Amazon AWS, Google cloud, Azure cloud, as well as to literally any internet server.There is no obligation to publish to the public.
- Project Size
For country-size projects with millions of streetviews.
- Timeline
Record the same area again and again. See the changes.
- EmbeddingControl the player by javascript in any web-page.
- Versatile
Mix recordings from many different recordings. Even different cameras from different brands.
- LocalisationAdd your own translations to the player in addition to the four default languages: English, Spanish, German, Arabic, Greek.
- MapPick one of 30 map-providers or use your own maps or aerial images.
- Mapbox
Use your Mapbox maps for the player.
Publishing
The player has been designed for very large projects with millions of streetviews.
There are only static files. Not even php. For this there is no need for complicated load balancing etc. Publishing the player to a server or cloud is sufficient.
Cloud
Publishing to the Amazon cloud is up to 80% cheaper than a player hosted in a conventional datacenter. Also there is virtually no maintenance when publishing to a cloud.
It has never been easier to prepare for your 15 minutes of internet fame.
Just add CloudFront as a CDN to your player. You even can create a custom URL for your own domain.
Cloud Evaluation
For evaluation one-click-publishing to the Amazon cloud works out-of-the-box. No setup needed.
Just pick a project and publish your first player right away.
For the Evaluation version the publishing Regions are limited to EU-Frankfurt.
After purchase and switching to your own Amazon AWS account all other AWS Regions will be available to you.
Please notice players published to our AWS account during evaluation can not be transferred to your own AWS account later. You have to upload all the data again.
All players from the Evaluation version will be deleted after 4 weeks.
FTP
The built-in one-click publishing feature for AWS is just for your convenience.
Of course you can upload the player manually to any cloud or server instead.
E.g. by ftp.
Hardware
360 Private Publisher can be installed to a Windows 10 PC or Windows 11 PC or to the Google Cloud, Amazon Web Services EC2 or Microsoft Azure.
PC
Windows 10 PC or Windows 11 PC
For a local installation the minimum requirement is a Windows 10 or 11 PC with one of the following NVIDIA graphics cards.
Recommended NVIDIA graphic cards for Windows 10 PC or Windows 11 PC
RTX 3050, RTX 3060 Ti, RTX 3060, RTX 3070 Ti, RTX 3070, RTX 3080 Ti, RTX 3080, RTX 3090 Ti, RTX 3090.
Relevant for the performance is the graphic card’s amount of VRAM.
The more VRAM, the faster the processing.
Minimum is 4GB of VRAM.
Cards we use ourselves
RTX 3050, 6GB
RTX 2060, 8GB
GTX 1080, 8GB
GTX 1650, 4 GB (Slower. No internal power cable is needed. Great for older PCs.)
Our customers reported this card to work:
RTX 2080
The following cards should work too:
RTX 3050, RTX 3060 Ti, RTX 3060, RTX 3070 Ti, RTX 3070, RTX 3080 Ti, RTX 3080, RTX 3090 Ti, RTX 3090.
RTX 2080 Ti, RTX 2080 Super, RTX 2080
RTX 2070 Super, RTX 2070
RTX 2060 Super, RTX 2060
GTX 1660 Ti, GTX 1660 Super, GTX 1660
GTX 1650 Super, GTX 1650
All other graphic cards (even “better” ones) are not supported!
CUDA
During the installation CUDA 11 is installed automatically.
Cloud
The 360 Private Publisher program itself can be installed to a cloud.
You then can operate it by Remote Desktop Connection (RDP).
We tested Google Cloud, Amazon Web Services EC2 and Microsoft Azure.
Setup
Folders
It is strongly recommended to create the following folders to organize your data.
Mandatory folders
Manually create these folders: In, Out, Backups.
Then set the folders up in Preferences -> Folders.
Recommended folders
Manually create these folders to keep your data organized.
Masks, Logos, Export, Player templates.
Performance
Import
Insta360 Pro 2:
Approximately 720.000 streetviews/day.
The actual performance depends on your hardware and setup.
Export
With a NVIDIA graphics card with 8 GB VRAM you should get a performance of about Approximately 240.000 streetviews and streetview-tiles per day.
The actual performance depends on your hardware and setup.
For best performance we recommend different drives for the in and out folders.
SSDs will be the fastest. Followed by HDDs.
Technically NAS works fine. However, depending on your network, it can be very slow.
Windows Virus and Thread protection
We strongly recommend adding the following exclusions to Microsoft Windows Virus and Thread protection.
This can speed up processing by 300%.
Please deactivate any third-party virus scanners.
Or apply the above settings correspondingly.
Workflow
Just follow the menu from the top to the bottom.
Skip menu items you do not need.
Go back and forth to make adjustments.
Project size
For quick results start familiarizing yourself with a small project!
This way alterations can be processed real fast.
Data Management
Menu: Import
New recordings always must be imported first.
For country-size projects we recommend processing the data in smaller, separate projects. Have separate projects for e.g. cities, counties, states, etc.
Process each. Before publishing combine the resulting players with Menu: Tools -> Merge Players.
This does not change the individual projects and their players.
It just creates a new, combined, player with all the data.
Import
In Menu: Import pick your camera or data-format and import your footage.
Multiple 360 videos can be imported at once.
Folders and their subfolders can be imported at once.
In case you have no data yet, try our test-data.
You can start a new project, or add the imported recording(s) to an already existing project.
Supported Cameras
Mosaic X
Mosaix 51
Insta360 PRO 2
Expected data format: A single .mp4 video file from the Insta360 Stitcher program.
Labpano Pilot One EE
Expected data format: A single .mp4 video file from the camera.
FLIR Ladybug 5+
A folder with equirectangular .jpg files with metadata.
Supported Data formats
HERE
A folder with equirectangular .jpg files with metadata.
Mapillary
A folder with equirectangular .jpg files with metadata.
Equirectangular
A folder (and subfolders) with equirectangular .jpg files with EXIF metadata.
Add my Camera
In case your camera is not supported yet:
1) Please try the already available Import options. One might just work.
2) In case not, please use the Import -> Add my Camera form.
Projects
The list of all your projects.
Click a project to open it. The Tours tab will open.
Import Backups
Import one or many project backups.
Project backup files to be found in the /out/Backups folder.
Or the /Out/projectname/backups folder.
This is only for this program’s data.
Sources or generated data is never part of a backup.
In case a backup is from another PC, paths then can be adjusted on the Tours tab.
Backup All
Backup all your projects with just one mouse click.
This is only for this program’s data. Sources or generated data is never part of a backup.
Additionally you can Edit, Backup or Delete a single project.
This is only for this program’s data. Sources or generated data is never part of a backup.
This program can not change or delete your source data.
It is best practice to always have an up-to-date backup of your data and the project backups on a disconnected drive.
If the drive is connected to your network and powered up it is just a copy, not a backup.
Tours
A list of all the tours of a Project.
The project’s tours can be from different cameras, even different camera brands.
Show on map
Click All or a tour to open the Map tab.
Import Backup
Import a tour backup. One or many tour backups can be imported at the same time.
Change Folder
When migrating backups from one PC to another or when the project’s in folder has been moved: Select all the tours and click the CHANGE FOLDER button. Then set the path to the new in folder.
If the project has e.g. additional tours that have been moved or copied from a different project, the tick those new tours individually and Click CHANGE FOLDER button.
Move
Move selected tours to a different project.
Copy
Copy selected tours to a different project.
Backup
Backup selected tours.
This is only for this program’s data. Sources or generated data is never part of a backup.
Delete
Deletes the selected tours from the project in this program.
This program can not change or delete your source data.
You should consider doing a backup first. Just in case.
Map
In order to display a large amount of streetviews on the map, streetviews are clustered together, depending on the map zoom level.
A cluster is basically a collection of streetviews.
Clusters are displayed for zoom levels 0 to 19 only. Zoom levels 20 , 21 etc. always show all streetviews individually.
Change map base layer
Click the
button in the top left corner to change the map base layer.
Esri.WorldImagery is the default. Select a different provider from the list. Or provide your own custom map tiles by clicking the
button.
Custom map tiles
The slippy map tiles format is supported with both Google/Bing/OSM tile coordinates and TMS.
Also works with Mapbox.com raster data.
See the Mapbox chapter for the URL format.
Label
Your custom tiles provider name
URL
The URL can point to an online resource:
Change the bold parts of the address.
http://www.your-company.com/map-tiles/{z}/{x}/{y}.png
Local
A local folder or NAS drive:
Change the bold parts of the address.
file://D:folder{z}{x}{y}.png
{z} is the zoom level, and {x} and {y} are the coordinates of the top left corner of the tile in web mercator projection. For the TMS format use the {–y} placeholder.
Attribution
Copyright information displayed at the bottom of the map.
Mapbox
Check the Mapbox section for instructions.
Display
Show or hide icons for active and deactivated streetviews.
Usually more footage than needed is recorded.
The Duplicate Remover and the Skip tool as well as manual deactivation on the map page can be used to reduce the number of streetviews to be published.
Activated streetviews have a white outline.
Deactivated streetviews have a gray outline.
Tours
Show the selected tours on the map.
Click a tour to zoom to it.
Click ALL to center the map on all the tours.
Untick to hide all tours. Then tick selected tours to show only them.
Timeline
Only available when timelines have been created.
Show the selected timelines on the map.
Click ALL to center on all the timelines.
Untick to hide all timelines. Then tick selected timelines to show only them.
Select streetviews
Most of the actions like activate/deactivate, move, rotate, assign a road name or POI are performed on one or many selected streetviews.
Click a streetview to select it. A selected streetview will change its color to orange.
It’s possible to select multiple streetviews by holding down the CTRL key when clicking on the streetviews.
Holding down the SHIFT key and then drag the mouse to select all the streetviews in a rectangle.
To select all the streetviews from first to last and everything in between, select the first streetview, then while holding down the ALT key, select the last one streetview.
To deselect click anywhere on the map or press the ESC key.
Deactivate and Activate
Select the streetviews.
To deactivate selected streetviews click the DEACTIVATE STREETVIEWS button.
To activate selected streetviews click the ACTIVATE STREETVIEWS button.
Meta Data
Displays the metadata for a selected streetview.
This panel will only be shown if a single streetview is selected.
It is not available for clusters. Zoom in more to see individual stretviews.
Road
Enable Show Road on Map to display the road name as a label for each streetview.
Select all streetviews with the same road name
Select and zoom to a specific road by selecting it from the list in the panel.
Assign a road name to a streetview(s)
Select streetviews on the map to assign a road name to them.
Type the name of the road in the text box and click the UPDATE STREETVIEWS button.
POI
Enable Show POI on Map to display the POI name as a label for each streetview.
Select all streetviews with the same POI name
Select and zoom to a specific POI by selecting it from the list.
Assign a POI name to streetview(s)
Select streetviews to assign a POI to.
Type the name of the POI in the text box and click the UPDATE STREETVIEWS button.
If a single streetview is selected, a POI of type point will be assigned the new name.
If multiple streetviews are selected, a POI of type line will be assigned the new name.
Overlay
Add a vector overlay to the map. Supported formats: kml.
Click on the
button next to the overlay name to remove it from the map.
The red line is the overlay
Keyboard shortcuts
| Mouse | Move all selected streetviews |
|---|---|
| ESC | Unselect all selections |
| CTRL + A | Select all streetviews visible on the map |
| Click an arrow | Select a streetview |
| Hold CTRL + click a Streetview | Add a streetview to the current selection |
| Shift + draw rectangle | Select all the streetviews in the rectangle |
| Hold CTRL + SHIFT + draw rectangle | Add all the streetviews in the rectangle to the current selection |
| Hold ALT + click a Streetview | Line selection. Having a streetview selected hold ALT then Click a second streetview to select it and all the streetviews in between. |
| CTRL + L | Align all selected streetviews in a straight line. |
| DELETE | Deactivate all selected streetviews |
| INSERT | Activate all selected streetviews |
| HOME | Rotate all selected streetviews counterclockwise |
| END | Rotate all selected streetviews clockwise |
| PG UP | Go to the next streetview |
| PG DOWN | Go to the previous streetview |
| Arrow keys:
Up, Down, Left, Right |
Scroll the map. |
Duplicate Remover
Removes duplicate recordings from roads recorded more than once.
Hint:
Additionally you can deactivate excessive footage with the Skip tool. For best results run the Skip tool after the Duplicate Remover.
Process target
(Visible only when there are timelines)
Process either the selected tours or process the selected timelines.
Keep footage
Older – Provides best results for most situations.
Keeps the existing, older, streetviews (blue), adds new (red) streetviews for newly recorded roads.
Newer – Replaces existing streetviews (blue) with newer footage (red).
The overall data will be more up-to-date.
Disadvantage: After driving into a dead-end road, you get the probably worse footage from reversing out of it.
Road width (m)
Base setting.
Consider Altitude (m)
By default the altitude is ignored when detecting duplicates.
Try it when there are many bridges and tunnels.
Deactivate manually activated streetviews
By default manually activated streetviews are not deactivated by the Duplicate Remover. Enable this option to force them to be deactivated.
Start
Start removing duplicates in streetviews.
Reset
Reset all streetviews deactivated by Duplicate Remover and Skip tools.
Imagery
Add watermarks to the streetview. Changes can be previewed in the Player -> Preview tab.
Hint:
For the Free program version the watermark is fixed to DEMO. It can not be changed or removed. Consider a paid version if you need to adjust the watermarks.
Add watermark
Enable watermarks.
Text
Watermark text.
Font
Pick a font for the watermark. The list of fonts is taken from C:WindowsFonts.
Size
Watermark text size.
Opacity
Watermark text opacity. (See through.)
Number of watermark columns
How many watermark columns to show. (left-right).
Number of watermark rows
How many watermark rows to show. (up-down).
Add mask
Add a mask to hide the car’s rooftop.
Technically it is a transparent PNG image merged to the streetview.
Download an example mask.
Mask path
Path to the mask PNG image.
A Nadir logo can be added as a mask.
Nadir Logo
Add your company’s logo to the Nadir (bottom) of your streetviews.
In Player – Preview it looks like this:
To see the Nadir logo change Player – Preferences:
– Look down limit (degrees) from the default -50 to -90
– Maximum Zoom Level from default 120 to 150.
This way you can see the Nadir logo better.
Change it back both when done reviewing.
Hint:
Color logos will be automatically made into grayscale logos during processing. This can not be changed.
Add Logo to Mask
Preparations:
Download this example with all files needed.
Additionally only your own logo is needed.
Recommended minimum size for your logo: 300 px x 300 px.
Supported formats: png, jpeg, tif
Hint
Color logos will be automatically made into grayscale logos during processing. This can not be changed.
Go to https://nadirpatch.com/logo2sphere/
- Logo: Drop your own logo onto Logo or select it to upload.
- Equirectangular: Drop green-screen-template.jpg onto Equirectangular projection or select it to upload.
- Create: After upload is complete click the Create button in the top right corner.
- Download: After the image is created click the Download button in the bottom right-hand corner. Download and save the pano.tif image.
Set Transparency
On your PC: Edit with Paint 3D: Right click the pano.tif image then select.
In the top navigation bar Click Canvas and then enable Transparent canvas.
To save press CTRL + S then Click Image.
Change Save as type to 2D PNG then click Save.
pano.png is now ready to be used as a Mask for this program.
Or just download our own pano.png for a quick test.
Apply the Mask
In your project go to the Imagery tab and activate the mask and set it to the new pano.png file.
Result
By default all our players are configured to not allow you to look down to see the logo you just added.
To change this, go to Player – Preferences – Streetview
Change Look Down Limit from default -50 to -90.
For your convenience change Maximum Zoom Level from default 120 to 150. This way you can see the result better. Change back both when done reviewing.
Check what it looks like in Player – Preview:
Now process the project as usual.
Timeline
Record the same road or area multiple times to document change.
Most simple example with two timelines, each with one tour only:
Create a minimum of two timelines. E.g. dates like 2018 and 2022.
Assign a minimum of one tour (folders) to each timeline.
Whats the player then looks like:
Enable timeline
Enable the timeline feature
Add
Click the Add button in the top right corner.
Set a Label for the timeline and which Tours belong to this timeline then click the Save button in the top right corner.
Sort
You can sort the timelines as needed.
Edit
Click the
button next to the timeline.
Modify the Label of the timeline and which Tours belong to this timeline. Then click the Save button in the top right corner.
Delete
Click the
button next to the timeline then confirm the delete operation.
After assigning all tours to timelines you can use the Duplicate Remover to sort out duplicates in each timeline.
Player
Player Keyboard shortcuts
| PG UP | Go to the next streetview |
|---|---|
| PG DOWN | Go to the previous streetview |
| Arrow keys: Up, Down, Left, Right | Look down, up, left, right. |
| Ctrl + Shift + h | Screenshot mode:
Toggle visibility of hotspot and arrows. |
Preferences
There are many options to configure the player.
Best is to back and forward between the Preferences and the Preview while making adjustments.
General
Layout
Logo
Streetview
Map
Mapbox
Raster data
If you have raster data at mapbox.com, please use Custom map tiles instead.
The mapbox URL for Custom map tiles looks like this:
https://api.mapbox.com/styles/v1/YOUR_USERNAME/YOUR_STYLE_ID/tiles/256/{z}/{x}/{y}?access_token=YOUR_MAPBOX_ACCESS_TOKEN
Vector data
The following is for vector data only.
If you have your own vector data and would like to add it to the Player.
Mapbox provides an easy way to do it.
Map provider label
Name of the map provider shown in the Player – base layer selection panel.
Style URL
To get the URL of your style, in Mapbox studio click on the
Share button in the top right corner and then copy the value of the Style URL field.
Access token
To get the URL of your style, in Mapbox studio click on the
Share button in the top right corner and then copy the value of Access token field.
Map data legal notices
Custom map data legal notices
Automatic rotation
Translations
For each language the default translations shown below will be used, unless you enter something else.
The Player will try to match the browser locale with one of the available languages, if that fails the first language will be used as the default.
Enable Multi language for a button to allow the user to select the language manually in the Player.
Click on Add new Language button
to create a new language.
You can find the 2 letter codes (ISO 639-1) of all the languages here: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
Delete
Consider doing a backup of the player settings and all translations before deleting.
Import a Backup to restore an added language and all other player settings.
You can delete your customisations to the four default languages and additional languages added.
In case one of the four default languages was deleted and you want to bring it back, just add it via the Add new Language button
and specify one of default language codes: en, de, es, ar. There is no need to enter all the translations again.
Default language
The player will try to match the browser language to one of the available languages. In case no match could be made – the first language will be used (by default English).
To set a different default language, delete all the languages except the desired language to make it the first language.
Then add all other languages again.
Preview
Press CTRL + SHIFT + H to toggle hotspot visibility. E.g. for screenshots.
Asset Visualization
Have the player show your assets via the URL. No database is needed.
Let’s assume you already have 100000 assets with Latitude and Longitude.
How can you link them to the 500 kilometers worth of streetviews you have just recorded?
Simply have your existing system generate a URL for each of your assets.
The player then will automatically open the streetview closest to the asset and look at it.
This even works with timelines. Perfect for inspection and documentation of change.
Most simple example:
https://dhwg78vfdmqzw.cloudfront.net/index.html?v_lat=29.274778&v_lng=48.023550
You should see a man with a water hose.
Same, but with a label added:
Minimum requirements:
Latitude and longitude values for your asset specified by URL query parameters:
v_lat – Latitude
v_lng – Longitude
Optional parameters:
v_alt – Altitude
v_label – asset description. It must be url encoded.
v_timeline – The name of an existing timeline. It must be url encoded.
Layout
v_layout can be one of the following values
map – Map
streetview – Streetview
streetviewBottom – Top Map, Bottom Streetview
streetviewTop – Bottom Map, Top Streetview
v_minimized
0 bottom left window being maximized
1 bottom left window maximized
v_htmlTitle changes the title of the page. It must be url encoded.
Formatting
v_label, v_htmlTitle, v_timeline must be url encoded.
To encode URLs use https://www.urlencoder.org/ or similar websites.
Export
Process
Creates the player and all data for it on your PC.
The player then can be viewed in many ways:
- In the program itself at Menu: Player -> Preview
- By running a local server on your PC. We suggest the “krpano Testing Server.exe” program. It is available for download for free here.
- After uploading to the Amazon AWS cloud by the Publish feature.
- After manual upload to any cloud or server.E.g. Amazon AWS (S3), Microsoft Azure, Google Cloud, Apache, NGINX, IIS and literally any other web server. Both shared and dedicated hosting works.
Create player
Creates the player in /out/projectname/player2 folder.
Create streetview-tiles
Creates the streetview-tiles for the player in /out/projectname/panorama-tiles folder.
Create project backup
Creates a project backup with a timestamp in the /out/projectname/backups folder.
We strongly suggest keeping the Create project backup option activated.
Skip existing streetviews
In case you are updating a project and reprocessing: If a streetview already exists, do not process it again. This can save a lot of time.
However, if you make changes to the streetviews e.g. by adding or removing a watermark or mask in Imagery deactivate this option to reprocess the streetviews.
Alternatively you can manually delete the /out/projectname/panorama-tiles folder.
Player folders
When processing a folder projectname (from the project name) with 4 subfolders is created:
/out
/projectname
/backup
/panoramas
/panorama-tiles
/player2
For a working player only the player2 and panorama-tiles subfolders need to be uploaded.
Publish
One-click upload of the player and the streetview-tiles to your Amazon AWS account.
For the free evaluation period we provide our own Amazon AWS cloud account.
Therefore no setup is required.
- Free testing with the 360camsters Amazon AWS account.
- Amazon regions are limited to Europe (Frankfurt).
Alternatively you can manually publish to Amazon AWS (S3), Microsoft Azure, Google Cloud, Apache, NGINX, IIS and literally any other web server.
Publish to Amazon cloud
Process and then publish in one simple step.
You also can process only. And then publish anytime later.
Advantages of the Amazon AWS player:
- Easiest player to publish.
- Cheapest player for hosting and data transfer.
- Very versatile. E.g. add a CND like CloudFront to speed up the loading of the streetviews even more. Or enable for a world-wide audience.
Sharing the Player
A unique ID (UUID) is part of the cloud player’s URL, and it is not listed anywhere.
It can not be guessed. Only users you tell the URL can access the player.
Consider forwarding a different URL to it.
E.g. by adding AWS CloudFront CDN (Content Delivery Network) to your player. That way you can remove and then add a different CloudFront URL without having to upload the player and streetviews again.
Player example URL (bold: UUID)
https://fmbeach-50cd3985-a77b-4b31-9d6c-995529c9532a.s3.eu-central-1.amazonaws.com/index.html
Player CloudFront example URL (for the player above)
https://d2gm8i73pgaxv.cloudfront.net
During the free evaluation period the AWS regions are limited to the EU (Frankfurt) location. Afterwards all 25 AWS regions are available to you.
After purchasing 360 Private Publisher more options become available:
- Access key ID and Secret access keyFollow Amazon Web Services Cloud on how to get your own AWS credentials.
- AWS region for publishing.Pick one of the 25 AWS regions closest to your viewers. This is not necessarily the region closest to you. Each player can have its own region.
AWS CloudFront (CDN)
If the cloud player is expected to
- Have a custom domain
- Handle high traffic from all over the world
It’s recommended to add a CloudFront distribution to the player.
Go to https://console.aws.amazon.com/cloudfront/home and click the Create Distribution button.
Origin Domain Name
Select the player in the drop-down field.
Example:
https://ghost-town-e6a1df59-15f6-45ea-9675-2de94703f92b.s3.eu-central-1.amazonaws.com/index.html
Viewer Protocol Policy
Set to Redirect HTTP to HTTPS.
Default root object
Enter index.html
Scroll down and click the Create Distribution button.
Go to CloudFront Distributions list, and wait until the distribution is created (Status column changes to Enabled). This might need a few minutes.
The complete CloudFront URL for the browser or for embedding:
https://d2gm8i73pgaxv.cloudfront.net
Hint:
Please notice that it might need up to 24 hours for the new CloudFront Distribution to deploy worldwide to work properly. Up until then it will forward to the S3 domain name.
URL query parameters like v_lat, v_lng, etc. will start working only when the CloudFront deployment is completed. This might need up to 24 hours.
Embed the Cloud Player into any webpage
What it looks like on our website:
3 examples for the same player:
Cloud Player URL from this program:
Get the URL from Publish -> Open Cloud Player.
Same player, with Amazon CloudFront CDN instead:
Same player, with a custom subdomain (with a SSL certificate) for CloudFront.
Cloud Player Management
Open Cloud player
Opens the published Cloud Player URL in the browser.
Delete Cloud player
Deletes the published Cloud Player from the internet and the project.
The same URL can not be re-used.
To only delete the cloud player from the internet, and to keep the URL in the project, use AWS Account instead.
An updated player can be published with the same URL.
Create Amazon Web Services (AWS) account
360 Private Publisher has a built-in one-click publishing feature for the Amazon Web Services (AWS) Cloud Computing Services to easily publish the player to the internet.
An Access key ID and Secret access key is required for publishing.
(In the free evaluation period it works without.)
This needs to be set up only once.
- Go to https://aws.amazon.com/console/ and sign in with an existing Amazon account or create a new account.
- Log in and continue to https://console.aws.amazon.com/iam/home?#/users$new?step=details to add a new IAM user
- User name: 360camsters
- Access type: Programmatic access
- Click Next: Permissions button
- Select Attach existing policies directly
- Select AdministratorAccess privileges.
- Click the Next: Tags button
- Click the Next: Review button. Make sure User details and Permission summary matches the image below.
- Click the Create user button
- Regions:All regions are available to a newly created IAM user by default.But to publish to the following four AWs regions you need to activate them first:https://console.aws.amazon.com/iam/home#/account_settings
Africa (Cape Town)
Asia Pacific (Hong Kong)
Europe (Milan)
Middle East (Bahrain)
Then copy the Access key ID and Secret access key into the appropriate fields on the 360 Private Publisher -> Export: Publish page.
Or 360 Private Publisher -> Preferences -> Amazon Cloud.
It is recommended to click the Download .csv button in order to save the credentials to your PC should you ever need to enter them again.
Request quota increase: Concurrent execution
Go to https://console.aws.amazon.com/servicequotas/home/services/lambda/quotas/L-B99A9384
Switch to the region where the player will be published.
Click on the Request quota increase button.
The quota increase is per AWS region. In case you plan to publish different players to different regions, you need to do this for each region you want to publish to.
Set Change quota value to 100
Click on the Request button.
Apache, NGINX, IIS, MS Azure and Google Cloud
The player can be published to literally any web server or cloud. It is a collection of static files (html, js, css, etc.). No database is needed.
Copy both the player2 and the panorama-tiles folders to e.g. the /players/hometown folder on your web server. The players URL would then be:
https://www.your-server.com/players/hometown/player2/
Embed the player into any webpage
First publish the player to a webserver.
Both the players2 and the panorama-tiles folders are published to the hometown folder:
https://www.your-server.com/players/hometown/player2
https://www.your-server.com/players/hometown/panorama-tiles
In your page, add this code:
API
When embedding the player into any html page as an iframe, you now can control it from the html page by javascript.
See the working API examples on our website:
https://www.360camsters.com/gallery/#api
For your own development, download the Javascript API examples.
Then develop your own solution. You can combine many examples into one player.
Working examples are also automatically added to each project of yours:
out/projectname/player2/examples/
Or contact us, we are available for hire for customisation and integration.
Map example
Click anywhere on the map, and the player will show you what it looks like.
Navigate the player, and the map will update.
On the left side it shows an external map. In this case Leaflet.
The map could be any map. E.g. Leaflet, Openlayers or Google map, etc.
On the right side it shows the player in an iframe. With the new Layout streetview only.
See the working example on our website:
https://www.360camsters.com/gallery
For your own development, download the Javascript API examples.
Then develop your own solution.
Or contact us, we are available for hire for customisation and integration.
Asset example
To view an asset by its Latitude and Longitude.
See the working example on our website:
https://www.360camsters.com/gallery
For your own development, download the Javascript API examples.
Then develop your own solution.
Or contact us, we are available for hire for customisation and integration.
Timeline example
Switch the timeline for a “before and after” comparison.
You also can have many timelines. E.g. 2019, 2020, 2021, 2022.
See the working example on our website:
https://www.360camsters.com/gallery
For your own development, download the Javascript API examples.
Then develop your own solution.
Or contact us, we are available for hire for customisation and integration.
Screenshot example
Take a screenshot of the currently visible part of the streetview. E.g zoom in to show a specific issue.
Ideal to add photos to a pdf file or a database.
See the working example on our website:
https://www.360camsters.com/gallery
For your own development, download the Javascript API examples.
Then develop your own solution.
Or contact us, we are available for hire for customisation and integration.
Data example
Get all the data available for the street view.
Data shown:
- Streetview ID
- Label
- Timeline
- Latitude, Longitude, Altitude
- Viewing direction (0-360 degree like on a compass)
- Vertical viewing direction (up and down)
- Zoom
- Date and time + timezone
See the working example on our website:
https://www.360camsters.com/gallery
For your own development, download the Javascript API examples.
Then develop your own solution.
Or contact us, we are available for hire for customisation and integration.
Second Monitor
Works with streetviews selected on the Map and Player – Preview.
By adding a second monitor you can see the program and the selected streetview in full size, at the same time. Side by side.
You can test this with a single monitor:
Shows the selected streetview.
You can navigate in Map and Player -> Preview using the PgUp and PgDown keyboard keys.
You can zoom in and out.
Tools
Skip
Always to be used after the Duplicate Remover.
To convert tours recorded in 1m Distance Mode to 5m Distance Mode.
To convert tours recorded in Interval Mode to Distance Mode.
Etc.
This greatly reduces the number of streetviews to process.
Process target
(Visible only when there are timelines)
Process either the selected tours or process the selected timelines.
By Distance
Separate by meters between streetviews.
By Interval
Separate by seconds between streetviews.
By Step
Process every x-th streetview.
Deactivate manually activated streetviews
By default manually activated streetviews are not deactivated. Enable this option to force them to be deactivated.
Start
Start separating the streetviews.
Try a few times to find the optimum settings for your footage.
Reset
Reset all streetviews deactivated by Duplicate Remover and Skip tool.
Road names from OpenStreetMap
If you already have road names, make a project backup first.
This ensures you can restore in case you accidentally change them in an unwanted way.
Preferred language
Local language only – “name” value of the OSM road.
Custom language – “name:language” value of the OSM road.
Custom language, fallback to local if not specified – If “name:language” value does not exist use “name”.
For Streetviews
Activated streetviews
Deactivated streetviews
Overwrite previously assigned road names?
If enabled streetviews with an existing road name will be skipped.
Maximum distance (m)
Maximum distance to the closest road to be considered for geocoding.
Start
Geocode streetviews with road names from OSM
Reset
Remove all assigned road names, even those assigned manually via the Map page.
Fix Direction
If the heading of the majority of the streetviews is not correct it’s possible to calculate the heading from the streetviews position.
Click Start to calculate the healing from position.
Click Reset to revert to original values.
Fix altitude
If the Altitude (height) of streetviews is not correct or missing it’s possible to determine it from the Latitude and Longitude. We are using NASA Shuttle Radar Topography Mission Global 3 arc second V003 dataset for this.
Click Start to calculate the height from the digital terrain model.
Click Reset to revert to the original values.
Once Start is clicked, 360 Private Publisher will download the digital terrain model for your project’s location and cache it.
This tool therefore requires an active internet connection.
The size of the height-data is about 3 MB for a 1×1 degree area.
The area is determined by a bounding box for all the streetviews in the Project, both active and deactivated.
Hint:
Streetviews deactivated for wrong positions can present a problem. They still will be considered for the bounding box, even when in the middle of the Atlantic Ocean for both Latitude and Longitude being “0”. Please move them closer to the active stretviews.
Export Metadata
Export streetview metadata.
E.g. for a 3rd-party program.
Streetview status
CSV (comma separated, double quote as as string delimiter),
GeoJSON
Streetview status
Activated: Metadata for activated streetviews only.
Deactivated: Metadata for deactivated streetviews only.
Start
Start the export process.
Merge Players
Players to merge
List of the available projects.
Only shows processed projects with data in /out.
Process all projects first, then merge.
Copy panoramas-tiles
Copy the panoramas-tiles folders of all the players into Output Folder/panorama-tiles
This might need a while.
Start
Create the merged player in a new folder.
The projects to be merged are not changed.
Open Output Folder
Open the output folder of the merged player.
The new folder with the merged player is always saved to the Out folder.
Preferences
General
Language
Set the program language.
Languages supported: English, Spanish, German.
We are happy to add more languages. Just contact us.
Automatically send usage statistics and crash reports to 360camsters.
Please help us make this program better.
Folders
It is strongly recommended to create the following 3 folders to organize your data:
In, Out, Backup.
Set the folders up in Preferences -> Folders.
Input folder
Usually named in.
Default location of the project input data. You should place your recorded data here.
Output folder
Usually named out.
Default location for publishing.
All the project folders are subfolders of the out folder. They are created automatically.
Backup folder
Default location for saving project backups.
Weekly or daily backups are strongly recommended.
This is only for this program’s data. Sources or generated data is not included in a Backup.
Manually create additional folders to keep your data organized:
Masks, Logos, Export, Player templates.
Amazon Cloud
An Access key ID and Secret access key is required for publishing.
See the Create Amazon Web Services (AWS) account section for how to get your own AWS credentials.
Allows to open or delete players published to your AWS account.
It does not need a project to do so.
If you delete a player from your AWS account, the project still knows the URL the player has been published to. Meaning you can re-publish to the same URL using the project, or a project backup.
To delete a player from both the Internet and a project, use Cloud Player -> Delete Cloud Player instead.
Project
Project name
Published date
Date and time of the upload.
Open
Open the player URL in the browser
Delete
Delete player (incl. all streetviews) from the Amazon account.
Local projects will not be changed.
The project still knows the same cloud URL.
Manuals
Open this manual.
License
Displays the current license.
Click Add activation key to enter your activation key.
Get an activation key here.
View Software License Agreement.
About
krpano license
A single krpano license is sufficient for all players you create.
For the Evaluation version of this program this feature is not available.
A demo version of krpano is bundled with this program.
Click Add activation key to enter your krpano license key. Get a krpano License if you do not have one already.
Paste your krpano key into the field and click the OK button. You should see a confirmation message that the key is registered.
Restart this program and re-create all players to remove the krpano watermarks.
krpano watermarks:
The krpano demo version watermark is visible in the playe:
- Player – Preview
- Player tab
- All generated players
Version
Displays this program’s installed version. Check for updates, view the release notes.
Logs
Open the newest log file or open the folder with all the log files.
About this PC
Displays the specifications of the PC.
Enterprise Version
360 Private Publisher Enterprise supports (manual) automation and (automatic) scripting.
Licensing
Automation is available with the Enterprise version only.
Please contact us for a quote and the details.
User Interface (UI)
Export Configuration
Projects: Click the
button next to the project name and then click Export Configuration to create and export a configuration file for the selected project.
Import Configuration
Projects: More
Add project from configuration
Click the Add project from the configuration menu item to add a project from a configuration file.
What is covered by automation?
- Creation of a project.
- Creation of the project’s tours.
- Loading of project and tour settings.
- Clicking on “Start” buttons.
- Close the program when processing is finished.
- Option to delete all projects when done.
Things not covered
Settings for individual streetviews.
Only settings on the project and tour levels are part of the configuration.
All settings applied to an individual streetview are not part of the configuration for an automation workflow.
Examples:
- Position
- Heading
- Status (activated/deactivated)
- Road name
Full Automation with the command line
This is meant for workflows that need to deal with data from many cameras for many months.
Licensing
Scripting is a feature of the Enterprise version only.
Please contact us for a quote and the details.
Mass production
When running Enterprise from the Windows command line make sure that the current working directory is set to the directory of the 360camsters.exe file:
cd C:UsersmeAppDataLocal360camsters
Typical Example
cd C:UsersmeAppDataLocal360camsters
360camsters.exe –actions=”ImportConfiguration,DuplicateRemover,Publish,Close” –importConfiguration=”S:DownloadsDemo-20220421-124812.project-config” –processSkipTiles=false
- –actions
- ImportConfiguration – Add a project from a configuration file and open it. –importConfiguration must be set to the path of the configuration file.
- DuplicateRemover – Run Duplicate Remover with current project settings.
- Skip – Run Tools – Skip with current project settings.
- RoadNamesFromOsm – Run Tools – Road names from OSM with current project settings.
- DirectionFromPosition – Run Tools – Direction from position.
- CameraMountedBackwards – Run Tools – Camera mounted backwards.
- Publish – Starts the publishing process with current project settings.
- Close – Closes Creator 7 when finished
- DeleteProjectsAndClose – Delete all projects and close Creator 7 when finished
- –importConfiguration – Specify a .project-config file created by exporting a project configuration. This field is required for the ImportConfiguration action.
- –processSkipTiles – Adjusts the value of Preferences – AdvancedSkips creating streetview-tiles during Publish. Can be true or false.
Actions are executed in the sequence they are listed.
If any of the actions trigger an error processing stops and no other actions will be executed.
Each completed action creates an entry in the log.
Errors triggered by an action are logged too.
Each action logs a start and finish message to stdout.
This allows for optional progress tracking.
Configuration export and import
This is the workflow to duplicate your project settings.
This way data is processed identically. You need to press all required “Start” buttons manually.
Steps
Export a configuration as template: You get a .project-config file
Edit it
Import it
Press all the Start buttons needed manually. Make sure not to miss a Start button.
Close 360 Private Publisher
Export a configuration as template
It is strongly recommended to configure a project as the template in 360camsters 360 Private Publisher first.
Do not try to build a configuration file from scratch with a text editor.
Suggested workflow
Create the project.
Configure it.
Run it for testing.
Check the result.
Export it:
Projects -> PROJECTNAME -> More (3 dots) -> Export Configuration
Make adjustments manually to the exported configuration file.
Example configuration file:
Demo-20220421-124812.project-config
Edit the configuration file
A project can have tours from different cameras (and recording vehicles).
Minimum change the tours name. If needed the tour path.
….
“name”: “Demo4-5m”,
“created_at”: 1597652281375,
“tours”: {
“camera-20181218-104940“: {
“yaw”: “0”,
“pitch”: “0”,
“roll”: “0”,
“imu”: true,
“exposure”: “0”,
“brightenEnabled”: true,
“brightenStrength”: “0.8”,
“brightenThreshold”: “0.4”,
“tourPath”: “E:\2020\in\Demo4-5m”
},
….
Import the configuration
Projects -> More (3 dots) -> Add project from configuration
Apply settings
Click the “Start” buttons in the desired sequence.
Processing
Export-> Start
Update Policy
As long as you have a valid license (subscription or one-time payment) you automatically get the newest release.
At start the program automatically checks and displays a pop-up that allows you to update.
Additionally you can check yourself anytime at
Menu: About -> Version: Check for update.
Good Housekeeping
Backup
Backup often.
This way you can import the last “good” backup anytime to continue.
It is best practice to always have an up-to-date backup of both your data and the project backups on a disconnected drive.
If the drive is connected to your network and powered up it is just a copy, not a backup.
You can back up one or many project(s), tours(s), or just the player configuration(s) incl. the translations.
Sources or generated data (streetviews and players) are never part of a backup.
Data safety
This program can not edit or delete your recordings.
Download
The program, this manual and various 360 recordings for testing.
https:/www.360camsters.com/downloads/
Support
Please update first.
Support is provided for the newest release only.
Support Portal
