Coordinates

LatLng

Classe google.maps.LatLng

Um LatLng é um ponto nas 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 alterados para que se enquadrem no intervalo. Por exemplo, um valor de -190 será convertido para 170. Um valor de 190 será convertido para -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 latitude vem sempre primeiro, seguida pela longitude.
Não é possível modificar as coordenadas de um LatLng. Se quiser computar outro ponto, é preciso criar um novo.

A maioria dos métodos que aceitam objetos LatLng também aceita um objeto LatLngLiteral, para que os seguintes sejam equivalentes:

 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 para o construtor, uma cópia será criada.

Veja abaixo as possíveis chamadas ao 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 chamando const {LatLng} = await google.maps.importLibrary("core"). Consulte Bibliotecas na API Maps JavaScript.

Construtor

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 dentro do intervalo [-90, 90]. A longitude é especificada em graus dentro do intervalo [-180, 180). Defina noClampNoWrap como true para ativar valores fora desse intervalo. Observe a ordem da latitude e da longitude.

Métodos
equals	equals(other) Parâmetros:  other:  LatLng 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 a representação JSON. Essa função deve 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 lat/lng para 6 casas decimais.

LatLngLiteral

Interface google.maps.LatLngLiteral

Os literais de objeto são aceitos no lugar de LatLng, por conveniência, em muitos lugares. 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 suportados na biblioteca de geometria.

Propriedades
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 alterados para que se enquadrem no intervalo. Por exemplo, um valor de -190 será convertido para 170. Um valor de 190 será convertido para -170. Isso reflete o fato de que as longitudes envolvem o globo.

LatLngBounds

Classe google.maps.LatLngBounds

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

Acesse chamando const {LatLngBounds} = await google.maps.importLibrary("core"). Consulte Bibliotecas na API Maps JavaScript.

Construtor
LatLngBounds	LatLngBounds([swOrLatLngBounds, ne]) Parâmetros:  swOrLatLngBounds:  LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral optional ne:  LatLng|LatLngLiteral optional Constrói um retângulo a partir dos cantos sudoeste e nordeste dos pontos.

Métodos
contains	contains(latLng) Parâmetros:  latLng:  LatLng|LatLngLiteral Valor de retorno:  boolean Retornará true se a latitude/longitude especificada estiver dentro desses limites.
equals	equals(other) Parâmetros:  other:  LatLngBounds|LatLngBoundsLiteral optional Valor de retorno:  boolean Retornará true se esses limites forem iguais aos limites especificados.
extend	extend(point) Parâmetros:  point:  LatLng|LatLngLiteral Valor de retorno:  LatLngBounds Estende esses limites para conter o ponto especificado.
getCenter	getCenter() Parâmetros: nenhum Valor de retorno:  LatLng Calcula o centro deste LatLngBounds.
getNorthEast	getNorthEast() Parâmetros: nenhum Valor de retorno:  LatLng Retorna o canto nordeste desses limites.
getSouthWest	getSouthWest() Parâmetros: nenhum Valor de retorno:  LatLng Retorna o canto sudoeste desses limites.
intersects	intersects(other) Parâmetros:  other:  LatLngBounds|LatLngBoundsLiteral Valor de retorno:  boolean Retorna true se esse limite compartilhar algum ponto com os outros limites.
isEmpty	isEmpty() Parâmetros: nenhum Valor de retorno:  boolean Retorna "true" se os limites estiverem vazios.
toJSON	toJSON() Parâmetros: nenhum Valor de retorno:  LatLngBoundsLiteral Converte para a representação JSON. Essa função deve ser usada com JSON.stringify.
toSpan	toSpan() Parâmetros: nenhum Valor de retorno:  LatLng Converte os limites do mapa especificado em um intervalo em lat/lng.
toString	toString() Parâmetros: nenhum Valor de retorno:  string Converte em string.
toUrlValue	toUrlValue([precision]) Parâmetros:  precision:  number optional Valor de retorno:  string Retorna uma string no formato "lat_lo,lng_lo,lat_hi,lng_hi" para esses limites, em que "lo" corresponde ao canto sudoeste da caixa delimitadora, e "hi" corresponde ao canto nordeste.
union	union(other) Parâmetros:  other:  LatLngBounds|LatLngBoundsLiteral Valor de retorno:  LatLngBounds Amplia esses limites para conter a união desses limites e dos limites especificados.

Constantes
MAX_BOUNDS	LatLngBounds para os limites máximos da Terra. Esses limites englobarão o globo inteiro.

LatLngBoundsLiteral.

Interface google.maps.LatLngBoundsLiteral

Literais de objetos são aceitos no lugar de objetos LatLngBounds em toda a API. Elas são convertidas automaticamente em objetos LatLngBounds. Todos os south, west, north e east precisam ser definidos. Caso contrário, uma exceção é gerada.

