Geometry Library

namespace encoding

google.maps.geometry.encoding namespace

Utilitários para codificação e decodificação de polilinhas.

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

decodePath
decodePath(encodedPath)
Parâmetros: 
  • encodedPathstring
Valor de retorno:  Array<LatLng>
Decodifica uma string de caminho codificado em uma sequência de LatLngs.
encodePath
encodePath(path)
Valor de retorno:  string
Codifica uma sequência de LatLngs em uma string de caminho codificado.

namespace esférico

google.maps.geometry.spherical namespace

Funções de utilitários para computar áreas, distâncias e ângulos geodésicos. O raio padrão é o raio da Terra que apresenta 6.378.137 metros.

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

computeArea
computeArea(path[, radiusOfSphere])
Parâmetros: 
Valor de retorno:  number
Retorna a área não assinada de um caminho fechado, no intervalo [0, 2×pi×Radius2]. A área calculada usa as mesmas unidades do raio. O radiusOfSphere padrão é o raio da Terra em metros, nesse caso, a área é em metros quadrados. A transmissão de um Circle exige que o radius seja definido como um valor não negativo. Além disso, o círculo não pode cobrir mais de 100% da esfera. Além disso, ao transmitir um LatLngBounds, a LatLng sul não pode ser mais ao norte do que a LatLng norte.
computeDistanceBetween
computeDistanceBetween(from, to[, radius])
Parâmetros: 
Valor de retorno:  number
Retorna a distância, em metros, entre duas LatLngs. Também é possível especificar um raio personalizado. O padrão é o raio da Terra.
computeHeading
computeHeading(from, to)
Parâmetros: 
Valor de retorno:  number
Retorna a orientação de uma LatLng para outra LatLng. Os rumos são expressos em graus no sentido horário a partir do Norte dentro do intervalo [-180,180).
computeLength
computeLength(path[, radius])
Parâmetros: 
Valor de retorno:  number
Retorna o tamanho do caminho fornecido.
computeOffset
computeOffset(from, distance, heading[, radius])
Parâmetros: 
Valor de retorno:  LatLng
Retorna a LatLng resultante do deslocamento de uma distância a partir de uma origem na direção especificada (expressa em graus no sentido horário a partir do norte).
computeOffsetOrigin
computeOffsetOrigin(to, distance, heading[, radius])
Parâmetros: 
Valor de retorno:  LatLng|null
Retorna o local de origem quando fornecido com um destino LatLng, metros percorridos e orientação original. Os rumos são expressos em graus no sentido horário a partir do Norte. Essa função retorna null quando nenhuma solução está disponível.
computeSignedArea
computeSignedArea(loop[, radius])
Parâmetros: 
Valor de retorno:  number
Retorna a área assinada de um caminho fechado, em que o valor no sentido anti-horário é positivo, no intervalo [-2×pi×Radius2, 2×pi×Radius2]. A área calculada usa as mesmas unidades que o raio. Por padrão, o raio da Terra é definido em metros, ou seja, a área é em metros quadrados.

A área é calculada usando o método de transporte paralelo. O transporte paralelo em torno de um caminho fechado na esfera unitária torce em um ângulo igual à área delimitada pelo caminho. Ela é mais simples, precisa e robusta do que a triangulação usando Girard, l'Huilier ou Eriksson em cada triângulo. Em particular, como não triangular, ele não sofre instabilidade, exceto no caso inevitável em que a borda (não uma diagonal) do polígono abrange 180 graus.
interpolate
interpolate(from, to, fraction)
Parâmetros: 
Valor de retorno:  LatLng
Retorna a LatLng que está na fração especificada do caminho entre a LatLng de origem e a LatLng de destino.

namespace poly

google.maps.geometry.poly namespace

Funções utilitárias para cálculos envolvendo polígonos e polilinhas.

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

containsLocation
containsLocation(point, polygon)
Parâmetros: 
Valor de retorno:  boolean
Computa se o ponto especificado está dentro do polígono especificado.
isLocationOnEdge
isLocationOnEdge(point, poly[, tolerance])
Parâmetros: 
Valor de retorno:  boolean
Computa se o ponto especificado está sobre ou perto de uma polilinha ou de um polígono, dentro de uma tolerância especificada. Retorna true quando a diferença entre a latitude e a longitude do ponto fornecido e o ponto mais próximo na borda é menor que a tolerância. A tolerância padrão é de 10a 9 graus.