Maven module :un.storage : media-mpeg4 :
Class : un.storage.media.mp4.boxes.impl.meta.ThreeGPPLocationBox
Extends/Implements : un.storage.media.mp4.boxes.impl.meta.ThreeGPPMetadataBox
Subclasses : -

This box contains meta information about a location.

If the location information refers to a time-variant location, the name
should express a high-level location, such as "Finland" for several places in
Finland or "Finland-Sweden" for several places in Finland and Sweden. Further
details on time-variant locations can be provided as additional notes.

The values of longitude, latitude and altitude provide cursory Global
Positioning System (GPS) information of the media content.

A value of longitude (latitude) that is less than –180 (-90) or greater than
180 (90) indicates that the GPS coordinates (longitude, latitude, altitude)
are unspecified, i.e. none of the given values for longitude, latitude or
altitude are valid.

@author Alexander Simm

Variables : -
Functions : ThreeGPPLocationBox, decode, getPlaceName, getRole, getLongitude, getLatitude, getAltitude, getAstronomicalBody, getAdditionalNotes

public void ThreeGPPLocationBox ()

public void decode (MP4InputStream in)


A string indicating the name of the place.
return  the place's name
public String getPlaceName ()


The role of the place:


  1. "shooting location"

  2. "real location"

  3. "fictional location"



Other values are reserved.

@return the role of the place
public int getRole ()


A floating point number indicating the longitude in degrees. Negative
values represent western longitude.
return  the longitude
public double getLongitude ()


A floating point number indicating the latitude in degrees. Negative
values represent southern latitude.
return  the latitude
public double getLatitude ()


A floating point number indicating the altitude in meters. The reference
altitude, indicated by zero, is set to the sea level.
return  the altitude
public double getAltitude ()


A string indicating the astronomical body on which the location exists,
e.g. "earth".

@return the astronomical body
public String getAstronomicalBody ()


A string containing any additional location-related information.
return  the additional notes
public String getAdditionalNotes ()