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: 
  • 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 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: 
  • precision:  number 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: