Classe GLatLng

Un objet de type GLatLng représente un point géographique par sa latitude et sa longitude.

NB: bien qu’habituellement la longitude soit représentée par une coordonnée en x et la longitude en y, Google a choisi de suivre la terminologie cartographique qui veut que la latitude s’écrive en premier et la longitude en second, comme le montre le constructeur GlatLng.
En outre, vous ne pouvez pas modifier les coordonnées d’un objet GLatLng. Si vous souhaitez modifier un point, il est nécessaire d’en créer un nouveau.

Le constructeur GLatLng

Signature de la classe GLatLng : GLatLng(lat,lng,[unbounded]).

Créé un nouvel objet GLatLng. Si unbounded vaut true, la latitude et la longitude passées en paramètre seront utilisées. Sinon, la latitude sera comprise entre -90 degrés et +90 degrés et la longitude entre -180 et +180 degrés.

<script type="text/javascript">

   var map = new GMap2(document.getElementById('map'), { size: new GSize(200,200)});
   /* Ici, nous déclarons l'élément html ayant pour id "map" comme conteneur de la map
   avec une taille de 200 * 200 pixel */

   var Paris = new GLatLng(48.8566667, 2.3509871);
   /* Paris est une instance de la classe GLatLng.
   Il s'agit donc d'un point représenté par ses coordonnées  */

   map.setCenter(Paris, 13);
   /* Affichage de la carte centrée sur Paris avec un zoom 13 */

</script>

lat()

La méthode lat() retourne la latitude d’un point en degrés.

<script type="text/javascript">

   var map = new GMap2(document.getElementById('map'), { size: new GSize(200,200)});
   /* Ici, nous déclarons l'élément html ayant pour id "map" comme conteneur de la map
   avec une taille de 200 * 200 pixel */

   var Paris = new GLatLng(48.8566667, 2.3509871);
   /* Paris est une instance de la classe GLatLng.
   Il s'agit donc d'un point représenté par ses coordonnées  */

   map.setCenter(Paris, 13);
   /* Affichage de la carte centrée sur Paris avec un zoom 13 */

   GLog.write(Paris.lat());
   /* Affiche  48.8566667 */

</script>

lng()

La méthode lng() retourne la longitude d’un point en degrés.

<script type="text/javascript">

   var map = new GMap2(document.getElementById('map'), { size: new GSize(200,200)});
   /* Ici, nous déclarons l'élément html ayant pour id "map" comme conteneur de la map
   avec une taille de 200 * 200 pixel */

   var Paris = new GLatLng(48.8566667, 2.3509871);
   /* Paris est une instance de la classe GLatLng.
   Il s'agit donc d'un point représenté par ses coordonnées  */

   map.setCenter(Paris, 13);
   /* Affichage de la carte centrée sur Paris avec un zoom 13 */

   GLog.write(Paris.lng());
   /* Affiche  2.3509871 */

</script>

latRadians()

La méthode latRadians() retourne la latitude d’un point en radians comprise entre -PI/2 et +PI/2.

<script type="text/javascript">

   var map = new GMap2(document.getElementById('map'), { size: new GSize(200,200)});
   /* Ici, nous déclarons l'élément html ayant pour id "map" comme conteneur de la map
   avec une taille de 200 * 200 pixel */

   var Paris = new GLatLng(48.8566667, 2.3509871);
   /* Paris est une instance de la classe GLatLng.
   Il s'agit donc d'un point représenté par ses coordonnées  */

   map.setCenter(Paris, 11);
   /* Affichage de la carte centrée sur Paris avec un zoom 11 */

   GLog.write(Paris.latRadians());
   /* Affiche  0.8527096954644726 */

</script>

lngRadians()

La méthode lngRadians() retourne la longitude d’un point en radians comprise entre -PI et +PI.

<script type="text/javascript">

   var map = new GMap2(document.getElementById('map'), { size: new GSize(200,200)});
   /* Ici, nous déclarons l'élément html ayant pour id "map" comme conteneur de la map
   avec une taille de 200 * 200 pixel */

   var Paris = new GLatLng(48.8566667, 2.3509871);
   /* Paris est une instance de la classe GLatLng.
   Il s'agit donc d'un point représenté par ses coordonnées  */

   map.setCenter(Paris, 11);
   /* Affichage de la carte centrée sur Paris avec un zoom 11 */

   GLog.write(Paris.lngRadians());
   /* Affiche  0.04103246556691319 */

</script>

equals(other)

La métode equals compare deux objet de type GLatLng et retourne true si les propriétés de ces 2 objets ont exactement les mêmes valeurs (à un certain arrondi près).

