Anúncio:em breve, a Plataforma Google Maps vai ter um novo estilo de mapa de base. Essa atualização inclui uma nova paleta de cores padrão, pinos modernizados e melhorias nas experiências de mapa e na usabilidade. Todos os estilos de mapa serão atualizados automaticamente em março de 2025. Para mais informações sobre a disponibilidade e como ativar logo, consulte Novo estilo de mapa para a Plataforma Google Maps.

Esta página foi traduzida pela API Cloud Translation.

Geometry Library

Namespace encoding

Namespace google.maps.geometry.encoding

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.

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 spherical

Namespace google.maps.geometry.spherical

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.

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×radius²]. A área calculada usa as mesmas unidades do raio. O padrão de `radiusOfSphere` é o raio da Terra em metros, e 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. E ao transmitir um `LatLngBounds`, a LatLng do sul não pode estar mais ao norte que a 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. Você pode especificar um raio personalizado. O padrão é o raio da Terra.
`computeHeading`	`computeHeading(from, to)` Parâmetros: `from`: `LatLng\|LatLngLiteral` `to`: `LatLng\|LatLngLiteral` Valor de retorno:`number` Retorna o título 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: `path`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>` `radius`: `number optional` Valor de retorno:`number` Retorna o comprimento 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 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: `to`: `LatLng\|LatLngLiteral` `distance`: `number` `heading`: `number` `radius`: `number optional` 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: `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×radius², 2×pi×radius²]. A área calculada usa as mesmas unidades do raio. O padrão é o raio 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 e mais preciso e robusto do que a triangulação usando Girard, l'Huilier ou Eriksson em cada triângulo. Em particular, como não triangula, não sofre instabilidade, exceto no caso inevitável em que um borda (não uma diagonal) do polígono se estende por 180 graus.
`interpolate`	`interpolate(from, to, fraction)` Parâmetros: `from`: `LatLng\|LatLngLiteral` `to`: `LatLng\|LatLngLiteral` `fraction`: `number` 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

Namespace google.maps.geometry.poly

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.

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. 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 10^-9 graus.

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. 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 10^-9 graus.