Photo Sphere XMP
Stay organized with collections
Save and categorize content based on your preferences.
The following table lists all required fields for Photo Sphere XMP. Select the following link for more information about Photo Sphere XMP. If you want to add custom fields, for example, GPano:PosePitchDegrees, shorten to PosePitchDegrees (no need for a prefix underscore "_").
| Name |
Type |
Description |
ProjectionType |
Open Choice of Text |
Image file projection type. Google products currently support equirectangular. |
UsePanoramaViewer |
Boolean |
Display the image in a panorama viewer (True), or as a flat image (False). Default to True. |
PoseHeadingDegrees |
Real |
Compass heading, in degrees, for the image center. Value range is >= 0 and < 360. |
CroppedAreaImageWidthPixels |
Integer |
Original width in pixels of the unedited image (equal to the actual image’s
width for unedited images). |
CroppedAreaImageHeightPixels |
Integer |
Original height in pixels of the image (equal to the actual image’s height for
unedited images). |
FullPanoWidthPixels |
Integer |
Original full panorama width from which the image was cropped. Or, if only a
partial panorama was captured, this specifies the width of what the full
panorama would have been. |
FullPanoHeightPixels |
Integer |
Original full panorama height from which the image was cropped. Or, if only a
partial panorama was captured, this specifies the height of what the full
panorama would have been. |
CroppedAreaLeftPixels |
Integer |
Column where the left edge of the image was cropped from the full sized panorama. |
CroppedAreaTopPixels |
Integer |
Row where the top edge of the image was cropped from the full sized panorama. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-10-09 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-10-09 UTC."],[[["This page lists all the required fields for Photo Sphere XMP metadata, which is used by Google products to display spherical images correctly."],["Photo Sphere XMP metadata includes information about the image's projection type, orientation, and dimensions, as well as how it should be displayed."],["If adding custom fields to the XMP metadata, omit the \"GPano:\" prefix (e.g., use \"PosePitchDegrees\" instead of \"GPano:PosePitchDegrees\")."],["For detailed information about Photo Sphere XMP and its usage, refer to the provided link."]]],["Photo Sphere XMP requires specific fields for proper image handling. These include `ProjectionType` (typically equirectangular), `UsePanoramaViewer` (defaults to `True`), and `PoseHeadingDegrees` (compass heading). Dimensions are specified using `CroppedAreaImageWidthPixels`, `CroppedAreaImageHeightPixels`, `FullPanoWidthPixels`, and `FullPanoHeightPixels`. `CroppedAreaLeftPixels` and `CroppedAreaTopPixels` indicate the cropped image's position within the full panorama. Custom fields can be added without prefixing underscores.\n"]]
