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 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 rodean el 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, esta siempre se escribe primero, seguida por la longitud.
Observa 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 manera 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 a const {LatLng} = await google.maps.importLibrary("core"). Consulta Bibliotecas de 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 los valores fuera de este rango. Observa el orden de latitud y longitud.
equals
equals(other)
Parámetros: 
Valor que se muestra:  boolean
Función de comparación.
lat
lat()
Parámetros: Ninguno
Valor que se muestra:  number
Muestra la latitud en grados.
lng
lng()
Parámetros: Ninguno
Valor que se muestra:  number
Muestra la longitud en grados.
toJSON
toJSON()
Parámetros: Ninguno
Valor que se muestra:  LatLngLiteral
Convierte en 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 muestra:  string
Convierte en representación de string.
toUrlValue
toUrlValue([precision])
Parámetros: 
  • precisionnumber optional
Valor que se muestra:  string
Muestra una string con el formato "lat,lng" para esta LatLng. Redondeamos los valores de latitud y longitud a 6 decimales de forma predeterminada.

LatLngLiteral,

Interfaz 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 son compatibles con la biblioteca de geometría.

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 rodean el 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 Bibliotecas de la API de Maps JavaScript.

LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
Parámetros: 
Construye un rectángulo a partir de los puntos en 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 que se muestra:  boolean
Muestra true si el valor de latitud y longitud especificados está dentro de estos límites.
equals
equals(other)
Parámetros: 
Valor que se muestra:  boolean
Muestra true si este límite iguala aproximadamente los límites determinados.
extend
extend(point)
Parámetros: 
Valor que se muestra:  LatLngBounds
Extiende este límite para contener el punto determinado.
getCenter
getCenter()
Parámetros: Ninguno
Valor que se muestra:  LatLng
Calcula el centro de este objeto LatLngBounds
getNorthEast
getNorthEast()
Parámetros: Ninguno
Valor que se muestra:  LatLng
Muestra la esquina noreste de este límite.
getSouthWest
getSouthWest()
Parámetros: Ninguno
Valor que se muestra:  LatLng
Muestra el ángulo suroeste de este límite.
intersects
intersects(other)
Parámetros: 
Valor que se muestra:  boolean
Muestra true si este límite comparte algún punto con los otros límites.
isEmpty
isEmpty()
Parámetros: Ninguno
Valor que se muestra:  boolean
Muestra si los límites están vacíos.
toJSON
toJSON()
Parámetros: Ninguno
Valor que se muestra:  LatLngBoundsLiteral
Convierte en 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 muestra:  LatLng
Convierte los límites del mapa especificado en un intervalo de latitud y longitud.
toString
toString()
Parámetros: Ninguno
Valor que se muestra:  string
Convierte una string.
toUrlValue
toUrlValue([precision])
Parámetros: 
  • precisionnumber optional
Valor que se muestra:  string
Muestra una string 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: 
Valor que se muestra:  LatLngBounds
Extiende estos límites para contener la unión de este límite y los dados.

LatLngBoundsLiteral

Interfaz google.maps.LatLngBoundsLiteral

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

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 rodean el 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
Es la 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 establecerá 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 rodean el 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 rodean el 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 bajo la superficie del suelo.

Esta clase implementa LatLngAltitudeLiteral.

Esta clase implementa LatLngLiteral.

Para acceder, llama a const {LatLngAltitude} = await google.maps.importLibrary("core"). Consulta Bibliotecas de 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 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 el ajuste de latitud y longitud.
altitude
Tipo:  number
Muestra la altitud.
lat
Tipo:  number
Muestra la latitud.
lng
Tipo:  number
Muestra la longitud.
equals
equals(other)
Parámetros: 
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 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.

altitude
Tipo:  number
Valor predeterminado: 0
Distancia (en metros) sobre la superficie del suelo. Un 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 rodean el globo terráqueo.

Clase Point

Clase google.maps.Point

Para acceder, llama a const {Point} = await google.maps.importLibrary("core"). Consulta Bibliotecas de 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: 
Valor que se muestra:  boolean
Compara dos puntos
toString
toString()
Parámetros: Ninguno
Valor que se muestra:  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 Bibliotecas de la API de Maps JavaScript.

Size
Size(width, height[, widthUnit, heightUnit])
Parámetros: 
  • widthnumber
  • heightnumber
  • widthUnitstring optional
  • heightUnitstring optional
Es un 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 en el eje Y, en píxeles.
width
Tipo:  number
El ancho en el eje X, en píxeles.
equals
equals(other)
Parámetros: 
Valor que se muestra:  boolean
Compara dos tamaños.
toString
toString()
Parámetros: Ninguno
Valor que se muestra:  string
Muestra una representación de string de este Size.

Padding

Interfaz google.maps.Padding

bottom optional
Tipo:  number optional
Relleno de la parte inferior, en píxeles.
left optional
Tipo:  number optional
Relleno para la izquierda, en píxeles.
right optional
Tipo:  number optional
Relleno del lado derecho, en píxeles.
top optional
Tipo:  number optional
Relleno de la parte superior, en píxeles.

CircleLiteral

Interfaz google.maps.CircleLiteral

Literal de objeto que representa un círculo.

Esta interfaz extiende CircleOptions.

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