Coordinates

Clase LatLng

google.maps.LatLng clase
biblioteca "core"

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 fijarán al rango [-90, 90]. Esto significa que, si el valor especificado es menor que -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 rodean el globo.
Aunque 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 los siguientes 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);
 

const {LatLng} = await google.maps.importLibrary("core");
LatLng
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])
Parámetros:
  • latOrLatLngOrLatLngLiteral: number|LatLngLiteral|LatLng
  • lngOrNoClampNoWrap: number|boolean optional
  • noClampNoWrap: boolean 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 retorno: boolean
Función de comparación para dos LatLngs. Devuelve verdadero si las coordenadas están dentro de 1e-9 entre sí y falso de lo contrario.
lat
lat()
Parámetros: Ninguno
Valor de retorno: number
Muestra la latitud en grados.
lng
lng()
Parámetros: Ninguno
Valor de retorno: number
Muestra la longitud en grados.
toJSON
toJSON()
Parámetros: Ninguno
Valor de retorno: LatLngLiteral
Se convierte en una representación JSON. Esta función se diseñó para usarse a través de JSON.stringify.
toString
toString()
Parámetros: Ninguno
Valor de retorno: string
Convierte a una representación de cadena.
toUrlValue
toUrlValue([precision])
Parámetros:
  • precision: number optional
Valor de retorno: string
Devuelve una cadena con el formato "lat,lng" para este LatLng. Redondeamos los valores de latitud y longitud a 6 decimales de forma predeterminada.

Interfaz LatLngLiteral

Interfaz google.maps.LatLngLiteral

Los literales de objeto se aceptan en lugar de los objetos LatLng, como una conveniencia, en muchos lugares. Estos se convierten en objetos LatLng cuando la API de Google Maps los encuentra.

Ejemplos: 

 map.setCenter({lat: -34, lng: 151});
 new google.maps.Marker({position: {lat: -34, lng: 151}, map: map});

Los literales de objeto LatLng no se admiten en la biblioteca de Geometry.
lat
Tipo: number
Es la latitud en grados. Los valores 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.
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 rodean el globo.

Clase LatLngBounds

google.maps.LatLngBounds clase
biblioteca "core"

Una instancia de LatLngBounds representa un rectángulo en coordenadas geográficas, incluido uno que cruza el meridiano longitudinal de 180 grados.

const {LatLngBounds} = await google.maps.importLibrary("core");
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 mundo.
contains
contains(latLng)
Parámetros:
Valor de retorno: boolean
Devuelve true si la latitud y longitud dadas se encuentran dentro de estos límites.
equals
equals(other)
Parámetros:
Valor de retorno: boolean
Devuelve true si estos límites son aproximadamente iguales a los límites dados.
extend
extend(point)
Parámetros:
Valor de retorno: LatLngBounds
Extiende estos límites para que contengan el punto determinado.
getCenter
getCenter()
Parámetros: Ninguno
Valor de retorno: LatLng
Calcula el centro de este LatLngBounds.
getNorthEast
getNorthEast()
Parámetros: Ninguno
Valor de retorno: LatLng
Devuelve la esquina noreste de estos límites.
getSouthWest
getSouthWest()
Parámetros: Ninguno
Valor de retorno: LatLng
Muestra la esquina sudoeste de estos límites.
intersects
intersects(other)
Parámetros:
Valor de retorno: boolean
Devuelve true si estos límites comparten algún punto con los otros límites.
isEmpty
isEmpty()
Parámetros: Ninguno
Valor de retorno: boolean
Devuelve si los límites están vacíos.
toJSON
toJSON()
Parámetros: Ninguno
Valor de retorno: LatLngBoundsLiteral
Convierte a la representación JSON. Esta función se diseñó para usarse a través de JSON.stringify.
toSpan
toSpan()
Parámetros: Ninguno
Valor de retorno: LatLng
Convierte los límites del mapa determinados en un intervalo de latitud y longitud.
toString
toString()
Parámetros: Ninguno
Valor de retorno: string
Se convierte en una cadena.
toUrlValue
toUrlValue([precision])
Parámetros:
  • precision: number optional
