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.
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.
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 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. |
Méthodes | |
---|---|
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:
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.
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, 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.
Constructeur | |
---|---|
LatLngBounds |
LatLngBounds([swOrLatLngBounds, ne]) Paramètres:
Construit un rectangle à partir des points situés à l'angle sud-ouest et nord-est. |
Méthodes | |
---|---|
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:
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. |
Constantes | |
---|---|
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.
Propriétés | |
---|---|
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.
Constructeur | |
---|---|
LatLngAltitude |
LatLngAltitude(value[, noClampNoWrap]) Paramètres:
|
Propriétés | |
---|---|
altitude |
Type:
number Affiche l'altitude. |
lat |
Type:
number Affiche 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
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
.
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 "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.
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. |
Size
Classe google.maps.Size
Accédez à en appelant const {Size} = await google.maps.importLibrary("core")
. Consultez Bibliothèques dans l'API Maps JavaScript.
Constructeur | |
---|---|
Size |
Size(width, height[, widthUnit, heightUnit]) Paramètres:
Taille en deux dimensions, où la largeur correspond à la distance sur l'axe X et la hauteur sur la distance sur l'axe Y. |
Propriétés | |
---|---|
height |
Type:
number Hauteur sur l'axe y, en pixels. |
width |
Type:
number Largeur le long de l'axe des abscisses, 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 de chaîne de cette taille. |
Remplissage
google.maps.Padding
interface
Propriétés | |
---|---|
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
.
Propriétés | |
---|---|
center |
Type:
LatLng|LatLngLiteral 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
|