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

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);
 

Para acceder, llama al const {LatLng} = await google.maps.importLibrary("core").
Consulta Bibliotecas de la API de Maps JavaScript.

Constructor

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.

Métodos
equals	equals(other) Parámetros:  other:  LatLng Valor de retorno:  boolean Es la función de comparación.
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 Convierte a la 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.

Propiedades
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

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.

Para acceder, llama al const {LatLngBounds} = await google.maps.importLibrary("core").
Consulta Bibliotecas de la API de Maps JavaScript.

Constructor
LatLngBounds	LatLngBounds([swOrLatLngBounds, ne]) Parámetros:  swOrLatLngBounds:  LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral optional ne:  LatLng|LatLngLiteral optional 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 mundo.

Métodos
contains	contains(latLng) Parámetros:  latLng:  LatLng|LatLngLiteral Valor de retorno:  boolean Devuelve true si la latitud y longitud dadas se encuentran dentro de estos límites.
equals	equals(other) Parámetros:  other:  LatLngBounds|LatLngBoundsLiteral optional Valor de retorno:  boolean Devuelve true si estos límites son aproximadamente iguales a los límites dados.
extend	extend(point) Parámetros:  point:  LatLng|LatLngLiteral 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:  other:  LatLngBounds|LatLngBoundsLiteral 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:  other:  LatLngBounds|LatLngBoundsLiteral 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.

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

Clase google.maps.LatLngAltitude

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.

Esta clase implementa LatLngAltitudeLiteral.

Esta clase implementa LatLngLiteral.

Para acceder, llama al const {LatLngAltitude} = await google.maps.importLibrary("core").
Consulta Bibliotecas de la API de Maps JavaScript.

Constructor

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.

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:  other:  LatLngAltitude optional Es otro objeto LatLngAltitude. Valor de retorno:  boolean Indica si los dos objetos son iguales. Es la función de comparación.
toJSON	toJSON() Parámetros: Ninguno Valor de retorno:  LatLngAltitudeLiteral Una representación JSON de este objeto.

Interfaz LatLngAltitudeLiteral

Interfaz google.maps.LatLngAltitudeLiteral

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.

Esta interfaz extiende LatLngLiteral.

Propiedades
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.
altitude optional	Tipo:  number optional La configuración predeterminada es 0. Es la distancia (en metros) sobre la superficie del suelo. Un valor negativo significa que se encuentra debajo de la superficie del suelo.

Clase Point

Clase google.maps.Point

Para acceder, llama al const {Point} = await google.maps.importLibrary("core").
Consulta Bibliotecas de la API de Maps JavaScript.

Constructor
Point	Point(x, y) Parámetros:  x:  number y:  number 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:  other:  Point optional 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

Clase google.maps.Size

Para acceder, llama al const {Size} = await google.maps.importLibrary("core").
Consulta Bibliotecas de la API de Maps JavaScript.

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

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:  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

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

Interfaz CircleLiteral

Interfaz google.maps.CircleLiteral

Es un 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 en la superficie de la Tierra.
Heredados: 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.

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

Esta clase implementa Orientation3DLiteral.

Para acceder, llama al const {Orientation3D} = await google.maps.importLibrary("core").
Consulta Bibliotecas de la API de Maps JavaScript.

Constructor
Orientation3D	Orientation3D(value) Parámetros:  value:  Orientation3D|Orientation3DLiteral Es el valor de inicialización.

Propiedades
heading	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	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	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.

Métodos
equals	equals(other) Parámetros:  other:  Orientation3D|Orientation3DLiteral optional Otro objeto Orientation3D. Valor de retorno:  boolean Indica si los dos objetos son iguales. Es la función de comparación.
toJSON	toJSON() Parámetros: Ninguno Valor de retorno:  Orientation3DLiteral Convierte a la representación JSON. Esta función se debe usar a través de JSON.stringify.

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.

Propiedades
heading optional	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 optional	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 optional	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

Clase google.maps.Vector3D

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.

Esta clase implementa Vector3DLiteral.

Para acceder, llama al const {Vector3D} = await google.maps.importLibrary("core").
Consulta Bibliotecas de la API de Maps JavaScript.

Constructor
Vector3D	Vector3D(value) Parámetros:  value:  Vector3D|Vector3DLiteral Es el valor de inicialización.

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

Métodos
equals	equals(other) Parámetros:  other:  Vector3D|Vector3DLiteral optional Es otro objeto Vector3D o Vector3DLiteral. Valor de retorno:  boolean Es la función de comparación.
toJSON	toJSON() Parámetros: Ninguno Valor de retorno:  Vector3DLiteral Convierte a la representación JSON. Esta función se debe usar a través de JSON.stringify.

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.

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