LatLng

Référence API Google Maps JavaScript version 3.24

API Google Maps JavaScript version 3

Classe LatLng

classe google.maps.LatLng

Un LatLng est un point en coordonnées géographiques : latitude et longitude.

  • La latitude varie entre -90 et 90 degrés, bornes comprises. Les valeurs supérieures ou inférieures à cette plage seront ramenées vers la valeur la plus proche dans cette plage. Par exemple, spécifier une latitude de 100 définit la valeur de 90.
  • La longitude varie entre -180 et 180 degrés, bornes comprises. Les valeurs supérieures ou inférieures à cette plage seront modifiées de façon à se retrouver dans la plage [-180, 180). Par exemple, 480, 840 et 1200 seront toutes modifiées en 120 degrés.

Bien que la projection de la carte par défaut associe la longitude à la coordonnée x de la carte, et la latitude avec la coordonnée y, la coordonnée de la latitude est toujours écrite en première, suivie de la longitude.

Notez que vous ne pouvez pas modifier les coordonnées d'un LatLng. Si vous désirez calculer un autre point, vous devez en créer un nouveau.

La plupart des méthodes acceptant un objet LatLng acceptent également un objet LatLngLiteral, ainsi les deux écritures ci-dessous sont équivalentes :

map.setCenter ( new google.maps.LatLng (-34, 151) );
map.setCenter ( {lat: -34, lng: 151} );

Le constructeur accepte également les objets littéraux, et les convertit en instance de l'objet LatLng :

myLatLng = new google.maps.LatLng ({lat: -34, lng: 151});
Constructeur
Méthode
Constructeur LatLng
ConstructeurDescription
LatLng(
     lat: number ,
     lng: number ,
     noWrap?: boolean 
)

Crée un objet LatLng représentant un point géographique.

La latitude est indiquée en degrès dans l'intervalle [-90, 90]

La longitude est indiquée en degrès dans l'intervalle [-180, 180]

Définissez noWrap sur  true  pour activer les valeurs en dehors de cette fourchette. Notez l'ordre de la latitude et de la longitude.

Méthode LatLng
MéthodeValeur RetournéeDescription
equals(
       other:LatLng
)
Valeur retournée :  boolean 

Fonction de comparaison.

lat()Valeur retournée :  number 

Retourne la latitude en degrés.

lng()Valeur retournée :  number 

Retourne la longitude en degrés.

toString()Valeur retournée :  string 

Convertit la représentation sous forme de chaîne.

toUrlValue(
       precision?: number 
)
Valeur retournée :  string 

Retourne une chaîne de la forme "lat, lng" pour ce LatLng.

Les valeurs de Lat / Lng sont arrondies et/ou complétées à 6 décimales  par défaut .