              
QGeoCoordinate Class ReferenceThe QGeoCoordinate class defines a geographical position on the surface of the Earth. More... #include <QGeoCoordinate> Public Types
Public Functions
Related Non-Members
Detailed DescriptionThe QGeoCoordinate class defines a geographical position on the surface of the Earth. A QGeoCoordinate is defined by latitude, longitude, and optionally, altitude. Use type() to determine whether a coordinate is a 2D coordinate (has latitude and longitude only) or 3D coordinate (has latitude, longitude and altitude). Use distanceTo() and azimuthTo() to calculate the distance and bearing between coordinates. The coordinate values should be specified using the WGS84 datum. Member Type Documentation
|
| Constant | Value | Description |
|---|---|---|
| QGeoCoordinate::DecimalDegrees | 0 | Returns a string representation of the coordinates in decimal degrees format. |
| QGeoCoordinate::DecimalDegreesWithHemisphere | 1 | Returns a string representation of the coordinates in decimal degrees format, using 'N', 'S', 'E' or 'W' to indicate the hemispheres of the coordinates. |
| QGeoCoordinate::DegreesMinutes | 2 | Returns a string representation of the coordinates in degrees-minutes format. |
| QGeoCoordinate::DegreesMinutesWithHemisphere | 3 | Returns a string representation of the coordinates in degrees-minutes format, using 'N', 'S', 'E' or 'W' to indicate the hemispheres of the coordinates. |
| QGeoCoordinate::DegreesMinutesSeconds | 4 | Returns a string representation of the coordinates in degrees-minutes-seconds format. |
| QGeoCoordinate::DegreesMinutesSecondsWithHemisphere | 5 | Returns a string representation of the coordinates in degrees-minutes-seconds format, using 'N', 'S', 'E' or 'W' to indicate the hemispheres of the coordinates. |
See also toString().
enum QGeoCoordinate::CoordinateType
Defines the types of a coordinate.
| Constant | Value | Description |
|---|---|---|
| QGeoCoordinate::InvalidCoordinate | 0 | An invalid coordinate. A coordinate is invalid if its latitude or longitude values are invalid. |
| QGeoCoordinate::Coordinate2D | 1 | A coordinate with valid latitude and longitude values. |
| QGeoCoordinate::Coordinate3D | 2 | A coordinate with valid latitude and longitude values, and also an altitude value. |
Member Function Documentation
QGeoCoordinate::QGeoCoordinate ()
Constructs a coordinate. The coordinate will be invalid until setLatitude() and setLongitude() have been called.
QGeoCoordinate::QGeoCoordinate ( double latitude, double longitude )
Constructs a coordinate with the given latitude and longitude.
If the latitude is not between -90 to 90 inclusive, or the longitude is not between -180 to 180 inclusive, none of the values are set and the type() will be QGeoCoordinate::InvalidCoordinate.
See also isValid().
QGeoCoordinate::QGeoCoordinate ( double latitude, double longitude, double altitude )
Constructs a coordinate with the given latitude, longitude and altitude.
If the latitude is not between -90 to 90 inclusive, or the longitude is not between -180 to 180 inclusive, none of the values are set and the type() will be QGeoCoordinate::InvalidCoordinate.
See also isValid().
QGeoCoordinate::QGeoCoordinate ( const QGeoCoordinate & other )
Constructs a coordinate from the contents of other.
QGeoCoordinate::~QGeoCoordinate ()
Destroys the coordinate object.
double QGeoCoordinate::altitude () const
Returns the altitude (meters above sea level).
The return value is undefined if the altitude has not been set.
See also setAltitude() and type().
qreal QGeoCoordinate::azimuthTo ( const QGeoCoordinate & other ) const
Returns the azimuth (or bearing) in degrees from this coordinate to the coordinate specified by other. Altitude is not used in the calculation.
There is an assumption that the Earth is spherical for the purpose of this calculation.
Returns 0 if the type of this coordinate or the type of other is QGeoCoordinate::InvalidCoordinate.
qreal QGeoCoordinate::distanceTo ( const QGeoCoordinate & other ) const
Returns the distance (in meters) from this coordinate to the coordinate specified by other. Altitude is not used in the calculation.
This calculation returns the great-circle distance between the two coordinates, with an assumption that the Earth is spherical for the purpose of this calculation.
Returns 0 if the type of this coordinate or the type of other is QGeoCoordinate::InvalidCoordinate.
bool QGeoCoordinate::isValid () const
Returns true if the type() is Coordinate2D or Coordinate3D.
double QGeoCoordinate::latitude () const
Returns the latitude, in decimal degrees. The return value is undefined if the latitude has not been set.
A positive latitude indicates the Northern Hemisphere, and a negative latitude indicates the Southern Hemisphere.
See also setLatitude() and type().
double QGeoCoordinate::longitude () const
Returns the longitude, in decimal degrees. The return value is undefined if the longitude has not been set.
A positive longitude indicates the Eastern Hemisphere, and a negative longitude indicates the Western Hemisphere.
See also setLongitude() and type().
void QGeoCoordinate::setAltitude ( double altitude )
Sets the altitude (meters above sea level) to altitude.
See also altitude().
void QGeoCoordinate::setLatitude ( double latitude )
Sets the latitude (in decimal degrees) to latitude. The value should be in the WGS84 datum.
To be valid, the latitude must be between -90 to 90 inclusive.
See also latitude().
void QGeoCoordinate::setLongitude ( double longitude )
Sets the longitude (in decimal degrees) to longitude. The value should be in the WGS84 datum.
To be valid, the longitude must be between -180 to 180 inclusive.
See also longitude().
QString QGeoCoordinate::toString ( CoordinateFormat format = DegreesMinutesSecondsWithHemisphere ) const
Returns this coordinate as a string in the specified format.
For example, if this coordinate has a latitude of -27.46758, a longitude of 153.027892 and an altitude of 28.1, these are the strings returned depending on format:
| format value | Returned string |
|---|---|
| DecimalDegrees | -27.46758°, 153.02789°, 28.1m |
| DecimalDegreesWithHemisphere | 27.46758° S, 153.02789° E, 28.1m |
| DegreesMinutes | -27° 28.054', 153° 1.673', 28.1m |
| DegreesMinutesWithHemisphere | 27° 28.054 S', 153° 1.673' E, 28.1m |
| DegreesMinutesSeconds | -27° 28' 3.2", 153° 1' 40.4", 28.1m |
| DegreesMinutesSecondsWithHemisphere | 27° 28' 3.2" S, 153° 1' 40.4" E, 28.1m |
The altitude field is omitted if no altitude is set.
If the coordinate is invalid, an empty string is returned.
CoordinateType QGeoCoordinate::type () const
Returns the type of this coordinate.
Returns true if the latitude, longitude or altitude of this coordinate are not the same as those of other.
Assigns other to this coordinate and returns a reference to this coordinate.
bool QGeoCoordinate::operator== ( const QGeoCoordinate & other ) const
Returns true if the latitude, longitude and altitude of this coordinate are the same as those of other.
Related Non-Members
QDataStream & operator<< ( QDataStream & stream, const QGeoCoordinate & coordinate )
Writes the given coordinate to the specified stream.
See also Format of the QDataStream Operators.
QDataStream & operator>> ( QDataStream & stream, QGeoCoordinate & coordinate )
Reads a coordinate from the specified stream into the given coordinate.
See also Format of the QDataStream Operators.
Best Of
Actualités les plus lues
- « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 64
- Créer des applications avec un style Metro avec Qt, exemples en QML et C++, un article du blog Digia traduit par Thibaut Cuvelier 0
- 2017 : un quinquennat pour une nouvelle version du C++ ? Possible, selon Herb Sutter 3
- Orientation de l'écran en QML, un article de Christophe Dumez traduit par Thibaut Cuvelier 0
- « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 64
- Apercevoir la troisième dimension ou l'utilisation multithreadée d'OpenGL dans Qt, un article des Qt Quarterly traduit par Guillaume Belz 0
- Les développeurs ignorent-ils trop les failles découvertes dans leur code ? Prenez-vous en compte les remarques des autres ? 17
- BlackBerry 10 : premières images du prochain OS de RIM qui devrait intégrer des widgets et des tuiles inspirées de Windows Phone 0
- Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
- Adieu qmake, bienvenue qbs : Qt Building Suite, un outil déclaratif et extensible pour la compilation de projets Qt 17
- La rubrique Qt a besoin de vous ! 1
- Linus Torvalds : le "C++ est un langage horrible", en justifiant le choix du C pour le système de gestion de version Git 100
- Comment prendre en compte l'utilisateur dans vos applications ? Pour un développeur, « 90 % des utilisateurs sont des idiots » 229
- Quel est LE livre que tout développeur doit lire absolument ? Celui qui vous a le plus marqué et inspiré 96
- Apple cède et s'engage à payer des droits à Nokia, le conflit des brevets entre les deux firmes s'achève 158
- Nokia porte à nouveau plainte contre Apple pour violation de sept nouveaux brevets 158
- Quel est le code dont vous êtes le plus fier ? Pourquoi l'avez-vous écrit ? Et pourquoi vous a-t-il donné autant de satisfaction ? 83
- Le Draft final de la norme C++ 0X validé 181
Le blog Digia au hasard
Déploiement d'applications Qt Commercial sur les tablettes Windows 8
Communauté
Ressources
- 91 cours et tutoriels Qt
- F.A.Q. Qt : 200 questions et réponses
- 48 Qt Quarterly, 35 Qt Labs et 22 Qt DevNet en français
- 43 outils Qt
- 99 sources Qt
- 26 binaires Qt
- 6 livres Qt et 9 critiques
- La documentation de Qt 4.7 en français : 157 classes, 70 concepts et 24 modules
- 3 certifications Qt
Liens utiles
Contact
- Vous souhaitez rejoindre la rédaction ou proposer un tutoriel, une traduction, une question... ? Postez dans le forum Contribuez ou contactez-nous par MP ou par email (voir en bas de page).
Qt dans le magazine
| Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. | Qt qtmobility-1.0-tp | |
| Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD. | ||
| Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP ! | ||
Copyright © 2000-2012 - www.developpez.com