Coordinates

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.
Si bien la proyección de mapa predeterminada asocia la longitud con la coordenada X del mapa y la latitud con la coordenada Y, la coordenada de latitud siempre se escribe primero, seguida de la longitud.
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.

LatLng
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])
Parámetros: 
  • latOrLatLngOrLatLngLiteralnumber|LatLngLiteral|LatLng
  • lngOrNoClampNoWrapnumber|boolean optional
  • noClampNoWrapboolean optional
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.
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: 
  • precisionnumber optional
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.

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.

LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
Parámetros: 
Construye un rectángulo a partir de los puntos de sus esquinas suroeste y noreste.
MAX_BOUNDS LatLngBounds para los límites máximos de la Tierra. Estos límites abarcarán todo el planeta.
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: 
  • precisionnumber optional
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.

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.

LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
Parámetros: 
  • valueLatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral Es el valor de inicialización.
  • noClampNoWrapboolean optional Indica si se deben conservar los valores de inicialización, incluso si no son necesariamente valores de latitud válidos en el rango de [-90, 90] o valores de longitud válidos en el rango de [-180, 180]. El valor predeterminado es false, que habilita el ajuste de la latitud y el ajuste de la longitud.
altitude
Tipo:  number
Devuelve la altitud.
lat
Tipo:  number
Devuelve la latitud.
lng
Tipo:  number
Devuelve la longitud.
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.

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.

Point
Point(x, y)
Parámetros: 
  • xnumber
  • ynumber
Es un punto en un plano bidimensional.
x
Tipo:  number
La coordenada X
y
Tipo:  number
La coordenada Y
equals
equals(other)
Parámetros: 
  • otherPoint optional
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.

Size
Size(width, height[, widthUnit, heightUnit])
Parámetros: 
  • widthnumber
  • heightnumber
  • widthUnitstring optional
  • heightUnitstring optional
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.
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.
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

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.

center
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.

Orientation3D
Orientation3D(value)
Parámetros: 
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.
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.

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.

Vector3D
Vector3D(value)
Parámetros: 
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.
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.

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.