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 menor que -90, se configurará en -90. Y si el valor es superior a 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 unen alrededor del globo terráqueo.

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, de modo que los siguientes valores 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 a const {LatLng} = await google.maps.importLibrary("core"). Consulta el artículo 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. Observa el orden de latitud y longitud.

Métodos
equals	equals(other) Parámetros:  other:  LatLng Valor que se devuelve:  boolean Función de comparación.
lat	lat() Parámetros: Ninguno Valor que se devuelve:  number Muestra la latitud en grados.
lng	lng() Parámetros: Ninguno Valor que se devuelve:  number Muestra la longitud en grados.
toJSON	toJSON() Parámetros: Ninguno Valor que se devuelve:  LatLngLiteral Convierte a una representación JSON. Esta función está diseñada para usarse a través de JSON.stringify.
toString	toString() Parámetros: Ninguno Valor que se devuelve:  string Convierte en representación de cadena.
toUrlValue	toUrlValue([precision]) Parámetros:  precision:  number optional Valor que se devuelve:  string Muestra una cadena con el formato "lat,lng" para esta LatLng. Redondeamos los valores de latitud y longitud a 6 decimales de forma predeterminada.

LatLngLiteral,

Interfaz de google.maps.LatLngLiteral

Por conveniencia, en muchos lugares, se aceptan literales de objeto en lugar de objetos LatLng. 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 del objeto LatLng no se admiten en la biblioteca de geometría.

Propiedades
lat	Tipo:  number Es la latitud en grados. Los valores se fijarán al rango [-90, 90]. Esto significa que si el valor especificado es menor que -90, se establecerá en -90. Y si el valor es superior a 90, se establecerá en 90.
lng	Tipo:  number Es la longitud en grados. Los valores fuera del rango [-180, 180] 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 unen alrededor del globo terráqueo.

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 a const {LatLngBounds} = await google.maps.importLibrary("core"). Consulta el artículo 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 en sus esquinas sudoeste y noreste.

Constantes
MAX_BOUNDS	LatLngBounds para los límites máximos de la Tierra Estos límites abarcarán todo el globo terráqueo.

Métodos
contains	contains(latLng) Parámetros:  latLng:  LatLng|LatLngLiteral Valor que se devuelve:  boolean Muestra true si el valor de latitud y longitud especificados está dentro de estos límites.
equals	equals(other) Parámetros:  other:  LatLngBounds|LatLngBoundsLiteral optional Valor que se devuelve:  boolean Muestra true si el límite es igual a los límites especificados.
extend	extend(point) Parámetros:  point:  LatLng|LatLngLiteral Valor que se devuelve:  LatLngBounds Extiende estos límites para contener el punto determinado.
getCenter	getCenter() Parámetros: Ninguno Valor que se devuelve:  LatLng Calcula el centro de este objeto LatLngBounds
getNorthEast	getNorthEast() Parámetros: Ninguno Valor que se devuelve:  LatLng Muestra la esquina noreste de estos límites.
getSouthWest	getSouthWest() Parámetros: Ninguno Valor que se devuelve:  LatLng Muestra la esquina sudoeste de estos límites.
intersects	intersects(other) Parámetros:  other:  LatLngBounds|LatLngBoundsLiteral Valor que se devuelve:  boolean Muestra true si este límite comparte algún punto con los otros límites.
isEmpty	isEmpty() Parámetros: Ninguno Valor que se devuelve:  boolean Muestra si los límites están vacíos.
toJSON	toJSON() Parámetros: Ninguno Valor que se devuelve:  LatLngBoundsLiteral Convierte a una representación JSON. Esta función está diseñada para usarse a través de JSON.stringify.
toSpan	toSpan() Parámetros: Ninguno Valor que se devuelve:  LatLng Convierte los límites del mapa determinados en un intervalo de latitud y longitud.
toString	toString() Parámetros: Ninguno Valor que se devuelve:  string Convierte los valores en una cadena.
toUrlValue	toUrlValue([precision]) Parámetros:  precision:  number optional Valor que se devuelve:  string Muestra 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 delimitador, mientras que "hi" corresponde a la esquina noreste de ese cuadro.
union	union(other) Parámetros:  other:  LatLngBounds|LatLngBoundsLiteral Valor que se devuelve:  LatLngBounds Extiende estos límites para contener la unión de este y los límites determinados.