Valor de retorno: 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 sudoeste del cuadro delimitador, mientras que "hi" corresponde a la esquina noreste de ese cuadro.
union
union(other)
Parámetros:
Valor de retorno: LatLngBounds
Extiende estos límites para que contengan la unión de estos y los límites dados.

Interfaz LatLngBoundsLiteral

Interfaz google.maps.LatLngBoundsLiteral

Se aceptan literales de objeto en lugar de objetos LatLngBounds en toda la API. Estos se convierten automáticamente en objetos LatLngBounds. Se deben establecer todos los valores de south, west, north y east; de lo contrario, se arrojará 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 rodean el globo.
north
Tipo: number
Es la latitud norte en grados. Los valores 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.
south
Tipo: number
Es la latitud sur en grados. Los valores 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.
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 rodean el globo.

Clase LatLngAltitude

google.maps.LatLngAltitude class
implements LatLngAltitudeLiteral, LatLngLiteral
library "core"

Un LatLngAltitude es un punto en 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 fijará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 rodean el globo.
  • La altitud se mide en metros. Los valores positivos indican alturas sobre el nivel del suelo, y los negativos, alturas por debajo de la superficie del suelo.

const {LatLngAltitude} = await google.maps.importLibrary("core");
LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
Parámetros:
  • value: LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral Es el valor de inicialización.
  • noClampNoWrap: boolean optional Indica si se deben conservar los valores de inicialización, incluso si no necesariamente son 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 la fijación de latitud y el ajuste de longitud.
altitude
readonly
Tipo: number
Devuelve la altitud.
lat
readonly
Tipo: number
Devuelve la latitud.
lng
readonly
Tipo: number
Devuelve la longitud.
equals
equals(other)
Parámetros:
Valor de retorno: boolean Indica si los dos objetos son iguales.
Función de comparación para dos LatLngAltitudes. Devuelve verdadero si las coordenadas están dentro de 1e-9 entre sí y falso de lo contrario.
toJSON
toJSON([key])
Parámetros:
  • key: string optional
Valor de retorno: LatLngAltitudeLiteral
Convierte en un objeto simple.

Interfaz LatLngAltitudeLiteral

google.maps.LatLngAltitudeLiteral interface
extends LatLngLiteral

Los literales de objeto se aceptan en lugar de los objetos LatLngAltitude, como una conveniencia, en muchos lugares. Estos se convierten en objetos LatLngAltitude cuando la API de Google Maps los encuentra.
altitude
Tipo: number
Es la distancia (en metros) sobre la superficie del suelo. Un valor negativo significa que se encuentra debajo de la superficie del suelo.
lat
Tipo: number
Es la latitud en grados. Los valores 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.
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 rodean el globo.

Clase Point

google.maps.Point clase
biblioteca "core" 

const {Point} = await google.maps.importLibrary("core");
Point
Point(x, y)
Parámetros:
  • x: number
  • y: number
Es un punto en un plano bidimensional.
x
Tipo: number
La coordenada X
y
Tipo: number
La coordenada Y
equals
equals(other)
Parámetros:
Valor de retorno: boolean
Compara dos puntos
toString
toString()
Parámetros: Ninguno
Valor de retorno: string
Devuelve una representación de cadena de este Point.

Clase Size

google.maps.Size clase
biblioteca "core" 

const {Size} = await google.maps.importLibrary("core");
Size
Size(width, height[, widthUnit, heightUnit])
Parámetros:
  • width: number
  • height: number
  • widthUnit: string optional
  • heightUnit: string optional
Es el 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:
  • other: Size optional
Valor de retorno: boolean
Compara dos tamaños.
toString
toString()
Parámetros: Ninguno
Valor de retorno: string
Devuelve una representación de cadena de este Size.

