Coordinates

LatLng

Classe google.maps.LatLng

Un LatLng est un point de coordonnées géographiques (latitude et longitude).

  • La plage est comprise entre -90 et 90 degrés (inclus). Les valeurs supérieures ou inférieures à cette plage seront limitées à la plage [-90, 90]. Cela signifie que si la valeur spécifiée est inférieure à -90, la valeur définie est -90. Si la valeur est supérieure à 90, elle est définie sur 90.
  • La longitude est comprise entre -180 et 180 degrés, inclus. Les valeurs supérieures ou inférieures à cette plage sont encapsulées de sorte qu'elles appartiennent à la plage. Par exemple, une valeur de -190 sera convertie en 170. La valeur 190 sera convertie en -170. Cela reflète le fait que les longitudes couvrent le monde entier.
Bien que la projection de carte par défaut associe la longitude à la coordonnée x de la carte et la latitude à la coordonnée y, la latitude s'écrit toujours en premier, suivie de la longitude.
Notez que vous ne pouvez pas modifier les coordonnées d'un LatLng. Si vous souhaitez calculer un autre point, vous devez en créer un autre.

La plupart des méthodes qui acceptent les objets LatLng acceptent également un objet LatLngLiteral, de sorte que les éléments suivants sont équivalents:

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

Le constructeur accepte également les objets LatLngLiteral et LatLng. Si une instance LatLng est transmise au constructeur, une copie est créée.

Voici les appels possibles au constructeur:

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

Accédez à en appelant const {LatLng} = await google.maps.importLibrary("core"). Consultez Bibliothèques dans l'API Maps JavaScript.

LatLng
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])
Paramètres:
  • latOrLatLngOrLatLngLiteralnumber|LatLngLiteral|LatLng
  • lngOrNoClampNoWrapnumber|boolean optional
  • noClampNoWrapboolean optional
Crée un objet LatLng représentant un point géographique. La latitude est spécifiée en degrés compris dans la plage [-90, 90]. La longitude est spécifiée en degrés dans la plage [-180, 180]. Définissez noClampNoWrap sur true pour activer les valeurs en dehors de cette plage. Notez l'ordre de latitude et de longitude.
equals
equals(other)
Paramètres:
Valeur renvoyée:boolean
Fonction de comparaison.
lat
lat()
Paramètres:aucun
Valeur renvoyée:number
Affiche la latitude en degrés.
lng
lng()
Paramètres:aucun
Valeur renvoyée:number
Renvoie la longitude en degrés.
toJSON
toJSON()
Paramètres:aucun
Valeur renvoyée:LatLngLiteral
Convertit en représentation JSON. Cette fonction est destinée à être utilisée via JSON.stringify.
toString
toString()
Paramètres:aucun
Valeur renvoyée:string
Convertit en représentation sous forme de chaîne.
toUrlValue
toUrlValue([precision])
Paramètres:
  • precisionnumber optional
Valeur renvoyée:string
Renvoie une chaîne au format "lat,lng" pour ces coordonnées LatLng. Par défaut, nous arrondissons les valeurs de latitude/longitude à 6 chiffres après la virgule.

Interface LatLngLiteral

google.maps.LatLngLiteral interface

Pour des raisons pratiques, il est possible d'utiliser des littéraux d'objet à la place d'objets LatLng. Ils sont convertis en objets LatLng lorsque l'API Google Maps les détecte.

Exemples:

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

Les littéraux d'objet LatLng ne sont pas compatibles avec la bibliothèque Geometry.

lat
Type:number
Latitude en degrés. Les valeurs seront limitées à la plage [-90, 90]. Cela signifie que si la valeur spécifiée est inférieure à -90, la valeur définie est -90. Si la valeur est supérieure à 90, elle est définie sur 90.
lng
Type:number
Longueur en degrés. Les valeurs situées en dehors de la plage [-180, 180] sont encapsulées de sorte qu'elles appartiennent à la plage. Par exemple, une valeur de -190 sera convertie en 170. La valeur 190 sera convertie en -170. Cela reflète le fait que les longitudes couvrent le monde entier.

LatLngBounds

Classe google.maps.LatLngBounds

Une instance LatLngBounds représente un rectangle aux coordonnées géographiques, y compris un qui traverse le méridien à 180 degrés.

Accédez à en appelant const {LatLngBounds} = await google.maps.importLibrary("core"). Consultez Bibliothèques dans l'API Maps JavaScript.

LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
Paramètres:
Construit un rectangle à partir des points situés à l'angle sud-ouest et nord-est.
contains
contains(latLng)
Paramètres:
Valeur renvoyée:boolean
Renvoie true si les coordonnées de latitude/longitude données sont comprises dans ces limites.
equals
equals(other)
Paramètres:
Valeur renvoyée:boolean
Renvoie true si cette limite est approximativement égale à la limite donnée.
extend
extend(point)
Paramètres:
Valeur renvoyée:LatLngBounds
Étend cette limite de manière à contenir le point donné.
getCenter
getCenter()
Paramètres:aucun
Valeur renvoyée:LatLng
Calcule le centre de ces coordonnées LatLngBounds
getNorthEast
getNorthEast()
Paramètres:aucun
Valeur renvoyée:LatLng
Affiche l'angle nord-est de ces limites.
getSouthWest
getSouthWest()
Paramètres:aucun
Valeur renvoyée:LatLng
Affiche l'angle sud-ouest de cette limite.
intersects
intersects(other)
Paramètres:
Valeur renvoyée:boolean
Renvoie true si cette limite partage des points avec les autres limites.
isEmpty
isEmpty()
Paramètres:aucun
Valeur renvoyée:boolean
Renvoie si les limites sont vides.
toJSON
toJSON()
Paramètres:aucun
Valeur renvoyée:LatLngBoundsLiteral
Convertit en représentation JSON. Cette fonction est destinée à être utilisée via JSON.stringify.
toSpan
toSpan()
Paramètres:aucun
Valeur renvoyée:LatLng
Convertit les limites de la carte en une latitude/longitude.
toString
toString()
Paramètres:aucun
Valeur renvoyée:string
Convertit en chaîne.
toUrlValue
toUrlValue([precision])
Paramètres:
  • precisionnumber optional
Valeur renvoyée:string
Renvoie une chaîne au format "lat_lo,lng_lo,lat_hi,lng_hi" pour ces limites, où "lo" correspond à l'angle sud-ouest de la boîte englobante, et "hi" correspond à l'angle nord-est de ce cadre.
union
union(other)
Paramètres:
Valeur renvoyée:LatLngBounds
Étend cette limite pour contenir l'union de cette limite et des limites données.
MAX_BOUNDS LatLngBounds pour les limites maximales de la Terre. Ces limites englobent l'ensemble du globe.

Interface LatLngBoundsLiteral

google.maps.LatLngBoundsLiteral interface

Les littéraux d'objet sont acceptés à la place des objets LatLngBounds dans l'API. Ils sont automatiquement convertis en objets LatLngBounds. Tous les éléments south, west, north et east doivent être définis. Sinon, une exception est levée.

east
Type:number
Longitude est en degrés. Les valeurs situées en dehors de la plage [-180, 180] sont encapsulées dans la plage [-180, 180]. Par exemple, une valeur de -190 sera convertie en 170. La valeur 190 sera convertie en -170. Cela reflète le fait que les longitudes couvrent le monde entier.
north
Type:number
Latitude nord en degrés. Les valeurs seront limitées à la plage [-90, 90]. Cela signifie que si la valeur spécifiée est inférieure à -90, la valeur définie est -90. Si la valeur est supérieure à 90, elle est définie sur 90.
south
Type:number
Latitude sud en degrés. Les valeurs seront limitées à la plage [-90, 90]. Cela signifie que si la valeur spécifiée est inférieure à -90, la valeur définie est -90. Si la valeur est supérieure à 90, elle est définie sur 90.
west
Type:number
Longitude Ouest en degrés. Les valeurs situées en dehors de la plage [-180, 180] sont encapsulées dans la plage [-180, 180]. Par exemple, une valeur de -190 sera convertie en 170. La valeur 190 sera convertie en -170. Cela reflète le fait que les longitudes couvrent le monde entier.

LatLngAltitude

Classe google.maps.LatLngAltitude

Un LatLngAltitude est un point 3D aux coordonnées géographiques (latitude, longitude et altitude).

  • La plage est comprise entre -90 et 90 degrés (inclus). Les valeurs supérieures ou inférieures à cette plage seront limitées à la plage [-90, 90]. Cela signifie que si la valeur spécifiée est inférieure à -90, la valeur définie est -90. Si la valeur est supérieure à 90, elle est définie sur 90.
  • La longitude est comprise entre -180 et 180 degrés, inclus. Les valeurs supérieures ou inférieures à cette plage sont encapsulées de sorte qu'elles appartiennent à la plage. Par exemple, une valeur de -190 sera convertie en 170. La valeur 190 sera convertie en -170. Cela reflète le fait que les longitudes couvrent le monde entier.
  • L'altitude est mesurée en mètres. Les valeurs positives correspondent aux hauteurs au-dessus du sol, tandis que les valeurs négatives correspondent aux hauteurs sous la surface du sol.