LatLngBoundsLiteral

Interfaz de google.maps.LatLngBoundsLiteral

En toda la API, se aceptan literales de objeto en lugar de objetos LatLngBounds. Estos se convierten automáticamente en objetos LatLngBounds. Se deben configurar todos los elementos south, west, north y east; de lo contrario, se arrojará una excepción.

Propiedades
east	Tipo:  number 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 unen alrededor del globo terráqueo.
north	Tipo:  number Latitud norte en grados. Los valores se fijarán al rango [-90, 90]. Esto significa que si el valor especificado es menor que -90, se establecerá en -90. Y si el valor es superior a 90, se establecerá en 90.
south	Tipo:  number Latitud sur en grados. Los valores se fijarán al rango [-90, 90]. Esto significa que si el valor especificado es menor que -90, se configurará en -90. Y si el valor es superior a 90, se establecerá en 90.
west	Tipo:  number 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 unen alrededor del globo terráqueo.

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 fijarán al rango [-90, 90]. Esto significa que si el valor especificado es menor que -90, se establecerá en -90. Y si el valor es superior a 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 unen alrededor del globo terráqueo.
• La altitud se mide en metros. Los valores positivos indican alturas sobre el nivel del suelo y los valores negativos indican alturas debajo de la superficie del suelo.

Esta clase implementa LatLngAltitudeLiteral.

Esta clase implementa LatLngLiteral.

Para acceder, llama a const {LatLngAltitude} = await google.maps.importLibrary("core"). Consulta el artículo 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 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 latitud y longitud.

Propiedades
altitude	Tipo:  number Muestra la altitud.
lat	Tipo:  number Muestra la latitud.
lng	Tipo:  number Muestra la longitud.

Métodos
equals	equals(other) Parámetros:  other:  LatLngAltitude optional es otro objeto LatLngAltitude. Valor que se muestra:  boolean Indica si los dos objetos son iguales. Función de comparación.
toJSON	toJSON() Parámetros: Ninguno Valor que se muestra:  LatLngAltitudeLiteral Es una representación JSON de este objeto.

Interfaz LatLngAltitudeLiteral.

Interfaz de google.maps.LatLngAltitudeLiteral

Por conveniencia, en muchos lugares, se aceptan literales de objeto en lugar de objetos LatLngAltitude. Estos se convierten en objetos LatLngAltitude cuando la API de Google Maps los encuentra.

Esta interfaz extiende LatLngLiteral.

Propiedades
altitude	Tipo:  number Valor predeterminado: 0 Distancia (en metros) sobre la superficie del suelo. El valor negativo significa debajo de la superficie del suelo.
lat	Tipo:  number Es la latitud en grados. Los valores se fijarán al rango [-90, 90]. Esto significa que si el valor especificado es menor que -90, se establecerá en -90. Y si el valor es superior a 90, se establecerá en 90.
lng	Tipo:  number Es la longitud en grados. Los valores fuera del rango [-180, 180] 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 unen alrededor del globo terráqueo.

Clase Point

Clase google.maps.Point

Para acceder, llama a const {Point} = await google.maps.importLibrary("core"). Consulta el artículo 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 Valor que se devuelve:  boolean Compara dos puntos
toString	toString() Parámetros: Ninguno Valor que se devuelve:  string Muestra una representación de cadena de este punto.

Clase Size

Clase google.maps.Size

Para acceder, llama a const {Size} = await google.maps.importLibrary("core"). Consulta el artículo 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 Tamaño bidimensional, donde 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 en el eje Y, en píxeles.
width	Tipo:  number Es el ancho en el eje x, en píxeles.

Métodos
equals	equals(other) Parámetros:  other:  Size Valor que se devuelve:  boolean Compara dos tamaños.
toString	toString() Parámetros: Ninguno Valor que se devuelve:  string Muestra una representación de cadena de este tamaño.

Interfaz Padding

Interfaz de google.maps.Padding

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

CircleLiteral

Interfaz de google.maps.CircleLiteral

Literal de objeto que representa un círculo.

Esta interfaz extiende CircleOptions.

Propiedades
center	Tipo:  LatLng|LatLngLiteral 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 y zIndex.