Interfaz Padding

Interfaz google.maps.Padding

bottom
opcional
Tipo: number optional
Es el padding para la parte inferior, en píxeles.
left
opcional
Tipo: number optional
Es el padding de la izquierda, en píxeles.
right
opcional
Tipo: number optional
Es el padding para la derecha, en píxeles.
top
opcional
Tipo: number optional
Es el padding de la parte superior, en píxeles.

Interfaz CircleLiteral

google.maps.CircleLiteral interface
extends CircleOptions

Es un literal de objeto que representa un círculo.
center
Es el centro del círculo.
radius
Tipo: number
Es el radio en metros en la superficie de la Tierra.
Heredados: clickable, draggable, editable, fillColor, fillOpacity, map, strokeColor, strokeOpacity, strokePosition, strokeWeight, visible, zIndex

Clase Orientation3D

google.maps.Orientation3D class
implements Orientation3DLiteral
library "core"

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.

  • heading es un ángulo en el rango [0, 360) grados.
  • tilt es un ángulo en el rango [0, 360) grados.
  • La rotación es un ángulo en el rango [0, 360) grados.

const {Orientation3D} = await google.maps.importLibrary("core");
Orientation3D
Orientation3D(value)
Parámetros:
heading
readonly
Tipo: number
La configuración predeterminada es 0.
Rotación alrededor del eje Z (normal a la superficie de la Tierra). Un valor de 0 (el predeterminado) equivale al 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
readonly
Tipo: number
La configuración predeterminada es 0.
Rotación alrededor del eje Y. Una rotación positiva es 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
readonly
Tipo: number
La configuración predeterminada es 0.
Rotación alrededor del eje X Una rotación positiva es 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 retorno: boolean Indica si los dos objetos son iguales.
Es la función de comparación.
toJSON
toJSON([key])
Parámetros:
  • key: string optional
Valor de retorno: Orientation3DLiteral
Convierte en un objeto simple.

Interfaz Orientation3DLiteral

Interfaz google.maps.Orientation3DLiteral

Los literales de objeto se aceptan en lugar de los objetos Orientation3D, como una conveniencia, en muchos lugares. Estos se convierten en objetos Orientation3D cuando la API de Google Maps los encuentra.
heading
opcional
Tipo: number optional
Rotación alrededor del eje Z (normal a la superficie de la Tierra). Un valor de 0 (el predeterminado) equivale al 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
opcional
Tipo: number optional
Rotación alrededor del eje Y. Una rotación positiva es en el sentido de las manecillas del reloj alrededor del eje Y y se especifica en grados de 0 a 360.
tilt
opcional
Tipo: number optional
Rotación alrededor del eje X Una rotación positiva es en el sentido de las manecillas del reloj alrededor del eje X y se especifica en grados de 0 a 360.

Clase Vector3D

google.maps.Vector3D class
implements Vector3DLiteral
library "core"

Un Vector3D es un vector tridimensional que se usa para operaciones matemáticas estándar, como escalar 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.

const {Vector3D} = await google.maps.importLibrary("core");
Vector3D
Vector3D(value)
Parámetros:
x
readonly
Tipo: number
Es el componente X del vector tridimensional.
y
readonly
Tipo: number
Es el componente Y del vector tridimensional.
z
readonly
Tipo: number
Es el componente Z del vector tridimensional.
equals
equals(other)
Parámetros:
Valor de retorno: boolean
Es la función de comparación.
toJSON
toJSON([key])
Parámetros:
  • key: string optional
Valor de retorno: Vector3DLiteral
Convierte en un objeto simple.

Interfaz Vector3DLiteral

Interfaz google.maps.Vector3DLiteral

Los literales de objeto se aceptan en lugar de los objetos Vector3D, como una conveniencia, en muchos lugares. Estos se convierten en objetos Vector3D cuando la API de Google Maps los encuentra.
x
Tipo: number
Es el 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.