Coordinates

Classe LatLng

Classe google.maps.LatLng

Um LatLng é um ponto em coordenadas geográficas: latitude e longitude.

  • A latitude varia entre -90 e 90 graus, inclusive. Valores acima ou abaixo desse intervalo serão ajustados para o intervalo [-90, 90]. Isso significa que, se o valor especificado for menor que -90, ele será definido como -90. Se o valor for maior que 90, ele será definido como 90.
  • A longitude varia entre -180 e 180 graus. Valores acima ou abaixo desse intervalo são ajustados para se adequarem ao intervalo. Por exemplo, um valor de -190 será convertido em 170. Um valor de 190 será convertido em -170. Isso reflete o fato de que as longitudes envolvem o globo.
Embora a projeção de mapa padrão associe a longitude à coordenada x do mapa e a latitude à coordenada y, a coordenada de latitude é sempre escrita primeiro, seguida pela longitude.
Não é possível modificar as coordenadas de um LatLng. Se quiser calcular outro ponto, crie um novo.

A maioria dos métodos que aceitam objetos LatLng também aceita um objeto LatLngLiteral. Portanto, o seguinte é equivalente: 

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

O construtor também aceita objetos LatLngLiteral e LatLng. Se uma instância LatLng for transmitida ao construtor, uma cópia será criada.

Confira abaixo as possíveis chamadas para o construtor: 

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

Acesse ligando para const {LatLng} = await google.maps.importLibrary("core").
Consulte Bibliotecas na API Maps JavaScript.
LatLng
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])
Parâmetros:
  • latOrLatLngOrLatLngLiteral:  number|LatLngLiteral|LatLng
  • lngOrNoClampNoWrap:  number|boolean optional
  • noClampNoWrap:  boolean optional
Cria um objeto LatLng que representa um ponto geográfico. A latitude é especificada em graus no intervalo [-90, 90]. A longitude é especificada em graus no intervalo [-180, 180). Defina noClampNoWrap como true para ativar valores fora desse intervalo. Observe a ordem da latitude e da longitude.
equals
equals(other)
Parâmetros:
Valor de retorno:boolean
Função de comparação.
lat
lat()
Parâmetros:nenhum
Valor de retorno:number
Retorna a latitude em graus.
lng
lng()
Parâmetros:nenhum
Valor de retorno:number
Retorna a longitude em graus.
toJSON
toJSON()
Parâmetros:nenhum
Valor de retorno:LatLngLiteral
Converte para representação JSON. Essa função foi criada para ser usada com JSON.stringify.
toString
toString()
Parâmetros:nenhum
Valor de retorno:string
Converte em uma representação no formato de string.
toUrlValue
toUrlValue([precision])
Parâmetros:
  • precision:  number optional
Valor de retorno:string
Retorna uma string no formato "lat,lng" para este LatLng. Por padrão, arredondamos os valores de latitude/longitude para seis casas decimais.

Interface LatLngLiteral

Interface google.maps.LatLngLiteral

Em muitos lugares, os literais de objeto são aceitos no lugar dos objetos LatLng para facilitar. Eles são convertidos em objetos LatLng quando a API Maps os encontra.

Exemplos: 

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

Os literais de objeto LatLng não são compatíveis com a biblioteca Geometry.
lat
Tipo:number
Latitude em graus. Os valores serão ajustados ao intervalo [-90, 90]. Isso significa que, se o valor especificado for menor que -90, ele será definido como -90. Se o valor for maior que 90, ele será definido como 90.
lng
Tipo:number
Longitude em graus. Valores fora do intervalo [-180, 180] serão ajustados para ficar dentro dele. Por exemplo, um valor de -190 será convertido em 170. Um valor de 190 será convertido em -170. Isso reflete o fato de que as longitudes envolvem o globo.

Classe LatLngBounds

Classe google.maps.LatLngBounds

Uma instância LatLngBounds representa um retângulo em coordenadas geográficas, incluindo um que cruza o meridiano longitudinal de 180 graus.

Acesse ligando para const {LatLngBounds} = await google.maps.importLibrary("core").
Consulte Bibliotecas na API Maps JavaScript.
LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
Parâmetros:
Constrói um retângulo a partir dos cantos sudoeste e nordeste dos pontos.
MAX_BOUNDS LatLngBounds para os limites máximos da Terra. Esses limites vão abranger o mundo todo.
contains
contains(latLng)
Parâmetros:
Valor de retorno:boolean
Retorna true se a latitude/longitude especificada estiver dentro desses limites.
equals
equals(other)
Parâmetros:
Valor de retorno:boolean
Retorna true se esses limites forem aproximadamente iguais aos limites especificados.
extend
extend(point)
Parâmetros:
Valor de retorno:LatLngBounds
Estende esses limites para conter o ponto especificado.