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

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

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

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 especificada 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 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 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 para representação JSON. Essa função foi criada 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 e "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 dos 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. 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. 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, 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.
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 ligando para 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 ativa o bloqueio 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 o bloqueio de latitude e o ajuste 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` 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

Em muitos lugares, os literais de objeto são aceitos no lugar dos objetos LatLngAltitude para facilitar. 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. Um 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 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 Point

Classe google.maps.Point

Acesse ligando para 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 de tamanho

Classe google.maps.Size

Acesse ligando para 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.

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 de tamanho

Construtor

Propriedades

Coordinates