Propriedades
east	Tipo:  number Longitude leste em graus. Valores fora do intervalo [-180, 180] serão convertidos para o intervalo [-180, 180]. Por exemplo, um valor de -190 será convertido para 170. Um valor de 190 será convertido para -170. Isso reflete o fato de que as longitudes envolvem o globo.
north	Tipo:  number Latitude norte 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.
south	Tipo:  number Latitude sul 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.
west	Tipo:  number Longitude oeste em graus. Valores fora do intervalo [-180, 180] serão convertidos para o intervalo [-180, 180]. Por exemplo, um valor de -190 será convertido para 170. Um valor de 190 será convertido para -170. Isso reflete o fato de que as longitudes envolvem o globo.

LatLngAltitude

Classe google.maps.LatLngAltitude

Um LatLngAltitude é um ponto 3D em coordenadas geográficas: latitude, longitude e altitude.

• 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 alterados para que se enquadrem no intervalo. Por exemplo, um valor de -190 será convertido para 170. Um valor de 190 será convertido para -170. Isso reflete o fato de que as longitudes envolvem o globo.
• A altitude é medida em metros. Valores positivos indicam alturas acima do nível do solo, e valores negativos indicam alturas abaixo da superfície do solo.

Essa classe implementa LatLngAltitudeLiteral.

Essa classe implementa LatLngLiteral.

Acesse chamando const {LatLngAltitude} = await google.maps.importLibrary("core"). Consulte Bibliotecas na API Maps JavaScript.

Construtor

LatLngAltitude

LatLngAltitude(value[, noClampNoWrap]) Parâmetros:  value:  LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral o valor de inicialização. noClampNoWrap:  boolean optional se os valores de inicialização devem ser preservados, mesmo que não sejam necessariamente valores de latitude válidos no intervalo de [-90, 90] ou valores de longitude válidos no intervalo de [-180, 180]. O padrão é false, que permite o ajuste de latitude e longitude.

Propriedades
altitude	Tipo:  number Retorna a altitude.
lat	Tipo:  number Retorna a latitude.
lng	Tipo:  number Retorna a longitude.

Métodos
equals	equals(other) Parâmetros:  other:  LatLngAltitude optional outro objeto LatLngAltitude. Valor de retorno:  boolean se os dois objetos são iguais. Função de comparação.
toJSON	toJSON() Parâmetros: nenhum Valor de retorno:  LatLngAltitudeLiteral Uma representação JSON desse objeto.

LatLngAltitudeLiteral

Interface google.maps.LatLngAltitudeLiteral

Os literais de objeto são aceitos no lugar de LatLngAltitude, por conveniência, em muitos lugares. Eles são convertidos em objetos LatLngAltitude quando a API Maps os encontra.

Essa interface estende LatLngLiteral.

Propriedades
altitude	Tipo:  number Padrão: 0 Distância (em metros) acima da superfície do solo. Valor negativo significa abaixo da superfície do solo.
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 alterados para que se enquadrem no intervalo. Por exemplo, um valor de -190 será convertido para 170. Um valor de 190 será convertido para -170. Isso reflete o fato de que as longitudes envolvem o globo.

Point.

Classe google.maps.Point

Acesse chamando const {Point} = await google.maps.importLibrary("core"). Consulte Bibliotecas na API Maps JavaScript.

Construtor
Point	Point(x, y) Parâmetros:  x:  number y:  number Um ponto em um plano bidimensional.

Propriedades
x	Tipo:  number A coordenada X.
y	Tipo:  number A coordenada Y.

Métodos
equals	equals(other) Parâmetros:  other:  Point Valor de retorno:  boolean Compara dois pontos.
toString	toString() Parâmetros: nenhum Valor de retorno:  string Retorna uma representação no formato de string deste ponto.

Size

Classe google.maps.Size

Acesse chamando const {Size} = await google.maps.importLibrary("core"). Consulte Bibliotecas na API Maps JavaScript.

Construtor
Size	Size(width, height[, widthUnit, heightUnit]) Parâmetros:  width:  number height:  number widthUnit:  string optional heightUnit:  string optional Tamanho bidimensional, em que a largura é a distância no eixo x e a altura é a distância no eixo y.

Propriedades
height	Tipo:  number A altura ao longo do eixo y, em pixels.
width	Tipo:  number A largura ao longo do eixo x, em pixels.

Métodos
equals	equals(other) Parâmetros:  other:  Size Valor de retorno:  boolean Compara dois tamanhos.
toString	toString() Parâmetros: nenhum Valor de retorno:  string Retorna uma representação no formato de string deste tamanho.

Padding.

Interface google.maps.Padding

Propriedades
bottom optional	Tipo:  number optional Preenchimento para a parte inferior, em pixels.
left optional	Tipo:  number optional Preenchimento à esquerda, em pixels.
right optional	Tipo:  number optional Preenchimento à direita, em pixels.
top optional	Tipo:  number optional Preenchimento para o topo, em pixels.

CircleLiteral

Interface google.maps.CircleLiteral

Literal de objeto que representa um círculo.

Essa interface estende CircleOptions.

Propriedades
center	Tipo:  LatLng|LatLngLiteral O centro do círculo.
radius	Tipo:  number O raio em metros na superfície da Terra.
Herdada: clickable, draggable, editable, fillColor, fillOpacity, map, strokeColor, strokeOpacity, strokePosition, strokeWeight, visible, zIndex