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 :
boolean Fonction de comparaison. |
lat |
lat() Paramètres : aucun
Valeur renvoyée :
number Renvoie 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 de chaîne. |
toUrlValue |
toUrlValue([precision]) Paramètres :
Valeur renvoyée :
string Renvoie 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 :
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, elle sera définie sur -90. Si la valeur est supérieure à 90, elle sera définie sur 90. |
lng |
Type :
number Longueur 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 :
boolean Renvoie true si la latitude/longitude donnée se trouve dans ces limites. |
equals |
equals(other) Paramètres :
Valeur renvoyée :
boolean Renvoie 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 :
LatLng Calcule le centre de ce LatLngBounds. |
getNorthEast |
getNorthEast() Paramètres : aucun
Valeur renvoyée :
LatLng Renvoie l'angle nord-est de ces limites. |
getSouthWest |
getSouthWest() Paramètres : aucun
Valeur renvoyée :
LatLng Renvoie l'angle sud-ouest de ces limites. |
intersects |
intersects(other) Paramètres :
Valeur renvoyée :
boolean Renvoie true si ces limites partagent 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 données en étendue de latitude/longitude. |
toString |
toString() Paramètres : aucun
Valeur renvoyée :
string Convertit en chaîne. |
toUrlValue |
toUrlValue([precision]) Paramètres :
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 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 :
number Longitude 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 :
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, elle sera définie sur -90. Si la valeur est supérieure à 90, elle sera 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, elle sera définie sur -90. Si la valeur est supérieure à 90, elle sera définie sur 90. |
west |
Type :
number Longitude 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 :
number Renvoie l'altitude. |
lat |
Type :
number Renvoie la latitude. |
lng |
Type :
number Renvoie 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 :
number Par défaut :
0 Distance (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 :
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, elle sera définie sur -90. Si la valeur est supérieure à 90, elle sera définie sur 90. |
lng |
Type :
number Longueur 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 :
number Coordonnée X |
y |
Type :
number Coordonnée Y |
Méthodes | |
---|---|
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. |
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 :
number Hauteur le long de l'axe Y, en pixels. |
width |
Type :
number Largeur le long de l'axe X, en pixels. |
Méthodes | |
---|---|
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 sous forme de chaîne de cette taille. |
Interface Padding
Interface google.maps.Padding
Propriétés | |
---|---|
bottom optional |
Type :
number optional Marge intérieure inférieure, en pixels. |
left optional |
Type :
number optional Marge intérieure à gauche, en pixels. |
right optional |
Type :
number optional Marge intérieure à droite, en pixels. |
top optional |
Type :
number optional Marge 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|LatLngLiteral Centre du cercle. |
radius |
Type :
number Rayon 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 :
number Par défaut :
0 Rotation 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 :
number Par défaut :
0 Rotation 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 :
number Par défaut :
0 Rotation 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 :
Orientation3DLiteral Convertit 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 optional Rotation 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 optional Rotation 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 optional Rotation 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 :
number Composant X du vecteur tridimensionnel. |
y |
Type :
number Composant Y du vecteur tridimensionnel. |
z |
Type :
number Composant Z du vecteur tridimensionnel. |
Méthodes | |
---|---|
equals |
equals(other) Paramètres :
Valeur renvoyée :
boolean Fonction de comparaison. |
toJSON |
toJSON() Paramètres : aucun
Valeur renvoyée :
Vector3DLiteral Convertit 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 :
number Composant X du vecteur tridimensionnel. |
y |
Type :
number Composant Y du vecteur tridimensionnel. |
z |
Type :
number Composant Z du vecteur tridimensionnel. |