Classe LatLng
Classe google.maps.LatLng
Un LatLng est un point de coordonnées géographiques : latitude et longitude.
- La latitude 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, elle sera définie sur -90. Si la valeur est supérieure à 90, elle sera définie sur 90.
- La longitude est comprise entre -180 et 180 degrés, inclus. Les valeurs supérieures ou inférieures à cette fourchette seront converties pour être incluses dans la fourchette. Par exemple, une valeur de -190 sera convertie en 170. Une valeur de 190 sera convertie en -170. Cela reflète le fait que les longitudes font le tour du globe.
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. La plupart des méthodes qui acceptent les objets LatLng acceptent également un objet LatLngLiteral. Les éléments suivants sont donc é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(new google.maps.LatLng(-34, 151));
new google.maps.LatLng(new google.maps.LatLng(-34, 151), true);
Accédez-y en appelant le const {LatLng} = await google.maps.importLibrary("core").
Consultez Bibliothèques de l'API Maps JavaScript.
Constructeur | |
|---|---|
LatLng |
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])Paramètres :
Crée un objet LatLng représentant un point géographique. La latitude est spécifiée en degrés 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 la latitude et de la longitude. |
Méthodes | |
|---|---|
equals |
equals(other)Paramètres :
Valeur renvoyée :
booleanFonction de comparaison. |
lat |
lat()Paramètres : aucun
Valeur renvoyée :
numberRenvoie la latitude en degrés. |
lng |
lng()Paramètres : aucun
Valeur renvoyée :
numberRenvoie la longitude en degrés. |
toJSON |
toJSON()Paramètres : aucun
Valeur renvoyée :
LatLngLiteralConvertit en représentation JSON. Cette fonction est destinée à être utilisée via JSON.stringify. |
toString |
toString()Paramètres : aucun
Valeur renvoyée :
stringConvertit en représentation de chaîne. |
toUrlValue |
toUrlValue([precision])Paramètres :
Valeur renvoyée :
stringRenvoie une chaîne au format "lat,lng" pour ce LatLng. Par défaut, nous arrondissons les valeurs de latitude et de longitude à six décimales. |
Interface LatLngLiteral
Interface google.maps.LatLngLiteral
Les littéraux d'objet sont acceptés à la place des objets LatLng, par souci de commodité, à de nombreux endroits. Ils sont convertis en objets LatLng lorsque l'API Maps les rencontre.
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 acceptés dans la bibliothèque Geometry.
Propriétés | |
|---|---|
lat |
Type :
numberLatitude 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, elle sera définie sur -90. Si la valeur est supérieure à 90, elle sera définie sur 90. |
lng |
Type :
numberLongueur en degrés. Les valeurs en dehors de la plage [-180, 180] seront converties pour être incluses dans la plage. Par exemple, une valeur de -190 sera convertie en 170. Une valeur de 190 sera convertie en -170. Cela reflète le fait que les longitudes font le tour du globe. |
Classe LatLngBounds
Classe google.maps.LatLngBounds
Une instance LatLngBounds représente un rectangle en coordonnées géographiques, y compris un rectangle qui traverse le méridien de longitude de 180 degrés.
Accédez-y en appelant le const {LatLngBounds} = await google.maps.importLibrary("core").
Consultez Bibliothèques de l'API Maps JavaScript.
Constructeur | |
|---|---|
LatLngBounds |
LatLngBounds([swOrLatLngBounds, ne])Paramètres :
Construit un rectangle à partir des points situés à ses angles sud-ouest et nord-est. |
Constantes | |
|---|---|
MAX_BOUNDS |
LatLngBounds pour les limites maximales de la Terre. Ces limites engloberont le monde entier. |
Méthodes | |
|---|---|
contains |
contains(latLng)Paramètres :
Valeur renvoyée :
booleanRenvoie true si la latitude/longitude donnée se trouve dans ces limites. |
equals |
equals(other)Paramètres :
Valeur renvoyée :
booleanRenvoie true si ces limites sont approximativement égales aux limites données. |
extend |
extend(point)Paramètres :
Valeur renvoyée :
LatLngBoundsÉtend ces limites pour contenir le point donné. |
getCenter |
getCenter()Paramètres : aucun
Valeur renvoyée :
LatLngCalcule le centre de ce LatLngBounds. |
getNorthEast |
getNorthEast()Paramètres : aucun
Valeur renvoyée :
LatLngRenvoie l'angle nord-est de ces limites. |
getSouthWest |
getSouthWest()Paramètres : aucun
Valeur renvoyée :
LatLngRenvoie l'angle sud-ouest de ces limites. |
intersects |
intersects(other)Paramètres :
Valeur renvoyée :
booleanRenvoie true si ces limites partagent des points avec les autres limites. |
isEmpty |
isEmpty()Paramètres : aucun
Valeur renvoyée :
booleanRenvoie si les limites sont vides. |
toJSON |
toJSON()Paramètres : aucun
Valeur renvoyée :
LatLngBoundsLiteralConvertit en représentation JSON. Cette fonction est destinée à être utilisée via JSON.stringify. |
toSpan |
toSpan()Paramètres : aucun
Valeur renvoyée :
LatLngConvertit les limites de la carte données en étendue de latitude/longitude. |
toString |
toString()Paramètres : aucun
Valeur renvoyée :
stringConvertit en chaîne. |
toUrlValue |
toUrlValue([precision])Paramètres :
Valeur renvoyée :
stringRenvoie une chaîne au format "lat_lo,lng_lo,lat_hi,lng_hi" pour ces limites, où "lo" correspond à l'angle sud-ouest du cadre de délimitation, tandis que "hi" correspond à l'angle nord-est de ce cadre. |
union |
union(other)Paramètres :
Valeur renvoyée :
LatLngBoundsÉtend ces limites pour contenir l'union de celles-ci et des limites spécifiées. |
Interface LatLngBoundsLiteral
Interface google.maps.LatLngBoundsLiteral
Les littéraux d'objet sont acceptés à la place des objets LatLngBounds dans toute l'API. Elles sont automatiquement converties en objets LatLngBounds. Tous les south, west, north et east doivent être définis, sinon une exception est générée.
Propriétés | |
|---|---|
east |
Type :
numberLongitude est en degrés. Les valeurs en dehors de la plage [-180, 180] seront ramenées à la plage [-180, 180). Par exemple, une valeur de -190 sera convertie en 170. Une valeur de 190 sera convertie en -170. Cela reflète le fait que les longitudes font le tour du globe. |
north |
Type :
numberLatitude 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, elle sera définie sur -90. Si la valeur est supérieure à 90, elle sera définie sur 90. |
south |
Type :
numberLatitude 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, elle sera définie sur -90. Si la valeur est supérieure à 90, elle sera définie sur 90. |
west |
Type :
numberLongitude ouest en degrés. Les valeurs en dehors de la plage [-180, 180] seront ramenées à la plage [-180, 180). Par exemple, une valeur de -190 sera convertie en 170. Une valeur de 190 sera convertie en -170. Cela reflète le fait que les longitudes font le tour du globe. |
Classe LatLngAltitude
Classe google.maps.LatLngAltitude
Un LatLngAltitude est un point 3D en coordonnées géographiques : latitude, longitude et altitude.
- La latitude 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, elle sera définie sur -90. Si la valeur est supérieure à 90, elle sera définie sur 90.
- La longitude est comprise entre -180 et 180 degrés, inclus. Les valeurs supérieures ou inférieures à cette fourchette seront converties pour être incluses dans la fourchette. Par exemple, une valeur de -190 sera convertie en 170. Une valeur de 190 sera convertie en -170. Cela reflète le fait que les longitudes font le tour du globe.
- L'altitude est mesurée en mètres. Les valeurs positives indiquent des hauteurs au-dessus du niveau du sol, et les valeurs négatives des hauteurs en dessous de la surface du sol.
Cette classe implémente LatLngAltitudeLiteral.
Cette classe implémente LatLngLiteral.
Accédez-y en appelant le const {LatLngAltitude} = await google.maps.importLibrary("core").
Consultez Bibliothèques de l'API Maps JavaScript.
Constructeur | |
|---|---|
LatLngAltitude |
LatLngAltitude(value[, noClampNoWrap])Paramètres :
|
Propriétés | |
|---|---|
altitude |
Type :
numberRenvoie l'altitude. |
lat |
Type :
numberRenvoie la latitude. |
lng |
Type :
numberRenvoie la longitude. |
Méthodes | |
|---|---|
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
Interface google.maps.LatLngAltitudeLiteral
Les littéraux d'objet sont acceptés à la place des objets LatLngAltitude, par souci de commodité, à de nombreux endroits. Ils sont convertis en objets LatLngAltitude lorsque l'API Maps les rencontre.
Cette interface étend LatLngLiteral.
Propriétés | |
|---|---|
altitude |
Type :
numberPar défaut :
0Distance (en mètres) au-dessus de la surface du sol. Une valeur négative signifie que le point se trouve sous la surface du sol. |
lat |
Type :
numberLatitude 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, elle sera définie sur -90. Si la valeur est supérieure à 90, elle sera définie sur 90. |
lng |
Type :
numberLongueur en degrés. Les valeurs en dehors de la plage [-180, 180] seront converties pour être incluses dans la plage. Par exemple, une valeur de -190 sera convertie en 170. Une valeur de 190 sera convertie en -170. Cela reflète le fait que les longitudes font le tour du globe. |
Classe Point
Classe google.maps.Point
Accédez-y en appelant le const {Point} = await google.maps.importLibrary("core").
Consultez Bibliothèques de l'API Maps JavaScript.
Constructeur | |
|---|---|
Point |
Point(x, y)Paramètres :
Point sur un plan bidimensionnel. |
Propriétés | |
|---|---|
x |
Type :
numberCoordonnée X |
y |
Type :
numberCoordonnée Y |
Méthodes | |
|---|---|
equals |
equals(other)Paramètres :
Valeur renvoyée :
booleanCompare deux points |
toString |
toString()Paramètres : aucun
Valeur renvoyée :
stringRenvoie une représentation sous forme de chaîne de ce point. |
Classe Size
Classe google.maps.Size
Accédez-y en appelant le const {Size} = await google.maps.importLibrary("core").
Consultez Bibliothèques de l'API Maps JavaScript.
Constructeur | |
|---|---|
Size |
Size(width, height[, widthUnit, heightUnit])Paramètres :
Taille bidimensionnelle, où la largeur correspond à la distance sur l'axe X et la hauteur à la distance sur l'axe Y. |
Propriétés | |
|---|---|
height |
Type :
numberHauteur le long de l'axe Y, en pixels. |
width |
Type :
numberLargeur le long de l'axe X, en pixels. |
Méthodes | |
|---|---|
equals |
equals(other)Paramètres :
Valeur renvoyée :
booleanCompare deux tailles. |
toString |
toString()Paramètres : aucun
Valeur renvoyée :
stringRenvoie une représentation sous forme de chaîne de cette taille. |
Interface Padding
Interface google.maps.Padding
Propriétés | |
|---|---|
bottom optional |
Type :
number optionalMarge intérieure inférieure, en pixels. |
left optional |
Type :
number optionalMarge intérieure à gauche, en pixels. |
right optional |
Type :
number optionalMarge intérieure à droite, en pixels. |
top optional |
Type :
number optionalMarge intérieure supérieure, en pixels. |
Interface CircleLiteral
Interface google.maps.CircleLiteral
Littéral d'objet représentant un cercle.
Cette interface étend CircleOptions.
Propriétés | |
|---|---|
center |
Type :
LatLng|LatLngLiteralCentre du cercle. |
radius |
Type :
numberRayon en mètres à la surface de la Terre. |
Hérité :
clickable,
draggable,
editable,
fillColor,
fillOpacity,
map,
strokeColor,
strokeOpacity,
strokePosition,
strokeWeight,
visible,
zIndex
| |
Classe Orientation3D
Classe google.maps.Orientation3D
Un Orientation3D est un vecteur tridimensionnel utilisé pour les transformations de rotation mathématiques standards le long du cap, de l'inclinaison et du roulis.
- L'orientation est un angle compris entre 0 et 360 degrés.
- L'inclinaison est un angle compris entre 0 et 360 degrés.
- Le roulis est un angle compris entre 0 et 360 degrés (exclus).
Cette classe implémente Orientation3DLiteral.
Accédez-y en appelant le const {Orientation3D} = await google.maps.importLibrary("core").
Consultez Bibliothèques de l'API Maps JavaScript.
Constructeur | |
|---|---|
Orientation3D |
Orientation3D(value)Paramètres :
|
Propriétés | |
|---|---|
heading |
Type :
numberPar défaut :
0Rotation autour de l'axe Z (normal à la surface de la Terre). Une valeur de 0 (par défaut) correspond au nord. Une rotation positive s'effectue dans le sens des aiguilles d'une montre autour de l'axe Z et est spécifiée en degrés de 0 à 360. Les valeurs supérieures ou inférieures à cette fourchette seront converties pour être incluses dans la fourchette. Par exemple, une valeur de -190 sera convertie en 170. Une valeur de 530 sera également convertie en 170. |
roll |
Type :
numberPar défaut :
0Rotation autour de l'axe Y. Une rotation positive s'effectue dans le sens des aiguilles d'une montre autour de l'axe Y et est spécifiée en degrés de 0 à 360. Les valeurs supérieures ou inférieures à cette fourchette seront converties pour être incluses dans la fourchette. Par exemple, une valeur de -190 sera convertie en 170. Une valeur de 530 sera également convertie en 170. |
tilt |
Type :
numberPar défaut :
0Rotation autour de l'axe X. Une rotation positive s'effectue dans le sens des aiguilles d'une montre autour de l'axe X et est spécifiée en degrés (de 0 à 360). Les valeurs supérieures ou inférieures à cette fourchette seront converties pour être incluses dans la fourchette. Par exemple, une valeur de -190 sera convertie en 170. Une valeur de 530 sera également convertie en 170. |
Méthodes | |
|---|---|
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 :
Orientation3DLiteralConvertit en représentation JSON. Cette fonction est destinée à être utilisée via JSON.stringify. |
Interface Orientation3DLiteral
Interface google.maps.Orientation3DLiteral
Les littéraux d'objet sont acceptés à la place des objets Orientation3D, par souci de commodité, à de nombreux endroits. Ils sont convertis en objets Orientation3D lorsque l'API Maps les rencontre.
Propriétés | |
|---|---|
heading optional |
Type :
number optionalRotation autour de l'axe Z (normal à la surface de la Terre). Une valeur de 0 (par défaut) correspond au nord. Une rotation positive s'effectue dans le sens des aiguilles d'une montre autour de l'axe Z et est spécifiée en degrés de 0 à 360. |
roll optional |
Type :
number optionalRotation autour de l'axe Y. Une rotation positive s'effectue dans le sens des aiguilles d'une montre autour de l'axe Y et est spécifiée en degrés de 0 à 360. |
tilt optional |
Type :
number optionalRotation autour de l'axe X. Une rotation positive s'effectue dans le sens des aiguilles d'une montre autour de l'axe X et est spécifiée en degrés (de 0 à 360). |
Classe Vector3D
Classe google.maps.Vector3D
Un Vector3D est un vecteur tridimensionnel utilisé pour les opérations mathématiques standards, comme la mise à l'échelle des limites d'un objet tridimensionnel le long des axes x, y et z locaux.
- x est un nombre réel.
- y est un nombre réel.
- z est un nombre réel.
Cette classe implémente Vector3DLiteral.
Accédez-y en appelant le const {Vector3D} = await google.maps.importLibrary("core").
Consultez Bibliothèques de l'API Maps JavaScript.
Constructeur | |
|---|---|
Vector3D |
Vector3D(value)Paramètres :
|
Propriétés | |
|---|---|
x |
Type :
numberComposant X du vecteur tridimensionnel. |
y |
Type :
numberComposant Y du vecteur tridimensionnel. |
z |
Type :
numberComposant Z du vecteur tridimensionnel. |
Méthodes | |
|---|---|
equals |
equals(other)Paramètres :
Valeur renvoyée :
booleanFonction de comparaison. |
toJSON |
toJSON()Paramètres : aucun
Valeur renvoyée :
Vector3DLiteralConvertit en représentation JSON. Cette fonction est destinée à être utilisée via JSON.stringify. |
Interface Vector3DLiteral
Interface google.maps.Vector3DLiteral
Les littéraux d'objet sont acceptés à la place des objets Vector3D, par souci de commodité, à de nombreux endroits. Ils sont convertis en objets Vector3D lorsque l'API Maps les rencontre.
Propriétés | |
|---|---|
x |
Type :
numberComposant X du vecteur tridimensionnel. |
y |
Type :
numberComposant Y du vecteur tridimensionnel. |
z |
Type :
numberComposant Z du vecteur tridimensionnel. |