Geometry Library

Espacio de nombres de codificación

Espacio de nombres google.maps.geometry.encoding

Son utilidades para codificar y decodificar polilíneas.

Para acceder, llama a const {encoding} = await google.maps.importLibrary("geometry"). Consulta Bibliotecas de la API de Maps JavaScript.

decodePath
decodePath(encodedPath)
Parámetros: 
  • encodedPathstring
Valor que se muestra:  Array<LatLng>
Decodifica una cadena de ruta de acceso codificada en una secuencia de LatLngs.
encodePath
encodePath(path)
Valor que se muestra:  string
Codifica una secuencia de LatLngs en una cadena de ruta de acceso codificada.

Espacio de nombres spherical

Espacio de nombres google.maps.geometry.spherical

Funciones de utilidad para calcular ángulos, distancias y áreas geodésicas. El radio predeterminado es el radio de la Tierra, de 6378137 metros.

Para acceder, llama a const {spherical} = await google.maps.importLibrary("geometry"). Consulta Bibliotecas de la API de Maps JavaScript.

computeArea
computeArea(path[, radiusOfSphere])
Parámetros: 
Valor que se muestra:  number
Muestra el área sin firmar de una ruta cerrada, en el rango [0, 2×pi×radio²]. El área calculada usa las mismas unidades que el radio. El valor predeterminado de radiusOfSphere es el radio de la Tierra en metros, en cuyo caso el área se expresa en metros cuadrados. Para pasar un Circle, se requiere que radius se establezca en un valor no negativo. Además, el círculo no debe cubrir más del 100% de la esfera. Además, cuando se pasa un LatLngBounds, la LatLng del sur no puede estar más al norte que la LatLng del norte.
computeDistanceBetween
computeDistanceBetween(from, to[, radius])
Parámetros: 
Valor que se muestra:  number
Muestra la distancia, en metros, entre dos LatLng. De manera opcional, puedes especificar un radio personalizado. El radio predeterminado es el de la Tierra.
computeHeading
computeHeading(from, to)
Parámetros: 
Valor que se muestra:  number
Muestra el rumbo de un LatLng a otro. Los rumbos se expresan en grados en el sentido de las manecillas del reloj desde el norte dentro del rango [-180,180).
computeLength
computeLength(path[, radius])
Parámetros: 
Valor que se muestra:  number
Muestra la longitud de la ruta de acceso determinada.
computeOffset
computeOffset(from, distance, heading[, radius])
Parámetros: 
Valor que se muestra:  LatLng
Devuelve la LatLng resultante de moverse una distancia desde un origen en el rumbo especificado (expresado en grados en el sentido de las manecillas del reloj desde el norte).
computeOffsetOrigin
computeOffsetOrigin(to, distance, heading[, radius])
Parámetros: 
Valor que se muestra:  LatLng|null
Muestra la ubicación de origen cuando se proporciona un destino LatLng, metros recorridos y rumbo original. Los rumbos se expresan en grados en el sentido de las manecillas del reloj desde el norte. Esta función muestra null cuando no hay ninguna solución disponible.
computeSignedArea
computeSignedArea(loop[, radius])
Parámetros: 
Valor que se muestra:  number
Devuelve el área firmada de una ruta cerrada, donde la dirección en sentido contrario a las manecillas del reloj es positiva, en el rango [-2×pi×radio², 2×pi×radio²]. El área calculada usa las mismas unidades que el radio. El radio predeterminado es el radio de la Tierra en metros, en cuyo caso el área se expresa en metros cuadrados.

El área se calcula con el método de transporte paralelo; el transporte paralelo alrededor de una ruta cerrada en la esfera unidad se tuerce en un ángulo igual al área que encierra la ruta. Esto es más simple, preciso y sólido que la triangulación con Girard, l'Huilier o Eriksson en cada triángulo. En particular, como no triangula, no sufre inestabilidad, excepto en el caso inevitable en el que un borde (no una diagonal) del polígono abarca 180 grados.
interpolate
interpolate(from, to, fraction)
Parámetros: 
Valor que se muestra:  LatLng
Muestra la LatLng que se encuentra en la fracción determinada de la ruta entre la LatLng de origen y la LatLng de destino.

Espacio de nombres poly

Espacio de nombres google.maps.geometry.poly

Funciones de utilidad para hacer cálculos que incluyen polígonos y polilíneas.

Para acceder, llama a const {poly} = await google.maps.importLibrary("geometry"). Consulta Bibliotecas de la API de Maps JavaScript.

containsLocation
containsLocation(point, polygon)
Parámetros: 
Valor que se muestra:  boolean
Calcula si el punto determinado se encuentra dentro del polígono especificado.
isLocationOnEdge
isLocationOnEdge(point, poly[, tolerance])
Parámetros: 
Valor que se muestra:  boolean
Calcula si el punto determinado se encuentra en una polilínea o cerca de ella, o en el borde de un polígono, dentro de una tolerancia especificada. Muestra true cuando la diferencia entre la latitud y la longitud del punto proporcionado y el punto más cercano del borde es menor que la tolerancia. La tolerancia predeterminada es de 10-9 grados.