O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Coordinates

Classe LatLng

classe google.maps.LatLng
biblioteca "core"

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 fixados 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 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, você precisa criar um novo.

A maioria dos métodos que aceitam 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 ao construtor, uma cópia será criada.

As possíveis chamadas para o construtor estão abaixo:

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

const {LatLng} = await google.maps.importLibrary("core");

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 de latitude e 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 de latitude e longitude.

Métodos
`equals`	`equals(other)` Parâmetros: `other: LatLng\|LatLngLiteral optional` Valor de retorno: `boolean` Função de comparação para dois LatLngs. Retorna verdadeiro se as coordenadas estiverem dentro de 1e-9 uma da outra e falso caso contrário.
`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 precisa 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
estendida por DirectionalLocationLiteral, LatLngAltitudeLiteral
implementada por DirectionalLocation, LatLngAltitude

Os objetos literais 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 objetos literais LatLng não são compatíveis com a biblioteca Geometry.

Propriedades
`lat`	Tipo: `number` Latitude em graus. Os valores serão fixados no 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
biblioteca "core"

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

const {LatLngBounds} = await google.maps.importLibrary("core");

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 vão abranger o mundo todo.

Métodos
`contains`	`contains(latLng)` Parâmetros: `latLng: LatLng\|LatLngLiteral` Valor de retorno: `boolean` Retorna `true` se a latitude/longitude fornecida estiver dentro desses limites.
`equals`	`equals(other)` Parâmetros: `other: LatLngBounds\|LatLngBoundsLiteral optional` Valor de retorno: `boolean` Retorna `true` se esses 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 esses limites compartilharem pontos 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 representação JSON. Essa função precisa 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.

Interface LatLngBoundsLiteral

interface google.maps.LatLngBoundsLiteral

Objetos literais 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 fixados no 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 fixados no 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 implementa LatLngAltitudeLiteral, LatLngLiteral
estendida por DirectionalLocation
biblioteca "core"

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

const {LatLngAltitude} = await google.maps.importLibrary("core");

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 ativa a fixação de latitude e o ajuste 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 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 ativa a fixação de latitude e o ajuste de longitude.

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

Métodos
`equals`	`equals(other)` Parâmetros: `other: LatLngAltitude\|LatLngAltitudeLiteral optional` Outro objeto LatLngAltitude. Valor de retorno: `boolean` se os dois objetos são iguais. Função de comparação para dois LatLngAltitudes. Retorna verdadeiro se as coordenadas estiverem dentro de 1e-9 uma da outra e falso caso contrário.
`toJSON`	`toJSON([key])` Parâmetros: `key: string optional` Valor de retorno: `LatLngAltitudeLiteral` Converte em um objeto simples.

Interface LatLngAltitudeLiteral

interface google.maps.LatLngAltitudeLiteral estende LatLngLiteral
estendida por DirectionalLocationLiteral
implementada por DirectionalLocation, LatLngAltitude

Os objetos literais 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.

Propriedades
`altitude`	Tipo: `number` Distância (em metros) acima da superfície do solo. Um valor negativo significa abaixo da superfície do solo.
`lat`	Tipo: `number` Latitude em graus. Os valores serão fixados no 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 Point

classe google.maps.Point
biblioteca "core"

const {Point} = await google.maps.importLibrary("core");

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 Size

classe google.maps.Size
biblioteca "core"

const {Size} = await google.maps.importLibrary("core");

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 optional` 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` opcional	Tipo: `number optional` Padding para a parte de baixo, em pixels.
`left` opcional	Tipo: `number optional` Padding à esquerda, em pixels.
`right` opcional	Tipo: `number optional` Padding à direita, em pixels.
`top` opcional	Tipo: `number optional` Padding para a parte de cima, em pixels.

Interface CircleLiteral

interface google.maps.CircleLiteral extends CircleOptions

Objeto literal que representa um círculo.

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 implementa Orientation3DLiteral
biblioteca "core"

Um Orientation3D é um vetor tridimensional usado para transformações de rotação matemática padrão ao longo de direção, inclinação e rotação.

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

const {Orientation3D} = await google.maps.importLibrary("core");

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

Propriedades
`heading` somente leitura	Tipo: `number` Padrão: `0` Rotação em torno do eixo z (normal à superfície da Terra). Um valor de 0 (o padrão) equivale ao 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 alterados 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` somente leitura	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 alterados 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` somente leitura	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 alterados 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` se os dois objetos são iguais. Função de comparação.
`toJSON`	`toJSON([key])` Parâmetros: `key: string optional` Valor de retorno: `Orientation3DLiteral` Converte em um objeto simples.

Interface Orientation3DLiteral

interface google.maps.Orientation3DLiteral
implementada por Orientation3D

Os objetos literais 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` opcional	Tipo: `number optional` Rotação em torno do eixo z (normal à superfície da Terra). Um valor de 0 (o padrão) equivale ao norte. Uma rotação positiva é no sentido horário em torno do eixo z e especificada em graus de 0 a 360.
`roll` opcional	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` opcional	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 implementa Vector3DLiteral
biblioteca "core"

Um Vector3D é um vetor tridimensional usado para operações matemáticas padrão, como dimensionar os limites de um objeto tridimensional ao longo dos eixos x, y e z locais.

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

const {Vector3D} = await google.maps.importLibrary("core");

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

Propriedades
`x` somente leitura	Tipo: `number` Componente X do vetor tridimensional.
`y` somente leitura	Tipo: `number` Componente Y do vetor tridimensional.
`z` somente leitura	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([key])` Parâmetros: `key: string optional` Valor de retorno: `Vector3DLiteral` Converte em um objeto simples.

Interface Vector3DLiteral

interface google.maps.Vector3DLiteral
implementada por Vector3D

Os objetos literais 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 Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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 Point

Construtor

Propriedades

Métodos

Classe Size

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

Coordinates