Cette classe implémente LatLngAltitudeLiteral.

Cette classe implémente LatLngLiteral.

Accédez à en appelant const {LatLngAltitude} = await google.maps.importLibrary("core"). Consultez Bibliothèques dans l'API Maps JavaScript.

LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
Paramètres:
  • valueLatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral|LatLng valeur d'initialisation.
  • noClampNoWrapboolean optional indique si les valeurs d'initialisation doivent être conservées, même si elles ne sont pas nécessairement des valeurs de latitude valides comprises dans la plage [-90, 90] ou des valeurs de longitude valides comprises dans la plage [-180, 180]. La valeur par défaut est false, ce qui active les paramètres de limitation de la latitude et de longitude.
altitude
Type:number
Affiche l'altitude.
lat
Type:number
Affiche la latitude.
lng
Type:number
Renvoie la longitude.
equals
equals(other)
Paramètres:
Valeur renvoyée:boolean indique si les deux objets sont égaux.
Fonction de comparaison.
toJSON
toJSON()
Paramètres:aucun
Valeur renvoyée:LatLngAltitudeLiteral Une représentation JSON de cet objet.

Interface LatLngAltitudeLiteral

google.maps.LatLngAltitudeLiteral interface

Pour des raisons pratiques, il est possible d'utiliser des littéraux d'objet à la place d'objets LatLngAltitude. Ils sont convertis en objets LatLngAltitude lorsque l'API Google Maps les détecte.

Cette interface étend LatLngLiteral.

altitude
Type:number
Par défaut:0
Distance (en mètres) au-dessus de la surface du sol. Une valeur négative signifie "sous la surface du sol".
lat
Type:number
Latitude en degrés. Les valeurs seront limitées à la plage [-90, 90]. Cela signifie que si la valeur spécifiée est inférieure à -90, la valeur définie est -90. Si la valeur est supérieure à 90, elle est définie sur 90.
lng
Type:number
Longueur en degrés. Les valeurs situées en dehors de la plage [-180, 180] sont encapsulées de sorte qu'elles appartiennent à la plage. Par exemple, une valeur de -190 sera convertie en 170. La valeur 190 sera convertie en -170. Cela reflète le fait que les longitudes couvrent le monde entier.

Classe Point

Classe google.maps.Point

Accédez à en appelant const {Point} = await google.maps.importLibrary("core"). Consultez Bibliothèques dans l'API Maps JavaScript.

Point
Point(x, y)
Paramètres:
  • xnumber
  • ynumber
Point sur un plan bidimensionnel.
x
Type:number
Coordonnée X
y
Type:number
Coordonnée Y
equals
equals(other)
Paramètres:
Valeur renvoyée:boolean
Compare deux points
toString
toString()
Paramètres:aucun
Valeur renvoyée:string
Renvoie une représentation sous forme de chaîne de ce point.

Size

Classe google.maps.Size

Accédez à en appelant const {Size} = await google.maps.importLibrary("core"). Consultez Bibliothèques dans l'API Maps JavaScript.

Size
Size(width, height[, widthUnit, heightUnit])
Paramètres:
  • widthnumber
  • heightnumber
  • widthUnitstring optional
  • heightUnitstring optional
Taille en deux dimensions, où la largeur correspond à la distance sur l'axe X et la hauteur sur la distance sur l'axe Y.
height
Type:number
Hauteur sur l'axe y, en pixels.
width
Type:number
Largeur le long de l'axe des abscisses, en pixels.
equals
equals(other)
Paramètres:
Valeur renvoyée:boolean
Compare deux tailles.
toString
toString()
Paramètres:aucun
Valeur renvoyée:string
Renvoie une représentation de chaîne de cette taille.

Remplissage

google.maps.Padding interface

bottom optional
Type:number optional
Marge intérieure inférieure, en pixels.
left optional
Type:number optional
Marge intérieure du bord gauche, en pixels
right optional
Type:number optional
Marge intérieure de droite, en pixels.
top optional
Type:number optional
Marge intérieure supérieure, en pixels.

Interface CircleLiteral

google.maps.CircleLiteral interface

Littéral d'objet qui représente un cercle.

Cette interface étend CircleOptions.

center
Au centre du cercle
radius
Type:number
Rayon en mètres sur la surface de la Terre.
Hérité: clickable, draggable, editable, fillColor, fillOpacity, map, strokeColor, strokeOpacity, strokePosition, strokeWeight, visible, zIndex