Clase LatLng
Clase google.maps.LatLng
Un LatLng
es un punto en coordenadas geográficas: latitud y longitud.
- La latitud varía entre -90 y 90 grados, inclusive. Los valores superiores o inferiores a este rango se restringirán al rango [-90, 90]. Esto significa que, si el valor especificado es inferior a -90, se establecerá en -90. Si el valor es mayor que 90, se establecerá en 90.
- La longitud varía entre -180 y 180 grados, inclusive. Los valores superiores o inferiores a este rango se ajustarán de forma tal que queden dentro del rango. Por ejemplo, un valor de -190 se convertirá en 170. Un valor de 190 se convertirá en -170. Esto refleja el hecho de que las longitudes se extienden alrededor del globo.
Ten en cuenta que no puedes modificar las coordenadas de un
LatLng
. Si quieres calcular otro punto, debes crear uno nuevo. La mayoría de los métodos que aceptan objetos LatLng
también aceptan un objeto LatLngLiteral
, por lo que las siguientes opciones son equivalentes:
map.setCenter(new google.maps.LatLng(-34, 151));
map.setCenter({lat: -34, lng: 151});
El constructor también acepta objetos LatLngLiteral
y LatLng
. Si se pasa una instancia de LatLng
al constructor, se crea una copia.
A continuación, se muestran las posibles llamadas al constructor:
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);
Llama al const {LatLng} = await google.maps.importLibrary("core")
para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
Constructor | |
---|---|
LatLng |
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap]) Parámetros:
Crea un objeto LatLng que representa un punto geográfico. La latitud se especifica en grados dentro del rango [-90, 90]. La longitud se especifica en grados dentro del rango [-180, 180). Establece noClampNoWrap en true para habilitar valores fuera de este rango. Ten en cuenta el orden de la latitud y la longitud. |
Métodos | |
---|---|
equals |
equals(other) Parámetros:
Valor de devolución:
boolean Función de comparación. |
lat |
lat() Parámetros: Ninguno
Valor de devolución:
number Muestra la latitud en grados. |
lng |
lng() Parámetros: Ninguno
Valor de devolución:
number Muestra la longitud en grados. |
toJSON |
toJSON() Parámetros: Ninguno
Valor de devolución:
LatLngLiteral Convierte a la representación JSON. Esta función está diseñada para usarse a través de JSON.stringify . |
toString |
toString() Parámetros: Ninguno
Valor de devolución:
string Convierte a representación de cadena. |
toUrlValue |
toUrlValue([precision]) Parámetros:
Valor de devolución:
string Devuelve una cadena con el formato "lat,lng" para este objeto LatLng. De forma predeterminada, redondeamos los valores de latitud y longitud a 6 decimales. |
Interfaz LatLngLiteral
Interfaz de google.maps.LatLngLiteral
En muchos lugares, se aceptan literales de objetos en lugar de objetos LatLng
, como una comodidad. Estos se convierten en objetos LatLng
cuando la API de Maps los encuentra.
Ejemplos:
map.setCenter({lat: -34, lng: 151});
new google.maps.Marker({position: {lat: -34, lng: 151}, map: map});
Los objetos literales LatLng no son compatibles con la biblioteca de Geometry.
Propiedades | |
---|---|
lat |
Tipo:
number Es la latitud en grados. Los valores se ajustarán al rango [-90, 90]. Esto significa que, si el valor especificado es inferior a -90, se establecerá en -90. Si el valor es mayor que 90, se establecerá en 90. |
lng |
Tipo:
number Es la longitud en grados. Los valores fuera del rango [-180, 180] se ajustarán para que queden dentro del rango. Por ejemplo, un valor de -190 se convertirá en 170. Un valor de 190 se convertirá en -170. Esto refleja el hecho de que las longitudes se extienden alrededor del globo. |
Clase LatLngBounds
Clase google.maps.LatLngBounds
Una instancia de LatLngBounds
representa un rectángulo en coordenadas geográficas, incluido uno que cruza el meridiano longitudinal de 180 grados.
Llama al const {LatLngBounds} = await google.maps.importLibrary("core")
para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
Constructor | |
---|---|
LatLngBounds |
LatLngBounds([swOrLatLngBounds, ne]) Parámetros:
Construye un rectángulo a partir de los puntos de sus esquinas suroeste y noreste. |
Constantes | |
---|---|
MAX_BOUNDS |
LatLngBounds para los límites máximos de la Tierra. Estos límites abarcarán todo el planeta. |
Métodos | |
---|---|
contains |
contains(latLng) Parámetros:
Valor de devolución:
boolean Devuelve true si la latitud y longitud proporcionadas se encuentran dentro de estos límites. |
equals |
equals(other) Parámetros:
Valor de devolución:
boolean Devuelve true si estos límites son aproximadamente iguales a los límites proporcionados. |
extend |
extend(point) Parámetros:
Valor de devolución:
LatLngBounds Extiende estos límites para incluir el punto determinado. |
getCenter |
getCenter() Parámetros: Ninguno
Valor de devolución:
LatLng Calcula el centro de este LatLngBounds. |
getNorthEast |
getNorthEast() Parámetros: Ninguno
Valor de devolución:
LatLng Devuelve la esquina noreste de estos límites. |
getSouthWest |
getSouthWest() Parámetros: Ninguno
Valor de devolución:
LatLng Devuelve la esquina sudoeste de estos límites. |
intersects |
intersects(other) Parámetros:
Valor de devolución:
boolean Devuelve true si este límite comparte algún punto con el otro límite. |
isEmpty |
isEmpty() Parámetros: Ninguno
Valor de devolución:
boolean Devuelve si los límites están vacíos. |
toJSON |
toJSON() Parámetros: Ninguno
Valor de devolución:
LatLngBoundsLiteral Convierte a la representación JSON. Esta función está diseñada para usarse a través de JSON.stringify . |
toSpan |
toSpan() Parámetros: Ninguno
Valor de devolución:
LatLng Convierte los límites del mapa proporcionados en un intervalo de latitud y longitud. |
toString |
toString() Parámetros: Ninguno
Valor de devolución:
string Se convierte en una cadena. |
toUrlValue |
toUrlValue([precision]) Parámetros:
Valor de devolución:
string Devuelve una cadena con el formato "lat_lo,lng_lo,lat_hi,lng_hi" para estos límites, donde "lo" corresponde a la esquina suroeste del cuadro de límite y "hi" corresponde a la esquina noreste de ese cuadro. |
union |
union(other) Parámetros:
Valor de devolución:
LatLngBounds Extiende estos límites para que contengan la unión de estos y los límites determinados. |
Interfaz LatLngBoundsLiteral
Interfaz de google.maps.LatLngBoundsLiteral
Se aceptan literales de objetos en lugar de objetos LatLngBounds
en toda la API. Estos se convierten automáticamente en objetos LatLngBounds
. Se deben establecer todos los parámetros south
, west
, north
y east
. De lo contrario, se arroja una excepción.
Propiedades | |
---|---|
east |
Tipo:
number Es la longitud este en grados. Los valores fuera del rango [-180, 180] se ajustarán al rango [-180, 180). Por ejemplo, un valor de -190 se convertirá en 170. Un valor de 190 se convertirá en -170. Esto refleja el hecho de que las longitudes se extienden alrededor del globo. |
north |
Tipo:
number Es la latitud norte en grados. Los valores se ajustarán al rango [-90, 90]. Esto significa que, si el valor especificado es inferior a -90, se establecerá en -90. Si el valor es mayor que 90, se establecerá en 90. |
south |
Tipo:
number Es la latitud sur en grados. Los valores se ajustarán al rango [-90, 90]. Esto significa que, si el valor especificado es inferior a -90, se establecerá en -90. Si el valor es mayor que 90, se establecerá en 90. |
west |
Tipo:
number Es la longitud oeste en grados. Los valores fuera del rango [-180, 180] se ajustarán al rango [-180, 180). Por ejemplo, un valor de -190 se convertirá en 170. Un valor de 190 se convertirá en -170. Esto refleja el hecho de que las longitudes se extienden alrededor del globo. |
Clase LatLngAltitude
Clase google.maps.LatLngAltitude
Un LatLngAltitude
es un punto 3D en coordenadas geográficas: latitud, longitud y altitud.
- La latitud varía entre -90 y 90 grados, inclusive. Los valores superiores o inferiores a este rango se restringirán al rango [-90, 90]. Esto significa que, si el valor especificado es inferior a -90, se establecerá en -90. Si el valor es mayor que 90, se establecerá en 90.
- La longitud varía entre -180 y 180 grados, inclusive. Los valores superiores o inferiores a este rango se ajustarán de forma tal que queden dentro del rango. Por ejemplo, un valor de -190 se convertirá en 170. Un valor de 190 se convertirá en -170. Esto refleja el hecho de que las longitudes se extienden alrededor del globo.
- La altitud se mide en metros. Los valores positivos denotan alturas por encima del nivel del suelo, y los valores negativos denotan alturas por debajo de la superficie del suelo.
Esta clase implementa LatLngAltitudeLiteral
.
Esta clase implementa LatLngLiteral
.
Llama al const {LatLngAltitude} = await google.maps.importLibrary("core")
para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
Constructor | |
---|---|
LatLngAltitude |
LatLngAltitude(value[, noClampNoWrap]) Parámetros:
|
Propiedades | |
---|---|
altitude |
Tipo:
number Devuelve la altitud. |
lat |
Tipo:
number Devuelve la latitud. |
lng |
Tipo:
number Devuelve la longitud. |
Métodos | |
---|---|
equals |
equals(other) Parámetros:
Valor de Devolución:
boolean Indica si los dos objetos son iguales.Función de comparación. |
toJSON |
toJSON() Parámetros: Ninguno
Valor de retorno:
LatLngAltitudeLiteral Una representación JSON de este objeto. |
Interfaz de LatLngAltitudeLiteral
Interfaz de google.maps.LatLngAltitudeLiteral
En muchos lugares, se aceptan literales de objetos en lugar de objetos LatLngAltitude
, como una comodidad. Estos se convierten en objetos LatLngAltitude
cuando la API de Maps los encuentra.
Esta interfaz extiende LatLngLiteral
.
Propiedades | |
---|---|
altitude |
Tipo:
number Predeterminado:
0 Distancia (en metros) por encima de la superficie del suelo. Un valor negativo significa que está por debajo de la superficie del suelo. |
lat |
Tipo:
number Es la latitud en grados. Los valores se ajustarán al rango [-90, 90]. Esto significa que, si el valor especificado es inferior a -90, se establecerá en -90. Si el valor es mayor que 90, se establecerá en 90. |
lng |
Tipo:
number Es la longitud en grados. Los valores fuera del rango [-180, 180] se ajustarán para que queden dentro del rango. Por ejemplo, un valor de -190 se convertirá en 170. Un valor de 190 se convertirá en -170. Esto refleja el hecho de que las longitudes se extienden alrededor del globo. |
Clase Point
Clase google.maps.Point
Llama al const {Point} = await google.maps.importLibrary("core")
para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
Constructor | |
---|---|
Point |
Point(x, y) Parámetros:
Es un punto en un plano bidimensional. |
Propiedades | |
---|---|
x |
Tipo:
number La coordenada X |
y |
Tipo:
number La coordenada Y |
Métodos | |
---|---|
equals |
equals(other) Parámetros:
Valor de devolución:
boolean Compara dos puntos |
toString |
toString() Parámetros: Ninguno
Valor de devolución:
string Devuelve una representación de cadena de este Point. |
Clase de tamaño
Clase google.maps.Size
Llama al const {Size} = await google.maps.importLibrary("core")
para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
Constructor | |
---|---|
Size |
Size(width, height[, widthUnit, heightUnit]) Parámetros:
Tamaño bidimensional, en el que el ancho es la distancia en el eje X y la altura es la distancia en el eje Y. |
Propiedades | |
---|---|
height |
Tipo:
number Es la altura a lo largo del eje Y, en píxeles. |
width |
Tipo:
number Es el ancho a lo largo del eje X, en píxeles. |
Métodos | |
---|---|
equals |
equals(other) Parámetros:
Valor de devolución:
boolean Compara dos tamaños. |
toString |
toString() Parámetros: Ninguno
Valor de devolución:
string Devuelve una representación de cadena de este Size. |
Interfaz de Padding
Interfaz de google.maps.Padding
Propiedades | |
---|---|
bottom optional |
Tipo:
number optional Padding para la parte inferior, en píxeles. |
left optional |
Tipo:
number optional Padding para la izquierda, en píxeles. |
right optional |
Tipo:
number optional Padding para la derecha, en píxeles. |
top optional |
Tipo:
number optional Padding para la parte superior, en píxeles. |
Interfaz CircleLiteral
Interfaz de google.maps.CircleLiteral
Literal de objeto que representa un círculo.
Esta interfaz extiende CircleOptions
.
Propiedades | |
---|---|
center |
Tipo:
LatLng|LatLngLiteral Es el centro del círculo. |
radius |
Tipo:
number Es el radio en metros sobre la superficie de la Tierra. |
Heredado:
clickable ,
draggable ,
editable ,
fillColor ,
fillOpacity ,
map ,
strokeColor ,
strokeOpacity ,
strokePosition ,
strokeWeight ,
visible ,
zIndex
|
Clase Orientation3D
Clase google.maps.Orientation3D
Un Orientation3D
es un vector tridimensional que se usa para las transformaciones de rotación matemática estándar a lo largo de la dirección, la inclinación y el balanceo.
- El rumbo es un ángulo en el rango de [0, 360) grados.
- La inclinación es un ángulo en el rango [0, 360) grados.
- El ángulo de balanceo es un ángulo en el rango [0, 360) grados.
Esta clase implementa Orientation3DLiteral
.
Llama al const {Orientation3D} = await google.maps.importLibrary("core")
para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
Constructor | |
---|---|
Orientation3D |
Orientation3D(value) Parámetros:
|
Propiedades | |
---|---|
heading |
Tipo:
number Predeterminado:
0 Rotación sobre el eje Z (normal a la superficie de la Tierra). Un valor de 0 (el valor predeterminado) equivale a Norte. Una rotación positiva se realiza en el sentido de las manecillas del reloj alrededor del eje Z y se especifica en grados de 0 a 360. Los valores superiores o inferiores a este rango se ajustarán de forma tal que queden dentro del rango. Por ejemplo, un valor de -190 se convertirá en 170. Un valor de 530 también se convertirá en 170. |
roll |
Tipo:
number Predeterminado:
0 Rotación sobre el eje Y. Una rotación positiva se realiza en el sentido de las manecillas del reloj alrededor del eje Y y se especifica en grados de 0 a 360. Los valores superiores o inferiores a este rango se ajustarán de forma tal que queden dentro del rango. Por ejemplo, un valor de -190 se convertirá en 170. Un valor de 530 también se convertirá en 170. |
tilt |
Tipo:
number Predeterminado:
0 Rotación sobre el eje X. Una rotación positiva se realiza en el sentido de las manecillas del reloj alrededor del eje X y se especifica en grados de 0 a 360. Los valores superiores o inferiores a este rango se ajustarán de forma tal que queden dentro del rango. Por ejemplo, un valor de -190 se convertirá en 170. Un valor de 530 también se convertirá en 170. |
Métodos | |
---|---|
equals |
equals(other) Parámetros:
Valor de Devolución:
boolean Indica si los dos objetos son iguales.Función de comparación. |
toJSON |
toJSON() Parámetros: Ninguno
Valor de devolución:
Orientation3DLiteral Convierte a la representación JSON. Esta función está diseñada para usarse a través de JSON.stringify. |
Interfaz Orientation3DLiteral
Interfaz de google.maps.Orientation3DLiteral
En muchos lugares, se aceptan literales de objetos en lugar de objetos Orientation3D
, como una comodidad. Estos se convierten en objetos Orientation3D
cuando la API de Maps los encuentra.
Propiedades | |
---|---|
heading optional |
Tipo:
number optional Rotación sobre el eje Z (normal a la superficie de la Tierra). Un valor de 0 (el valor predeterminado) equivale a Norte. Una rotación positiva se realiza en el sentido de las manecillas del reloj alrededor del eje Z y se especifica en grados de 0 a 360. |
roll optional |
Tipo:
number optional Rotación sobre el eje Y. Una rotación positiva se realiza en el sentido de las manecillas del reloj alrededor del eje Y y se especifica en grados de 0 a 360. |
tilt optional |
Tipo:
number optional Rotación sobre el eje X. Una rotación positiva se realiza en el sentido de las manecillas del reloj alrededor del eje X y se especifica en grados de 0 a 360. |
Clase Vector3D
Clase google.maps.Vector3D
Un Vector3D
es un vector tridimensional que se usa para operaciones matemáticas estándar, como ajustar los límites de un objeto tridimensional a lo largo de los ejes X, Y y Z locales.
- x es un número real.
- y es un número real.
- z es un número real.
Esta clase implementa Vector3DLiteral
.
Llama al const {Vector3D} = await google.maps.importLibrary("core")
para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
Constructor | |
---|---|
Vector3D |
Vector3D(value) Parámetros:
|
Propiedades | |
---|---|
x |
Tipo:
number Componente X del vector tridimensional. |
y |
Tipo:
number Es el componente Y del vector tridimensional. |
z |
Tipo:
number Es el componente Z del vector tridimensional. |
Métodos | |
---|---|
equals |
equals(other) Parámetros:
Valor de devolución:
boolean Función de comparación. |
toJSON |
toJSON() Parámetros: Ninguno
Valor de devolución:
Vector3DLiteral Convierte a la representación JSON. Esta función está diseñada para usarse a través de JSON.stringify. |
Interfaz Vector3DLiteral
Interfaz de google.maps.Vector3DLiteral
En muchos lugares, se aceptan literales de objetos en lugar de objetos Vector3D
, como una comodidad. Estos se convierten en objetos Vector3D
cuando la API de Maps los encuentra.
Propiedades | |
---|---|
x |
Tipo:
number Componente X del vector tridimensional. |
y |
Tipo:
number Es el componente Y del vector tridimensional. |
z |
Tipo:
number Es el componente Z del vector tridimensional. |