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.

LatLng
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])
Parâmetros:
  • latOrLatLngOrLatLngLiteralnumber|LatLngLiteral|LatLng
  • lngOrNoClampNoWrapnumber|boolean optional
  • noClampNoWrapboolean 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.
equals
equals(other)
Parâmetros:
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:
  • precisionnumber 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.

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.

LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
Parâmetros:
Constrói um retângulo a partir dos cantos sudoeste e nordeste dos pontos.
MAX_BOUNDS LatLngBounds para os limites máximos da Terra. Esses limites vão abranger o mundo todo.
contains
contains(latLng)
Parâmetros:
Valor de retorno:boolean
Retorna true se a latitude/longitude especificada estiver dentro desses limites.
equals
equals(other)
Parâmetros:
Valor de retorno:boolean
Retorna true se esses limites forem aproximadamente iguais aos limites especificados.
extend
extend(point)
Parâmetros:
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:
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:
  • precisionnumber 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:
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.

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.

LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
Parâmetros:
  • valueLatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral o valor de inicialização.
  • noClampNoWrapboolean 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.
altitude
Tipo:number
Retorna a altitude.
lat
Tipo:number
Retorna a latitude.
lng
Tipo:number
Retorna a longitude.
equals
equals(other)
Parâmetros:
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.

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.

Point
Point(x, y)
Parâmetros:
  • xnumber
  • ynumber
Um ponto em um plano bidimensional.
x
Tipo:number
A coordenada X.
y
Tipo:number
A coordenada Y.
equals
equals(other)
Parâmetros:
  • otherPoint 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.

Size
Size(width, height[, widthUnit, heightUnit])
Parâmetros:
  • widthnumber
  • heightnumber
  • widthUnitstring optional
  • heightUnitstring optional
Tamanho bidimensional, em que a largura é a distância no eixo x e a altura é a distância no eixo y.
height
Tipo:number
A altura ao longo do eixo y, em pixels.
width
Tipo:number
A largura ao longo do eixo x, em pixels.
equals
equals(other)
Parâmetros:
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

bottom optional
Tipo:number optional
Padding para a parte de baixo, 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
Padding 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.

center
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 de rotação matemática padrão ao longo de direção, inclinação e rotação.

  • O rumo é um ângulo no intervalo [0, 360) graus.
  • A inclinação é um ângulo no intervalo [0, 360) graus.
  • A rotação é um ângulo no intervalo [0, 360) graus.

Essa classe implementa Orientation3DLiteral.

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

Orientation3D
Orientation3D(value)
Parâmetros:
heading
Tipo:number
Padrão:0
Rotação em torno do eixo z (normal à superfície da Terra). Um valor de 0 (o 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.
equals
equals(other)
Parâmetros:
Valor de retorno:boolean se os dois objetos são iguais.
Função de comparação.
toJSON
toJSON()
Parâmetros:nenhum
Valor de retorno:Orientation3DLiteral
Converte para representação JSON. Essa função foi criada para ser usada com JSON.stringify.

Interface Orientation3DLiteral

Interface google.maps.Orientation3DLiteral

Em muitos lugares, os literais de objeto são aceitos no lugar dos objetos Orientation3D para facilitar. Eles são convertidos em objetos Orientation3D quando a API Maps os encontra.

heading optional
Tipo:number optional
Rotação em torno do eixo z (normal à superfície da Terra). Um valor de 0 (o 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 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.

Essa classe implementa Vector3DLiteral.

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

Vector3D
Vector3D(value)
Parâmetros:
x
Tipo:number
Componente X do vetor tridimensional.
y
Tipo:number
Componente Y do vetor tridimensional.
z
Tipo:number
Componente Z do vetor tridimensional.
equals
equals(other)
Parâmetros:
Valor de retorno:boolean
Função de comparação.
toJSON
toJSON()
Parâmetros:nenhum
Valor de retorno:Vector3DLiteral
Converte para representação JSON. Essa função foi criada para ser usada com JSON.stringify.

Interface Vector3DLiteral

Interface google.maps.Vector3DLiteral

Em muitos lugares, os literais de objeto são aceitos no lugar dos objetos Vector3D para facilitar. Eles são convertidos em objetos Vector3D quando a API Maps os encontra.

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