Geometry Library

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.

Métodos estáticos
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) Parâmetros: path: Array<LatLng|LatLngLiteral>|MVCArray<LatLng|LatLngLiteral> 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.

Métodos estáticos
computeArea	computeArea(path[, radiusOfSphere]) Parâmetros: path: Array<LatLng|LatLngLiteral>|MVCArray<LatLng|LatLngLiteral>|Circle|CircleLiteral|LatLngBounds|LatLngBoundsLiteral radiusOfSphere:  number optional 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: from: LatLng|LatLngLiteral to:  LatLng|LatLngLiteral radius: number optional 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: from:  LatLng|LatLngLiteral to:  LatLng|LatLngLiteral 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: path: Array<LatLng|LatLngLiteral>|MVCArray<LatLng|LatLngLiteral> radius: number optional Valor de retorno: number Retorna o tamanho do caminho fornecido.
computeOffset	computeOffset(from, distance, heading[, radius]) Parâmetros: from: LatLng|LatLngLiteral distance:  number heading: number radius: number optional 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: to:  LatLng|LatLngLiteral distance:  number heading: number radius: number optional 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: loop:  Array<LatLng|LatLngLiteral>|MVCArray<LatLng|LatLngLiteral> radius: number optional 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: from:  LatLng|LatLngLiteral to: LatLng|LatLngLiteral fraction: number 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.

Métodos estáticos
containsLocation	containsLocation(point, polygon) Parâmetros: point:  LatLng|LatLngLiteral polygon: Polygon Valor de retorno: boolean Calcula se o ponto especificado está dentro do polígono especificado.
isLocationOnEdge	isLocationOnEdge(point, poly[, tolerance]) Parâmetros: point:  LatLng|LatLngLiteral poly:  Polygon|Polyline tolerance:  number optional 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.