<script type="text/javascript">

   var map = new GMap2(document.getElementById('map'), {mapTypes: [G_PHYSICAL_MAP]});
   /* Ici, nous déclarons l'élément html ayant pour id "map" comme conteneur de la map
   avec une vue de type "terrain" par défaut */

   var Paris = new GLatLng(48.8566667, 2.3509871);
   var Versailles = new GLatLng(48.80233, 2.1298227);
   /* Instanciation de 2 objets GLatLng */

   if(Paris.equals(Versailles))
	GLog.write('Les propriétés de ces 2 objets ont les mêmes valeurs');

</script>

distanceFrom()

Jusqu’à la version 2.89 de l’Api Google Map, la signature de la méthode distanceFrom était : distanceFrom(Other: GLatLng).
Depuis la version 2.89, sa signature est : distanceFrom(other:GLatLng, radius?:Number) .

La métode distanceFrom() retourne la distance (à vol d’oiseau) en mètres entre 2 points donnés. Par défaut, cette distance est calculée par rapport au rayon (à l’Équateur) de la Terre, soit 6378137 mètres.

La Terre étant considérée comme une sphère, la distance peut différer de 0,3%, en particulier pour les extrêmes polaires.

Il est cependant possible de renseigner un argument optionnel (radius) correspondant à un rayon différent de celui par défaut.

<script type="text/javascript">

   var map = new GMap2(document.getElementById('map'), {mapTypes: [G_PHYSICAL_MAP]});
   /* Ici, nous déclarons l'élément html ayant pour id "map" comme conteneur de la map
   avec une vue de type "terrain" par défaut */

   var Paris = new GLatLng(48.8566667, 2.3509871);
   var Versailles = new GLatLng(48.80233, 2.1298227);
   /* Instanciation de 2 objets GLatLng */

   GLog.write('Distance Paris > Versailles : '+Paris.distanceFrom(Versailles)+' mètres');
   /* Affiche :  Distance Paris > Versailles : 17299.26593292102 mètres */

</script>

toUrlValue()

Jusqu’à la version 2.78 de l’Api Google Map, la signature de la méthode toUrlValue était : toUrlValue().
Depuis la version 2.78, sa signature est : toUrlValue(precision?:Number) .

La métode toUrlValue() retourne une chaîne de caractères contenant la latitude et la longitude du point séparées par une virgule. Cette chaîne de caractères peut directement être utilisée dans une URL pour afficher ce point via un navigateur.

Par défaut, la précision est de 6 chiffres après la virgule.
Cette précision (disponible depuis la version 2.78) peut être modifiée afin de réduire le temps de chargement du serveur pour l’affichage du point.

<script type="text/javascript">

   var map = new GMap2(document.getElementById('map'), {mapTypes: [G_PHYSICAL_MAP]});
   /* Ici, nous déclarons l'élément html ayant pour id "map" comme conteneur de la map
   avec une vue de type "terrain" par défaut */

   var Paris = new GLatLng(48.8566667, 2.3509871);
   /* Instanciation d'un objet GLatLng */

   GLog.write(Paris.toUrlValue());
   /* Affiche :  48.856667,2.350987 */

   En récupérant ce résultat, l'url suivante affichera directement
   le point sur la Google Map :
   http://maps.google.fr/maps?hl=fr&tab=wl&q=48.856667,2.350987

</script>

fromUrlValue()

Cette méthode est disponible depuis la version 2.78. Sa signature est : GLatLng.fromUrlValue(latlng:String) .

La métode fromUrlValue() convertit la chaîne de caractères (latitude/longitude) passée en paramètre en un objet de type GLatLng. Le format de ce paramètre est: latitude,longitude.
Cette retourne un objet de type GLatLng avec une précision de 6 chiffres après la virgule.

Par défaut, la précision est de 6 chiffres après la virgule.
Cette précision (disponible depuis la version 2.78) peut être modifiée afin de réduire le temps de chargement du serveur pour l’affichage du point.

<script type="text/javascript">

   var map = new GMap2(document.getElementById('map'), {mapTypes: [G_PHYSICAL_MAP]});
   /* Ici, nous déclarons l'élément html ayant pour id "map" comme conteneur de la map
   avec une vue de type "terrain" par défaut */

   var coordonneesParis = '48.8566667, 2.3509871';
   /* Ici on dispose des coordonnées d'un point */

   var Paris = GLatLng.fromUrlValue(coordonneesParis);
   /* Paris sera donc un objet de type GLatLng */

</script>

Laisser une réponse

Security Code: