Geometry Library

namespace encoding

namespace google.maps.geometry.encoding
biblioteca "geometry"

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

const {encoding} = await google.maps.importLibrary("geometry");
decodePath
decodePath(encodedPath)
Parâmetros:
  • encodedPath: string
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 spherical

namespace google.maps.geometry.spherical
biblioteca "geometry"

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.

const {spherical} = await google.maps.importLibrary("geometry");
computeArea
computeArea(path[, radiusOfSphere])
Valor de retorno: number
Retorna a área não assinada de um caminho fechado, no intervalo [0, 2×pi×raio²]. A área calculada usa as mesmas unidades do raio. O padrão de radiusOfSphere é o raio da Terra em metros. Nesse caso, a área é em metros quadrados. Para transmitir um Circle, o radius precisa ser definido como um valor não negativo. Além disso, o círculo não pode cobrir mais de 100% da esfera. Ao transmitir um LatLngBounds, o LatLng do sul não pode estar mais ao norte do que o LatLng do norte.
computeDistanceBetween
computeDistanceBetween(from, to[, radius])
Parâmetros:
Valor de retorno: number
Retorna a distância, em metros, entre dois LatLngs. Se quiser, especifique um raio personalizado. O raio padrão é o raio da Terra.
computeHeading
computeHeading(from, to)
Parâmetros:
Valor de retorno: number
Retorna o rumo de um LatLng para outro. As direções são expressas em graus no sentido horário a partir do norte, no intervalo [-180,180).
computeLength
computeLength(path[, radius])
Parâmetros:
Valor de retorno: number
Retorna o comprimento do caminho fornecido.
computeOffset
computeOffset(from, distance, heading[, radius])
Parâmetros:
Valor de retorno: LatLng
Retorna o LatLng resultante de mover uma distância 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 direção original. As direções são expressas 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 sentido anti-horário é positivo, no intervalo [-2×pi×raio², 2×pi×raio²]. A área calculada usa as mesmas unidades do raio. O raio padrão é o da Terra em metros, e 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 se torce em um ângulo igual à área delimitada pelo caminho. Isso é mais simples, preciso e robusto do que a triangulação usando Girard, l'Huilier ou Eriksson em cada triângulo. Como não faz triangulação, ele não sofre instabilidade, exceto no caso inevitável em que uma borda (não uma diagonal) do polígono se estende por 180 graus.
interpolate
interpolate(from, to, fraction)
Parâmetros:
Valor de retorno: LatLng
Retorna o LatLng que se encontra na fração indicada do caminho entre o LatLng de origem e o LatLng de destino.
AlphatraversePath
traversePath(path, fraction)
Parâmetros:
Valor de retorno: LatLngLiteral
Retorna a posição que se encontra na fração especificada do caminho indicado. Se você transmitir objetos LatLngAltitude, a altitude será ignorada, mas as versões futuras poderão considerar esse valor.

Namespace poly

namespace google.maps.geometry.poly
biblioteca "geometry"

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

const {poly} = await google.maps.importLibrary("geometry");
containsLocation
containsLocation(point, polygon)
Parâmetros:
Valor de retorno: boolean
Calcula se o ponto fornecido está dentro do polígono ou círculo especificado. Para transmitir um Circle, é necessário definir center e radius como um valor não negativo.
isLocationOnEdge
isLocationOnEdge(point, poly[, tolerance])
Parâmetros:
Valor de retorno: boolean
Calcula se o ponto fornecido está sobre ou perto de uma polilinha ou da borda 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.