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.
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:
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:
Valor de retorno:
booleanFunção de comparação. |
lat |
lat()Parâmetros:nenhum
Valor de retorno:
numberRetorna a latitude em graus. |
lng |
lng()Parâmetros:nenhum
Valor de retorno:
numberRetorna a longitude em graus. |
toJSON |
toJSON()Parâmetros:nenhum
Valor de retorno:
LatLngLiteralConverte para representação JSON. Essa função foi criada para ser usada com JSON.stringify. |
toString |
toString()Parâmetros:nenhum
Valor de retorno:
stringConverte em uma representação no formato de string. |
toUrlValue |
toUrlValue([precision])Parâmetros:
Valor de retorno:
stringRetorna 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:
numberLatitude 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:
numberLongitude 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:
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:
Valor de retorno:
booleanRetorna true se a latitude/longitude especificada estiver dentro desses limites. |
equals |
equals(other)Parâmetros:
Valor de retorno:
booleanRetorna true se esses limites forem aproximadamente iguais aos limites especificados. |
extend |
extend(point)Parâmetros:
Valor de retorno:
LatLngBoundsEstende esses limites para conter o ponto especificado. |
getCenter |
getCenter()Parâmetros:nenhum
Valor de retorno:
LatLngCalcula o centro deste LatLngBounds. |
getNorthEast |
getNorthEast()Parâmetros:nenhum
Valor de retorno:
LatLngRetorna o canto nordeste desses limites. |
getSouthWest |
getSouthWest()Parâmetros:nenhum
Valor de retorno:
LatLngRetorna o canto sudoeste desses limites. |
intersects |
intersects(other)Parâmetros:
Valor de retorno:
booleanRetorna true se esses limites compartilharem pontos com os outros. |
isEmpty |
isEmpty()Parâmetros:nenhum
Valor de retorno:
booleanRetorna "true" se os limites estiverem vazios. |
toJSON |
toJSON()Parâmetros:nenhum
Valor de retorno:
LatLngBoundsLiteralConverte para representação JSON. Essa função foi criada para ser usada com JSON.stringify. |
toSpan |
toSpan()Parâmetros:nenhum
Valor de retorno:
LatLngConverte os limites do mapa especificado em um intervalo em lat/lng. |
toString |
toString()Parâmetros:nenhum
Valor de retorno:
stringConverte em string. |
toUrlValue |
toUrlValue([precision])Parâmetros:
Valor de retorno:
stringRetorna 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:
LatLngBoundsAmplia 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:
numberLongitude 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:
numberLatitude 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:
numberLatitude 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:
numberLongitude 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:
|
Propriedades | |
|---|---|
altitude |
Tipo:
numberRetorna a altitude. |
lat |
Tipo:
numberRetorna a latitude. |
lng |
Tipo:
numberRetorna a longitude. |
Métodos | |
|---|---|
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.
Propriedades | |
|---|---|
altitude |
Tipo:
numberPadrão:
0Distância (em metros) acima da superfície do solo. Um valor negativo significa abaixo da superfície do solo. |
lat |
Tipo:
numberLatitude 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:
numberLongitude 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:
Um ponto em um plano bidimensional. |
Propriedades | |
|---|---|
x |
Tipo:
numberA coordenada X. |
y |
Tipo:
numberA coordenada Y. |
Métodos | |
|---|---|
equals |
equals(other)Parâmetros:
Valor de retorno:
booleanCompara dois pontos. |
toString |
toString()Parâmetros:nenhum
Valor de retorno:
stringRetorna 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:
Tamanho bidimensional, em que a largura é a distância no eixo x e a altura é a distância no eixo y. |
Propriedades | |
|---|---|
height |
Tipo:
numberA altura ao longo do eixo y, em pixels. |
width |
Tipo:
numberA largura ao longo do eixo x, em pixels. |
Métodos | |
|---|---|
equals |
equals(other)Parâmetros:
Valor de retorno:
booleanCompara dois tamanhos. |
toString |
toString()Parâmetros:nenhum
Valor de retorno:
stringRetorna uma representação no formato de string deste tamanho. |
Interface Padding
Interface google.maps.Padding
Propriedades | |
|---|---|
bottom optional |
Tipo:
number optionalPadding para a parte de baixo, em pixels. |
left optional |
Tipo:
number optionalPadding à esquerda, em pixels. |
right optional |
Tipo:
number optionalPadding à direita, em pixels. |
top optional |
Tipo:
number optionalPadding 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|LatLngLiteralO centro do círculo. |
radius |
Tipo:
numberO 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.
Construtor | |
|---|---|
Orientation3D |
Orientation3D(value)Parâmetros:
|
Propriedades | |
|---|---|
heading |
Tipo:
numberPadrão:
0Rotaçã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:
numberPadrão:
0Rotaçã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:
numberPadrão:
0Rotaçã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:
Valor de retorno:
boolean se os dois objetos são iguais.Função de comparação. |
toJSON |
toJSON()Parâmetros:nenhum
Valor de retorno:
Orientation3DLiteralConverte 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.
Propriedades | |
|---|---|
heading optional |
Tipo:
number optionalRotaçã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 optionalRotaçã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 optionalRotaçã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.
Construtor | |
|---|---|
Vector3D |
Vector3D(value)Parâmetros:
|
Propriedades | |
|---|---|
x |
Tipo:
numberComponente X do vetor tridimensional. |
y |
Tipo:
numberComponente Y do vetor tridimensional. |
z |
Tipo:
numberComponente Z do vetor tridimensional. |
Métodos | |
|---|---|
equals |
equals(other)Parâmetros:
Valor de retorno:
booleanFunção de comparação. |
toJSON |
toJSON()Parâmetros:nenhum
Valor de retorno:
Vector3DLiteralConverte 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.
Propriedades | |
|---|---|
x |
Tipo:
numberComponente X do vetor tridimensional. |
y |
Tipo:
numberComponente Y do vetor tridimensional. |
z |
Tipo:
numberComponente Z do vetor tridimensional. |