Geometry Library

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

namespace de codificação

google.maps.geometry.encoding namespace

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

Carregar usando o parâmetro de URL &libraries=geometry. Consulte Bibliotecas na API Maps JavaScript.

Ao usar v=beta, é possível chamar const {encoding} = await google.map.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.

Carregar usando o parâmetro de URL &libraries=geometry. Consulte Bibliotecas na API Maps JavaScript.

Ao usar v=beta, é possível chamar const {spherical} = await google.map.importLibrary("geometry"). Consulte Bibliotecas na API Maps JavaScript.

computeArea
computeArea(path[, radiusOfSphere])
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 que o raio. O padrão de radiusOfSphere é o raio da Terra em metros. Nesse caso, a área é em metros quadrados. Transmitir um Circle exige que o radius seja definido como um valor não negativo. Além disso, o círculo não pode abranger mais de 100% da esfera. E ao transmitir um LatLngBounds, o LatLng do sul não pode ser 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. Também é possível especificar um raio personalizado. O raio é padrão para o da Terra.
computeHeading
computeHeading(from, to)
Parâmetros:
Valor de retorno: number
Retorna o título de uma LatLng para outra LatLng. Os títulos 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 o LatLng resultante de uma distância de uma origem no título especificado (expresso 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 informado com um destino LatLng, metros percorridos e direçã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 sentido anti-horário é positivo, no intervalo [-2×pi×Radius2, 2×pi×radius2]. A área calculada usa as mesmas unidades que o raio. O raio padrão é o raio da Terra em metros. Nesse caso, a área é em metros quadrados.

A área é calculada usando o método de transporte paralelo, e o transporte paralelo ao redor de um caminho fechado na esfera da unidade gira em um ângulo igual à área incluída no caminho. Isso é mais simples, preciso e robusto do que a triangulação usando Girard, l'Huilier ou Eriksson em cada triângulo. Em particular, como ele não triangular, não sofre instabilidade, exceto no caso inevitável quando uma borda (não uma diagonal) do polígono abrange 180 graus.
interpolate
interpolate(from, to, fraction)
Parâmetros:
Valor de retorno: LatLng
Retorna o LatLng que está entre a fração especificada do caminho entre o Plano de origem e o Destino de destino.

namespace Poly

google.maps.geometry.poly namespace

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

Carregar usando o parâmetro de URL &libraries=geometry. Consulte Bibliotecas na API Maps JavaScript.

Ao usar v=beta, é possível chamar const {poly} = await google.map.importLibrary("geometry"). Consulte Bibliotecas na API Maps JavaScript.

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