.. index:: pair: struct; P1::ImageSdk::GpsData
.. _doxid-struct_p1_1_1_image_sdk_1_1_gps_data:

struct P1::ImageSdk::GpsData
============================

.. toctree::
	:hidden:

Overview
~~~~~~~~

A GPS data bundle, that defines an auxillary GPS's position on earth, along with a date-time stamp. :ref:`More...<details-struct_p1_1_1_image_sdk_1_1_gps_data>`


.. ref-code-block:: cpp
	:class: doxyrest-overview-code-block

	#include <P1ImageGpsImu.hpp>
	
	struct GpsData
	{
		// fields
	
		:ref:`GpsDateTimeComponents<doxid-struct_p1_1_1_image_sdk_1_1_gps_date_time_components>` :ref:`gpsDateTimeStamp<doxid-struct_p1_1_1_image_sdk_1_1_gps_data_1acda906afdc3139df54e35719eacf1969>`;
		int :ref:`latitudeDegrees<doxid-struct_p1_1_1_image_sdk_1_1_gps_data_1aa19b379c4efd40a663f4e7eafc07087d>`;
		double :ref:`latitudeMinutes<doxid-struct_p1_1_1_image_sdk_1_1_gps_data_1acee6d22a6e0b93a44a9de2955e19df2f>`;
		int :ref:`longitudeDegrees<doxid-struct_p1_1_1_image_sdk_1_1_gps_data_1a66aad158d3f91a25f626dd7ca89351e6>`;
		double :ref:`longitudeMinutes<doxid-struct_p1_1_1_image_sdk_1_1_gps_data_1a4248d7fb528c84847e5734414ccbb7dd>`;
		:ref:`Rational<doxid-struct_p1_1_1_image_sdk_1_1_rational>` :ref:`altitude<doxid-struct_p1_1_1_image_sdk_1_1_gps_data_1a80d4fb64f6a2bac4ab740bb2933f7869>`;

		// methods
	
		double :ref:`LatitudeAsDecimal<doxid-struct_p1_1_1_image_sdk_1_1_gps_data_1abfe6d92975c45b4615b501578a9544fd>`() const;
		double :ref:`LongitudeAsDecimal<doxid-struct_p1_1_1_image_sdk_1_1_gps_data_1a079ae2608ecbd7aa268423d64667f100>`() const;
		std::string :target:`ToString<doxid-struct_p1_1_1_image_sdk_1_1_gps_data_1a601bcbdb5c764e63baf8476fdecd808a>`() const;
	};
.. _details-struct_p1_1_1_image_sdk_1_1_gps_data:

Detailed Documentation
~~~~~~~~~~~~~~~~~~~~~~

A GPS data bundle, that defines an auxillary GPS's position on earth, along with a date-time stamp.

Coordinates are stored in degrees and minutes (of arc) with decimals. (No seconds of arc components.)

Conveniece methods :ref:`LatitudeAsDecimal() <doxid-struct_p1_1_1_image_sdk_1_1_gps_data_1abfe6d92975c45b4615b501578a9544fd>` and :ref:`LongitudeAsDecimal() <doxid-struct_p1_1_1_image_sdk_1_1_gps_data_1a079ae2608ecbd7aa268423d64667f100>`, returns the decimal degrees representation. These are calculated using the formular:

.. ref-code-block:: cpp

	decimalDegrees = degrees + minutes / 60

here are no convenience converters for convertion to a degree, minute & second representation.

However, the seconds components can be calculated from the minutes:

.. ref-code-block:: cpp

	seconds = (minutes - floor(minutes)) * 60

The GPS timestamp might not contain a date component. This depends on the GPS device used, when the IIQ file was created. The member GpsDateTimeComponents.HasDate defines if date components (year, month, day) are present.

Fields
------

.. index:: pair: variable; gpsDateTimeStamp
.. _doxid-struct_p1_1_1_image_sdk_1_1_gps_data_1acda906afdc3139df54e35719eacf1969:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`GpsDateTimeComponents<doxid-struct_p1_1_1_image_sdk_1_1_gps_date_time_components>` gpsDateTimeStamp

The GPS time stamp, that might include a date.

.. index:: pair: variable; latitudeDegrees
.. _doxid-struct_p1_1_1_image_sdk_1_1_gps_data_1aa19b379c4efd40a663f4e7eafc07087d:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	int latitudeDegrees

North-South point in (integer) degrees from -90 (South Pole) or +90 (North Pole)

.. index:: pair: variable; latitudeMinutes
.. _doxid-struct_p1_1_1_image_sdk_1_1_gps_data_1acee6d22a6e0b93a44a9de2955e19df2f:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	double latitudeMinutes

*Minute of arc* part of the latitude coordinate (North-South)

.. index:: pair: variable; longitudeDegrees
.. _doxid-struct_p1_1_1_image_sdk_1_1_gps_data_1a66aad158d3f91a25f626dd7ca89351e6:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	int longitudeDegrees

East-West point in (integer) degrees from -180 (West) to +180 (East), where 0 is near Greenwich, England.

.. index:: pair: variable; longitudeMinutes
.. _doxid-struct_p1_1_1_image_sdk_1_1_gps_data_1a4248d7fb528c84847e5734414ccbb7dd:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	double longitudeMinutes

*Minute of arc* part of the longitude coordinate (East-West)

.. index:: pair: variable; altitude
.. _doxid-struct_p1_1_1_image_sdk_1_1_gps_data_1a80d4fb64f6a2bac4ab740bb2933f7869:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`Rational<doxid-struct_p1_1_1_image_sdk_1_1_rational>` altitude

Height of camera in meters, above sea level. Negative values means below sea level.

Methods
-------

.. index:: pair: function; LatitudeAsDecimal
.. _doxid-struct_p1_1_1_image_sdk_1_1_gps_data_1abfe6d92975c45b4615b501578a9544fd:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	double LatitudeAsDecimal() const

Return *degrees only* latitude coordinate. (Degrees with decimals)

.. index:: pair: function; LongitudeAsDecimal
.. _doxid-struct_p1_1_1_image_sdk_1_1_gps_data_1a079ae2608ecbd7aa268423d64667f100:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	double LongitudeAsDecimal() const

Return *degrees only* longitude coordinate. (Degrees with decimals)