Anúncio:em breve, a Plataforma Google Maps vai ter um novo estilo de mapa de base. Essa atualização inclui uma nova paleta de cores padrão, pinos modernizados 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 em coordenadas geográficas: latitude e longitude.

A latitude varia entre -90 e 90 graus. Valores acima ou abaixo desse intervalo sã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 você quiser calcular outro ponto, crie um novo.

A maioria dos métodos que aceitam objetos LatLng também aceitam um objeto LatLngLiteral, de modo que o seguinte seja 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 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 permitir 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 permitir 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 é destinada a ser usada por `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

Os literais de objeto são aceitos no lugar de objetos 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 aceitos na biblioteca Geometry.

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. Os valores fora do intervalo [-180, 180] serã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.

Classe LatLngBounds

Classe google.maps.LatLngBounds

Uma instância 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.

Constantes
`MAX_BOUNDS`	LatLngBounds para os limites máximos da Terra. Esses limites abrangem 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 nesses limites.
`equals`	`equals(other)` Parâmetros: `other`: `LatLngBounds\|LatLngBoundsLiteral optional` Valor de retorno:`boolean` Retorna `true` se os limites forem aproximadamente iguais aos limites fornecidos.
`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 os limites compartilharem pontos com os outros.
`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 é destinada a ser usada por `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 do formulário "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.

Interface LatLngBoundsLiteral

Interface google.maps.LatLngBoundsLiteral

Os literais de objeto são aceitos no lugar de objetos LatLngBounds em toda a API. 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. Os valores fora do intervalo [-180, 180] serão ajustados para o intervalo [-180, 180]. 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.
`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. Os valores fora do intervalo [-180, 180] serão ajustados para o intervalo [-180, 180]. 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 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. Valores acima ou abaixo desse intervalo sã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.
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 valores de longitude válidos no intervalo de [-180, 180]. O padrão é `false`, que permite a fixação da latitude e o ajuste da 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 valores de longitude válidos no intervalo de [-180, 180]. O padrão é false, que permite a fixação da latitude e o ajuste da 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.

Interface LatLngAltitudeLiteral

Interface google.maps.LatLngAltitudeLiteral

Os literais de objeto são aceitos no lugar de objetos 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. Os valores fora do intervalo [-180, 180] serã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.

Classe Ponto

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

Classe Tamanho

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.

Interface Padding

Interface google.maps.Padding

Propriedades
`bottom optional`	Tipo:`number optional` Padding para a parte de baixo, em pixels.
`left optional`	Tipo:`number optional` Padding para a esquerda, em pixels.
`right optional`	Tipo:`number optional` Padding para a direita, em pixels.
`top optional`	Tipo:`number optional` Margem para a parte de cima, em pixels.

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

Classe Orientation3D

Classe google.maps.Orientation3D

Um Orientation3D é um vetor tridimensional usado para transformações matemáticas padrão de rotação ao longo do rumo, da inclinação e do rolamento.

heading é um ângulo no intervalo [0, 360] graus.
tilt é um ângulo no intervalo [0, 360] graus.
roll é um ângulo no intervalo [0, 360] graus.

Essa classe implementa Orientation3DLiteral.

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

Construtor
`Orientation3D`	`Orientation3D(value)` Parâmetros: `value`: `Orientation3D\|Orientation3DLiteral` O valor de inicialização.

Propriedades
`heading`	Tipo:`number` Padrão:`0` Rotação em torno do eixo z (normal à superfície da Terra). Um valor de 0 (padrão) é igual a "Norte". Uma rotação positiva é no sentido horário em torno do eixo z e especificada em graus de 0 a 360. 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 530 também será convertido em 170.
`roll`	Tipo:`number` Padrão:`0` Rotação em torno do eixo Y. Uma rotação positiva é no sentido horário em torno do eixo y e especificada em graus de 0 a 360. 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 530 também será convertido em 170.
`tilt`	Tipo:`number` Padrão:`0` Rotação em torno do eixo x. Uma rotação positiva é no sentido horário em torno do eixo x e especificada em graus de 0 a 360. 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 530 também será convertido em 170.

Métodos
`equals`	`equals(other)` Parâmetros: `other`: `Orientation3D\|Orientation3DLiteral optional` Outro objeto Orientation3D. 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:`Orientation3DLiteral` Converte em representação JSON. Essa função é destinada a ser usada por JSON.stringify.

Interface Orientation3DLiteral

Interface google.maps.Orientation3DLiteral

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

Propriedades
`heading optional`	Tipo:`number optional` Rotação em torno do eixo z (normal à superfície da Terra). Um valor de 0 (padrão) é igual a "Norte". Uma rotação positiva é no sentido horário em torno do eixo z e especificada em graus de 0 a 360.
`roll optional`	Tipo:`number optional` Rotação em torno do eixo Y. Uma rotação positiva é no sentido horário em torno do eixo y e especificada em graus de 0 a 360.
`tilt optional`	Tipo:`number optional` Rotação em torno do eixo x. Uma rotação positiva é no sentido horário em torno do eixo x e especificada em graus de 0 a 360.

Classe Vector3D

Classe google.maps.Vector3D

Um Vector3D é um vetor tridimensional usado para operações matemáticas padrão, como dimensionar os limites de objetos tridimensionais ao longo dos eixos X, Y e Z locais.

x é um número real.
y é um número real.
z é um número real.

Essa classe implementa Vector3DLiteral.

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

Construtor
`Vector3D`	`Vector3D(value)` Parâmetros: `value`: `Vector3D\|Vector3DLiteral` O valor de inicialização.

Propriedades
`x`	Tipo:`number` Componente X do vetor tridimensional.
`y`	Tipo:`number` Componente Y do vetor tridimensional.
`z`	Tipo:`number` Componente Z do vetor tridimensional.

Métodos
`equals`	`equals(other)` Parâmetros: `other`: `Vector3D\|Vector3DLiteral optional` Outro objeto Vector3D ou Vector3DLiteral. Valor de retorno:`boolean` Função de comparação.
`toJSON`	`toJSON()` Parâmetros:nenhum Valor de retorno:`Vector3DLiteral` Converte em representação JSON. Essa função é destinada a ser usada por JSON.stringify.

Interface Vector3DLiteral

Interface google.maps.Vector3DLiteral

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

Propriedades
`x`	Tipo:`number` Componente X do vetor tridimensional.
`y`	Tipo:`number` Componente Y do vetor tridimensional.
`z`	Tipo:`number` Componente Z do vetor tridimensional.

Coordinates

Classe LatLng

Construtor

Métodos

Interface LatLngLiteral

Propriedades

Classe LatLngBounds

Construtor

Constantes

Métodos

Interface LatLngBoundsLiteral

Propriedades

Classe LatLngAltitude

Construtor

Propriedades

Métodos

Interface LatLngAltitudeLiteral

Propriedades

Classe Ponto

Construtor

Propriedades

Métodos

Classe Tamanho

Construtor

Propriedades

Métodos

Interface Padding

Propriedades

Interface CircleLiteral

Propriedades

Classe Orientation3D

Construtor

Propriedades

Métodos

Interface Orientation3DLiteral

Propriedades

Classe Vector3D

Construtor

Propriedades

Métodos

Interface Vector3DLiteral

Propriedades