Em breve, a Plataforma Google Maps usará a nova estilização de mapas. Essa atualização inclui uma nova paleta de cores padrão e melhorias nas experiências de mapa e na usabilidade. Todos os estilos de mapa serão atualizados automaticamente em março de 2025. Para mais informações sobre a disponibilidade e como ativar logo, consulte Novo estilo de mapa para a Plataforma Google Maps.

Esta página foi traduzida pela API Cloud Translation.

Coordinates

Classe 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 fixados no intervalo [-90, 90]. Isso significa que, se o valor especificado for menor que -90, ele será definido como -90. E 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 se adequarem ao 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 ao redor do globo.

Embora a projeção padrão do mapa associe a longitude à coordenada X do mapa, e a latitude à coordenada Y, a coordenada de latitude vem sempre primeiro, seguida pela longitude.
Não é possível modificar as coordenadas de uma LatLng. Se você quiser computar outro ponto, terá que criar um novo.

A maioria dos métodos que aceita objetos LatLng também aceita um objeto LatLngLiteral, de modo que os seguintes são 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.

As possíveis chamadas para o construtor são estas:

 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 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.

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 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.

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 em representação JSON. Essa função é 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 lat/lng para 6 casas decimais.

LatLngLiteral

Interface google.maps.LatLngLiteral

Por conveniência, literais de objeto são aceitos no lugar de objetos LatLng em muitos lugares. Eles são convertidos em objetos LatLng quando são encontrados pela API Maps.

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 aceitos na Biblioteca de geometria.

Propriedades
`lat`	Tipo: `number` Latitude em graus. Os valores são fixados no intervalo [-90, 90]. Isso significa que, se o valor especificado for menor que -90, ele será definido como -90. E se o valor for maior que 90, ele será definido como 90.
`lng`	Tipo: `number` Longitude em graus. Valores fora do intervalo [-180, 180] são alterados para se adequarem ao 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 ao redor do globo.

Classe LatLngBounds

Classe google.maps.LatLngBounds

Uma instância de LatLngBounds representa um retângulo em coordenadas geográficas, incluindo a 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.

Constantes
`MAX_BOUNDS`	LatLngBounds para os limites máximos da Terra. Esses limites abrangerão todo o globo.

Métodos
`contains`	`contains(latLng)` Parâmetros: `latLng`: `LatLng\|LatLngLiteral` Valor de retorno: `boolean` Retorna `true` se a lat/lng especificada estiver dentro dos limites.
`equals`	`equals(other)` Parâmetros: `other`: `LatLngBounds\|LatLngBoundsLiteral optional` Valor de retorno: `boolean` Retorna `true` se esses limites forem aproximadamente 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 esses limites tiverem pontos em comum 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 em representação JSON. Essa função é para 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, enquanto "hi" corresponde ao canto nordeste dessa caixa.
`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.

LatLngBoundsLiteral

Interface google.maps.LatLngBoundsLiteral

Em toda a API, literais de objeto são aceitos no lugar de objetos LatLngBounds. Eles são convertidos automaticamente em objetos LatLngBounds. Todos os south, west, north e east precisam ser definidos. Caso contrário, uma exceção será gerada.

Propriedades
`east`	Tipo: `number` Longitude Leste em graus. Valores fora do intervalo [-180, 180] serão ajustados 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 ao redor do globo.
`north`	Tipo: `number` Latitude norte em graus. Os valores são fixados no intervalo [-90, 90]. Isso significa que, se o valor especificado for menor que -90, ele será definido como -90. E se o valor for maior que 90, ele será definido como 90.
`south`	Tipo: `number` Latitude sul em graus. Os valores são fixados no intervalo [-90, 90]. Isso significa que, se o valor especificado for menor que -90, ele será definido como -90. E 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 ajustados 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 ao redor do globo.

Classe 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 fixados no intervalo [-90, 90]. Isso significa que, se o valor especificado for menor que -90, ele será definido como -90. E 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 se adequarem ao 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 ao redor do 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 serão preservados, mesmo que não sejam necessariamente valores de latitude válidos no intervalo de [-90, 90] ou de longitude válidos no intervalo de [-180, 180]. O padrão é `false`, que ativa a limitação de latitude e a quebra de longitude.

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 serão preservados, mesmo que não sejam necessariamente valores de latitude válidos no intervalo de [-90, 90] ou de longitude válidos no intervalo de [-180, 180]. O padrão é false, que ativa a limitação de latitude e a quebra de 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` indica 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

Por conveniência, literais de objeto são aceitos no lugar de objetos LatLngAltitude em muitos lugares. Eles são convertidos em objetos LatLngAltitude quando são encontrados pela API Maps.

Essa interface estende LatLngLiteral.

Propriedades
`altitude`	Tipo: `number` Padrão:`0` Distância (em metros) acima da superfície do solo. Um valor negativo significa que está sob a superfície do solo.
`lat`	Tipo: `number` Latitude em graus. Os valores são fixados no intervalo [-90, 90]. Isso significa que, se o valor especificado for menor que -90, ele será definido como -90. E se o valor for maior que 90, ele será definido como 90.
`lng`	Tipo: `number` Longitude em graus. Valores fora do intervalo [-180, 180] são alterados para se adequarem ao 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 ao redor do globo.

Classe 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` Espaçamento da parte inferior, em pixels.
`left optional`	Tipo: `number optional` Padding à esquerda, em pixels.
`right optional`	Tipo: `number optional` Padding à direita, em pixels.
`top optional`	Tipo: `number optional` Espaçamento da parte superior, em pixels.

Interface CircleLiteral

Interface google.maps.CircleLiteral

Objeto literal 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.
Herdado: `clickable`, `draggable`, `editable`, `fillColor`, `fillOpacity`, `map`, `strokeColor`, `strokeOpacity`, `strokePosition`, `strokeWeight`, `visible`, `zIndex`

Coordinates

Classe LatLng

Construtor

Métodos

LatLngLiteral

Propriedades

Classe LatLngBounds

Construtor

Constantes

Métodos

LatLngBoundsLiteral

Propriedades

Classe LatLngAltitude

Construtor

Propriedades

Métodos

LatLngAltitudeLiteral

Propriedades

Classe Point

Construtor

Propriedades

Métodos

Size

Construtor

Propriedades

Métodos

Padding.

Propriedades

Interface CircleLiteral

Propriedades